This guide explains Bitcoin Core removeprunedfunds 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 0.16.0 removeprunedfunds deleted a specified transaction from wallet history. It was designed for pruned wallets as the companion to importprunedfunds, and the official help warned that removal affected wallet balances.
- Why it matters: removeprunedfunds is a destructive wallet-history correction, not blockchain deletion. Safe use requires complete transaction lineage, exact balance reconciliation and retained evidence for controlled re-import.
- Current position: Bitcoin Core 0.16.0 removeprunedfunds deleted a specified transaction from wallet history.
Bitcoin Core removeprunedfunds RPC in simple English
Bitcoin Core removeprunedfunds RPC: Removing a funding transaction without accounting for later spends can leave confusing wallet history. Removing a spend can resurrect apparent funds.
Simple example
A miner is checking Bitcoin Core removeprunedfunds RPC. Validate the 32-byte txid and retrieve the wallet record, raw transaction, outputs, related spends and import proof.
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.
- Consensus:
- The shared rules full nodes use to decide whether blocks and transactions are valid.
- UTXO:
- An unspent transaction output: a piece of bitcoin that can be used as an input to a later transaction.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Exact transaction identity
Validate the 32-byte txid and retrieve the wallet record, raw transaction, outputs, related spends and import proof. A typing error or wrong-wallet success can remove evidence unrelated to the intended recovery correction.
Local deletion only
The RPC changes this wallet database, not blockchain consensus or other nodes. The transaction remains in its block and can be reintroduced by rescan or proof-based import where data is available.
Balance impact
Record confirmed, unconfirmed, immature and affected UTXO state before mutation in satoshis. Predict the expected delta from decoded outpoints. Stop if the observed post-call balance change differs.
Spend-chain context
Removing a funding transaction without accounting for later spends can leave confusing wallet history; removing a spend can resurrect apparent funds. Trace the complete chain of imported funding and spending transactions before approval.
Backup and evidence
Create and verify a pre-change encrypted backup and retain raw transaction, Merkle proof, block hash, chainwork and reason. After reconciliation, make a new backup and restore-test the corrected history.
Reversibility limits
Re-import may restore evidence when raw data and proof are retained, but it is not an automatic inverse and later wallet state may differ. Never promise one-click rollback or overwrite a newer wallet database.
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 removeprunedfunds RPC?
Bitcoin Core removeprunedfunds RPC: Removing a funding transaction without accounting for later spends can leave confusing wallet history.
For Bitcoin Core removeprunedfunds RPC, what should a beginner know about exact transaction identity?
Validate the 32-byte txid and retrieve the wallet record, raw transaction, outputs, related spends and import proof.
For Bitcoin Core removeprunedfunds RPC, what should a beginner know about local deletion only?
The RPC changes this wallet database, not blockchain consensus or other nodes.
For Bitcoin Core removeprunedfunds RPC, what should a beginner know about balance impact?
Record confirmed, unconfirmed, immature and affected UTXO state before mutation in satoshis.
Conclusion
removeprunedfunds is a destructive wallet-history correction, not blockchain deletion. Safe use requires complete transaction lineage, exact balance reconciliation and retained evidence for controlled re-import.
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.