The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
import { fireEvent, screen, waitFor } from '@testing-library/react';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import type { WalletStatus } from '../../../../services/walletApi';
import { renderWithProviders } from '../../../../test/test-utils';
import RecoveryPhrasePanel from '../RecoveryPhrasePanel';
// Use vi.hoisted so the factory closures can reference these before module initialisation.
const {
mockGenerateMnemonicPhrase,
mockFetchWalletStatus,
mockValidateRecoveryPhrase,
mockPersistLocalWalletFromMnemonic,
mockRevealRecoveryPhrase,
} = vi.hoisted(() => ({
mockGenerateMnemonicPhrase: vi.fn<() => string | { phrase: string; wordCount: number }>(() => ({
phrase: 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12',
wordCount: 12,
})),
mockValidateRecoveryPhrase: vi.fn(async () => true),
mockFetchWalletStatus: vi.fn(
async (): Promise<WalletStatus> => ({
configured: false,
onboardingCompleted: false,
consentGranted: false,
secretStored: false,
source: null,
mnemonicWordCount: null,
accounts: [],
updatedAtMs: null,
})
),
mockPersistLocalWalletFromMnemonic: vi.fn(
async (_args: { force?: boolean; mnemonic?: string; source?: string }) => undefined
),
mockRevealRecoveryPhrase: vi.fn(async () => ({
phrase: 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12',
wordCount: 12,
})),
}));
vi.mock('../../../../providers/CoreStateProvider', () => ({
useCoreState: () => ({
snapshot: { currentUser: { _id: 'test-user-id' } },
setEncryptionKey: vi.fn(async () => undefined),
}),
}));
// Default: no existing wallet. Individual describe blocks override in beforeEach.
vi.mock('../../../../services/walletApi', () => ({
fetchWalletStatus: mockFetchWalletStatus,
generateRecoveryPhrase: async () => {
const generated = await mockGenerateMnemonicPhrase();
return typeof generated === 'string' ? { phrase: generated, wordCount: 12 } : generated;
},
validateRecoveryPhrase: mockValidateRecoveryPhrase,
setupLocalWallet: vi.fn(async () => ({
configured: true,
onboardingCompleted: true,
consentGranted: true,
secretStored: true,
source: 'generated',
mnemonicWordCount: 12,
accounts: [],
updatedAtMs: Date.now(),
})),
revealRecoveryPhrase: mockRevealRecoveryPhrase,
}));
vi.mock('../../../../features/wallet/setupLocalWalletFromMnemonic', () => ({
persistLocalWalletFromMnemonic: mockPersistLocalWalletFromMnemonic,
}));
// Helper: configured wallet status
const configuredWalletStatus = (): WalletStatus => ({
configured: true,
onboardingCompleted: true,
consentGranted: true,
secretStored: true,
source: 'generated',
mnemonicWordCount: 12,
accounts: [
{ chain: 'evm', address: '0xabc123', derivationPath: "m/44'/60'/0'/0/0" },
{ chain: 'btc', address: 'bc1qxyz', derivationPath: "m/84'/0'/0'/0/0" },
{ chain: 'solana', address: 'SolAbc', derivationPath: "m/44'/501'/0'/0'" },
{ chain: 'tron', address: 'TronAbc', derivationPath: "m/44'/195'/0'/0/0" },
],
updatedAtMs: 1_700_000_000_000,
});
// Reset to unconfigured wallet between tests
const noWalletStatus = (): WalletStatus => ({
configured: false,
onboardingCompleted: false,
consentGranted: false,
secretStored: false,
source: null,
mnemonicWordCount: null,
accounts: [],
updatedAtMs: null,
});
describe('RecoveryPhrasePanel — trust-surface polish', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(noWalletStatus());
});
it('renders the warning callout in generate mode', async () => {
const { container } = renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => expect(screen.queryByText(/can never be recovered if lost/i)).toBeTruthy());
expect(container.querySelector('[data-variant="info"]')).not.toBeNull();
});
it('renders import-mode intro copy when switching modes', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
expect(screen.getByText(/Enter your recovery phrase below/i)).toBeTruthy();
});
it('uses the semantic text-content-secondary token on the confirm-checkbox label (not opacity)', async () => {
const { container } = renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/consent to using it for local wallet setup/i));
const label = screen.getByText(/consent to using it for local wallet setup/i);
expect(label.className).toContain('text-content-secondary');
expect(label.className).not.toContain('opacity-80');
expect(container).toBeTruthy();
});
});
// Batch-5: recovery/mnemonic mode-switch state reset (pr#1646)
describe('RecoveryPhrasePanel — mode-switch state reset', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(noWalletStatus());
});
it('switches to import mode and shows import-mode UI', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/can never be recovered if lost/i));
expect(screen.getByText(/can never be recovered if lost/i)).toBeTruthy();
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
expect(screen.getByText(/Enter your recovery phrase below/i)).toBeTruthy();
});
it('resets confirmed checkbox when switching from generate to import', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByRole('checkbox'));
const checkbox = screen.getByRole('checkbox');
fireEvent.click(checkbox);
expect(checkbox).toBeChecked();
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
expect(screen.queryByRole('checkbox')).toBeNull();
fireEvent.click(screen.getByText(/Create a New Wallet/i));
const regeneratedCheckbox = await screen.findByRole('checkbox');
expect(regeneratedCheckbox).not.toBeChecked();
});
it('shows generate-mode UI again after switching back from import', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
expect(screen.getByText(/Enter your recovery phrase below/i)).toBeTruthy();
fireEvent.click(screen.getByText(/Create a New Wallet/i));
expect(await screen.findByText(/can never be recovered if lost/i)).toBeTruthy();
});
});
// ── New wallet-safety tests ───────────────────────────────────────────────────
describe('RecoveryPhrasePanel — existing wallet → view mode (no regenerate)', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(configuredWalletStatus());
});
it('shows view mode when wallet is already configured', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
// "Your wallet is already set up." — the English translation of mnemonic.walletAlreadyConfigured
await waitFor(() => expect(screen.queryByText(/Your wallet is already set up/i)).toBeTruthy());
// No mnemonic reveal button in view mode
expect(screen.queryByLabelText(/Reveal recovery phrase/i)).toBeNull();
// No consent checkbox in view mode
expect(screen.queryByRole('checkbox')).toBeNull();
});
it('does NOT call generateMnemonicPhrase when wallet exists', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => expect(screen.queryByText(/Your wallet is already set up/i)).toBeTruthy());
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
});
it('shows wallet metadata: source and word count labels', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => expect(screen.queryByText(/Source/i)).toBeTruthy());
expect(screen.getByText(/Recovery phrase length/i)).toBeTruthy();
expect(screen.getByText(/Last updated/i)).toBeTruthy();
});
it('shows account addresses in view mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText('0xabc123'));
expect(screen.getByText('0xabc123')).toBeTruthy();
expect(screen.getByText('bc1qxyz')).toBeTruthy();
});
});
describe('RecoveryPhrasePanel — replace-wallet confirmation gate', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(configuredWalletStatus());
});
it('clicking Replace wallet shows confirmation dialog, not generate mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
// Wait for view mode: "Replace wallet" dropdown
await waitFor(() => screen.getByText(/Replace Wallet/i));
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/Create a New Wallet/i));
// Warning text for replace
expect(screen.getByText(/permanently replace your current wallet/i)).toBeTruthy();
// Confirm button present
expect(screen.getByText(/I understand, replace my wallet/i)).toBeTruthy();
// Mnemonic grid not shown yet
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
});
it('confirming replace enters generate mode and generates a new phrase', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Replace Wallet/i));
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/Create a New Wallet/i));
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
fireEvent.click(screen.getByText(/I understand, replace my wallet/i));
expect(mockGenerateMnemonicPhrase).toHaveBeenCalledTimes(1);
await waitFor(() => screen.getByLabelText(/Reveal recovery phrase/i));
});
it('cancel in replace-confirm returns to view mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Replace Wallet/i));
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/Cancel/i));
await waitFor(() => screen.getByText(/Your wallet is already set up/i));
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
});
});
describe('RecoveryPhrasePanel — replace save calls persistLocalWalletFromMnemonic with force=true', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(configuredWalletStatus());
});
it('after replace confirmation, save calls persistLocalWalletFromMnemonic with force=true', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Replace Wallet/i));
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/Create a New Wallet/i));
fireEvent.click(screen.getByText(/I understand, replace my wallet/i));
const revealButton = await screen.findByLabelText(/Reveal recovery phrase/i);
fireEvent.click(revealButton);
const checkbox = screen.getByRole('checkbox');
fireEvent.click(checkbox);
const saveButton = screen.getByText(/Save Recovery Phrase/i).closest('button')!;
fireEvent.click(saveButton);
await waitFor(() => expect(mockPersistLocalWalletFromMnemonic).toHaveBeenCalled());
const callArgs = mockPersistLocalWalletFromMnemonic.mock.calls[0][0];
expect(callArgs.force).toBe(true);
});
});
describe('RecoveryPhrasePanel — no wallet → generate calls persistLocalWalletFromMnemonic without force', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue(noWalletStatus());
});
it('fresh setup saves without force flag', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByRole('checkbox'));
fireEvent.click(screen.getByLabelText(/Reveal recovery phrase/i));
const checkbox = screen.getByRole('checkbox');
fireEvent.click(checkbox);
const saveButton = screen.getByText(/Save Recovery Phrase/i).closest('button')!;
fireEvent.click(saveButton);
await waitFor(() => expect(mockPersistLocalWalletFromMnemonic).toHaveBeenCalled());
const callArgs = mockPersistLocalWalletFromMnemonic.mock.calls[0][0];
expect(callArgs.force).toBeUndefined();
});
});
describe('RecoveryPhrasePanel — loading state', () => {
it('shows loading spinner while checking wallet status', () => {
// fetchWalletStatus never resolves — simulates pending/loading state.
mockFetchWalletStatus.mockImplementation(() => new Promise(() => {}));
renderWithProviders(<RecoveryPhrasePanel />);
// "Checking wallet status..." — English translation of mnemonic.loadingWalletStatus
expect(screen.getByText(/Checking wallet status/i)).toBeTruthy();
});
});
// ── Coverage gate additions ───────────────────────────────────────────────────
// Covers diff-cover lines: 78,81-82,84 (status-fetch failure → view/statusError),
// 106-111 (handleImportReplace in replace-confirm), 153 (handleCopy guard),
// 253-254 (!mnemonic early-return), 312 (statusError alert in view mode),
// 538,541 (copy button onClick + copied state), 608 (word-count change),
// 633-634,638,640,650 (import word onChange/onKeyDown + styling + valid banner),
// 707 (error alert in generate/import mode).
describe('RecoveryPhrasePanel — fetchWalletStatus rejection degrades to view with statusError', () => {
beforeEach(() => {
vi.clearAllMocks();
// Simulate a network / RPC failure on the status check (covers lines 78, 81-82, 84).
mockFetchWalletStatus.mockRejectedValue(new Error('Network error: wallet status unavailable'));
});
// Covers lines 78, 81-82, 84, 312.
it('shows statusError alert in view mode when fetchWalletStatus rejects', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
// After rejection the component degrades to view mode and renders the coral error alert.
await waitFor(() => expect(screen.queryByRole('alert')).toBeTruthy());
expect(screen.getByRole('alert').textContent).toContain(
'Network error: wallet status unavailable'
);
// Must NOT auto-generate a phrase (would risk overwriting an existing wallet).
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
// The recovery/consent UI must not be shown — only the error alert.
expect(screen.queryByRole('checkbox')).toBeNull();
});
// Covers line 312 (statusError branch in renderViewMode).
it('statusError alert uses role="alert" and shows the error text', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByRole('alert'));
const alert = screen.getByRole('alert');
expect(alert.textContent).toMatch(/Network error/i);
});
// Verify a generic error message appears when rejection value is not an Error instance.
it('falls back to generic message when rejection is a plain string', async () => {
mockFetchWalletStatus.mockRejectedValue('unexpected failure');
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByRole('alert'));
expect(screen.getByRole('alert').textContent).toContain(
'Failed to check wallet status. Please try again.'
);
});
});
describe('RecoveryPhrasePanel — replace-confirm → import path (handleImportReplace)', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue({
configured: true,
onboardingCompleted: true,
consentGranted: true,
secretStored: true,
source: 'generated',
mnemonicWordCount: 12,
accounts: [],
updatedAtMs: 1_700_000_000_000,
});
});
// Covers lines 106-111 (handleImportReplace sets isReplace=true and enters import mode).
it('clicking Import an Existing Wallet enters import replace-confirm mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Replace Wallet/i));
// Enter replace-confirm mode.
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Import an Existing Wallet/i));
fireEvent.click(screen.getByText(/Import an Existing Wallet/i));
expect(screen.getByText(/permanently replace your current wallet/i)).toBeTruthy();
// Click the "I understand, replace my wallet" button inside replace-confirm.
await waitFor(() => screen.getByText(/I understand, replace my wallet/i));
fireEvent.click(screen.getByText(/I understand, replace my wallet/i));
// Must arrive in import mode — the intro copy is the marker.
await waitFor(() =>
expect(screen.queryByText(/Enter your recovery phrase below/i)).toBeTruthy()
);
// No mnemonic was generated (since we went to import, not generate).
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
});
// Covers line 608 (word-count change buttons in import mode after handleImportReplace).
it('changing word count in import mode (after replace flow) updates the word slots', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Replace Wallet/i));
fireEvent.pointerDown(screen.getByText(/Replace Wallet/i));
await waitFor(() => screen.getByText(/Import an Existing Wallet/i));
fireEvent.click(screen.getByText(/Import an Existing Wallet/i));
fireEvent.click(screen.getByText(/I understand, replace my wallet/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
// Default is 12 word slots; switch to 24.
fireEvent.click(screen.getByRole('radio', { name: '24' }));
// 24 labelled inputs should now be visible.
const inputs = screen.getAllByRole('textbox');
// The count may exceed 24 if there are other textboxes, but there must be at least 24.
expect(inputs.length).toBeGreaterThanOrEqual(24);
});
});
describe('RecoveryPhrasePanel — copy button in revealed generate mode', () => {
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue({
configured: false,
onboardingCompleted: false,
consentGranted: false,
secretStored: false,
source: null,
mnemonicWordCount: null,
accounts: [],
updatedAtMs: null,
});
// Stub clipboard so the copy path doesn't throw.
Object.assign(navigator, { clipboard: { writeText: vi.fn(async () => undefined) } });
});
// Covers lines 538, 541 (copy button onClick triggers handleCopy; copied state renders "Copied").
it('reveals phrase then copies — shows Copied state after clicking copy button', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByLabelText(/Reveal recovery phrase/i));
// Reveal the phrase first (otherwise the copy button is disabled).
fireEvent.click(screen.getByLabelText(/Reveal recovery phrase/i));
// Copy button should now be enabled. Click it.
const copyButton = screen.getByText(/Copy to Clipboard/i).closest('button')!;
expect(copyButton).not.toBeDisabled();
fireEvent.click(copyButton);
// navigator.clipboard.writeText must have been called with the mnemonic.
await waitFor(() =>
expect(vi.mocked(navigator.clipboard.writeText)).toHaveBeenCalledWith(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
)
);
// The button label switches to "Copied" (common.copied translation).
await waitFor(() => expect(screen.queryByText(/^Copied$/i)).toBeTruthy());
});
// Covers line 153 (handleCopy early-return when !mnemonic — guard branch).
// This can only happen if mnemonic is null; we simulate it by making generateMnemonicPhrase
// return an empty string so the split produces no words, but the guard is at the function level.
// We test the guard indirectly: with no mnemonic the copy button is disabled and clipboard is
// never written.
it('copy button is disabled before phrase is revealed (mnemonic guard path)', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByLabelText(/Reveal recovery phrase/i));
// The copy button exists but is disabled before reveal.
const copyButton = screen.getByText(/Copy to Clipboard/i).closest('button')!;
expect(copyButton).toBeDisabled();
fireEvent.click(copyButton);
// Clipboard should not have been written.
expect(vi.mocked(navigator.clipboard.writeText)).not.toHaveBeenCalled();
});
});
describe('RecoveryPhrasePanel — !mnemonic early-return in handleSave (lines 253-254)', () => {
beforeEach(() => {
vi.clearAllMocks();
// Return empty string so mnemonic state is set to '' — falsy, triggers the guard.
mockGenerateMnemonicPhrase.mockReturnValue('');
mockFetchWalletStatus.mockResolvedValue({
configured: false,
onboardingCompleted: false,
consentGranted: false,
secretStored: false,
source: null,
mnemonicWordCount: null,
accounts: [],
updatedAtMs: null,
});
});
// Covers lines 253-254: confirmed=true but mnemonic is falsy → early return, no persist call.
it('does not call persistLocalWalletFromMnemonic when mnemonic is empty', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
// The checkbox is present once generate mode initialises.
await waitFor(() => screen.getByRole('checkbox'));
const checkbox = screen.getByRole('checkbox');
fireEvent.click(checkbox);
const saveButton = screen.getByText(/Save Recovery Phrase/i).closest('button')!;
fireEvent.click(saveButton);
// With an empty mnemonic, persistLocalWalletFromMnemonic must NOT be called.
await waitFor(() => expect(mockPersistLocalWalletFromMnemonic).not.toHaveBeenCalled());
});
});
describe('RecoveryPhrasePanel — import mode word inputs and valid/invalid styling', () => {
// Known-valid 12-word BIP39 test vector.
const VALID_12_WORDS =
'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'.split(
' '
);
beforeEach(() => {
vi.clearAllMocks();
mockGenerateMnemonicPhrase.mockReturnValue(
'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12'
);
mockFetchWalletStatus.mockResolvedValue({
configured: false,
onboardingCompleted: false,
consentGranted: false,
secretStored: false,
source: null,
mnemonicWordCount: null,
accounts: [],
updatedAtMs: null,
});
});
// Covers lines 633-634 (onChange on word inputs updates importWords).
it('typing into a word input updates the value (onChange coverage)', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
const wordInputs = screen.getAllByLabelText(/Recovery phrase word/i);
fireEvent.change(wordInputs[0], { target: { value: 'abandon' } });
expect((wordInputs[0] as HTMLInputElement).value).toBe('abandon');
});
// Covers line 638 (onKeyDown on word inputs — Backspace on empty field).
it('pressing Backspace on an empty word input (onKeyDown coverage)', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
const wordInputs = screen.getAllByLabelText(/Recovery phrase word/i);
// Word 1 is empty; Backspace on word slot 2 (index 1) when it is empty.
fireEvent.keyDown(wordInputs[1], { key: 'Backspace' });
// No crash — focus attempt is the side-effect; just verify the inputs remain.
expect(wordInputs[1]).toBeTruthy();
});
// Covers lines 640 (importValid===false invalid border), 638, and 707 (error alert).
it('clicking Save with an invalid phrase shows the error alert (line 707)', async () => {
mockValidateRecoveryPhrase.mockResolvedValueOnce(false);
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
// Fill all 12 slots with an invalid word so the phrase is structurally complete but invalid.
const wordInputs = screen.getAllByLabelText(/Recovery phrase word/i);
for (const input of wordInputs.slice(0, 12)) {
fireEvent.change(input, { target: { value: 'invalid' } });
}
// All slots filled — Save should now be enabled.
const saveButton = screen.getByText(/Import wallet/i).closest('button')!;
fireEvent.click(saveButton);
// The error alert (line 707) must appear.
await waitFor(() => expect(screen.queryByRole('alert')).toBeTruthy());
// persistLocalWalletFromMnemonic should NOT have been called.
expect(mockPersistLocalWalletFromMnemonic).not.toHaveBeenCalled();
});
// Covers line 650 (importValid===true banner), line 640 (sage border on valid inputs).
it('filling a valid BIP39 phrase and saving shows the valid-phrase banner then persists', async () => {
let finishPersist!: () => void;
mockPersistLocalWalletFromMnemonic.mockImplementationOnce(
() =>
new Promise<undefined>(resolve => {
finishPersist = () => resolve(undefined);
})
);
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
const wordInputs = screen.getAllByLabelText(/Recovery phrase word/i);
// Type the 12-word valid BIP39 vector into each slot.
VALID_12_WORDS.forEach((word, i) => {
fireEvent.change(wordInputs[i], { target: { value: word } });
});
// All slots filled — Save button should be enabled.
const saveButton = screen.getByText(/Import wallet/i).closest('button')!;
expect(saveButton).not.toBeDisabled();
fireEvent.click(saveButton);
// After validation, importValid becomes true → "Valid recovery phrase" banner (line 650).
await waitFor(() => expect(screen.queryByText(/Valid recovery phrase/i)).toBeTruthy());
// Wallet persist must have been called with the correct phrase.
await waitFor(() => expect(mockPersistLocalWalletFromMnemonic).toHaveBeenCalled());
const callArgs = mockPersistLocalWalletFromMnemonic.mock.calls[0][0];
expect(callArgs.mnemonic).toBe(VALID_12_WORDS.join(' '));
expect(callArgs.source).toBe('imported');
finishPersist();
await waitFor(() => expect(screen.queryByText(/Recovery phrase saved/i)).toBeTruthy());
});
// Covers line 608 (handleWordCountChange via the word-count toggle buttons).
it('switching from 12 to 15 word slots adjusts the import grid', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/I already have a recovery phrase/i));
fireEvent.click(screen.getByText(/I already have a recovery phrase/i));
await waitFor(() => screen.getByText(/Enter your recovery phrase below/i));
// Initially 12 slots.
expect(screen.getAllByLabelText(/Recovery phrase word/i).length).toBe(12);
// Click the "15" word-count button.
fireEvent.click(screen.getByRole('radio', { name: '15' }));
// Now 15 slots.
expect(screen.getAllByLabelText(/Recovery phrase word/i).length).toBe(15);
});
});
describe('RecoveryPhrasePanel — view mode: reveal existing recovery phrase', () => {
beforeEach(() => {
vi.clearAllMocks();
mockFetchWalletStatus.mockResolvedValue(configuredWalletStatus());
mockRevealRecoveryPhrase.mockResolvedValue({
phrase: 'word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12',
wordCount: 12,
});
});
it('shows "Reveal recovery phrase" button in view mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Your wallet is already set up/i));
expect(screen.getByText(/Reveal recovery phrase/i)).toBeTruthy();
});
it('clicking reveal button calls revealRecoveryPhrase and opens modal', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Reveal recovery phrase/i));
fireEvent.click(screen.getByText(/Reveal recovery phrase/i).closest('button')!);
await waitFor(() => expect(mockRevealRecoveryPhrase).toHaveBeenCalled());
// The modal opens and shows the localized save instructions.
await waitFor(() => expect(screen.queryByText(/Save Recovery Phrase/i)).toBeTruthy());
});
it('shows error message when revealRecoveryPhrase rejects', async () => {
mockRevealRecoveryPhrase.mockRejectedValue(new Error('No recovery phrase available'));
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Reveal recovery phrase/i));
fireEvent.click(screen.getByText(/Reveal recovery phrase/i).closest('button')!);
await waitFor(() => expect(screen.queryByRole('alert')).toBeTruthy());
expect(screen.getByRole('alert').textContent).toContain('No recovery phrase available');
});
it('does NOT call generateMnemonicPhrase or persistLocalWalletFromMnemonic in view mode', async () => {
renderWithProviders(<RecoveryPhrasePanel />);
await waitFor(() => screen.getByText(/Reveal recovery phrase/i));
fireEvent.click(screen.getByText(/Reveal recovery phrase/i).closest('button')!);
await waitFor(() => expect(mockRevealRecoveryPhrase).toHaveBeenCalled());
expect(mockGenerateMnemonicPhrase).not.toHaveBeenCalled();
expect(mockPersistLocalWalletFromMnemonic).not.toHaveBeenCalled();
});
});