7.3 KiB
Minisafe API
minisafe exposes a JSON-RPC 2.0
interface over a Unix Domain socket.
Commands must be sent as valid JSONRPC 2.0 requests, ending with a \n.
| Command | Description |
|---|---|
stop |
Stops the minisafe daemon |
getinfo |
Get general information about the daemon |
getnewaddress |
Get a new receiving address |
listspendtxs |
List all stored Spend transactions |
delspendtx |
Delete a stored Spend transaction |
Reference
General
stop
Stops the minisafe daemon.
Response
Returns an empty response.
| Field | Type | Description |
|---|
getinfo
General information about the daemon
Request
This command does not take any parameter for now.
| Field | Type | Description |
|---|
Response
| Field | Type | Description |
|---|---|---|
version |
string | Version following the SimVer format |
network |
string | Answer can be mainnet, testnet, regtest |
blockheight |
integer | Current block height |
sync |
float | The synchronization progress as percentage (0 < sync < 1) |
descriptors |
object | Object with the name of the descriptor as key and the descriptor string as value |
getnewaddress
Get a new address for receiving coins. This will always generate a new address regardless of whether it was used or not.
Request
This command does not take any parameter for now.
| Field | Type | Description |
|---|
Response
| Field | Type | Description |
|---|---|---|
address |
string | A Bitcoin address |
listcoins
List our current Unspent Transaction Outputs.
Request
This command does not take any parameter for now.
| Field | Type | Description |
|---|
Response
| Field | Type | Description |
|---|---|---|
amount |
int | Value of the UTxO in satoshis |
outpoint |
string | Transaction id and output index of this coin |
block_height |
int or null | Blockheight the transaction was confirmed at, or null |
createspend
Create a transaction spending one or more of our coins. All coins must exist and not be spent.
Will error if the given coins are not sufficient to cover the transaction cost at 90% (or more) of the given feerate. If on the contrary the transaction is more than sufficiently funded, it will create a change output when economically rationale to do so.
This command will refuse to create any output worth less than 5k sats.
Request
| Field | Type | Description |
|---|---|---|
outpoints |
list of string | List of the coins to be spent, as txid:vout. |
destinations |
object | Map from Bitcoin address to value |
feerate |
integer | Target feerate for the transaction, in satoshis per virtual byte. |
Response
| Field | Type | Description |
|---|---|---|
psbt |
string | PSBT of the spending transaction, encoded as base64. |
updatespend
Store the PSBT of a Spend transaction in database, updating it if it already exists.
Will merge the partial signatures for all inputs if a PSBT for a transaction with the same txid exists in DB.
Request
| Field | Type | Description |
|---|---|---|
psbt |
string | Base64-encoded PSBT of a Spend transaction. |
Response
This command does not return anything for now.
| Field | Type | Description |
|---|
listspendtxs
List stored Spend transactions.
Request
This command does not take any parameter for now.
| Field | Type | Description |
|---|
Response
| Field | Type | Description |
|---|---|---|
spend_txs |
array | Array of Spend tx entries |
Spend tx entry
| Field | Type | Description |
|---|---|---|
psbt |
string | Base64-encoded PSBT of the Spend transaction. |
change_index |
int or null | Index of the change output in the transaction outputs, if there is one. |
delspendtx
Request
| Field | Type | Description |
|---|---|---|
txid |
string | Hex encoded txid of the Spend transaction to delete |
Response
This command does not return anything for now.
| Field | Type | Description |
|---|