combine_btc_psbts
DestructiveIdempotent
Merge multiple multi-sig PSBTs from cosigners into a single signed transaction. Validates all PSBTs share the same unsigned transaction body before combining signatures.
Instructions
Merge 2-15 partial PSBTs from multi-sig cosigners into one whose inputs carry every cosigner's signature. Each entry must be a base64-encoded PSBT v0 sharing the same unsigned tx body (same inputs/outputs/sequences/locktime); only per-cosigner witness data may differ. Refuses with a clear error when bodies disagree — combining across distinct unsigned txs would silently merge signatures across different transactions. Returns the merged PSBT plus a per-input signature count so the caller can tell whether the threshold has been reached. No device touch.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| psbts | Yes | Array of 2-15 base64-encoded PSBT v0 strings to merge. Every entry must share the same unsigned tx body (same inputs in the same order, same outputs in the same order, same sequence numbers, same locktime); only the per-cosigner witness data may differ. Refused if any pair has a mismatched body — combining PSBTs across distinct unsigned txs would silently merge signatures across different transactions. |