JSON-RPC methods supported on Zilliqa Mainnet and Zilliqa Testnet through Tatum RPC Gateway, with base URLs and an example request.
Call Zilliqa JSON-RPC methods through Tatum RPC Gateway. Send an HTTP POST request with a JSON-RPC 2.0 body to the network's base URL, with your API key in the x-api-key header. See Authentication.
Base URLs
| Network | Base URL |
|---|---|
| Zilliqa Mainnet | https://zilliqa-mainnet.gateway.tatum.io |
| Zilliqa Testnet | https://zilliqa-testnet.gateway.tatum.io |
Example request
curl 'https://zilliqa-mainnet.gateway.tatum.io' \
--header 'content-type: application/json' \
--header 'x-api-key: {YOUR_API_KEY}' \
--data '{"jsonrpc":"2.0","method":"GetBlockchainInfo","params":[""],"id":1}'Methods
77 methods. Parameters and responses are described in the Zilliqa API reference; linked method names go to their page there.
| Method | Description |
|---|---|
CreateTransaction | Creates a transaction from signed parameters and sends it to the network. |
DSBlockListing | Returns a paginated list of Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value. |
eth_blockNumber | Returns the number of the most recent block. |
eth_call | Executes a message call immediately without creating a transaction on the chain. |
eth_callMany | Executes a list of message calls in sequence on top of a given block, without creating transactions. |
eth_chainId | Returns the chain ID used for signing replay-protected transactions. |
eth_estimateGas | Estimates the gas needed to execute a transaction without adding it to the chain. |
eth_feeHistory | Returns base fees, gas usage ratios and priority fee percentiles for a range of blocks. |
eth_gasPrice | Returns the current gas price in wei. |
eth_getBalance | Returns the balance of an address in wei. |
eth_getBlockByHash | Returns information about a block by hash. |
eth_getBlockByNumber | Returns information about a block by number. |
eth_getBlockTransactionCountByHash | Returns the number of transactions in a block, selected by hash. |
eth_getBlockTransactionCountByNumber | Returns the number of transactions in a block, selected by number. |
eth_getCode | Returns the bytecode at an address. |
eth_getLogs | Returns the logs that match a filter object. |
eth_getProof | Returns the Merkle proof of an account and, optionally, of some of its storage slots. |
eth_getStorageAt | Returns the value of a storage slot at an address. |
eth_getTransactionByBlockHashAndIndex | Returns a transaction by block hash and transaction index. |
eth_getTransactionByBlockNumberAndIndex | Returns a transaction by block number and transaction index. |
eth_getTransactionByHash | Returns a transaction by hash. |
eth_getTransactionCount | Returns the number of transactions sent from an address (its nonce). |
eth_getTransactionReceipt | Returns the receipt of a transaction by transaction hash. |
eth_getUncleByBlockHashAndIndex | Returns an uncle of a block, selected by block hash and uncle index. |
eth_getUncleByBlockNumberAndIndex | Returns an uncle of a block, selected by block number and uncle index. |
eth_getUncleCountByBlockHash | Returns the number of uncles in a block, selected by hash. |
eth_getUncleCountByBlockNumber | Returns the number of uncles in a block, selected by number. |
eth_maxPriorityFeePerGas | Returns a suggested priority fee (tip) per gas in wei. |
eth_sendRawTransaction | Submits a signed, RLP-encoded transaction to the network. |
eth_signTypedData | Signs EIP-712 typed structured data. |
eth_signTypedData_v3 | Signs EIP-712 typed structured data (version 3 of the format). |
eth_syncing | Returns the sync status of the node, or false when it is not syncing. |
GetBalance | Returns the balance and nonce of an account. |
GetBlockchainInfo | Returns current network statistics. |
GetContractAddressFromTransactionID | Returns the address of the contract deployed by a transaction. |
GetCurrentDSComm | Returns the public keys of the Directory Service committee. Deprecated in Zilliqa 2; returns a placeholder value. |
GetCurrentDSEpoch | Returns the current number of Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value. |
GetCurrentMiniEpoch | Returns the current TX block number. |
GetDsBlock | Returns a Directory Service block by block number. Deprecated in Zilliqa 2; returns a placeholder value. |
GetDSBlockRate | Returns the Directory Service block rate per second. Deprecated in Zilliqa 2; returns a placeholder value. |
GetLatestDsBlock | Returns the latest Directory Service block. Deprecated in Zilliqa 2; returns a placeholder value. |
GetLatestTxBlock | Returns the latest TX block. |
GetMinerInfo | Returns the DS committee and shard members for a DS block. Returns placeholder data in Zilliqa 2. |
GetMinimumGasPrice | Returns the minimum gas price in Qa. |
GetNetworkId | Returns the chain ID of the network. |
GetNodeType | Returns the node type. Always returns Seed in Zilliqa 2. |
GetNumDSBlocks | Returns the number of validated Directory Service blocks. Deprecated in Zilliqa 2; returns a placeholder value. |
GetNumPeers | Returns the number of peers of the node. |
GetNumTransactions | Returns the number of validated transactions in the network. |
GetNumTxBlocks | Returns the number of TX blocks in the network. |
GetNumTxnsDSEpoch | Returns the number of transactions in the current DS epoch. Deprecated in Zilliqa 2; returns a placeholder value. |
GetNumTxnsTxEpoch | Returns the number of transactions in the current TX epoch. |
GetPrevDifficulty | Returns the minimum shard difficulty of the previous block. Always returns 0 in Zilliqa 2. |
GetPrevDSDifficulty | Returns the minimum DS difficulty of the previous block. Always returns 0 in Zilliqa 2. |
GetRecentTransactions | Returns up to 100 most recent validated transactions. |
GetShardingStructure | Returns the sharding structure. Not supported in Zilliqa 2. |
GetSmartContractCode | Returns the Scilla or EVM code of a smart contract. |
GetSmartContractInit | Returns the initialization (immutable) parameters of a smart contract. |
GetSmartContracts | Lists the smart contracts deployed by an account. |
GetSmartContractState | Returns the mutable state variables of a Scilla smart contract. |
GetSmartContractSubState | Returns a selected part of the state of a Scilla smart contract. |
GetSoftConfirmedTransaction | Returns a transaction by hash, including soft-confirmed transactions. |
GetStateProof | Returns the state proof of a smart contract. Returns empty values in Zilliqa 2. |
GetTotalCoinSupply | Returns the total ZIL supply. |
GetTransaction | Returns a transaction by hash. |
GetTransactionRate | Returns the current transaction rate per second. |
GetTransactionsForTxBlock | Returns the hashes of the transactions in a TX block. |
GetTransactionsForTxBlockEx | Returns the hashes of the transactions in a TX block, in pages of 2,500. |
GetTransactionStatus | Returns the status of a transaction. |
GetTxBlock | Returns a TX block by block number. |
GetTxBlockRate | Returns the current TX block rate per second. |
GetTxnBodiesForTxBlock | Returns the full transactions in a TX block. |
GetVersion | Returns the software version of the node. |
net_peerCount | Returns the number of peers connected to the client. |
net_version | Returns the current network ID. |
TxBlockListing | Returns a paginated list of TX blocks and their hashes. |
web3_clientVersion | Returns the client version. |
The gateway lists its supported methods at runtime:
Method unavailable?If you need a method we don't support yet, contact support.