decodepsbt

decodepsbt "psbt" Return a JSON object representing Arguments: 1. psbt (string, required) The Result: { "tx" : { ... }, "global_xpubs" : [ { "xpub" : "str", "master_fingerprint" "path" : "str" }, ... ], "psbt_version" : n, "proprietary" : [ { "identifier" : "hex", "subtype" : n, "key" : "hex", "value" : "hex" }, ... ], "unknown" : { "key" : "hex", ... }, "inputs" : [ { "non_witness_utxo" : { ... }, "witness_utxo" : { "amount" : n, "scriptPubKey" : { "asm" : "str", "desc" : "str", "hex" : "hex", "type" : "str", "address" : "str" } }, "partial_signatures" : { "pubkey" : "str", ... }, "sighash" : "str", "redeem_script" : { "asm" : "str", "hex" : "hex", "type" : "str" }, "witness_script" : { "asm" : "str", "hex" : "hex", "type" : "str" }, "bip32_derivs" : [ { "pubkey" : "str", "master_fingerprint" "path" : "str" }, ... ], "final_scriptSig" : { "asm" : "str", "hex" : "hex" }, "final_scriptwitness" : [ "hex", ... ], "ripemd160_preimages" : { "hash" : "str", ... }, "sha256_preimages" : { "hash" : "str", ... }, "hash160_preimages" : { "hash" : "str", ... }, "hash256_preimages" : { "hash" : "str", ... }, "taproot_key_path_sig" "taproot_script_path_sigs" : [ { "pubkey" : "str", "leaf_hash" : "str", "sig" : "str" }, ... ], "taproot_scripts" : [ { "script" : "hex", "leaf_ver" : n, "control_blocks" : [ "hex", ... ] }, ... ], "taproot_bip32_derivs" : [ { "pubkey" : "str", "master_fingerprint" "path" : "str", "leaf_hashes" : [ "hex", ... ] }, ... ], "taproot_internal_key" "taproot_merkle_root" "musig2_participant_pubkeys" : [ { "aggregate_pubkey" "participant_pubkeys" : [ "hex", ... ] }, ... ], "musig2_pubnonces" : [ { "participant_pubkey" "aggregate_pubkey" "leaf_hash" : "hex", "pubnonce" : "hex" }, ... ], "musig2_partial_sigs" : [ { "participant_pubkey" "aggregate_pubkey" "leaf_hash" : "hex", "partial_sig" : "hex" }, ... ], "unknown" : { "key" : "hex", ... }, "proprietary" : [ { "identifier" : "hex", "subtype" : n, "key" : "hex", "value" : "hex" }, ... ] }, ... ], "outputs" : [ { "redeem_script" : { "asm" : "str", "hex" : "hex", "type" : "str" }, "witness_script" : { "asm" : "str", "hex" : "hex", "type" : "str" }, "bip32_derivs" : [ { "pubkey" : "str", "master_fingerprint" "path" : "str" }, ... ], "taproot_internal_key" "taproot_tree" : [ { "depth" : n, "leaf_ver" : n, "script" : "str" }, ... ], "taproot_bip32_derivs" : [ { "pubkey" : "str", "master_fingerprint" "path" : "str", "leaf_hashes" : [ "hex", ... ] }, ... ], "musig2_participant_pubkeys" : [ { "aggregate_pubkey" "participant_pubkeys" : [ "hex", ... ] }, ... ], "unknown" : { "key" : "hex", ... }, "proprietary" : [ { "identifier" : "hex", "subtype" : n, "key" : "hex", "value" : "hex" }, ... ] }, ... ], "fee" : n } Examples: > bitcoin-cli decodepsbt "psbt&quo the serialized, base64-encoded partially signed Bitcoin transaction. PSBT base64 string (json object) (json object) The decoded network-serialized unsigned transaction. The layout is the same as the output of decoderawtransaction. (json array) (json object) (string) The extended public key this path corresponds to : "hex", (string) The fingerprint of the master key (string) The path (numeric) The PSBT version number. Not to be confused with the unsigned transaction version (json array) The global proprietary map (json object) (string) The hex string for the proprietary identifier (numeric) The number for the subtype (string) The hex for the key (string) The hex for the value (json object) The unknown global fields (string) (key-value pair) An unknown key-value pair (json array) (json object) (json object, optional) Decoded network transaction for non-witness UTXOs (json object, optional) Transaction output for witness UTXOs (numeric) The value in BTC (json object) (string) Disassembly of the output script (string) Inferred descriptor for the output (string) The raw output script bytes, hex-encoded (string) The type, eg 'pubkeyhash' (string, optional) The Bitcoin address (only if a well-defined address exists) (json object, optional) (string) The public key and signature that corresponds to it. (string, optional) The sighash type to be used (json object, optional) (string) Disassembly of the redeem script (string) The raw redeem script bytes, hex-encoded (string) The type, eg 'pubkeyhash' (json object, optional) (string) Disassembly of the witness script (string) The raw witness script bytes, hex-encoded (string) The type, eg 'pubkeyhash' (json array, optional) (json object) (string) The public key with the derivation path as the value. : "str", (string) The fingerprint of the master key (string) The path (json object, optional) (string) Disassembly of the final signature script (string) The raw final signature script bytes, hex-encoded (json array, optional) (string) hex-encoded witness data (if any) (json object, optional) (string) The hash and preimage that corresponds to it. (json object, optional) (string) The hash and preimage that corresponds to it. (json object, optional) (string) The hash and preimage that corresponds to it. (json object, optional) (string) The hash and preimage that corresponds to it. : "hex", (string, optional) hex-encoded signature for the Taproot key path spend (json array, optional) (json object, optional) The signature for the pubkey and leaf hash combination (string) The x-only pubkey for this signature (string) The leaf hash for this signature (string) The signature itself (json array, optional) (json object) (string) A leaf script (numeric) The version number for the leaf script (json array) The control blocks for this script (string) A hex-encoded control block for this script (json array, optional) (json object) (string) The x-only public key this path corresponds to : "str", (string) The fingerprint of the master key (string) The path (json array) The hashes of the leaves this pubkey appears in (string) The hash of a leaf this pubkey appears in : "hex", (string, optional) The hex-encoded Taproot x-only internal key : "hex", (string, optional) The hex-encoded Taproot merkle root (json array, optional) (json object) : "hex", (string) The compressed aggregate public key for which the participants create. (json array) (string) The compressed public keys that are aggregated for aggregate_pubkey. (json array, optional) (json object) : "hex", (string) The compressed public key of the participant that created this pubnonce. : "hex", (string) The compressed aggregate public key for which this pubnonce is for. (string, optional) The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key. (string) The public nonce itself. (json array, optional) (json object) : "hex", (string) The compressed public key of the participant that created this partial signature. : "hex", (string) The compressed aggregate public key for which this partial signature is for. (string, optional) The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key. (string) The partial signature itself. (json object, optional) The unknown input fields (string) (key-value pair) An unknown key-value pair (json array, optional) The input proprietary map (json object) (string) The hex string for the proprietary identifier (numeric) The number for the subtype (string) The hex for the key (string) The hex for the value (json array) (json object) (json object, optional) (string) Disassembly of the redeem script (string) The raw redeem script bytes, hex-encoded (string) The type, eg 'pubkeyhash' (json object, optional) (string) Disassembly of the witness script (string) The raw witness script bytes, hex-encoded (string) The type, eg 'pubkeyhash' (json array, optional) (json object) (string) The public key this path corresponds to : "str", (string) The fingerprint of the master key (string) The path : "hex", (string, optional) The hex-encoded Taproot x-only internal key (json array, optional) The tuples that make up the Taproot tree, in depth first search order (json object, optional) A single leaf script in the taproot tree (numeric) The depth of this element in the tree (numeric) The version of this leaf (string) The hex-encoded script itself (json array, optional) (json object) (string) The x-only public key this path corresponds to : "str", (string) The fingerprint of the master key (string) The path (json array) The hashes of the leaves this pubkey appears in (string) The hash of a leaf this pubkey appears in (json array, optional) (json object) : "hex", (string) The compressed aggregate public key for which the participants create. (json array) (string) The compressed public keys that are aggregated for aggregate_pubkey. (json object, optional) The unknown output fields (string) (key-value pair) An unknown key-value pair (json array, optional) The output proprietary map (json object) (string) The hex string for the proprietary identifier (numeric) The number for the subtype (string) The hex for the key (string) The hex for the value (numeric, optional) The transaction fee paid if all UTXOs slots in the PSBT have been filled. t;

