descriptorprocesspsbt

descriptorprocesspsbt "psbt" ["",{"desc":"str","range":n or [n,n]},...] ( "sighashtype" bip32derivs finalize ) Update all segwit inputs in a PSBT with information from output descriptors, the UTXO set or the mempool. Then, sign the inputs we are able to with information from the output descriptors. Arguments: 1. psbt (string, required) The transaction base64 string 2. descriptors (json array, required) An array of either strings or objects [ "", (string) An output descriptor { (json object) An object with an output descriptor and extra information "desc": "str", (string, required) An output descriptor "range": n or [n,n], (numeric or array, optional, default=1000) Up to what index HD chains should be explored (either end or [begin,end]) }, ... ] 3. sighashtype (string, optional, default="DEFAULT for Taproot, ALL otherwise") The signature hash type to sign with if not specified by the PSBT. Must be one of "DEFAULT" "ALL" "NONE" "SINGLE" "ALL|ANYONECANPAY" "NONE|ANYONECANPAY" "SINGLE|ANYONECANPAY" 4. bip32derivs (boolean, optional, default=true) Include BIP 32 derivation paths for public keys if we know them 5. finalize (boolean, optional, default=true) Also finalize inputs if possible Result: { (json object) "psbt" : "str", (string) The base64-encoded partially signed transaction "complete" : true|false, (boolean) If the transaction has a complete set of signatures "hex" : "hex" (string, optional) The hex-encoded network transaction if complete } Examples: > bitcoin-cli descriptorprocesspsbt "psbt" "[\"descriptor1\", \"descriptor2\"]" > bitcoin-cli descriptorprocesspsbt "psbt" "[{\"desc\":\"mydescriptor\", \"range\":21}]"

Signature

descriptorprocesspsbt(psbt: string, descriptors: array, sighashtype?: string, bip32derivs?: boolean, finalize?: boolean) → any

Code samples

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

bitcoin-cli descriptorprocesspsbt "psbt" "[\"descriptor1\", \"descriptor2\"]"

bitcoin-cli descriptorprocesspsbt "psbt" "[{\"desc\":\"mydescriptor\", \"range\":21}]"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "descriptorprocesspsbt",
        "params": ["\"<psbt>\"", [], "DEFAULT for Taproot", true, true],
    },
    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: "descriptorprocesspsbt",
    params: ["\"<psbt>\"",[],"DEFAULT for Taproot",true,true],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
psbt	`string`	yes	The transaction base64 string
descriptors	`any[]`	yes	An array of either strings or objects [ "", (string) An output descriptor { (json object) An object with an output descriptor and extra information "desc": "str", (string, required) An output descriptor "range": n or [n,n], (numeric or array, optional, default=1000) Up to what index HD chains should be explored (either end or [begin,end]) }, ... ]
sighashtype	`string`	—	The signature hash type to sign with if not specified by the PSBT. Must be one of "DEFAULT" "ALL" "NONE" "SINGLE" "ALL\|ANYONECANPAY" "NONE\|ANYONECANPAY" "SINGLE\|ANYONECANPAY"
bip32derivs	`boolean`	—	Include BIP 32 derivation paths for public keys if we know them
finalize	`boolean`	—	Also finalize inputs if possible

Result

Type: any

{ (json object) "psbt" : "str", (string) The base64-encoded partially signed transaction "complete" : true|false, (boolean) If the transaction has a complete set of signatures "hex" : "hex" (string, optional) The hex-encoded network transaction if complete }

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

C++ symbol: descriptorprocesspsbt

Code samples

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

bitcoin-cli descriptorprocesspsbt "psbt" "[\"descriptor1\", \"descriptor2\"]"

bitcoin-cli descriptorprocesspsbt "psbt" "[{\"desc\":\"mydescriptor\", \"range\":21}]"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "descriptorprocesspsbt",
        "params": ["\"<psbt>\"", [], "DEFAULT for Taproot", true, true],
    },
    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: "descriptorprocesspsbt",
    params: ["\"<psbt>\"",[],"DEFAULT for Taproot",true,true],
  }),
});
console.log(await res.json());