walletcreatefundedpsbt (0.21.0.0 RPC)

walletcreatefundedpsbt ( [{"txid":"hex","vout":n,"sequence":n,"pegin_bitcoin_tx":"hex","pegin_txout_proof":"hex","pegin_claim_script":"hex","issuance_amount":n,"issuance_tokens":n,"asset_entropy":"hex","asset_blinding_nonce":"hex","blind_reissuance":bool},...] ) [{"address":amount,"blinder_index":n,"asset":"str"},{"data":"hex"},...] ( locktime options bip32derivs {"pubkeys":["pubkey",...],"scripts":["script",...],"descriptors":["descriptor",...]} psbt_version )

Creates and funds a transaction in the Partially Signed Transaction format.
Implements the Creator and Updater roles.

Arguments:
1. inputs                                  (json array, optional) Leave empty to add inputs automatically. See add_inputs option.
     [
       {                                   (json object)
         "txid": "hex",                    (string, required) The transaction id
         "vout": n,                        (numeric, required) The output number
         "sequence": n,                    (numeric, optional, default=depends on the value of the 'locktime' and 'options.replaceable' arguments) The sequence number
         "pegin_bitcoin_tx": "hex",        (string, required) The raw bitcoin transaction (in hex) depositing bitcoin to the mainchain_address generated by getpeginaddress
         "pegin_txout_proof": "hex",       (string, required) A rawtxoutproof (in hex) generated by the mainchain daemon's `gettxoutproof` containing a proof of only bitcoin_tx
         "pegin_claim_script": "hex",      (string, required) The witness program generated by getpeginaddress.
         "issuance_amount": n,             (numeric) The amount to be issued
         "issuance_tokens": n,             (numeric) The number of asset issuance tokens to generate
         "asset_entropy": "hex",           (string) For new asset issuance, this is any additional entropy to be used in the asset tag calculation. For reissuance, this is the original asaset entropy
         "asset_blinding_nonce": "hex",    (string) Do not set for new asset issuance. For reissuance, this is the blinding factor for reissuance token output for the asset being reissued
         "blind_reissuance": bool,         (boolean, optional, default=true) Whether to mark the issuance input for blinding or not. Only affects issuances with re-issuance tokens.
       },
       ...
     ]
2. outputs                                 (json array, required) The outputs (key-value pairs), where none of the keys are duplicated.
                                           That is, each address can only appear once and there can only be one 'data' object.
                                           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 address, the value (float or string) is the amount in BTC
         "blinder_index": n,               (numeric) The index of the input whose signer will blind this output. Must be provided if this output is to be blinded
         "asset": "str",                   (string) The asset tag for this output if it is not the main chain asset
       },
       {                                   (json object)
         "data": "hex",                    (string, required) A key-value pair. The key must be "data", the value is hex-encoded data
       },
       ...
     ]
3. locktime                                (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs
4. options                                 (json object, optional)
     {
       "add_inputs": bool,                 (boolean, optional, default=false) If inputs are specified, automatically include more if they are not enough.
       "changeAddress": "hex",             (string, optional, default=pool address) The address to receive the change
       "changePosition": n,                (numeric, optional, default=random) The index of the change output
       "change_type": "str",               (string, optional, default=set by -changetype) The output type to use. Only valid if changeAddress is not specified. Options are "legacy", "p2sh-segwit", and "bech32".
       "includeWatching": bool,            (boolean, optional, default=true for watch-only wallets, otherwise false) Also select inputs which are watch only
       "lockUnspents": bool,               (boolean, optional, default=false) Lock selected unspent outputs
       "fee_rate": amount,                 (numeric or string, optional, default=not set, fall back to wallet fee estimation) Specify a fee rate in sat/vB.
       "feeRate": amount,                  (numeric or string, optional, default=not set, fall back to wallet fee estimation) Specify a fee rate in BTC/kvB.
       "subtractFeeFromOutputs": [         (json array, optional, default=empty array) The outputs to subtract the fee from.
                                           The fee will be equally deducted from the amount of each specified output.
                                           Those recipients will receive less bitcoins than you enter in their corresponding amount field.
                                           If no outputs are specified here, the sender pays the fee.
         vout_index,                       (numeric) The zero-based output index, before a change output is added.
         ...
       ],
       "replaceable": bool,                (boolean, optional, default=wallet default) Marks this transaction as BIP125 replaceable.
                                           Allows this transaction to be replaced by a transaction with higher fees
       "conf_target": n,                   (numeric, optional, default=wallet -txconfirmtarget) Confirmation target in blocks
       "estimate_mode": "str",             (string, optional, default=unset) The fee estimate mode, must be one of (case insensitive):
                                           "unset"
                                           "economical"
                                           "conservative"
     }
5. bip32derivs                             (boolean, optional, default=true) Include BIP 32 derivation paths for public keys if we know them
6. solving_data                            (json object, optional) Keys and scripts needed for producing a final transaction with a dummy signature. Used for fee estimation during coin selection.
                                           
     {
       "pubkeys": [                        (json array, optional, default=empty array) A json array of public keys.
                                           
         "pubkey",                         (string) A public key
         ...
       ],
       "scripts": [                        (json array, optional, default=empty array) A json array of scripts.
                                           
         "script",                         (string) A script
         ...
       ],
       "descriptors": [                    (json array, optional, default=empty array) A json array of descriptors.
                                           
         "descriptor",                     (string) A descriptor
         ...
       ],
     }
7. psbt_version                            (numeric, optional, default=2) The PSBT version number to use.

Result:
{                     (json object)
  "psbt" : "str",     (string) The resulting raw transaction (base64-encoded string)
  "fee" : n,          (numeric) Fee in BTC the resulting transaction pays
  "changepos" : n     (numeric) The position of the added change output, or -1
}

Examples:

Create a transaction with no inputs
> elements-cli walletcreatefundedpsbt "[{\"txid\":\"myid\",\"vout\":0}]" "[{\"data\":\"00010203\"}]"