Signature

decodepsbt(psbt: string) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"decodepsbt","params":["\"<psbt>\""]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli decodepsbt "psbt"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "decodepsbt",
        "params": ["\"<psbt>\""],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "decodepsbt",
    params: ["\"<psbt>\""],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
psbt	`string`	yes	The PSBT base64 string

Result

Type: any

{ (json object) "tx" : { (json object) The decoded network-serialized unsigned transaction. ... The layout is the same as the output of decoderawtransaction. }, "global_xpubs" : [ (json array) { (json object) "xpub" : "str", (string) The extended public key this path corresponds to "master_fingerprint" : "hex", (string) The fingerprint of the master key "path" : "str" (string) The path }, ... ], "psbt_version" : n, (numeric) The PSBT version number. Not to be confused with the unsigned transaction version "proprietary" : [ (json array) The global proprietary map { (json object) "identifier" : "hex", (string) The hex string for the proprietary identifier "subtype" : n, (numeric) The number for the subtype "key" : "hex", (string) The hex for the key "value" : "hex" (string) The hex for the value }, ... ], "unknown" : { (json object) The unknown global fields "key" : "hex", (string) (key-value pair) An unknown key-value pair ... }, "inputs" : [ (json array) { (json object) "non_witness_utxo" : { (json object, optional) Decoded network transaction for non-witness UTXOs ... }, "witness_utxo" : { (json object, optional) Transaction output for witness UTXOs "amount" : n, (numeric) The value in BTC "scriptPubKey" : { (json object) "asm" : "str", (string) Disassembly of the output script "desc" : "str", (string) Inferred descriptor for the output "hex" : "hex", (string) The raw output script bytes, hex-encoded "type" : "str", (string) The type, eg 'pubkeyhash' "address" : "str" (string, optional) The Bitcoin address (only if a well-defined address exists) } }, "partial_signatures" : { (json object, optional) "pubkey" : "str", (string) The public key and signature that corresponds to it. ... }, "sighash" : "str", (string, optional) The sighash type to be used "redeem_script" : { (json object, optional) "asm" : "str", (string) Disassembly of the redeem script "hex" : "hex", (string) The raw redeem script bytes, hex-encoded "type" : "str" (string) The type, eg 'pubkeyhash' }, "witness_script" : { (json object, optional) "asm" : "str", (string) Disassembly of the witness script "hex" : "hex", (string) The raw witness script bytes, hex-encoded "type" : "str" (string) The type, eg 'pubkeyhash' }, "bip32_derivs" : [ (json array, optional) { (json object) "pubkey" : "str", (string) The public key with the derivation path as the value. "master_fingerprint" : "str", (string) The fingerprint of the master key "path" : "str" (string) The path }, ... ], "final_scriptSig" : { (json object, optional) "asm" : "str", (string) Disassembly of the final signature script "hex" : "hex" (string) The raw final signature script bytes, hex-encoded }, "final_scriptwitness" : [ (json array, optional) "hex", (string) hex-encoded witness data (if any) ... ], "ripemd160_preimages" : { (json object, optional) "hash" : "str", (string) The hash and preimage that corresponds to it. ... }, "sha256_preimages" : { (json object, optional) "hash" : "str", (string) The hash and preimage that corresponds to it. ... }, "hash160_preimages" : { (json object, optional) "hash" : "str", (string) The hash and preimage that corresponds to it. ... }, "hash256_preimages" : { (json object, optional) "hash" : "str", (string) The hash and preimage that corresponds to it. ... }, "taproot_key_path_sig" : "hex", (string, optional) hex-encoded signature for the Taproot key path spend "taproot_script_path_sigs" : [ (json array, optional) { (json object, optional) The signature for the pubkey and leaf hash combination "pubkey" : "str", (string) The x-only pubkey for this signature "leaf_hash" : "str", (string) The leaf hash for this signature "sig" : "str" (string) The signature itself }, ... ], "taproot_scripts" : [ (json array, optional) { (json object) "script" : "hex", (string) A leaf script "leaf_ver" : n, (numeric) The version number for the leaf script "control_blocks" : [ (json array) The control blocks for this script "hex", (string) A hex-encoded control block for this script ... ] }, ... ], "taproot_bip32_derivs" : [ (json array, optional) { (json object) "pubkey" : "str", (string) The x-only public key this path corresponds to "master_fingerprint" : "str", (string) The fingerprint of the master key "path" : "str", (string) The path "leaf_hashes" : [ (json array) The hashes of the leaves this pubkey appears in "hex", (string) The hash of a leaf this pubkey appears in ... ] }, ... ], "taproot_internal_key" : "hex", (string, optional) The hex-encoded Taproot x-only internal key "taproot_merkle_root" : "hex", (string, optional) The hex-encoded Taproot merkle root "musig2_participant_pubkeys" : [ (json array, optional) { (json object) "aggregate_pubkey" : "hex", (string) The compressed aggregate public key for which the participants create. "participant_pubkeys" : [ (json array) "hex", (string) The compressed public keys that are aggregated for aggregate_pubkey. ... ] }, ... ], "musig2_pubnonces" : [ (json array, optional) { (json object) "participant_pubkey" : "hex", (string) The compressed public key of the participant that created this pubnonce. "aggregate_pubkey" : "hex", (string) The compressed aggregate public key for which this pubnonce is for. "leaf_hash" : "hex", (string, optional) The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key. "pubnonce" : "hex" (string) The public nonce itself. }, ... ], "musig2_partial_sigs" : [ (json array, optional) { (json object) "participant_pubkey" : "hex", (string) The compressed public key of the participant that created this partial signature. "aggregate_pubkey" : "hex", (string) The compressed aggregate public key for which this partial signature is for. "leaf_hash" : "hex", (string, optional) The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key. "partial_sig" : "hex" (string) The partial signature itself. }, ... ], "unknown" : { (json object, optional) The unknown input fields "key" : "hex", (string) (key-value pair) An unknown key-value pair ... }, "proprietary" : [ (json array, optional) The input proprietary map { (json object) "identifier" : "hex", (string) The hex string for the proprietary identifier "subtype" : n, (numeric) The number for the subtype "key" : "hex", (string) The hex for the key "value" : "hex" (string) The hex for the value }, ... ] }, ... ], "outputs" : [ (json array) { (json object) "redeem_script" : { (json object, optional) "asm" : "str", (string) Disassembly of the redeem script "hex" : "hex", (string) The raw redeem script bytes, hex-encoded "type" : "str" (string) The type, eg 'pubkeyhash' }, "witness_script" : { (json object, optional) "asm" : "str", (string) Disassembly of the witness script "hex" : "hex", (string) The raw witness script bytes, hex-encoded "type" : "str" (string) The type, eg 'pubkeyhash' }, "bip32_derivs" : [ (json array, optional) { (json object) "pubkey" : "str", (string) The public key this path corresponds to "master_fingerprint" : "str", (string) The fingerprint of the master key "path" : "str" (string) The path }, ... ], "taproot_internal_key" : "hex", (string, optional) The hex-encoded Taproot x-only internal key "taproot_tree" : [ (json array, optional) The tuples that make up the Taproot tree, in depth first search order { (json object, optional) A single leaf script in the taproot tree "depth" : n, (numeric) The depth of this element in the tree "leaf_ver" : n, (numeric) The version of this leaf "script" : "str" (string) The hex-encoded script itself }, ... ], "taproot_bip32_derivs" : [ (json array, optional) { (json object) "pubkey" : "str", (string) The x-only public key this path corresponds to "master_fingerprint" : "str", (string) The fingerprint of the master key "path" : "str", (string) The path "leaf_hashes" : [ (json array) The hashes of the leaves this pubkey appears in "hex", (string) The hash of a leaf this pubkey appears in ... ] }, ... ], "musig2_participant_pubkeys" : [ (json array, optional) { (json object) "aggregate_pubkey" : "hex", (string) The compressed aggregate public key for which the participants create. "participant_pubkeys" : [ (json array) "hex", (string) The compressed public keys that are aggregated for aggregate_pubkey. ... ] }, ... ], "unknown" : { (json object, optional) The unknown output fields "key" : "hex", (string) (key-value pair) An unknown key-value pair ... }, "proprietary" : [ (json array, optional) The output proprietary map { (json object) "identifier" : "hex", (string) The hex string for the proprietary identifier "subtype" : n, (numeric) The number for the subtype "key" : "hex", (string) The hex for the key "value" : "hex" (string) The hex for the value }, ... ] }, ... ], "fee" : n (numeric, optional) The transaction fee paid if all UTXOs slots in the PSBT have been filled. }

Source: services/core-node/bcore/src/rpc/rawtransaction.cpp:3717

C++ symbol: decodepsbt

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"decodepsbt","params":["\"<psbt>\""]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli decodepsbt "psbt"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "decodepsbt",
        "params": ["\"<psbt>\""],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "decodepsbt",
    params: ["\"<psbt>\""],
  }),
});
console.log(await res.json());