zenith/zenith-openrpc.json

815 lines
28 KiB
JSON
Raw Normal View History

2024-08-03 12:00:12 +00:00
{
"openrpc": "1.0.0-rc1",
"info": {
2024-08-06 21:08:26 +00:00
"version": "0.7.0.0-beta",
2024-08-03 12:00:12 +00:00
"title": "Zenith RPC",
"description": "The RPC methods to interact with the Zenith Zcash wallet",
"license": {
2024-08-06 21:08:26 +00:00
"name": "MIT",
"url": "https://choosealicense.com/licenses/mit/"
2024-08-03 12:00:12 +00:00
}
},
"servers": [
{
2024-08-05 17:54:02 +00:00
"name": "Zenith RPC",
"summary": "The Zenith wallet RPC server",
"description": "This is the server that allows programmatic interaction with the Zenith Zcash wallet via RPC",
2024-08-03 12:00:12 +00:00
"url": "http://localhost:8234"
}
],
2024-08-05 17:54:02 +00:00
"methods": [
{
"name": "getinfo",
2024-08-05 20:44:11 +00:00
"summary": "Get basic Zenith information",
"description": "Get basic information about Zenith, such as the network it is running on and the version of Zebra it is connected to",
2024-08-06 18:38:00 +00:00
"tags": [],
2024-08-05 17:54:02 +00:00
"result" : {
"name": "Zenith information",
"schema": { "$ref": "#/components/schemas/ZenithInfo" }
},
"params" : [],
"examples": [
{
"name": "GetInfo example",
"summary": "Get information from Zenith",
"description": "Gets the status of the Zenith wallet server",
"params": [],
"result": {
"name": "GetInfo result",
"value": {
"version": "0.7.0.0-beta",
"network": "TestNet",
"zebraVersion": "v1.8.0"
}
}
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" }
]
},
{
"name": "listwallets",
2024-08-05 20:44:11 +00:00
"summary": "Get the list of available wallets",
"description": "Returns a list of available wallets per the network that the Zebra node is running on.",
2024-08-06 18:38:00 +00:00
"tags": [],
2024-08-05 17:54:02 +00:00
"result": {
"name": "Wallets",
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ZcashWallet"
}
}
},
2024-08-05 18:04:57 +00:00
"params": [],
"examples": [
{
"name": "ListWallets example",
"summary": "Get list of wallets",
"description": "Get the list of wallets available in Zenith for the current network (Mainnet/Testnet)",
"params": [],
"result": {
"name": "ListWallets result",
"value": [
{
"birthday": 2762066,
"index": 1,
"lastSync": 2919374,
"name": "Main",
"network": "TestNet"
},
{
"birthday": 2798877,
"index": 2,
"lastSync": 2894652,
"name": "zcashd",
"network": "TestNet"
}
]
}
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" },
{ "$ref": "#/components/errors/NoWallets" }
]
2024-08-05 20:16:03 +00:00
},
2024-08-07 16:57:10 +00:00
{
"name": "getnewwallet",
2024-08-07 16:57:10 +00:00
"summary": "Create a new wallet",
"description": "Create a new wallet for Zenith.",
2024-08-24 12:45:42 +00:00
"tags": [],
"params": [
{ "$ref": "#/components/contentDescriptors/Name"}
],
"paramStructure": "by-position",
2024-08-08 14:31:34 +00:00
"result": {
"name": "Wallet",
"schema": {
2024-08-08 15:11:10 +00:00
"$ref": "#/components/contentDescriptors/WalletId"
2024-08-08 14:31:34 +00:00
}
2024-08-24 12:45:42 +00:00
},
"examples": [
{
"name": "GetNewWallet example",
"summary": "Create a wallet",
"description": "Creates a new wallet with the given name",
2024-08-24 12:51:07 +00:00
"params": [
{
"name": "Wallet name",
"summary": "The user-friendly name for the wallet",
"value": "Main"
}
],
2024-08-24 12:45:42 +00:00
"result": {
"name": "GetNewWallet result",
"value": 1
}
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" },
{ "$ref": "#/components/errors/DuplicateName" }
]
2024-08-07 16:57:10 +00:00
},
2024-08-05 20:16:03 +00:00
{
"name": "listaccounts",
2024-08-06 18:38:00 +00:00
"summary": "List existing accounts for a wallet ID",
2024-08-05 20:44:11 +00:00
"description": "List existing accounts for the given wallet ID or provide an error if none",
2024-08-06 18:38:00 +00:00
"tags": [],
2024-08-05 20:16:03 +00:00
"result": {
"name": "Accounts",
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ZcashAccount"
}
}
},
"params": [{ "$ref": "#/components/contentDescriptors/WalletId"}],
"paramStructure": "by-position",
"examples": [
{
"name": "ListAccounts example",
"summary": "Get list of accounts",
"description": "Get the list of accounts available in Zenith for the given wallet ID",
"params": [
{
"name": "walletId",
"summary": "The integer ID of the wallet to use",
"value": 1
}
],
"result": {
"name": "ListAccounts result",
"value": [
2024-08-06 18:38:00 +00:00
{
"index": 3,
"name": "Business",
"wallet": 1
},
{
"index": 1,
"name": "Savings",
"wallet": 1
}
2024-08-05 20:16:03 +00:00
]
}
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" },
{ "$ref": "#/components/errors/NoAccounts" }
]
2024-08-06 21:08:26 +00:00
},
2024-08-07 16:57:10 +00:00
{
"name": "getnewaccount",
2024-08-07 16:57:10 +00:00
"summary": "Create a new account",
"description": "Create a new account in the given wallet.",
2024-08-26 20:25:31 +00:00
"tags": [],
2024-08-24 13:59:26 +00:00
"params": [
2024-08-26 18:49:00 +00:00
{ "$ref": "#/components/contentDescriptors/Name"},
{ "$ref": "#/components/contentDescriptors/WalletId"}
2024-08-24 13:59:26 +00:00
],
"paramStructure": "by-position",
2024-08-08 14:31:34 +00:00
"result": {
"name": "Account",
"schema": {
2024-08-08 15:11:10 +00:00
"$ref": "#/components/contentDescriptors/AccountId"
2024-08-08 14:31:34 +00:00
}
2024-08-24 13:59:26 +00:00
},
"examples": [
{
"name": "GetNewAccount example",
"summary": "Create an account",
"description": "Creates a new account with the given name",
"params": [
{
"name": "Account name",
"summary": "The user-friendly name for the Account",
"value": "Personal"
2024-08-26 20:25:31 +00:00
},
{
"name": "Wallet Id",
"summary": "The internal index of the Wallet to use",
"value": 1
2024-08-24 13:59:26 +00:00
}
],
"result": {
"name": "GetNewAccount result",
"value": 1
}
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" },
2024-08-26 20:25:31 +00:00
{ "$ref": "#/components/errors/DuplicateName" },
{ "$ref": "#/components/errors/InvalidWallet" }
2024-08-24 13:59:26 +00:00
]
2024-08-07 16:57:10 +00:00
},
2024-08-06 21:08:26 +00:00
{
"name": "listaddresses",
"summary": "List existing addresses for an account ID",
"description": "List existing addresses for the given account ID or provide an error if none",
2024-08-07 15:21:04 +00:00
"tags": [],
2024-08-06 21:08:26 +00:00
"result": {
"name": "Addresses",
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ZcashAddress"
}
}
},
"params": [{ "$ref": "#/components/contentDescriptors/AccountId"}],
"paramStructure": "by-position",
"examples": [
{
"name": "ListAddresses example",
"summary": "Get list of addresses",
2024-08-15 19:41:10 +00:00
"description": "Get the list of addresses available in Zenith for the given account ID",
2024-08-06 21:08:26 +00:00
"params": [
{
"name": "accountId",
"summary": "The integer ID of the account to use",
"value": 1
}
],
"result": {
"name": "ListAddresses result",
"value": [
2024-08-07 15:21:04 +00:00
{
"index": 3,
"account": 1,
"name": "Clothes",
"ua": "utest13dq4u4dnf3yddw8lq2n6zdclshra6xsp8zgkc5ydyu6k20zrsscmuex46qa4vh84rgd78sqnlleapznnz7mnzx9wv0unts8pv32paj8se5ca3kves2u4a89uy6e8cf4hnarxydxh7hq2e9uu39punfmm53k5h45xn9k3dx35la8j7munh9td7774m8gkqgc4mn40t69w20uu2gtks7a",
"legacy": "ztestsapling188csdsvhdny25am8ume03qr2026hdy03zpg5pq7jmmfxtxtct0e93p0rg80yfxvynqd4gwlwft5",
"transparent": "tmMouLwVfRYrF91fWjDJToivmsTWBhxfX4E"
},
{
"index": 2,
"account": 1,
"name": "Vacation",
"ua": "utest1hhggl4nxfdx63evps6r7qz50cgacgtdpt9k7dl0734w63zn5qmrp6c2xdv9rkqyfkj6kgau4kz48xtm80e67l534qp02teqq86zuzetxql6z5v32yglg9n2un5zsu0hwcvaunzdfg5qnry6syh2dh9x8eu27de03j9pjfvrqda6acgtc6f0emdfh6r5jvfanmjml4ms5wwj9wfqmamq",
"legacy": "ztestsapling1mpup3xv2k9clxaf9wjcr0dt5gnmkprz9s9qsn298mqs356pf39wmh30q3pgsp0w5vyrmj6mrzw2",
"transparent": "tmX8qCB96Dq49YZkww3bSty7eZDA4Fq6F4R"
}
2024-08-06 21:08:26 +00:00
]
}
}
],
"errors": [
{ "$ref": "#/components/errors/NoAddress" }
]
2024-08-07 16:57:10 +00:00
},
{
"name": "getnewaddress",
2024-08-07 16:57:10 +00:00
"summary": "Add a new address",
"description": "Derive a new address in the given account.",
2024-09-04 14:17:12 +00:00
"tags": [],
2024-08-29 14:19:10 +00:00
"params": [
{ "$ref": "#/components/contentDescriptors/AccountId"},
{ "$ref": "#/components/contentDescriptors/Name"},
{ "$ref": "#/components/contentDescriptors/ExcludeSapling"},
{ "$ref": "#/components/contentDescriptors/ExcludeTransparent"}
],
2024-08-08 14:31:34 +00:00
"result": {
"name": "Address",
"schema": {
"$ref": "#/components/schemas/ZcashAddress"
}
2024-08-29 14:19:10 +00:00
},
2024-08-30 20:14:48 +00:00
"examples": [
{
"name": "GetNewAddress example",
"summary": "Get a new address for the given account",
"description": "Get a new address for the given account with an Orchard receiver, a Sapling receiver and a transparent receiver (default)",
"params": [
{
"name": "Account Id",
"summary": "The account index",
"value": 1
},
{
"name": "Name",
"summary": "User-friendly name for the address",
"value": "AllRecvs"
}
],
"result":
{
2024-08-30 20:25:25 +00:00
"name": "Default receivers",
"value": {
"index": 14,
"account": 1,
"name": "AllRecvs",
"ua": "utest1as2fhusjt5r7xl8963jnkkums6gue6qvu7fpw2cvrctwnwrku9r4av9zmmjt7mmet927cq9z4z0hq2w7tpm7qa8lzl5fyj6d83un6v3q78c76j7thpuzyzr260apm8xvjua5fvmrfzy59mpurec7tfamp6nd6eq95pe8vzm69hfsfea29u4v3a6lyuaah20c4k6rvf9skz35ct2r54z",
"legacy": "ztestsapling1esn0wamf8w3nz2juwryscc3l8e5xtll6aewx0r2h5xtmrpnzsw2k23lec65agn8v59r72v2krrh",
"transparent": "tmMteg5HxFnmn4mbm2UNEGzWgLX16bGLg16"
}
2024-08-30 20:14:48 +00:00
}
},
{
"name": "GetNewAddress - no transparent",
"summary": "Get a new address for the given account with no transparent receiver",
"description": "Get a new address for the given account with an Orchard receiver, a Sapling receiver and *no* transparent receiver (default)",
"params": [
{
"name": "Account Id",
"summary": "The account index",
"value": 1
},
{
"name": "Name",
"summary": "User-friendly name for the address",
"value": "NoTransparent"
},
{
"name": "ExcludeTransparent",
"summary": "Option to exclude transparent receivers from the address",
"value": "ExcludeTransparent"
}
],
"result":
{
"name": "NoTransparent",
2024-08-30 20:25:25 +00:00
"value": {
"index": 15,
"account": 1,
"name": "NoTransparent",
"ua": "utest1l0t3uzadaxa4jg7qatsfwqdvfp0qtedyyall65hm2nzwnwdmcvd7j4z6wdrftpsjxv8aw4qh0hka3wdqj0z48xrhg356dlapy36ug6tt20tkzavwccjfup8wy8sdkcc60rpf400mwek73n0ph9jyw9ae60rm5jt8rx75nzhyuymern2t",
"legacy": "ztestsapling1vp3kzw7rqldfvaw5edfgqq66qm0xnexmscwnys220403mqqh9uyl0sqsye37aelrese42y8ecnx",
"transparent": null
}
2024-08-30 20:14:48 +00:00
}
},
{
"name": "GetNewAddress - no Sapling",
"summary": "Get a new address for the given account with no Sapling receiver",
"description": "Get a new address for the given account with an Orchard receiver and a transparent receiver, and *no* Sapling receiver.",
"params": [
{
"name": "Account Id",
"summary": "The account index",
"value": 1
},
{
"name": "Name",
"summary": "User-friendly name for the address",
"value": "NoSapling"
},
{
"name": "ExcludeSapling",
"summary": "Option to exclude Sapling receivers from the address",
"value": "ExcludeSapling"
}
],
"result":
{
"name": "NoSapling",
2024-08-30 20:25:25 +00:00
"value": {
"index": 16,
"account": 3,
"name": "NoSapling",
"ua": "utest14yvw4msvn9r5nggv2s0yye8phqwrhsx8ddfvpg30zp4gtf928myaua8jwxssl7frr8eagvcrsa8tuu9dlh7cvksv3lkudvyrq2ysrtzate0dud7x0zhgz26wqccn8w7346v4kfagv3e",
"legacy": null,
"transparent": "tmQ7z6q46NLQXpeNkfeRL6wJwJWA4picf6b"
}
2024-08-30 20:14:48 +00:00
}
},
{
"name": "GetNewAddress - Orchard only",
"summary": "Get a new address for the given account with only an Orchard receiver",
"description": "Get a new address for the given account with an Orchard receiver and *no* transparent receiver, and *no* Sapling receiver.",
"params": [
{
"name": "Account Id",
"summary": "The account index",
"value": 1
},
{
"name": "Name",
"summary": "User-friendly name for the address",
"value": "OrchardOnly"
},
{
"name": "ExcludeSapling",
"summary": "Option to exclude Sapling receivers from the address",
"value": "ExcludeSapling"
},
{
"name": "ExcludeTransparent",
"summary": "Option to exclude transparent receivers from the address",
"value": "ExcludeTransparent"
}
],
"result":
{
2024-08-30 20:25:25 +00:00
"name": "OrchardOnly",
"value": {
2024-08-30 20:14:48 +00:00
"index": 17,
"account": 3,
"name": "OrchardOnly",
"ua": "utest1890l0xjxcsapk0u7jnqdglzwp04rt4r8zfvh7qx6a76fq96fyxg9xysvklwjymm9xuxzk0578pvv3yzv0w8l5x4run96mahky5defw0m",
"legacy": null,
"transparent": null
2024-08-30 20:25:25 +00:00
}
2024-08-30 20:14:48 +00:00
}
}
],
2024-08-29 14:19:10 +00:00
"errors": [
{ "$ref": "#/components/errors/InvalidAccount" },
{ "$ref": "#/components/errors/DuplicateName" }
]
2024-08-07 16:57:10 +00:00
},
{
"name": "getbalance",
"summary": "Get the balance of the given account",
"description": "Get the balance of the given account, including any unconfirmed balance.",
2024-08-16 18:31:25 +00:00
"tags": [],
2024-08-15 19:41:10 +00:00
"params": [{ "$ref": "#/components/contentDescriptors/AccountId"}],
2024-08-08 14:31:34 +00:00
"result": {
"name": "Balance",
"schema": {
2024-08-15 19:41:10 +00:00
"type": "object",
"properties": {
"confirmed": {"$ref": "#/components/schemas/Balance" },
"unconfirmed": {"$ref": "#/components/schemas/Balance" }
}
2024-08-08 14:31:34 +00:00
}
2024-08-15 19:41:10 +00:00
},
2024-08-16 18:28:44 +00:00
"examples": [
{
"name": "GetBalance example",
"summary": "Get account balance",
"description": "Provides the balance for the current account, showing the balance for the transparent, Sapling and Orchard pools, both for confirmed notes and unconfirmed notes",
"params": [
{
"name": "accountId",
"summary": "The integer ID of the account to use",
"value": 1
}
],
"result": {
"name": "GetBalance result",
"value":{
"confirmed": {
"orchard": 22210259,
"sapling": 0,
"transparent": 0
},
"unconfirmed": {
"orchard": 0,
"sapling": 0,
"transparent": 0
}
}
}
}
],
2024-08-15 19:41:10 +00:00
"errors": [
{ "$ref": "#/components/errors/InvalidAccount" }
]
2024-08-07 16:57:10 +00:00
},
{
"name": "listreceived",
"summary": "List received transactions",
"description": "List transactions received by the given address.",
"tags": [],
2024-08-08 14:20:35 +00:00
"params": [{ "$ref": "#/components/contentDescriptors/Address"}],
"paramStructure": "by-position",
"result": {
"name": "Transactions",
"schema": {
"type": "array",
"items": {
2024-08-08 14:22:37 +00:00
"$ref": "#/components/schemas/ZcashNote"
2024-08-08 14:20:35 +00:00
}
}
2024-08-15 16:17:24 +00:00
},
"examples": [
{
"name": "ListReceived by Id",
"summary": "Get list of notes received by the address ID",
"description": "Provides the list of notes received by the address identified by the index provided as a parameter",
"params": [
{
"name": "Address index",
"summary": "The index for the address to use",
"value": "1"
}
],
"result": {
"name": "ListReceived by Id result",
"value": [
{
"txid": "987fcdb9bd37cbb5b205a8336de60d043f7028bebaa372828d81f3da296c7ef9",
"pool": "p2pkh",
"amount": 0.13773064,
"amountZats": 13773064,
"memo": "",
"confirmed": true,
"blockheight": 2767099,
"blocktime": 1711132723,
"outindex": 0,
"change": false
},
{
"txid": "186bdbc64f728c9d0be96082e946a9228153e24a70e20d8a82f0601da679e0c2",
"pool": "orchard",
"amount": 0.0005,
"amountZats": 50000,
"memo": "<22>",
"confirmed": true,
"blockheight": 2801820,
"blocktime": 1713399060,
"outindex": 0,
"change": false
}
]
}
2024-08-15 16:38:57 +00:00
},
{
"name": "ListReceived by Address",
"summary": "Get list of notes received by the address",
"description": "Provides the list of notes received by the address provided as a parameter",
"params": [
{
"name": "Address",
"summary": "The address to use",
"value": "ztestsapling1mpup3xv2k9clxaf9wjcr0dt5gnmkprz9s9qsn298mqs356pf39wmh30q3pgsp0w5vyrmj6mrzw2"
}
],
"result": {
"name": "ListReceived by Address result",
"value": [
{
"txid": "2a104393d72d1e62c94654950a92931e786a1f04aa732512597638b5c4a69a91",
"pool": "sapling",
"amount": 0.11447195,
"amountZats": 11447195,
"memo": "<22>",
"confirmed": true,
"blockheight": 2800319,
"blocktime": 1713301802,
"outindex": 0,
"change": false
}
]
}
2024-08-15 16:17:24 +00:00
}
],
"errors": [
{ "$ref": "#/components/errors/ZebraNotAvailable" },
{ "$ref": "#/components/errors/UnknownAddress" },
{ "$ref": "#/components/errors/InvalidAddress" }
]
2024-08-07 16:57:10 +00:00
},
{
"name": "sendmany",
"summary": "Send transaction(s)",
"description": "Send one or more transactions ",
"tags": [{"$ref": "#/components/tags/draft"}],
"params": [],
2024-08-08 14:31:34 +00:00
"result": {
"name": "Operation ID",
"schema": {
}
}
},
{
"name": "getoperationstatus",
"summary": "Get the status of a Zenith operation",
"description": "Get the status of the given operation",
2024-09-04 18:10:09 +00:00
"tags": [],
2024-09-04 14:17:12 +00:00
"params": [{ "$ref": "#/components/contentDescriptors/OperationId"}],
"paramStructure": "by-position",
2024-08-08 14:31:34 +00:00
"result": {
2024-09-04 16:08:00 +00:00
"name": "Operation",
2024-08-08 14:31:34 +00:00
"schema": {
2024-09-04 16:11:01 +00:00
"$ref": "#/components/schemas/Operation"
2024-08-08 14:31:34 +00:00
}
2024-09-04 14:17:12 +00:00
},
"errors": [
{ "$ref": "#/components/errors/OpNotFound" }
]
2024-08-05 17:54:02 +00:00
}
],
2024-08-03 12:00:12 +00:00
"components": {
2024-08-05 20:16:03 +00:00
"contentDescriptors": {
"WalletId": {
"name": "Wallet ID",
"summary": "The wallet's internal index used for unique identification",
"description": "An Integer value that uniquely identifies a wallet in Zenith",
"required": true,
"schema": {
"type": "integer"
}
2024-08-06 21:08:26 +00:00
},
"AccountId": {
"name": "Account ID",
"summary": "The account's internal index used for unique identification",
"description": "An Integer value that uniquely identifies an account in Zenith",
"required": true,
"schema": {
"type": "integer"
}
2024-08-08 14:20:35 +00:00
},
"Address": {
"name": "Address identifier",
"summary": "The address identifier",
2024-08-10 12:04:40 +00:00
"description": "A string that identifies a specific address, either by its index or the [ZIP-316](https://zips.z.cash/zip-0316) encoded address itself",
2024-08-08 14:20:35 +00:00
"required": true,
"schema": {
"type": "string"
}
2024-08-24 12:45:42 +00:00
},
"Name": {
"name": "Name",
"summary": "A user-friendly name",
"description": "A string that represents an entity in Zenith, like a wallet, an account or an address.",
"required": true,
"schema": {
"type": "string"
}
2024-08-29 14:19:10 +00:00
},
"ExcludeSapling": {
"name": "ExcludeSapling",
"summary": "Setting that indicates that the new address requested should not contain a Sapling component",
"description": "When this parameter is present, Zenith will generate an address with no Sapling receiver",
"required": false,
"schema" : {
"type": "string"
}
},
"ExcludeTransparent": {
"name": "ExcludeTransparent",
"summary": "Setting that indicates that the new address requested should not contain a Transparent component",
"description": "When this parameter is present, Zenith will generate an address with no Transparent receiver",
"required": false,
"schema" : {
"type": "string"
}
2024-09-04 14:17:12 +00:00
},
"OperationId": {
"name": "Operation ID",
"summary": "A unique identifier for Zenith operations",
"description": "A [UUID](http://en.wikipedia.org/wiki/UUID) assigned to an operation (like sending a transaction) that can be used to query Zenith to see the status and outcome of the operation.",
"required": true,
"schema" : {
"type": "string"
}
2024-08-05 20:16:03 +00:00
}
2024-09-04 14:17:12 +00:00
2024-08-05 20:16:03 +00:00
},
2024-08-05 17:54:02 +00:00
"schemas": {
"ZenithInfo": {
"type": "object",
"properties": {
"version": { "type": "string", "description": "Zenith's version"},
"network": { "type": "string", "description": "The network the wallet is connected to"},
"zebraVersion": { "type": "string", "description": "The version of the Zebra node used by Zenith"}
}
},
"ZcashWallet": {
"type": "object",
"properties": {
"index": { "type": "integer", "description": "Internal index of wallet"},
"name": { "type": "string", "description": "User-friendly name of the wallet" },
"network": { "type": "string", "description": "Network the wallet is for. Testnet or MainNet" },
"birthday": { "type": "integer", "description": "Wallet's birthday height" },
"lastSync": { "type": "integer", "description": "Last block the wallet is synced to" }
}
2024-08-05 20:16:03 +00:00
},
"ZcashAccount": {
"type": "object",
"properties": {
"index": { "type": "integer", "description": "Internal index for account"},
"wallet": { "type": "integer", "description": "ID of the wallet this account belongs to"},
"name": { "type": "string", "description": "User-friendly name of the account"}
}
2024-08-06 21:08:26 +00:00
},
"ZcashAddress": {
"type": "object",
"properties": {
"index": { "type": "integer", "description": "Internal index for address"},
"account": { "type": "integer", "description": "ID of the account this address belongs to"},
"name": { "type": "string", "description": "User-friendly name of the address"},
"ua": { "type": "string", "description": "Unified address"},
"legacy": { "type": "string", "description": "Legacy Sapling address"},
"transparent": { "type": "string", "description": "Transparent address"}
}
2024-08-08 14:20:35 +00:00
},
"ZcashNote": {
"type": "object",
"properties": {
"txid": { "type": "string", "description": "Transaction ID"},
"pool": { "type": "string", "description": "Orchard, Sapling, or Transparent" },
"amount" : { "type": "number", "description": "The amount of the note in ZEC"},
"amountZats": { "type": "integer", "description": "The amount of the note in zats"},
"memo": { "type": "string", "description": "The memo corresponding to the note, if any"},
"confirmed": { "type": "boolean", "description": "If the note is confirmed per the thresholds in the configuration"},
"blockheight": { "type": "integer", "description": "The block height containing the transaction"},
"blocktime": { "type": "integer", "description": "The transaction time in seconds since epoch"},
"outindex": { "type": "integer", "description": "The Sapling output index, or the Orchard action index"},
"change": { "type": "boolean", "description": "True if this output was received by a change address"}
}
2024-08-15 19:41:10 +00:00
},
"Balance": {
"type": "object",
"properties": {
"transparent": { "type": "integer", "description": "Confirmed transparent balance in zats." },
"sapling": { "type": "integer", "description": "Confirmed Sapling balance in zats." },
"orchard": { "type": "integer", "description": "Confirmed Orchard balance in zats." }
}
2024-09-04 16:08:00 +00:00
},
"Operation": {
"type": "object",
"properties": {
"uuid": {"type": "string", "description": "Operation Identifier"},
"start": {"type": "string", "description": "The date and time the operation started"},
"end": {"type": ["string", "null"], "description": "The date and time the operation ended. If the operation is still running, this field is null"},
"status": {"type": "string", "enum": ["Processing", "Failed", "Successful"], "description": "If the operation has started it will show Processing, once it completes it will show Failed or Successful depending on the outcome"},
2024-09-04 18:10:09 +00:00
"result": {"type": ["string", "null"], "description": "For a succesful transaction operation, the transaction ID. For failed operations, the error message. For pending operations, this field is null."}
2024-09-04 16:08:00 +00:00
}
2024-08-05 17:54:02 +00:00
}
},
"examples": {},
"tags": {
2024-08-08 14:20:35 +00:00
"draft": {"name": "Draft"},
"wip": {"name": "WIP"}
2024-08-05 17:54:02 +00:00
},
"errors": {
"ZebraNotAvailable": {
"code": -32000,
"message": "Zebra not available"
},
"NoWallets": {
"code": -32001,
"message": "No wallets available. Please create one first"
2024-08-05 20:16:03 +00:00
},
"NoAccounts": {
"code": -32002,
"message": "No accounts available. Please create one first"
2024-08-06 21:08:26 +00:00
},
"NoAddress": {
"code": -32003,
"message": "No addresses available for this account. Please create one first"
2024-08-08 14:20:35 +00:00
},
"UnknownAddress": {
"code": -32004,
"message": "Address does not belong to the wallet"
2024-08-15 16:17:24 +00:00
},
"InvalidAddress": {
"code": -32005,
"message": "Unable to parse address"
2024-08-15 19:41:10 +00:00
},
"InvalidAccount": {
"code": -32006,
"message": "Account does not exist."
2024-08-24 12:45:42 +00:00
},
"DuplicateName": {
"code": -32007,
"message": "Entity with that name already exists."
2024-08-26 18:49:00 +00:00
},
"InvalidWallet": {
"code": -32008,
"message": "Wallet does not exist."
2024-08-26 20:25:31 +00:00
},
2024-09-04 14:17:12 +00:00
"OpNotFound": {
"code": -32009,
"message": "Operation ID not found."
},
2024-08-26 20:25:31 +00:00
"InternalError": {
"code": -32010,
"message": "Varies"
2024-08-05 17:54:02 +00:00
}
}
2024-08-03 12:00:12 +00:00
}
}