Skip to main content

fundrawtransaction

fundrawtransaction "hexstring" ( options )

Add inputs to a transaction until it has enough in value to meet its out value. This will not modify existing inputs, and will add at most one change output to the outputs. No existing outputs will be modified unless "subtractFeeFromOutputs" is specified. Note that inputs which were signed may need to be resigned after completion since in/outputs have been added. The inputs added will not be signed, use signrawtransaction for that. Note that all existing inputs must have their previous output transaction be in the wallet. Note that all inputs selected must be of standard form and P2SH scripts must be in the wallet using importaddress or addmultisigaddress (to calculate fees). You can see whether this is the case by checking the "solvable" field in the listunspent output. Only pay-to-pubkey, multisig, and P2SH versions thereof are currently supported for watch-only

#Create a transaction with no inputs
yerbas-cli createrawtransaction "[]" "{\"myaddress\":0.01}"

# Add sufficient unsigned inputs to meet the output value
yerbas-cli fundrawtransaction "rawtransactionhex"

# Sign the transaction
yerbas-cli signrawtransaction "fundedtransactionhex"

# Send the transaction
yerbas-cli sendrawtransaction "signedtransactionhex"

Arguments

ArgumentTypeDescription
"hexstring"(string)The hex string of the raw transaction
Arguments:
1. "hexstring" (string, required) The hex string of the raw transaction
2. options (object, optional)
{
"changeAddress" (string, optional, default pool address) The yerbas address to receive the change
"changePosition" (numeric, optional, default random) The index of the change output
"includeWatching" (boolean, optional, default false) Also select inputs which are watch only
"lockUnspents" (boolean, optional, default false) Lock selected unspent outputs
"feeRate" (numeric, optional, default not set: makes wallet determine the fee) Set a specific feerate (YERB per KB)
"subtractFeeFromOutputs" (array, optional) A json array of integers.
The fee will be equally deducted from the amount of each specified output.
The outputs are specified by their zero-based index, before any change output is added.
Those recipients will receive less yerbas than you enter in their corresponding amount field.
If no outputs are specified here, the sender pays the fee.
[vout_index,...]
"conf_target" (numeric, optional) Confirmation target (in blocks)
"estimate_mode" (string, optional, default=UNSET) The fee estimate mode, must be one of:
"UNSET"
"ECONOMICAL"
"CONSERVATIVE"
}
for backward compatibility: passing in a true instead of an object will result in {"includeWatching":true}

Output

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

Examples

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressbalance", "params": [{"addresses": ["XwnLY9Tf7Zsef8gMGL2fhWA9ZmMjt4KPwg"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:9998/