Skip to main content

Importing an existing phrase

BitTool Signer imports any valid BIP39 phrase of 12, 15, 18, 21 or 24 words in any of the ten official wordlists. Import has two steps: enter and validate the phrase (optionally with a BIP39 passphrase), then set the wallet password.

Supported languages​

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Italiano · Čeština · Português

The wordlists are bundled byte-for-byte from bitcoin/bips, pinned by SHA-256 and cross-checked against two independent libraries. Validation, including the checksum, runs in native code.

Only BIP39 phrases are accepted. Other seed formats (for example Electrum's own seed version system, SLIP-39 shares or raw private keys) are not.

Forgiving input, exact seed​

People type phrases in many ways. The editor accepts them and converts to the official spelling before anything is derived:

TypedUnderstood as
Any whitespace, commas, line breaks, the Japanese ideographic space  Word separators
Numbering such as 1. 2)Ignored
Chinese without spaces: 的一是在不了有和人这中大Split into its one-character words
Capitals, or Latin words without accents: abacoThe official word (ábaco)

The seed is always computed from the canonical words: Unicode NFKD, joined by single ASCII spaces, exactly as BIP39 specifies, so the result matches other standard wallets. The vault stores the canonical words in NFC.

Typed accents are treated as deliberate: if a user types an accent, it must be the right one.

Phrases valid in two languages​

A few unaccented phrases are valid in two wordlists once accents are restored (for example an Italian phrase that is also valid Spanish). The two readings are different wallets with different addresses, so BitTool Signer does not guess: it asks which language the backup is written in. Your own import code should do the same rather than picking the first match.

Importing from a QR code​

The import screen can scan:

QR contentSupported
The words as plain text, in any of the ten languages (including BitTool Signer's own recovery phrase QR code)Yes, with the exact spelling, so no language question
Standard SeedQR: 4 decimal digits per word index (48, 60, 72, 84 or 96 digits)Yes (English only, as SeedQR defines)
Compact SeedQR (binary entropy)No; the scanner says so

For example, the Standard SeedQR for the test phrase is the word indexes 0000 × 11 followed by 0003:

000000000000000000000000000000000000000000000003

Input safety​

The phrase editor disables autocorrection, autocapitalization, autofill and (on iOS 18+) Writing Tools, and the app refuses third-party keyboards. Apple's own Chinese, Japanese and Korean input methods still work; they may remember converted words in their dictionaries, which the user can reset in iOS Settings. A screenshot while the phrase is on screen shows a warning.

On Android, the phrase is typed on the app's own keyboard, which has no connection to any input method, so neither the system keyboard nor a third-party one sees it. The BIP39 passphrase and the wallet password use the system keyboard in password mode, with personalised learning turned off.

Checking an import​

After import, BitTool Signer shows the wallet's master fingerprint (8 hex digits, 73C5DA0A for the test phrase) and its addresses. If they differ from what the user expected, the most common causes are a different language reading, a missing or different BIP39 passphrase, or a wallet that uses other derivation paths. See Derivation paths.