newkeypool

wallet wallet since 0.17.0

entirely clears and refills the keypool.

Share: X Bluesky Mastodon Reddit HN
↑ shares the docs page. Use Share this query below for a link with your current arg values.
Wallet RPC, not available on our node. Wallet operation. Our node runs without a wallet, so this RPC is structurally unreachable here. Docs are kept for reference.
Call from your own code

Replace $BITCOIN_RPC_USER / $BITCOIN_RPC_PASSWORD with credentials from your bitcoind's bitcoin.conf, and replace localhost:8332 with your node's RPC address. You can't run this RPC against our node (we run wallet=0), but you can run it against your own bitcoind.

Help

newkeypool

Entirely clears and refills the keypool.
WARNING: On non-HD wallets, this will require a new backup immediately, to include the new keys.
When restoring a backup of an HD wallet created before the newkeypool command is run, funds received to
new addresses may not appear automatically. They have not been lost, but the wallet may not find them.
This can be fixed by running the newkeypool command on the backup and then rescanning, so the wallet
re-generates the required keys.
Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Result:
null    (json null)

Examples:
> bitcoin-cli newkeypool 
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "newkeypool", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
← back to all RPCs