Skip to main content

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.

That is, each address can only appear once and there can only be one ‘data’ object. For convenience, a dictionary, which holds the key-value pairs directly, is also accepted.

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

## 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 .

## Argument #5 - options

**Type:** json object, optional

"locktime": n, (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs

"lock\_unspents": bool, (boolean, optional, default=false) Lock selected unspent outputs "psbt": bool, (boolean, optional, default=automatic) Always return a PSBT, implies add\_to\_wallet=false. "subtract\_fee\_from\_outputs": \[ (json array, optional, default=empty array) Outputs to subtract the fee from, specified as integer indices. The fee will be equally deducted from the amount of each specified output. Those recipients will receive less bitgesells 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

```json
{
"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 bitgesell 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 .
"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
{ (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
}
}
```

## Example usage (with RPC call)

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

```sh
BGL-cli send '{"bg1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.1}' 6 economical
```

Send 0.2 BGL with a fee rate of 1.1 using positional arguments:

```sh
BGL-cli send '{"bg1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.2}' null "unset" 1.1
```

Send 0.2 BGL with a fee rate of 1 using the options argument:

```sh
BGL-cli send '{"bg1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.2}' null "unset" null '{"fee_rate": 1}'
```
Send 0.3 BGL with a fee rate of 25 using named arguments:

```sh
BGL-cli -named send outputs='{"bg1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.3}' fee_rate=25
```

Create a transaction that should confirm the next block, with a specific input, and return result without adding to wallet or broadcasting to the network:

```sh
BGL-cli send '{"bg1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl": 0.1}' 1 economical '{"add_to_wallet": false, "inputs": [{"txid":"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0", "vout":1}]}'

```