# Wallet passphrases: seed extensions versus wallet-file encryption “Wallet passphrase” can mean different things. In BIP-39, an optional passphrase combines with the mnemonic to derive a seed after Unicode normalization; changing the normalized passphrase derives a different wallet. A wallet-file password instead decrypts a stored wallet. The two mechanisms have different recovery requirements and must not be treated as interchangeable. Evidence: [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki); [walletpassphrase RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/walletpassphrase/) Canonical: https://degreesofsatoshi.com/encyclopedia/bitcoin-wallet-passphrases/ Published: 2026-10-02 Substantively modified: 2026-10-02 Independently verified by an automated reviewer: 2026-10-02T18:15:23.891Z Data current through: 2026-10-02 AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied. ## Key facts - **BIP-39:** Every passphrase produces a seed; there is no built-in correct-passphrase signal. ([Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki)) - **Empty string:** A BIP-39 wallet without an added passphrase uses an empty passphrase. ([Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki)) - **File encryption:** Bitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily. ([walletpassphrase RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/walletpassphrase/)) ## Identify which secret the wallet is asking for A mnemonic passphrase participates in key derivation. A local application password may protect an encrypted file or unlock an interface. A PIN on a hardware device can be yet another control. Only the first of these is defined by BIP-39. Read the wallet’s documented recovery process before relying on a backup. Bitcoin Core’s cited RPC is an example of file unlocking; it should not be used to infer that Bitcoin Core wallets universally use BIP-39 mnemonics. Evidence: [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki); [walletpassphrase RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/walletpassphrase/) ## Why an empty wallet may appear after a typo BIP-39 normalizes the mnemonic and passphrase using Unicode NFKD before deriving the seed. With the same mnemonic, a different normalized passphrase derives a different seed. Both results can be internally valid. A mistyped passphrase can therefore show no expected transactions rather than display an explicit wrong-password error. Restoration also needs the wallet’s derivation and script conventions. Seeing no balance does not immediately identify which element is wrong. Evidence: [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki) ## Back up the recovery information that actually matters If an account uses a BIP-39 passphrase, preserving only the mnemonic is insufficient to reproduce that account. Descriptor and derivation information can also matter when identifying outputs. A recovery test should establish that the intended addresses can be reproduced in a trusted environment. Do not enter a real recovery secret into an educational page or a website that claims to check it. Evidence: [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki); [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki) ## Questions ### Is the optional passphrase just an extra mnemonic word? No. BIP-39 accepts a passphrase string in its seed derivation. Calling it an extra word can hide the fact that spacing and characters matter after the specified Unicode normalization. Evidence: [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki) ## Claims and scope ### bitcoin-wallet-passphrases-quick-answer “Wallet passphrase” can mean different things. In BIP-39, an optional passphrase combines with the mnemonic to derive a seed after Unicode normalization; changing the normalized passphrase derives a different wallet. A wallet-file password instead decrypts a stored wallet. The two mechanisms have different recovery requirements and must not be treated as interchangeable. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-wallet-passphrases-fact-bip-39 BIP-39: Every passphrase produces a seed; there is no built-in correct-passphrase signal. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-wallet-passphrases-fact-empty-string Empty string: A BIP-39 wallet without an added passphrase uses an empty passphrase. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-wallet-passphrases-fact-file-encryption File encryption: Bitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ## Sources - [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki) — Bitcoin BIPs contributors. The optional passphrase participates in deriving a different seed. Locator: From mnemonic to seed. Retrieved: 2026-10-02T17:22:20.588Z. - [walletpassphrase RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/walletpassphrase/) — Bitcoin Core. Unlocking an encrypted wallet temporarily; distinct from a BIP-39 passphrase. Locator: Arguments and result fields. Retrieved: 2026-10-02T17:03:41.013Z. - [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki) — Bitcoin BIPs contributors. Descriptors describe output scripts, keys and derivation information. Locator: Specification; Key expressions; Checksum. Retrieved: 2026-10-02T17:22:20.620Z. ## Revision history - 2026-10-02: Initial Bitcoin encyclopedia entry at this permanent URL. - 2026-10-02: Added reusable claims, explicit source locators, and matching Markdown and JSON. This publishing change does not itself establish factual verification. ## Cite this entry Degrees of Satoshi editorial project. “Wallet passphrases: seed extensions versus wallet-file encryption.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-wallet-passphrases/