133 lines
5.5 KiB
Markdown
133 lines
5.5 KiB
Markdown
# Minisafe API
|
|
|
|
`minisafe` exposes a [JSON-RPC 2.0](https://www.jsonrpc.org/specification)
|
|
interface over a Unix Domain socket.
|
|
|
|
Commands must be sent as valid JSONRPC 2.0 requests, ending with a `\n`.
|
|
|
|
| Command | Description |
|
|
| ----------------------------------------------------------- | ---------------------------------------------------- |
|
|
| [`stop`](#stop) | Stops the minisafe daemon |
|
|
| [`getinfo`](#getinfo) | Get general information about the daemon |
|
|
| [`getnewaddress`](#getnewaddress) | Get a new receiving address |
|
|
|
|
# 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](http://www.simver.org/) 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 |
|
|
| -------------- | --------- | ---------------------------------------------------- |
|