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
{
2024-08-07 17:10:44 +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
{
2024-08-07 17:10:44 +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
} ,
{
2024-08-07 17:10:44 +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." ,
2024-08-15 16:41:03 +00:00
"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)" ,
2024-09-13 22:20:31 +00:00
"description" : "Send one or more transactions by specifying the source account, the recipient address, the amount, the shielded memo (optional) and the privacy policy (optional)." ,
"tags" : [ { "$ref" : "#/components/tags/draft" } , { "$ref" : "#/components/tags/wip" } ] ,
"params" : [
{ "$ref" : "#/components/contentDescriptors/AccountId" } ,
2024-09-14 13:59:31 +00:00
{ "$ref" : "#/components/contentDescriptors/TxRequestArray" }
2024-09-13 22:20:31 +00:00
] ,
2024-09-14 11:47:18 +00:00
"paramStructure" : "by-position" ,
2024-08-08 14:31:34 +00:00
"result" : {
2024-09-14 11:47:18 +00:00
"name" : "Operation ID(s)" ,
2024-08-08 14:31:34 +00:00
"schema" : {
2024-09-14 11:47:18 +00:00
"type" : "array" ,
"items" : { "$ref" : "#/components/contentDescriptors/OperationId" }
2024-08-08 14:31:34 +00:00
}
2024-09-14 11:47:18 +00:00
} ,
"examples" : [
{
"name" : "Send a transaction" ,
"summary" : "Send one transaction" ,
"description" : "Send a single transaction" ,
"params" : [
{
"name" : "Account index" ,
"summary" : "The index for the account to use" ,
"value" : "1"
} ,
{
"name" : "Transaction request" ,
"summary" : "The transaction to attempt" ,
"value" : [
{
"address" : "utest13dq4u4dnf3yddw8lq2n6zdclshra6xsp8zgkc5ydyu6k20zrsscmuex46qa4vh84rgd78sqnlleapznnz7mnzx9wv0unts8pv32paj8se5ca3kves2u4a89uy6e8cf4hnarxydxh7hq2e9uu39punfmm53k5h45xn9k3dx35la8j7munh9td7774m8gkqgc4mn40t69w20uu2gtks7a" ,
"amount" : 2.45 ,
"memo" : "Simple transaction"
}
]
}
] ,
"result" : {
"name" : "SendMany result" ,
"value" : [
"3cc31c07-07cf-4a6e-9190-156c4b8c4088"
]
}
}
] ,
"errors" : [
{ "$ref" : "#/components/errors/ZebraNotAvailable" } ,
{ "$ref" : "#/components/errors/InvalidRecipient" } ,
{ "$ref" : "#/components/errors/InvalidAccount" }
]
2024-08-07 17:10:44 +00:00
} ,
{
"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-09-13 22:20:31 +00:00
} ,
2024-09-14 13:54:12 +00:00
"TxRequestArray" : {
"name" : "Transaction Request Array" ,
"summary" : "An array of proposed transactions" ,
"description" : "An array of proposed new outgoing transactions, including the recipient's address, the amount in ZEC, the optional shielded memo, and the optional privacy level." ,
2024-09-13 22:20:31 +00:00
"required" : true ,
"schema" : {
2024-09-14 13:54:12 +00:00
"type" : "array" ,
"items" : { "$ref" : "#/components/schemas/TxRequest" }
2024-09-13 22:20:31 +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-09-14 13:54:12 +00:00
} ,
"TxRequest" : {
2024-09-14 14:10:01 +00:00
"type" : "object" ,
"properties" : {
"address" : { "type" : "string" , "description" : "Recipient's address (unified, Sapling or transparent)" } ,
"amount" : { "type" : "number" , "description" : "The amount to send in ZEC" } ,
"memo" : { "type" : "string" , "description" : "The shielded memo to include, if applicable" } ,
2024-09-14 20:30:02 +00:00
"privacy" : { "type" : "string" , "enum" : [ "None" , "Low" , "Medium" , "Full" ] , "description" : "The privacy policy to use for the transaction. `Full` policy allows shielded funds to be transferred within their shielded pools. `Medium` policy allows shielded funds to cross shielded pools and deshielding transactions. `Low` allows to spend transparent funds into shielded pools. `None` allows for transparent funds to be spent to transparent addresses." }
2024-09-14 14:10:01 +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-09-14 11:47:18 +00:00
} ,
"InvalidRecipient" : {
"code" : -32011 ,
"message" : "The provided recipient address is not valid."
2024-08-05 17:54:02 +00:00
}
}
2024-08-03 12:00:12 +00:00
}
}