lockunspent

lockunspent unlock ( [{"txid":"hex","vout":n},...] )

Updates the list of temporarily unspendable outputs.

You can temporarily lock (unlock=false) or unlock (unlock=true) specified transaction outputs.

If no specific outputs are provided when unlocking, all currently locked transaction outputs will be unlocked.

A locked transaction output will not be used in automatic coin selection when spending BitcoinEvos. However, manually selected coins are automatically unlocked.

Locks are stored in memory only. Nodes start with zero locked outputs, and the list of locked outputs is always cleared when a node stops or exits.

For more information, refer to the listunspent call.

Argument #1 – unlock

Type: boolean, required

Whether to unlock (true) or lock (false) the specified transactions

Argument #2 – transactions

Type: json array, optional, default=empty array

The transaction outputs and within each, the txid (string) vout (numeric).

[
  {                   (json object)
    "txid": "hex",    (string, required) The transaction id
    "vout": n,        (numeric, required) The output number
  },
  ...
]

Result

Name	Type	Description
true\|false	boolean	Whether the command was successful or not

Examples

List the unspent transactions:

bitcoinevo-cli listunspent

Lock an unspent transaction:

bitcoinevo-cli lockunspent false "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"

List the locked transactions:

bitcoinevo-cli listlockunspent

Unlock the transaction again:

bitcoinevo-cli lockunspent true "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"

As a JSON-RPC call:

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "lockunspent", "params": [false, "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"]}' -H 'content-type: text/plain;' http://127.0.0.1:7332/