Bitcoin Core importprunedfunds RPC: Proof-Based Recovery Guide

This guide explains Bitcoin Core importprunedfunds RPC in plain English. It shows what the command does, what its result means and what it cannot prove.

Prerequisite wallet script

Import the destination address, public key or script first and verify the wallet recognises it with correct watch-only or spendable status. The funding transaction cannot establish wallet ownership on its own.

Raw transaction validation

Decode the supplied transaction independently, recompute txid and witness identity, and verify the exact output script and satoshi value. Reject excess size, malformed serialisation and unexpected inputs or outputs before wallet mutation.

Merkle proof validation

The txoutproof must include the transaction in a block. Verify proof bytes, reconstructed root, header proof of work, active-chain ancestry and suitable depth. Inclusion in a side-chain header is not settled active-chain receipt.

Pruned-node rationale

The method avoids requiring old block data locally, but another trusted process must supply and verify the evidence. Record block hash, height, chainwork and source. Do not accept arbitrary proofs from a customer-facing endpoint.

Later-spend responsibility

The documentation explicitly assigns responsibility for importing subsequent spends or rescanning from the inclusion point. Without them, the wallet may show outputs already spent. Build a chronological chain of funding and spending transactions.

Reconciliation and backup

After every import, compare wallet outpoints with an independently validating node at the same tip. Freeze spending until later spends are accounted for, then create and restore-test a new wallet backup containing the imported history.

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.

Conclusion

importprunedfunds can reconstruct selected wallet history without old blocks, but it transfers completeness responsibility to the operator. Every funding proof must be followed through subsequent spends and active-chain reconciliation.