JsonRpcRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/derod-org/json-schema/derod-org-json-rpc-request-schema.json",
  "title": "JsonRpcRequest",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/derod-org-openapi.json#/components/schemas/JsonRpcRequest",
  "type": "object",
  "required": [
    "jsonrpc",
    "id",
    "method"
  ],
  "properties": {
    "jsonrpc": {
      "type": "string",
      "enum": [
        "2.0"
      ],
      "description": "JSON-RPC version"
    },
    "id": {
      "type": "string",
      "description": "Request identifier"
    },
    "method": {
      "type": "string",
      "description": "RPC method name",
      "enum": [
        "DERO.Echo",
        "DERO.Ping",
        "DERO.GetInfo",
        "DERO.GetBlock",
        "DERO.GetBlockHeaderByTopoHeight",
        "DERO.GetBlockHeaderByHash",
        "DERO.GetTxPool",
        "DERO.GetRandomAddress",
        "DERO.GetTransaction",
        "DERO.SendRawTransaction",
        "DERO.SubmitBlock",
        "DERO.GetHeight",
        "DERO.GetBlockCount",
        "DERO.GetLastBlockHeader",
        "DERO.GetBlockTemplate",
        "DERO.GetEncryptedBalance",
        "DERO.GetSC",
        "DERO.GetGasEstimate",
        "DERO.NameToAddress",
        "Echo",
        "GetAddress",
        "GetBalance",
        "GetHeight",
        "GetTransferbyTXID",
        "GetTransfers",
        "MakeIntegratedAddress",
        "SplitIntegratedAddress",
        "QueryKey",
        "transfer",
        "scinvoke"
      ]
    },
    "params": {
      "oneOf": [
        {
          "$ref": "#/$defs/GetBlockParams"
        },
        {
          "$ref": "#/$defs/GetSCParams"
        },
        {
          "$ref": "#/$defs/TransferParams"
        },
        {
          "$ref": "#/$defs/SCInvokeParams"
        },
        {
          "$ref": "#/$defs/GetEncryptedBalanceParams"
        },
        {
          "$ref": "#/$defs/GetGasEstimateParams"
        },
        {
          "$ref": "#/$defs/NameToAddressParams"
        },
        {
          "$ref": "#/$defs/GetTransfersParams"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    }
  },
  "$defs": {
    "Argument": {
      "type": "object",
      "description": "RPC argument for SC calls",
      "required": [
        "name",
        "datatype",
        "value"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Argument name"
        },
        "datatype": {
          "type": "string",
          "enum": [
            "S",
            "U",
            "H"
          ],
          "description": "Data type: S=String, U=Uint64, H=Hash"
        },
        "value": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "integer"
            }
          ],
          "description": "Argument value"
        }
      }
    },
    "GetBlockParams": {
      "type": "object",
      "description": "Parameters for DERO.GetBlock",
      "properties": {
        "hash": {
          "type": "string",
          "description": "Block hash (hex string)"
        },
        "height": {
          "type": "integer",
          "description": "Block height"
        }
      }
    },
    "GetEncryptedBalanceParams": {
      "type": "object",
      "description": "Parameters for DERO.GetEncryptedBalance",
      "required": [
        "address",
        "topoheight"
      ],
      "properties": {
        "address": {
          "type": "string",
          "description": "DERO address (starts with deto1)"
        },
        "topoheight": {
          "type": "integer",
          "description": "Topo height (-1 for latest)"
        },
        "scid": {
          "type": "string",
          "description": "Asset SCID (optional, defaults to native DERO)"
        }
      }
    },
    "GetGasEstimateParams": {
      "type": "object",
      "description": "Parameters for DERO.GetGasEstimate",
      "properties": {
        "transfers": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Transfer"
          }
        },
        "sc": {
          "type": "string",
          "description": "Smart contract code to deploy"
        },
        "sc_rpc": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Argument"
          },
          "description": "SC call arguments"
        },
        "signer": {
          "type": "string",
          "description": "Signer address for estimation"
        }
      }
    },
    "GetSCParams": {
      "type": "object",
      "description": "Parameters for DERO.GetSC (Get Smart Contract)",
      "required": [
        "scid"
      ],
      "properties": {
        "scid": {
          "type": "string",
          "description": "Smart Contract ID (64-character hex string)"
        },
        "code": {
          "type": "boolean",
          "description": "Include contract source code"
        },
        "variables": {
          "type": "boolean",
          "description": "Include all stored variables"
        },
        "topoheight": {
          "type": "integer",
          "description": "Query at specific topo height (-1 for latest)"
        },
        "keysuint64": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "Specific uint64 keys to retrieve"
        },
        "keysstring": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Specific string keys to retrieve"
        }
      }
    },
    "GetTransfersParams": {
      "type": "object",
      "description": "Parameters for GetTransfers (Wallet RPC)",
      "properties": {
        "scid": {
          "type": "string",
          "description": "Filter by asset SCID"
        },
        "coinbase": {
          "type": "boolean",
          "description": "Include coinbase transactions"
        },
        "in": {
          "type": "boolean",
          "description": "Include incoming transfers"
        },
        "out": {
          "type": "boolean",
          "description": "Include outgoing transfers"
        },
        "min_height": {
          "type": "integer",
          "description": "Minimum block height"
        },
        "max_height": {
          "type": "integer",
          "description": "Maximum block height"
        },
        "sender": {
          "type": "string",
          "description": "Filter by sender address"
        },
        "receiver": {
          "type": "string",
          "description": "Filter by receiver address"
        }
      }
    },
    "NameToAddressParams": {
      "type": "object",
      "description": "Parameters for DERO.NameToAddress",
      "required": [
        "name",
        "topoheight"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Registered name to look up"
        },
        "topoheight": {
          "type": "integer",
          "description": "Topo height (-1 for latest)"
        }
      }
    },
    "SCInvokeParams": {
      "type": "object",
      "description": "Parameters for scinvoke (Smart Contract Invoke)",
      "required": [
        "scid",
        "sc_rpc"
      ],
      "properties": {
        "scid": {
          "type": "string",
          "description": "Smart Contract ID to call"
        },
        "sc_rpc": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Argument"
          },
          "description": "SC call arguments including entrypoint"
        },
        "sc_dero_deposit": {
          "type": "integer",
          "description": "DERO to deposit (atomic units)"
        },
        "sc_token_deposit": {
          "type": "integer",
          "description": "Token to deposit (atomic units)"
        },
        "ringsize": {
          "type": "integer",
          "description": "Ring size for privacy"
        }
      }
    },
    "Transfer": {
      "type": "object",
      "description": "A single transfer destination",
      "properties": {
        "scid": {
          "type": "string",
          "description": "Asset SCID (0x00...00 for native DERO)"
        },
        "destination": {
          "type": "string",
          "description": "Recipient DERO address"
        },
        "amount": {
          "type": "integer",
          "description": "Amount in atomic units (1 DERO = 100000)"
        },
        "burn": {
          "type": "integer",
          "description": "Amount to burn"
        },
        "payload_rpc": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Argument"
          }
        }
      }
    },
    "TransferParams": {
      "type": "object",
      "description": "Parameters for transfer (Wallet RPC)",
      "properties": {
        "transfers": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Transfer"
          }
        },
        "ringsize": {
          "type": "integer",
          "description": "Ring size for privacy (2-128, powers of 2)",
          "minimum": 2,
          "maximum": 128
        },
        "fees": {
          "type": "integer",
          "description": "Transaction fees in atomic units"
        }
      }
    }
  }
}