This guide explains Bitcoin Core newkeypool RPC in plain English. It shows what the command does, what its result means and what it cannot prove.
TL;DR
- What it is: Bitcoin Core 23.0 introduced newkeypool to entirely clear and refill a wallet’s keypool. It takes no arguments and returns null, but it is not a harmless cache refresh.
- Why it matters: newkeypool is a deliberate wallet-state rotation. Its safe use depends on wallet type, immediate backup discipline, address-issuer coordination and a restoration test that proves later funds remain discoverable.
- Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.
Bitcoin Core newkeypool RPC in simple English
Bitcoin Core newkeypool RPC: Keys can be re-derived from the seed, but an older restored backup may not automatically discover addresses created after rotation.
Simple example
A miner is checking Bitcoin Core newkeypool RPC. Make, verify and secure a fresh backup immediately after the command and before issuing another address. Re-run newkeypool and rescan the relevant chain range.
Key terms in plain English
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- RPC:
- A command that software sends to a node to request information or a local action.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Mutation boundary
The command discards unused pre-generated keys and refills the pool. Confirm the selected wallet and maintenance reason; do not invoke it as a routine health check.
Encryption
An encrypted wallet must first be unlocked with walletpassphrase. Keep the unlock window short, restrict RPC access and avoid exposing passphrases in shell history or process lists.
Non-HD wallets
New random keys are not derivable from an old backup. Make, verify and secure a fresh backup immediately after the command and before issuing another address.
HD wallets
Keys can be re-derived from the seed, but an older restored backup may not automatically discover addresses created after rotation. Re-run newkeypool and rescan the relevant chain range.
Address continuity
Previously issued addresses remain valid, while abandoned unused pool entries should no longer be issued. Reconcile address-generation services and prevent duplicate or stale allocation records.
Result semantics
A null result indicates command completion, not backup success, scan completion, balance reconciliation or availability of every future key.
How specialists test it
Operators test the command on a non-production node first. They check a normal reply, an invalid request, a timeout and a restart. This shows what the response means and prevents one local result from being mistaken for a network-wide outcome.
Frequently asked questions
What is the main point of Bitcoin Core newkeypool RPC?
Bitcoin Core newkeypool RPC: Keys can be re-derived from the seed, but an older restored backup may not automatically discover addresses created after rotation.
For Bitcoin Core newkeypool RPC, what should a beginner know about mutation boundary?
The command discards unused pre-generated keys and refills the pool. Confirm the selected wallet and maintenance reason.
For Bitcoin Core newkeypool RPC, what should a beginner know about encryption?
An encrypted wallet must first be unlocked with walletpassphrase. Keep the unlock window short, restrict RPC access and avoid exposing passphrases in shell history or process lists.
For Bitcoin Core newkeypool RPC, what should a beginner know about non-hd wallets?
New random keys are not derivable from an old backup. Make, verify and secure a fresh backup immediately after the command and before issuing another address.
Conclusion
newkeypool is a deliberate wallet-state rotation. Its safe use depends on wallet type, immediate backup discipline, address-issuer coordination and a restoration test that proves later funds remain discoverable.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.