{
  "$schema": "https://degreesofsatoshi.com/encyclopedia/schemas/article-v1.json",
  "schemaVersion": "1.0.0",
  "id": "bitcoin-wallet-passphrases",
  "canonical": "https://degreesofsatoshi.com/encyclopedia/bitcoin-wallet-passphrases/",
  "collection": "bitcoin",
  "title": "Wallet passphrases: seed extensions versus wallet-file encryption",
  "description": "Distinguish a BIP-39 seed passphrase from a wallet-file password and understand why a different passphrase can open a different wallet without an error.",
  "aliases": [],
  "dates": {
    "published": "2026-10-02",
    "modified": "2026-10-02",
    "verified": "2026-10-02T18:15:23.891Z",
    "dataAsOf": "2026-10-02"
  },
  "authorship": {
    "publisher": "Degrees of Satoshi editorial project",
    "process": "AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied."
  },
  "quickAnswer": {
    "text": "“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.",
    "claimId": "bitcoin-wallet-passphrases-quick-answer",
    "sourceIds": [
      "bip39",
      "core-walletpassphrase"
    ]
  },
  "keyFacts": [
    {
      "label": "BIP-39",
      "value": "Every passphrase produces a seed; there is no built-in correct-passphrase signal.",
      "sourceIds": [
        "bip39"
      ],
      "id": "bip-39",
      "claimId": "bitcoin-wallet-passphrases-fact-bip-39"
    },
    {
      "label": "Empty string",
      "value": "A BIP-39 wallet without an added passphrase uses an empty passphrase.",
      "sourceIds": [
        "bip39"
      ],
      "id": "empty-string",
      "claimId": "bitcoin-wallet-passphrases-fact-empty-string"
    },
    {
      "label": "File encryption",
      "value": "Bitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily.",
      "sourceIds": [
        "core-walletpassphrase"
      ],
      "id": "file-encryption",
      "claimId": "bitcoin-wallet-passphrases-fact-file-encryption"
    }
  ],
  "prerequisites": [
    "private-keys-and-seed-phrases"
  ],
  "sections": [
    {
      "id": "two-meanings",
      "heading": "Identify which secret the wallet is asking for",
      "sourceIds": [
        "bip39",
        "core-walletpassphrase"
      ],
      "paragraphs": [
        "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."
      ]
    },
    {
      "id": "different-seed",
      "heading": "Why an empty wallet may appear after a typo",
      "sourceIds": [
        "bip39"
      ],
      "paragraphs": [
        "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."
      ]
    },
    {
      "id": "backup",
      "heading": "Back up the recovery information that actually matters",
      "sourceIds": [
        "bip39",
        "bip380"
      ],
      "paragraphs": [
        "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."
      ]
    }
  ],
  "faq": [
    {
      "question": "Is the optional passphrase just an extra mnemonic word?",
      "answer": "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.",
      "sourceIds": [
        "bip39"
      ]
    }
  ],
  "claims": [
    {
      "id": "bitcoin-wallet-passphrases-quick-answer",
      "articleSlug": "bitcoin-wallet-passphrases",
      "statement": "“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.",
      "sourceIds": [
        "source-a7583e32275982ab",
        "source-7780ee9334c1bcbd"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-a7583e32275982ab",
          "locator": "From mnemonic to seed"
        },
        {
          "sourceId": "source-7780ee9334c1bcbd",
          "locator": "Arguments and result fields"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:15:23.891Z",
        "reviewer": "Independent automated verification agent verify_bitcoin_stablecoins_100",
        "notes": [
          "Corrected the claim that every different raw passphrase string necessarily produces a different wallet: BIP-39 first applies Unicode NFKD. Independently demonstrated equal derivation from equivalent normalized public test strings.",
          "Read BIP-39 seed derivation and Core walletpassphrase memory unlock/timeout behavior. File encryption and mnemonic passphrases remain distinct; no assumption that Core universally uses BIP-39."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-passphrases-fact-bip-39",
      "articleSlug": "bitcoin-wallet-passphrases",
      "statement": "BIP-39: Every passphrase produces a seed; there is no built-in correct-passphrase signal.",
      "sourceIds": [
        "source-a7583e32275982ab"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-a7583e32275982ab",
          "locator": "From mnemonic to seed"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:15:23.891Z",
        "reviewer": "Independent automated verification agent verify_bitcoin_stablecoins_100",
        "notes": [
          "Corrected the claim that every different raw passphrase string necessarily produces a different wallet: BIP-39 first applies Unicode NFKD. Independently demonstrated equal derivation from equivalent normalized public test strings.",
          "Read BIP-39 seed derivation and Core walletpassphrase memory unlock/timeout behavior. File encryption and mnemonic passphrases remain distinct; no assumption that Core universally uses BIP-39."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-passphrases-fact-empty-string",
      "articleSlug": "bitcoin-wallet-passphrases",
      "statement": "Empty string: A BIP-39 wallet without an added passphrase uses an empty passphrase.",
      "sourceIds": [
        "source-a7583e32275982ab"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-a7583e32275982ab",
          "locator": "From mnemonic to seed"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:15:23.891Z",
        "reviewer": "Independent automated verification agent verify_bitcoin_stablecoins_100",
        "notes": [
          "Corrected the claim that every different raw passphrase string necessarily produces a different wallet: BIP-39 first applies Unicode NFKD. Independently demonstrated equal derivation from equivalent normalized public test strings.",
          "Read BIP-39 seed derivation and Core walletpassphrase memory unlock/timeout behavior. File encryption and mnemonic passphrases remain distinct; no assumption that Core universally uses BIP-39."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-passphrases-fact-file-encryption",
      "articleSlug": "bitcoin-wallet-passphrases",
      "statement": "File encryption: Bitcoin Core’s walletpassphrase unlocks an encrypted wallet temporarily.",
      "sourceIds": [
        "source-7780ee9334c1bcbd"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-7780ee9334c1bcbd",
          "locator": "Arguments and result fields"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:15:23.891Z",
        "reviewer": "Independent automated verification agent verify_bitcoin_stablecoins_100",
        "notes": [
          "Corrected the claim that every different raw passphrase string necessarily produces a different wallet: BIP-39 first applies Unicode NFKD. Independently demonstrated equal derivation from equivalent normalized public test strings.",
          "Read BIP-39 seed derivation and Core walletpassphrase memory unlock/timeout behavior. File encryption and mnemonic passphrases remain distinct; no assumption that Core universally uses BIP-39."
        ]
      }
    }
  ],
  "sources": [
    {
      "id": "bip39",
      "label": "Mnemonic code for generating deterministic keys",
      "publisher": "Bitcoin BIPs contributors",
      "url": "https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki",
      "locator": "From mnemonic to seed",
      "note": "The optional passphrase participates in deriving a different seed.",
      "version": "BIP-39; immutable revision pinned in source URL",
      "checkedAt": "2026-10-02T17:22:20.588Z",
      "contentSha256": "afcbcbed36fe9eb734bd607398a8c124683ded2a75c3830e1b16c47b043a9134",
      "recordId": "source-a7583e32275982ab"
    },
    {
      "id": "core-walletpassphrase",
      "label": "walletpassphrase RPC",
      "publisher": "Bitcoin Core",
      "url": "https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/walletpassphrase/",
      "locator": "Arguments and result fields",
      "note": "Unlocking an encrypted wallet temporarily; distinct from a BIP-39 passphrase.",
      "version": "Bitcoin Core 29.0.0 RPC",
      "checkedAt": "2026-10-02T17:03:41.013Z",
      "contentSha256": "cd9e589b0773ebfd7d0bc2734aba0a8ab22d8530cb0c81a9a45c419e4361c31d",
      "recordId": "source-7780ee9334c1bcbd"
    },
    {
      "id": "bip380",
      "label": "Output Script Descriptors General Operation",
      "publisher": "Bitcoin BIPs contributors",
      "url": "https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki",
      "locator": "Specification; Key expressions; Checksum",
      "note": "Descriptors describe output scripts, keys and derivation information.",
      "version": "BIP-380; immutable revision pinned in source URL",
      "checkedAt": "2026-10-02T17:22:20.620Z",
      "contentSha256": "34e6510bb2eba9445a68eacf3d24d5a4e5f24481477488d5552f674ac81dd5fe",
      "recordId": "source-36e62aca6baaa2f2"
    }
  ],
  "related": {
    "articles": [
      "bitcoin-output-descriptors",
      "bitcoin-extended-public-keys",
      "watch-only-wallets"
    ],
    "dossiers": [],
    "wallets": []
  },
  "revisionHistory": [
    {
      "date": "2026-10-02",
      "kind": "published",
      "summary": "Initial Bitcoin encyclopedia entry at this permanent URL."
    },
    {
      "date": "2026-10-02",
      "kind": "publishing-format",
      "summary": "Added reusable claims, explicit source locators, and matching Markdown and JSON. This publishing change does not itself establish factual verification."
    }
  ],
  "citation": "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/"
}