This guide explains Bitcoin Core combinepsbt 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.17.0 combinepsbt implemented the BIP 174 Combiner role. It accepted an array of base64 PSBT strings representing versions of the same unsigned transaction and returned one base64 PSBT containing merged information.
- Why it matters: combinepsbt is a coordination merge, not a signing or payment decision. Safe multi-party use freezes one transaction identity, protects combined metadata and keeps finalisation and broadcast behind separate reviews.
- 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 combinepsbt RPC in simple English
Bitcoin Core combinepsbt RPC: The Combiner merges complementary key-value data from creators, updaters or signers. It does not choose a new transaction intent.
Simple example
A miner is checking Bitcoin Core combinepsbt RPC. Decode and compare version, locktime, ordered inputs, sequences and ordered outputs before combining. Decode it, run role-specific policy checks, finalize only when every required signature and script condition is satisfied, extract a transaction and perform a final human-readable output and fee review before separate broadcast.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- 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.
- UTXO:
- An unspent transaction output: a piece of bitcoin that can be used as an input to a later transaction.
- PSBT:
- A portable format for passing an unsigned or partly signed Bitcoin transaction between tools and signers.
Same unsigned transaction
Every input PSBT must describe the identical unsigned transaction. Decode and compare version, locktime, ordered inputs, sequences and ordered outputs before combining. Do not rely on filenames or workflow identifiers; compute and bind a canonical unsigned-transaction identity.
Base64 input array
The argument is an array of base64 PSBT strings. Enforce count and size limits, validate decoding and reject empty or untrusted bulk requests. Treat parse failure as a hard stop and never try to repair corrupted base64 automatically.
Information merge
The Combiner merges complementary key-value data from creators, updaters or signers. It does not choose a new transaction intent. Inspect UTXO records, scripts, derivation data, partial signatures and proprietary fields and reject inconsistent values rather than accepting whichever arrived first.
Privacy boundary
Combining information can reveal a fuller multisignature policy, public keys, derivation paths, change identification and participant metadata than any contributor held alone. Use an authorised coordinator, minimise retained PSBT copies and encrypt transport and storage.
No finality or broadcast
The returned PSBT remains a PSBT. Decode it, run role-specific policy checks, finalize only when every required signature and script condition is satisfied, extract a transaction and perform a final human-readable output and fee review before separate broadcast.
Idempotence and lineage
Store hashes of every input and combined output with participant and workflow identifiers. Recombining the same set should be deterministic at the information level. Reject packets from another round and freeze transaction intent before collecting signatures.
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 combinepsbt RPC?
Bitcoin Core combinepsbt RPC: The Combiner merges complementary key-value data from creators, updaters or signers.
For Bitcoin Core combinepsbt RPC, what should a beginner know about same unsigned transaction?
Every input PSBT must describe the identical unsigned transaction. Decode and compare version, locktime, ordered inputs, sequences and ordered outputs before combining.
For Bitcoin Core combinepsbt RPC, what should a beginner know about base64 input array?
The argument is an array of base64 PSBT strings. Enforce count and size limits, validate decoding and reject empty or untrusted bulk requests.
For Bitcoin Core combinepsbt RPC, what should a beginner know about information merge?
The Combiner merges complementary key-value data from creators, updaters or signers.
Conclusion
combinepsbt is a coordination merge, not a signing or payment decision. Safe multi-party use freezes one transaction identity, protects combined metadata and keeps finalisation and broadcast behind separate reviews.
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.