walletcreatefundedpsbt ( [{"txid":"hex","vout":n,"sequence":n},...] ) [{"address":amount},{"data":"hex"},...] ( locktime options bip32derivs )
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
},
...
]
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 bitcoin address, the value (float or string) is the amount in XEC
},
{ (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
Allows this transaction to be replaced by a transaction with higher fees. If provided, it is an error if explicit sequence numbers are incompatible.
4. options (json object, optional) Options object that can be used to pass named arguments, listed below.
5. bip32derivs (boolean, optional, default=true) Includes the BIP 32 derivation paths for public keys if we know them
Named Arguments:
add_inputs (boolean, optional, default=false) If inputs are specified, automatically include more if they are not enough.
include_unsafe (boolean, optional, default=false) Include inputs that are not safe to spend (unconfirmed transactions from outside keys).
Warning: the resulting transaction may become invalid if one of the unsafe inputs disappears.
If that happens, you will need to fund the transaction with different inputs and republish it.
changeAddress (string, optional, default=pool address) The bitcoin address to receive the change
changePosition (numeric, optional, default=random) The index of the change output
includeWatching (boolean, optional, default=true for watch-only wallets, otherwise false) Also select inputs which are watch only
lockUnspents (boolean, optional, default=false) Lock selected unspent outputs
feeRate (numeric or string, optional, default=not set: makes wallet determine the fee) Set a specific fee rate in XEC/kB
subtractFeeFromOutputs (json array, optional, default=[]) 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.
...
]
Result:
{ (json object)
"psbt" : "str", (string) The resulting raw transaction (base64-encoded string)
"fee" : n, (numeric) Fee in XEC the resulting transaction pays
"changepos" : n (numeric) The position of the added change output, or -1
}
Examples:
Create a transaction with no inputs
> bitcoin-cli walletcreatefundedpsbt "[{\"txid\":\"myid\",\"vout\":0}]" "[{\"data\":\"00010203\"}]"