zenith/zenith-openrpc.json

{
  "openrpc": "1.0.0-rc1",
  "info": {
    "version": "0.1.0",
    "title": "Zenith RPC",
    "description": "The RPC methods to interact with the Zenith Zcash wallet",
    "license": {
      "name": "MIT"
    }
  },
  "servers": [
    {
      "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",
      "url": "http://localhost:8234"
    }
  ],
  "methods": [
    {
      "name": "getinfo",
      "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",
      "tags": [],
      "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",
      "summary": "Get the list of available wallets",
      "description": "Returns a list of available wallets per the network that the Zebra node is running on.",
      "tags": [],
      "result": {
        "name": "Wallets",
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ZcashWallet"
          }
        }
      },
      "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" }
      ]
    },
    {
      "name": "listaccounts",
      "summary": "List existing accounts for a wallet ID",
      "description": "List existing accounts for the given wallet ID or provide an error if none",
      "tags": [],
      "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": [
              {
                "index": 3,
                "name": "Business",
                "wallet": 1
              },
              {
                "index": 1,
                "name": "Savings",
                "wallet": 1
              }
            ]
          }

        }
      ],
      "errors": [
        { "$ref": "#/components/errors/ZebraNotAvailable" },
        { "$ref": "#/components/errors/NoAccounts" }
      ]
    }
  ],
  "components": {
	  "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"
        }
      }
    },
	  "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" }
        }
      },
      "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"}
        }
      }
    },
	  "examples": {},
    "tags": {
      "draft": {"name": "Draft"}
    },
    "errors": {
      "ZebraNotAvailable": {
        "code": -32000,
        "message": "Zebra not available"
      },
      "NoWallets": {
        "code": -32001,
        "message": "No wallets available. Please create one first"
      },
      "NoAccounts": {
        "code": -32002,
        "message": "No accounts available. Please create one first"
      }
    }
  }
}