Skip to content

createpsbt JSON-RPC command

createpsbt [{"txid":"hex","vout":n,"sequence":n},...] [{"address":amount},{"address":},{"data":"hex"},...] ( locktime )

Creates a transaction in the Partially Signed Transaction format.
Implements the Creator role.

Arguments

1. inputs                              (json array, required) A json array of json objects
     [
       {                               (json object)
         "txid": "hex",                (string, required) The transaction id
         "vout": n,                    (numeric, required) The output number
         "sequence": n,                (numeric, optional) The sequence number
       },
       ...
     ]
2. outputs                             (json array, required) a json array with outputs (key-value pairs).
                                       For compatibility reasons, a dictionary, which holds the key-value pairs directly, is also
                                       accepted as second parameter.
     [
       {                               (json object)
         "address": amount,            (numeric or string, required) A key-value pair. The key (string) is the Bitcoin Cash address, the value (float or string) is the amount in BCH
       },
       {                               (json object)
         "address": {                  (json object, required) A key-value pair. The key (string) is the Bitcoin Cash address, the value is a JSON object
           "amount": amount,           (numeric or string, required) The amount in BCH
           "tokenData": {              (json object, optional) Optional CashToken data to add to this output
             "category": "hex",        (string, required) The token id
             "amount": n,              (numeric, optional) The token fungible amount, use JSON strings for >53-bit amounts
             "nft": {                  (json object, optional) NFT data for the token
               "capability": "str",    (string, optional) One of "none", "mutable", "minting"
               "commitment": "hex",    (string, optional) The token NFT commitment
             },
           },
         },
       },
       {                               (json object)
         "data": "hex",                (string, required) A key-value pair. The key must be "data", the value is a hex-encoded data string or an array of hex-encoded data strings (each item yields a separate data push)
       },
       ...
     ]
3. locktime                            (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs

Result

  "psbt"        (string)  The resulting raw transaction (base64-encoded string)

Examples

> bitcoin-cli createpsbt "[{\"txid\":\"myid\",\"vout\":0}]" "[{\"data\":\"00010203\"}]"

Bitcoin Cash Node Daemon version v27.0.1-6a03070

Documentation on docs.bitcoincashnode.org reflects the current master branch in Git, and may include API changes that are not yet present in the latest release.