verifytxoutproof

verifytxoutproof is the checking half of Bitcoin's Merkle-proof pair: you give it the hex proof that gettxoutproof produced, and it validates that proof against the node's view of the best chain. If the proof holds, it returns the array of txids the proof commits to, confirming those BTC transactions really were mined into a block on the main chain; if it does not, you get an empty array. This lets a light client or counterparty confirm a payment was included without trusting whoever supplied the proof. Send the hex proof string to https://bitcoin.therpc.io/YOUR_API_KEY.

Use cases

• Validate a Merkle proof a counterparty supplied before acting on a claimed payment.
• Confirm a transaction is committed in the best chain without trusting the sender's word.
• Drive SPV-style verification inside a light client that does not store full blocks.

Parameters

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "verifytxoutproof",
8  "params": [
9    "0000..."
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• An empty array means the proof did not verify against the node's best chain — treat that as a verification failure, not as "no transactions," and never accept the payment on an empty result.

Supported networks

• Mainnet
• Testnet

See also

• gettxoutproof
• getrawtransaction