Skip to article
Degrees of SatoshiFollow the connections.
SearchTrace an address
Degrees of Satoshi/ Encyclopedia

Encyclopedia How the network works · Entry 90

Wallet passphrases: seed extensions versus wallet-file encryption

AI-assisted research · separate automated verificationCorrections

Theme
How the network works
Sources
3 cited records
Reading time
About 3 minutes
Automated verification
Substantive update
In this article

At a glance

Key facts

Key facts for Wallet passphrases: seed extensions versus wallet-file encryption
FactDetailSource
BIP-39Every passphrase produces a seed; there is no built-in correct-passphrase signal.[1]
Empty stringA BIP-39 wallet without an added passphrase uses an empty passphrase.[1]
File encryptionBitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily.[2]
01

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.

02

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.

03

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.

Direct answers

Questions people ask

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.

Inspect the evidence

The answer and key facts have stable claim links. These records retain the scope and qualification when reused.

“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: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.

Link to this claim
BIP-39: Every passphrase produces a seed; there is no built-in correct-passphrase signal.

Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.

Link to this claim
Empty string: A BIP-39 wallet without an added passphrase uses an empty passphrase.

Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.

Link to this claim
File encryption: Bitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily.

Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.

Link to this claim
Revision history
  1. — Initial Bitcoin encyclopedia entry at this permanent URL.
  2. — Added reusable claims, explicit source locators, and matching Markdown and JSON. This publishing change does not itself establish factual verification.

Source register

Sources and references

Retrieval dates and locators are recorded individually.
  1. Mnemonic code for generating deterministic keysBitcoin BIPs contributors

    The optional passphrase participates in deriving a different seed.

    Locator: From mnemonic to seed · Version / scope: BIP-39; immutable revision pinned in source URL · Retrieved: 2026-10-02T17:22:20.588ZOpen source
  2. walletpassphrase RPCBitcoin Core

    Unlocking an encrypted wallet temporarily; distinct from a BIP-39 passphrase.

    Locator: Arguments and result fields · Version / scope: Bitcoin Core 29.0.0 RPC · Retrieved: 2026-10-02T17:03:41.013ZOpen source
  3. Output Script Descriptors General OperationBitcoin BIPs contributors

    Descriptors describe output scripts, keys and derivation information.

    Locator: Specification; Key expressions; Checksum · Version / scope: BIP-380; immutable revision pinned in source URL · Retrieved: 2026-10-02T17:22:20.620ZOpen source
How this article was made

Research and drafting use AI assistance. A separate automated review checks claims against primary sources; no external expert or named human review is implied. Publication, substantive editing, source retrieval and verification are recorded separately. This version was independently checked by an automated reviewer on 2 October 2026.

Editorial method and corrections

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/