fundrawtransaction

fundrawtransaction "hexstring" ( options iswitness )

If the transaction has no inputs, they will be automatically selected to cover the output value. At most one change output will be added, and no existing outputs will be modified unless “subtractFeeFromOutputs” is specified.

Note that inputs that were signed may need to be re-signed after completion, as inputs/outputs have been added. The newly added inputs will not be signed; use signrawtransactionwithkey or signrawtransactionwithwallet to sign them.

All existing inputs must have their previous output transactions available in the wallet. Additionally, all selected inputs must be of a standard form, and P2SH scripts must be in the wallet using importaddress or addmultisigaddress (to calculate fees).

You can verify this by checking the “solvable” field in the listunspent output. Currently, only pay-to-pubkey, multisig, and their P2SH variants are supported for watch-only.

Argument #1 – hexstring

Type: string, required

The hex string of the raw transaction

Argument #2 – options

Type: json object, optional

For backward compatibility, passing true instead of an object will result in {"includeWatching":true}.

Options:

  • replaceable: Marks the transaction as BIP125 replaceable, allowing replacement by a transaction with higher fees.
  • conf_target: The target number of blocks for confirmation (default is the wallet’s -txconfirmtarget setting).
  • estimate_mode: Sets the fee estimate mode, which can be "unset", "economical", or "conservative".
{
  "add_inputs": bool,            (boolean, optional, default=true) For a transaction with existing inputs, automatically include more if they are not enough.
  "changeAddress": "str",        (string, optional, default=pool address) The bitcoinevo 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.
                                 Only solvable inputs can be used. Watch-only destinations are solvable if the public key and/or output script was imported,
                                 e.g. with 'importpubkey' or 'importmulti' with the 'pubkeys' or 'desc' field.
  "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 BTCE/kvB.
  "subtractFeeFromOutputs": [    (json array, optional, default=empty array) The integers.
                                 The fee will be equally deducted from the amount of each specified output.
                                 Those recipients will receive less bitcoinevos 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.
    ...
  ],

Argument #3 – iswitness

Type: boolean, optional, default=depends on heuristic tests

iswitness:

Specifies whether the transaction hex is a serialized witness transaction. If iswitness is not provided, heuristic tests will be used to determine the format:

  • If true, only witness deserialization will be attempted.
  • If false, only non-witness deserialization will be tried.

This boolean should indicate whether the transaction has inputs (e.g., fully valid or on-chain transactions), if known by the caller.

Result 

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

Examples

Create a transaction with no inputs:

bitcoinevo-cli createrawtransaction "[]" "{\"myaddress\":0.01}"

Add sufficient unsigned inputs to meet the output value:

bitcoinevo-cli fundrawtransaction "rawtransactionhex"

Sign the transaction:

bitcoinevo-cli signrawtransactionwithwallet "fundedtransactionhex"

Send the transaction:

bitcoinevo-cli sendrawtransaction "signedtransactionhex"