send

send [{"address":amount},{"data":"hex"},...] ( conf_target "estimate_mode" fee_rate options )

EXPERIMENTAL warning: this call may be changed in future releases.

Send a transaction.

Argument #1 – outputs

Type: json array, required

The outputs (key-value pairs), where none of the keys are duplicated.: Each address can appear only once, and there can be only one ‘data’ object. For convenience, a dictionary that holds key-value pairs directly is also accepted.

[
  {                                 (json object)
    "address": amount,              (numeric or string, required) A key-value pair. The key (string) is the bitcoinevo address, the value (float or string) is the amount in BTCE
  },
  {                                 (json object)
    "data": "hex",                  (string, required) A key-value pair. The key must be "data", the value is hex-encoded data
  },
  ...
]

Argument #2 – conf_target

Type: numeric, optional, default=wallet -txconfirmtarget

Confirmation target in blocks

Argument #3 – estimate_mode

Type: string, optional, default=unset

The fee estimate mode, must be one of (case insensitive):: “unset” “economical” “conservative”

Argument #4 – fee_rate

Type: numeric or string, optional, default=not set, fall back to wallet fee estimation

Specify a fee rate in sat/vB.

Argument #5 – options

Type: json object, optional

Type: json object, optional

“locktime”: numeric, optional, default=0
Specifies the raw locktime. A non-zero value also activates locktime on the inputs.
“lock_unspents”: bool, optional, default=false
Locks the selected unspent outputs.
“psbt”: bool, optional, default=automatic
Always returns a PSBT (Partially Signed Bitcoin Transaction), implying add_to_wallet=false.
“subtract_fee_from_outputs”: json array, optional, default=empty array
Specifies outputs from which the fee will be subtracted, given as integer indices. The fee will be equally deducted from the amount of each specified output, meaning those recipients will receive less BitcoinEvos than the entered amount. If no outputs are specified, the sender will cover the fee.

Example:
- vout_index: numeric
  The zero-based output index, before a change output is added.
“replaceable”: bool, optional, default=wallet default
Marks the transaction as BIP125 replaceable, allowing it to be replaced with a transaction that has higher fees.

{
  "add_inputs": bool,               (boolean, optional, default=false) If inputs are specified, automatically include more if they are not enough.
  "add_to_wallet": bool,            (boolean, optional, default=true) When false, returns a serialized transaction which will not be added to the wallet or broadcast
  "change_address": "hex",          (string, optional, default=pool address) The bitcoinevo address to receive the change
  "change_position": 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 change_address is not specified. Options are "legacy", "p2sh-segwit", and "bech32".
  "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"
  "fee_rate": amount,               (numeric or string, optional, default=not set, fall back to wallet fee estimation) Specify a fee rate in sat/vB.
  "include_watching": 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.
  "inputs": [                       (json array, optional, default=empty array) Specify inputs instead of adding them automatically. A JSON array of JSON objects
    "txid",                         (string, required) The transaction id
    vout,                           (numeric, required) The output number
    sequence,                       (numeric, required) The sequence number
    ...
  ],

Result

{                             (json object)
  "complete" : true|false,    (boolean) If the transaction has a complete set of signatures
  "txid" : "hex",             (string) The transaction id for the send. Only 1 transaction is created regardless of the number of addresses.
  "hex" : "hex",              (string) If add_to_wallet is false, the hex-encoded raw transaction with signature(s)
  "psbt" : "str"              (string) If more signatures are needed, or if add_to_wallet is false, the base64-encoded (partially) signed transaction
}

Examples

Send 0.1 BTCE with a confirmation target of 6 blocks in economical fee estimate mode:

bitcoinevo-cli send '{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.1}' 6 economical

Send 0.2 BTCE with a fee rate of 1.1 sat/vB using positional arguments:

bitcoinevo-cli send '{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.2}' null "unset" 1.1

Send 0.2 BTCE with a fee rate of 1 sat/vB using the options argument:

bitcoinevo-cli send '{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.2}' null "unset" null '{"fee_rate": 1}'

Send 0.3 BTCE with a fee rate of 25 sat/vB using named arguments:

bitcoinevo-cli -named send outputs='{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.3}' fee_rate=25

To create a transaction that should confirm in the next block, with a specific input, and return the result without adding it to the wallet or broadcasting to the network, specify the above options.

bitcoinevo-cli send '{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.1}' 1 economical '{"add_to_wallet": false, "inputs": [{"txid":"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0", "vout":1}]}'