Summary
Chapter 3 of the course material rely on legacy wallet behavior that is no longer supported in recent versions of Bitcoin Core. Commands like dumpwallet fail with unhelpful errors, and legacy wallet creation is entirely blocked, making it impossible for learners on current default setups to follow along.
Reproduction
Issue 1 — dumpwallet in the chapter no longer exists
Running the tutorial command:
bitcoin-cli dumpwallet ~/mywallet.txt
Returns:
error code: -32601
error message:
Method not found
Issue 2 — Legacy wallet creation is blocked
bitcoin-cli -named createwallet wallet_name="my_wallet" descriptors=false
Returns:
error code: -4
error message:
descriptors argument must be set to "true"; it is no longer possible to create a legacy wallet.
Root cause
- Bitcoin Core now uses descriptor wallets by default since v23
- Legacy (non-descriptor) wallet creation was fully removed in v30+
- RPC methods like
dumpwallet are tied to the legacy key-store model and do not exist in descriptor wallets
Suggested fixes
1. Migrate to descriptor-based workflow
Replace dumpwallet with the modern equivalent:
bitcoin-cli listdescriptors
Add a brief explanation of descriptor structure (pkh, wpkh, tr) and derivation paths.
2. Add context
A short note on the legacy → descriptor wallet transition would help learners understand why the change happened, not just what changed.
Closing note
Updating the course to descriptor-based workflows would make the material more accurate for anyone running a current Bitcoin Core installation.
Summary
Chapter 3 of the course material rely on legacy wallet behavior that is no longer supported in recent versions of Bitcoin Core. Commands like
dumpwalletfail with unhelpful errors, and legacy wallet creation is entirely blocked, making it impossible for learners on current default setups to follow along.Reproduction
Issue 1 —
dumpwalletin the chapter no longer existsRunning the tutorial command:
bitcoin-cli dumpwallet ~/mywallet.txtReturns:
Issue 2 — Legacy wallet creation is blocked
bitcoin-cli -named createwallet wallet_name="my_wallet" descriptors=falseReturns:
Root cause
dumpwalletare tied to the legacy key-store model and do not exist in descriptor walletsSuggested fixes
1. Migrate to descriptor-based workflow
Replace
dumpwalletwith the modern equivalent:Add a brief explanation of descriptor structure (
pkh,wpkh,tr) and derivation paths.2. Add context
A short note on the legacy → descriptor wallet transition would help learners understand why the change happened, not just what changed.
Closing note
Updating the course to descriptor-based workflows would make the material more accurate for anyone running a current Bitcoin Core installation.