Kava
Kava API is available on Web3 API platform (opens in a new tab).
The Kava Network is the Layer-1 blockchain that combines the speed and scalability of the Cosmos SDK with the developer support of Ethereum. Kava will empower developers to build for Web3 and next-gen blockchain technologies through its unique co-chain architecture. KAVA is the native governance and staking token of the Kava Network, enabling its decentralization and security.
In order for your Web3 application to interact with Kava — either by reading blockchain data or sending transactions to the network — it must connect to a Kava node. Developers interact with the blockchain using the methods provided by the API.
We support the following networks and protocols for Kava:
Responses come in JSON format (opens in a new tab).
EVM JSON-RPC methods
web3_clientVersion
— returns the current client version.web3_sha3
— returns Keccak-256 (not the standardized SHA3-256) of the given data.net_version
— returns the current network ID.net_listening
— returns true if client is actively listening for network connections.eth_protocolVersion
— returns the current protocol version.eth_syncing
— returns data on the sync status or false.eth_gasPrice
— returns the current price per gas in wei.eth_accounts
— returns a list of addresses owned by client.eth_blockNumber
— returns the number of most recent block.eth_getBalance
— returns the balance of the account specified by address.eth_getStorageAt
— returns the value from a storage position at an address specified.eth_getTransactionCount
— returns the number of transactions sent from an address.eth_getBlockTransactionCountByHash
— returns the number of transactions in a block specified by block hash.eth_getBlockTransactionCountByNumber
— returns the number of transactions in the block specified by number.eth_getUncleCountByBlockHash
— returns the number of uncles in a block specified by block hash.eth_getUncleCountByBlockNumber
— returns the number of uncles in a block specified by block number.eth_getCode
— returns code at an address specified.eth_sendRawTransaction
— creates a new message call transaction or a contract creation for signed transactions.eth_call
— executes a new message call immediately without creating a transaction on the blockchain.eth_estimateGas
— generates and returns an estimate of how much gas is necessary to allow the transaction to complete.eth_getBlockByHash
— returns information for the block specified by block hash.eth_getBlockByNumber
— returns information for the block specified by block number.eth_getTransactionByHash
— returns information on a transaction specified by transaction hash.eth_getTransactionByBlockHashAndIndex
— returns information on a transaction specified by block hash and transaction index position.eth_getTransactionByBlockNumberAndIndex
— returns information on a transaction by block number and transaction index position.eth_getTransactionReceipt
— returns the receipt of a transaction by transaction hash.eth_getUncleByBlockHashAndIndex
— returns information about an uncle of a block by hash and uncle index position.eth_getUncleByBlockNumberAndIndex
— returns information about an uncle of a block by number and uncle index position.eth_getLogs
— returns logs matching the parameters specified.
web3_clientVersion
Returns the current client version.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<string>
: the current client version.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "web3_clientVersion",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "Version dev ()Compiled at using Go go1.21.1 (amd64)"
}
web3_sha3
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data): the data to convert into a SHA3 hash.
Returns
<string>
(data): the SHA3 result of the given string.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "web3_sha3",
"params": ["0x68656c6c6f20776f726c64"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5b2c76da96136d193336fad3fbc049867b8ca157da22f69ae0e4923648250acc"
}
net_version
Returns the current network ID.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<string>
: the current network ID.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "net_version",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "2222"
}
net_listening
Returns
true
if client is actively listening for network connections.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<boolean>
:true
when listening, otherwisefalse
.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "net_listening",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
eth_protocolVersion
Returns the current Ethereum protocol version.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<string>
: the current Ethereum protocol version.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_protocolVersion",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"result": "0x41",
"id": 1
}
eth_syncing
Returns an object with data about the sync status or false.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<object>
|<boolean>
: an object with sync status data orfalse
, when not syncing:startingBlock
(quantity): the block at which the import started (will only be reset, after the sync reached its head).currentBlock
(quantity): the current block, same aseth_blockNumber
.highestBlock
(quantity): the estimated highest block.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": [],
"id": 1
}'
Response example (syncing)
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"startingBlock": "0x384",
"currentBlock": "0x386",
"highestBlock": "0x454"
}
}
Response example (not syncing)
{
"jsonrpc": "2.0",
"id": 1,
"result": false
}
eth_gasPrice
Returns the current price per gas in wei.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<string>
(quantity): the current gas price in wei.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x3b9aca00"
}
eth_accounts
Returns a list of addresses owned by client.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<array>
(string; data, 20 bytes): addresses owned by the client.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": [],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": [
"0x407d73d8a49eeb85d32cf465507dd71d507100c1"
]
}
eth_blockNumber
Returns the number of most recent block.
Parameters
id
(integer; required): a request ID (example: 1).jsonrpc
(string; required): a JSON RPC spec used (example: 2.0).method
(string; required): a method used for the request.params
(array; required): None.
Returns
<string>
(quantity): the current block number the client is on.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": [],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x847e09"
}
eth_getBalance
Returns the balance of the account specified by address.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 20 bytes): an address to check for balance.<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
Returns
<string>
(quantity): the current balance in wei.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": ["0xCe292495Ac1166215eA02f1616900F90B3C20762", "latest"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x594c67b5408f"
}
eth_getStorageAt
Returns the value from a storage position at an address specified.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):-
<string>
(data, 20 bytes): an address of the storage (hex encoded). -
<string>
(quantity): a slot position in the storage (hex encoded unsigned integer). -
<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
-
Returns
<string>
(data): the value at this storage position.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": ["0xCe292495Ac1166215eA02f1616900F90B3C20762", "0x0", "latest"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
eth_getTransactionCount
Returns the number of transactions sent from an address.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):-
<string>
(data, 20 bytes): an address. -
<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
-
Returns
<string>
(quantity): the number of transactions send from this address.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": ["0xB8FF877ed78Ba520Ece21B1de7843A8a57cA47Cb", "latest"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x26db1d"
}
eth_getBlockTransactionCountByHash
Returns the number of transactions in a block specified by block hash.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): a block hash.
Returns
<string>
(quantity): the number of transactions in this block.
Request example:
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": ["0x004e9007f85b0931df490262b1605837596c8e622e981282123eb949564f4a5e"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xe"
}
eth_getBlockTransactionCountByNumber
Returns the number of transactions in the block specified by number.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
Returns
<string>
(quantity): the number of transactions in this block.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": ["0x847E17"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0xa"
}
eth_getUncleCountByBlockHash
Returns the number of uncles in a block specified by block hash.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): a block hash.
Returns
<string>
(quantity): the number of uncles in this block.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": ["0x2e0fde25135f358272f79f9c370b8934b4524e87bd8e04aad8a42d4fc4003c2c"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
eth_getUncleCountByBlockNumber
Returns the number of uncles in a block specified by block number.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
Returns
<string>
(quantity): the number of uncles in this block.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": ["0x847E12"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x0"
}
eth_getCode
Returns code at a given address.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 20 bytes): an address to get the code from.<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
Returns
<string>
(data): the code from the given address.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": ["0x2a6b5109F48A5d50D82f618500237a70608fc9b2", "latest"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
eth_sendRawTransaction
Creates new message call transaction or a contract creation for signed transactions.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data): the signed transaction data.
Returns
<string>
(data, 32 bytes): the transaction hash, or the zero hash if the transaction is not yet available.
Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_sendRawTransaction",
"params": ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
eth_call
Executes a new message call immediately without creating a transaction on the blockchain.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):-
<object>
(hex encoded): the transaction object:from
(string; data, 20 bytes; optional): the address the transaction is sent from.to
(string; data, 20 bytes): the address the transaction is directed to.gas
(string; quantity; optional): the gas provided for the transaction execution.eth_call
consumes zero gas, but this parameter may be needed by some executions.gasPrice
(string; quantity; optional): the gas price willing to be paid by the sender in wei.value
(string; quantity; optional): the value sent with this transaction, in wei.data
(string; data; optional): the hash of the method signature and encoded parameters.
-
<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
-
Returns
<string>
(hex encoded bytes): the return value of executed contract.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_call",
"params": [{"from":null,"to":"0xE0c865f883cbF9A2be65fFa03B7330013faD9BFe","data":"0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"}, "latest"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x"
}
eth_estimateGas
Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.
The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):-
<object>
(hex encoded): the transaction object:from
(string; data, 20 bytes; optional): the address the transaction is sent from.to
(string; data, 20 bytes; optional): the address the transaction is directed to.gas
(string; quantity; optional): the gas provided for the transaction execution.eth_call
consumes zero gas, but this parameter may be needed by some executions.gasPrice
(string; quantity; optional): the gas price willing to be paid by the sender in wei.value
(string; quantity; optional): the value sent with this transaction, in wei.data
(string; data; optional): the hash of the method signature and encoded parameters.
-
<string>
(quantity|tag; optional): either a HEX value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
-
Returns
<string>
(quantity): the amount of gas used.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [{"to":"0xE0c865f883cbF9A2be65fFa03B7330013faD9BFe"}],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x5208"
}
eth_getBlockByHash
Returns information for the block specified by block hash.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): the block hash.<boolean>
: iftrue
it returns the full transaction objects, iffalse
— only the hashes of the transactions.
Returns
<object>
: a block object, or null when no block was found:number
(string; quantity): the block number; null when it's a pending block.hash
(string; data, 32 bytes): the hash of the block; null when it's a pending block.parentHash
(string; data, 32 bytes): the hash of the parent block.nonce
(string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.sha3Uncles
(string; data, 32 bytes): SHA3 of the uncles data in the block.logsBloom
(string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.transactionsRoot
(string; data, 32 bytes): the root of the transaction trie of the block.stateRoot
(string; data, 32 bytes): the root of the final state trie of the block.receiptsRoot
(string; data, 32 bytes): the root of the receipts trie of the block.miner
(string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.difficulty
(string; quantity): the difficulty for this block.totalDifficulty
(string; quantity): the total difficulty of the chain until this block.extraData
(string; data): the extra data field of this block.size
(string; quantity): the size of this block in bytes.gasLimit
(string; quantity): the maximum gas allowed in this block.gasUsed
(string; quantity): the total used gas by all transactions in this block.timestamp
(string; quantity): the unix timestamp for when the block was collated.transactions
(array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.uncles
(array of strings): an array of uncle hashes.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": ["0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982", false],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x1312d00",
"gasUsed": "0x2df97f",
"hash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"logsBloom": "0x0000000000000008000000200000008040004210000000000000000300000000000400004000100000000000000000008000020200002000000002000000200000004000000080080000000c0000120000000000000a000010010000000200200500000000000200004400050002100000000800000800002000001000080000000008000000000500000000000400000080100000000000000000000000020101000000108008000400000005111000000a000002000001000022000000000080000002000110030000000000100001000000200000001000010080000200000000010000000000000000000000004848000040008000000000000100000000",
"miner": "0x97eaafa954a6a848df656eebb24637921a2fe798",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x0000000000000000",
"number": "0x847e9a",
"parentHash": "0x7623510c31da52597f81b30cf8e3a0749b602c4864a0c97f1c76f01e7ac3e987",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x4fe3",
"stateRoot": "0xb6fe6a8fce0b84d2626c8abcb10fb9a63ff854cc4295e413d96028dcb664bfa4",
"timestamp": "0x65d61a21",
"totalDifficulty": "0x0",
"transactions": [
"0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"0x17828d77a6a9326a60ab7faf56b6ecc66f0cc9ce48c7543baab4f7141dfa6764",
"0x79c18d30a4e3a408658938dc6a811f2cacaac3d8e2a5149ecb1f65a89c6ddfaa",
"0xa50fa76c06a6c2700574d33987f9a6fd6bc06b9a042def2b60eccc9208b1a5bf",
"0x0ac7d63724960562ceda4bf5a9ae993a9200c8603dcc13413079ac44a8ed074b",
"0x2ebf3882bcefdc95062b6af242c29397f26d4dae412a6ba7d86efaaf308d4612",
"0x4ad4332e4df2e152145d67ba5fc4effc0a20d387f4efb1cedfe00aa727734684",
"0xfa00db04008f003927619ddfc32f8f6278a9da60fc7f8d163bfae1e15d5e0977"
],
"transactionsRoot": "0xdb6581a769bf9079e51815bde8b23f2b9196c22795630c638a9446181951e769",
"uncles": []
}
}
eth_getBlockByNumber
Returns information for the block specified by block number.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
<boolean>
: iftrue
it returns the full transaction objects, iffalse
— only the hashes of the transactions.
Returns
<object>
: a block object, or null when no block was found:number
(string; quantity): the block number; null when it's a pending block.hash
(string; data, 32 bytes): the hash of the block; null when it's a pending block.parentHash
(string; data, 32 bytes): the hash of the parent block.nonce
(string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.sha3Uncles
(string; data, 32 bytes): SHA3 of the uncles data in the block.logsBloom
(string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.transactionsRoot
(string; data, 32 bytes): the root of the transaction trie of the block.stateRoot
(string; data, 32 bytes): the root of the final state trie of the block.receiptsRoot
(string; data, 32 bytes): the root of the receipts trie of the block.miner
(string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.difficulty
(string; quantity): the difficulty for this block.totalDifficulty
(string; quantity): the total difficulty of the chain until this block.extraData
(string; data): the extra data field of this block.size
(string; quantity): the size of this block in bytes.gasLimit
(string; quantity): the maximum gas allowed in this block.gasUsed
(string; quantity): the total used gas by all transactions in this block.timestamp
(string; quantity): the unix timestamp for when the block was collated.transactions
(array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.uncles
(array of strings): an array of uncle hashes.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": ["latest", false],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x1312d00",
"gasUsed": "0x7f36a",
"hash": "0x95d062cb1fcf6e0a45057a7616ea08fa0c9d9f2e517d96139585af7dca1d8e00",
"logsBloom": "0x00000000000000000000000000000000000002000000000000000000000000040000000001000000000000000000008000000000000000000000000000080000000000000800000000100000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000002000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000",
"miner": "0x4a71c949f46694a7e306ee80d98451954f343d55",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x0000000000000000",
"number": "0x847ed0",
"parentHash": "0x126760ff1767c68c03d593d829fab7c4488659dac7a508f5c9a7c720bbd198ff",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x2fe6",
"stateRoot": "0xa40bebeedfdbf3638ad7c9bfe00fe5c7c9b02d15a3da33ee090ffca870319933",
"timestamp": "0x65d61b73",
"totalDifficulty": "0x0",
"transactions": [
"0xbafa2fba29f6ad040ef2516db914d0f86c6d5a383fbad6ffa1b6263590a3dfa3"
],
"transactionsRoot": "0x957d70dc0b699470a00a5cc1a7a92c0107bf91132fb92aecda98eda820d82742",
"uncles": []
}
}
eth_getTransactionByHash
Returns information on a transaction specified by transaction hash.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): a transaction hash.
Returns
blockHash
(string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.blockNumber
(string; quantity): a number of the block containing the transaction; null when it's pending.from
(string; data, 20 bytes): an address of the sender.gas
(string; quantity): the gas provided by the sender.gasPrice
(string; quantity): the gas price provided by the sender in wei.hash
(string; data, 32 bytes): the hash of the transaction.input
(string; data): the data send along with the transaction.nonce
(string; quantity): the number of transactions made by the sender prior to this one.to
(string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.transactionIndex
(string; quantity): the transaction index position in the block; null when it's pending.value
(string; quantity): the value transferred in wei.v
(string; quantity): ECDSA recovery ID.r
(string; quantity): ECDSA signature r.s
(string; quantity): ECDSA signature s.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": ["0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"blockNumber": "0x847e9a",
"from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
"gas": "0xaae60",
"gasPrice": "0x3b9aca00",
"hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
"nonce": "0x30721",
"to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x0",
"chainId": "0x8ae",
"v": "0x117f",
"r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
"s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
}
}
eth_getTransactionByBlockHashAndIndex
Returns information on a transaction specified by block hash and transaction index position.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): a block hash.<string>
(quantity): a transaction index position.
Returns
blockHash
(string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.blockNumber
(string; quantity): a number of the block containing the transaction; null when it's pending.from
(string; data, 20 bytes): an address of the sender.gas
(string; quantity): the gas provided by the sender.gasPrice
(string; quantity): the gas price provided by the sender in wei.hash
(string; data, 32 bytes): the hash of the transaction.input
(string; data): the data send along with the transaction.nonce
(string; quantity): the number of transactions made by the sender prior to this one.to
(string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.transactionIndex
(string; quantity): the transaction index position in the block; null when it's pending.value
(string; quantity): the value transferred in wei.v
(string; quantity): ECDSA recovery ID.r
(string; quantity): ECDSA signature r.s
(string; quantity): ECDSA signature s.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": ["0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982", "0x0"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"blockNumber": "0x847e9a",
"from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
"gas": "0xaae60",
"gasPrice": "0x3b9aca00",
"hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
"nonce": "0x30721",
"to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x0",
"chainId": "0x8ae",
"v": "0x117f",
"r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
"s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
}
}
eth_getTransactionByBlockNumberAndIndex
Returns information on a transaction by block number and transaction index position.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(quantity|tag): either the hex value of a block number or one of the following block tags:earliest
: the lowest numbered block available on the client.finalized
: the most recent crypto-economically secure block; cannot be re-orged outside of manual intervention driven by community coordination.safe
: the most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions.latest
: the most recent block in the canonical chain observed by the client; this block can be re-orged out of the canonical chain even under healthy/normal conditions.pending
: a sample next block built by the client on top of thelatest
and containing the set of transactions usually taken from local mempool. In other words, it is the block that has not been mined yet.
<string>
(quantity): the transaction index position.
Returns
blockHash
(string; data, 32 bytes): a hash of the block containing the transaction; null when it's pending.blockNumber
(string; quantity): a number of the block containing the transaction; null when it's pending.from
(string; data, 20 bytes): an address of the sender.gas
(string; quantity): the gas provided by the sender.gasPrice
(string; quantity): the gas price provided by the sender in wei.hash
(string; data, 32 bytes): the hash of the transaction.input
(string; data): the data send along with the transaction.nonce
(string; quantity): the number of transactions made by the sender prior to this one.to
(string: data, 20 bytes): an address of the receiver: null when it's a contract creation transaction.transactionIndex
(string; quantity): the transaction index position in the block; null when it's pending.value
(string; quantity): the value transferred in wei.v
(string; quantity): ECDSA recovery ID.r
(string; quantity): ECDSA signature r.s
(string; quantity): ECDSA signature s.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": ["0x847E9A", "0x0"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"blockNumber": "0x847e9a",
"from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
"gas": "0xaae60",
"gasPrice": "0x3b9aca00",
"hash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"input": "0x06c429e5000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca0000000000000000000000001a35ee4640b0a3b87705b0a4b45d227ba60ca2ad000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000919c1c267bc06a7039e03fcc2ef738525769109c000000000000000000000000b829b68f57cc546da7e5806a929e53be32a4625d00000000000000000000000000000000000000000000000000000000000001f400000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e000000000000000000000000c8f22018d3c5f5a4101fb1448d5e5ccdda4f123e",
"nonce": "0x30721",
"to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x0",
"chainId": "0x8ae",
"v": "0x117f",
"r": "0x83f5313d2a434f05435a02000f310fa2690f8b936353e233935bfc7ad8a6091c",
"s": "0x7b0a065c45e00b5280906c31d75309588d15cca0c9e124052119f2d43b809fbe"
}
}
eth_getTransactionReceipt
Returns the receipt of a transaction by transaction hash.
The receipt is not available for pending transactions.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): a hash of the transaction.
Returns
-
object
: a transaction receipt object, or null when no receipt was found:-
transactionHash
(string; data, 32 bytes): a hash of the transaction. -
transactionIndex
(string; quantity): the transactions index position in the block. -
blockHash
(string; data, 32 bytes): a hash of the block containing the transaction. -
blockNumber
(string; quantity): a number of the block containing the transaction. -
from
(string; data, 20 bytes): an address of the sender. -
to
(string; data, 20 bytes): an address of the receiver; null when it's a contract creation transaction. -
cumulativeGasUsed
(string; quantity): the total amount of gas used when this transaction was executed in the block. -
effectiveGasPrice
(string; quantity): the sum of the base fee and tip paid per unit of gas. -
gasUsed
(string; quantity): the amount of gas used by this specific transaction alone. -
contractAddress
(string; data, 20 bytes): the contract address created, if the transaction was a contract creation, otherwise null. -
logs
(array): an array of log objects, which this transaction generated. -
logsBloom
(string; data, 256 bytes): a bloom filter for light clients to quickly retrieve related logs. -
type
(string; data): the transaction type,0x00
for legacy transactions,0x01
for access list types,0x02
for dynamic fees. It also returns either of the following:root
(string; data, 32 bytes): a post-transaction stateroot (pre Byzantium).status
(string; quantity): either 1 (success) or 0 (failure).
-
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": ["0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"blockNumber": "0x847e9a",
"contractAddress": null,
"cumulativeGasUsed": "0x55730",
"from": "0x5819dbc374754c027e83bd6b1e14085ae5ce2bfa",
"gasUsed": "0x55730",
"logs": [
{
"address": "0x1a35ee4640b0a3b87705b0a4b45d227ba60ca2ad",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000a11df70789c4fe546fe347f2a9705f6fccbc05ca",
"0x0000000000000000000000001c253ea05445a44f3d1a273a11ed498825a58228"
],
"data": "0x0000000000000000000000000000000000000000000000000000000000002609",
"blockNumber": "0x847e9a",
"transactionHash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"transactionIndex": "0x0",
"blockHash": "0xe81063de7bb3c4703824d5d5f39bfcbe42ca21bbe9552912e83fbfc69b456982",
"logIndex": "0x0",
"removed": false
}
],
"logsBloom": "0x00000000000000000000000000000080400040100000000000000001000000000004000040001000000000000000000000000200000020000000000000000000000000000000800800000008000000000000000000080000000000000000002001000000000000000000000100021000000008000000000020000010000800000000080000000000000000000004000000001000000000000000000000000001000000000080080000000000041000000000000002000000000002000000000000000002000100020000000000000001000000200000000000000080000200000000010000000000000000000000000800000000000000000000000000000000",
"status": "0x1",
"to": "0x1c253ea05445a44f3d1a273a11ed498825a58228",
"transactionHash": "0x504404e952225959c573209df9313437694b1256073b14d08201a89fe279e8a4",
"transactionIndex": "0x0",
"type": "0x0"
}
}
eth_getUncleByBlockHashAndIndex
Returns information about an uncle of a block by hash and uncle index position.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(data, 32 bytes): the hash of a block.<string>
(quantity): the uncle's index position.
Returns
<object>
: a block object, or null when no block was found:number
(string; quantity): the block number; null when it's a pending block.hash
(string; data, 32 bytes): the hash of the block; null when it's a pending block.parentHash
(string; data, 32 bytes): the hash of the parent block.nonce
(string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.sha3Uncles
(string; data, 32 bytes): SHA3 of the uncles data in the block.logsBloom
(string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.transactionsRoot
(string; data, 32 bytes): the root of the transaction trie of the block.stateRoot
(string; data, 32 bytes): the root of the final state trie of the block.receiptsRoot
(string; data, 32 bytes): the root of the receipts trie of the block.miner
(string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.difficulty
(string; quantity): the difficulty for this block.totalDifficulty
(string; quantity): the total difficulty of the chain until this block.extraData
(string; data): the extra data field of this block.size
(string; quantity): the size of this block in bytes.gasLimit
(string; quantity): the maximum gas allowed in this block.gasUsed
(string; quantity): the total used gas by all transactions in this block.timestamp
(string; quantity): the unix timestamp for when the block was collated.transactions
(array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.uncles
(array of strings): an array of uncle hashes.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": ["0x7eb6de38b5996d4d3568a84f6fb8e54069d23d36aa00c7dac3798e5deb164a23", "0x0"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difficulty": "0x4ea3f27bc",
"extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
"gasLimit": "0x1388",
"gasUsed": "0x0",
"hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
"mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
"nonce": "0x689056015818adbe",
"number": "0x1b4",
"parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x220",
"stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
"timestamp": "0x55ba467c",
"totalDifficulty": "0x78ed983323d",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
}
}
eth_getUncleByBlockNumberAndIndex
Returns information about an uncle of a block by number and uncle index position.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):<string>
(quantity|tag): the hex value of a block number.<string>
(quantity): the uncle's index position.
Returns
<object>
: a block object, or null when no block was found:number
(string; quantity): the block number; null when it's a pending block.hash
(string; data, 32 bytes): the hash of the block; null when it's a pending block.parentHash
(string; data, 32 bytes): the hash of the parent block.nonce
(string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.sha3Uncles
(string; data, 32 bytes): SHA3 of the uncles data in the block.logsBloom
(string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.transactionsRoot
(string; data, 32 bytes): the root of the transaction trie of the block.stateRoot
(string; data, 32 bytes): the root of the final state trie of the block.receiptsRoot
(string; data, 32 bytes): the root of the receipts trie of the block.miner
(string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.difficulty
(string; quantity): the difficulty for this block.totalDifficulty
(string; quantity): the total difficulty of the chain until this block.extraData
(string; data): the extra data field of this block.size
(string; quantity): the size of this block in bytes.gasLimit
(string; quantity): the maximum gas allowed in this block.gasUsed
(string; quantity): the total used gas by all transactions in this block.timestamp
(string; quantity): the unix timestamp for when the block was collated.transactions
(array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.uncles
(array of strings): an array of uncle hashes.
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": ["0x258C44", "0x0"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difficulty": "0x57f117f5c",
"extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32",
"gasLimit": "0x1388",
"gasUsed": "0x0",
"hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc",
"mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169",
"nonce": "0x24732773618192ac",
"number": "0x299",
"parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x21d",
"stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec",
"timestamp": "0x55ba4827",
"totalDifficulty": "0xc46826a2c6a",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": []
}
}
eth_getLogs
Returns an array of all logs matching a given filter object.
Parameters
-
id
(integer; required): a request ID (example: 1). -
jsonrpc
(string; required): a JSON RPC spec used (example: 2.0). -
method
(string; required): a method used for the request. -
params
(array; required):-
object
: the filter options:-
fromBlock
(string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:latest
: for the last mined block.earliest
: for the lowest numbered block available on the client.pending
: for not yet mined transactions.
-
toBlock
(string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:latest
: for the last mined block.earliest
: for the lowest numbered block available on the client.pending
: for not yet mined transactions.
-
address
(array of strings; data, 20 bytes; optional): a contract address or a list of addresses from which logs should originate. -
topics
(array of strings; data; optional): an array of 32 bytes data topics. Topics are order-dependent. Each topic can also be an array of data with "or" options. -
blockhash
(string; data, 32 bytes; optional; future): with the addition of EIP-234,blockHash
will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent tofromBlock = toBlock = the block
number with hash blockHash. IfblockHash
is present in the filter criteria, then neitherfromBlock
nortoBlock
are allowed.
-
-
Returns
removed
(string; tag):true
when the log was removed, due to a chain reorganization;false
if it's a valid log.logIndex
(string; quantity): the log index position in the block; null when it's a pending log.transactionIndex
(string; quantity): the transactions index position log was created from; null when it's a pending log.transactionHash
(string; data, 32 bytes): a hash of the transactions this log was created from; null when it's a pending log.blockHash
(string; data, 32 bytes): a hash of the block containing the log; null when it's pending; null when it's a pending log.blockNumber
(string; quantity): the number of the block containing the log; null when it's pending; null when it's a pending log.address
(string; data, 20 bytes): an address from which this log originated.data
(string; data): contains one or more 32 bytes non-indexed arguments of the log.topics
(array of strings; data): an array of 0 to 4 32 bytes data of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.)
Request example
curl -X POST https://rpc.ankr.com/kava_evm \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [{"address": "0x2BCfE12a949267e3Da5874E44554b29FA4B753E6"}],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000009acbb72cf67103a30333a32cd203459c6a9c3311",
"0x000000000000000000000000994871e1103c5da4be270365fa62771ea4525520"
],
"data": "0x000000000000000000000000000000000000000000000000000000001ec39aa0",
"blockNumber": "0xf6289d",
"transactionHash": "0xc7ed73c9b219d4243872e5993ad2950c8ea87d15af28562d33b0c05d46a90cee",
"transactionIndex": "0x1e",
"blockHash": "0x1e12377f0357320c0e5cfcadc2dfbc9c75fc339be668e118c34e4333f835ef31",
"logIndex": "0x13",
"removed": false
},
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000005879975799597392c031f10b6eff282cb7974ac8",
"0x0000000000000000000000006d52ab66340f3f78d0c1007bec484268876b5948"
],
"data": "0x0000000000000000000000000000000000000000000000000000000000000000",
"blockNumber": "0xf6289d",
"transactionHash": "0x0118499f7be4c3510bd60fe3a3aee5f5f316743b6cc13a8cb0528d784f962aec",
"transactionIndex": "0x20",
"blockHash": "0x1e12377f0357320c0e5cfcadc2dfbc9c75fc339be668e118c34e4333f835ef31",
"logIndex": "0x14",
"removed": false
}
]
}
Tendermint JSON-RPC/REST methods
Info — node information:
blockchain
— retrieves block headers (max: 20) forminHeight <= height <= maxHeight
.block
— retrieves a block at a specified height.block_by_hash
— retrieves a block by hash.block_results
— retrieves block results at a specified height.commit
— retrieves commit results at a specified height.validators
— retrieves a validator set at a specified height.genesis_chunked
— retrieves the Genesis in multiple chunks.dump_consensus_state
— retrieves consensus state.consensus_state
— retrieves consensus state.consensus_params
— retrieves consensus parameters.unconfirmed_txs
— retrieves the list of unconfirmed transactions.num_unconfirmed_txs
— retrieves data about unconfirmed transactions.tx_search
— searches for transactions.block_search
— searches for blocks byBeginBlock
andEndBlock
events.tx
— retrieves transactions by hash.
Tx — transactions broadcast information:
broadcast_tx_sync
— returns with the response fromCheckTx
. Does not wait forDeliverTx
result.broadcast_tx_async
— returns right away, with no response. Does not wait forCheckTx
norDeliverTx
results.broadcast_tx_commit
— returns with the responses fromCheckTx
andDeliverTx
.check_tx
— checks the transaction without executing it.
ABCI — ABCI info:
abci_info
— retrieves info about the application.abci_query
— queries the application for some information.
Information
blockchain
Retrieves block headers for
minHeight <= height <= maxHeight
.
At most 20 items will return for the minHeight
or maxHeight
parameters specified. If maxHeight
does not yet exist, the blocks up to the current height will return. If minHeight
does not exist (pruning), the earliest existing height will be used.
Parameters
minHeight
(integer): the minimum block height to return.maxHeight
(integer): the maximum block height to return.
Returns
Block headers, in descending order (highest first).
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "blockchain",
"params": ["1", "2"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"last_height": "13211309",
"block_metas": [
{
"block_id": {
"hash": "606AA3A0B325273C27FCD254D528DCCB968351ECF4C045920517A5269D76DB4E",
"parts": {
"total": 1,
"hash": "8B827E255B0EFF6D3D66315F9460D180D7A1988A5281DE11699CE204A0308E79"
}
},
"block_size": "6590",
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "2",
"time": "2022-05-25T18:39:32.196946927Z",
"last_block_id": {
"hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
"parts": {
"total": 1,
"hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
}
},
"last_commit_hash": "093DC4B1414DE776AAC2388AAD616FCAC5E783930420710395732259CA023DB8",
"data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "4107A4EABA68DEF282B97D5071440DFB121307B524B0E2B64D7F348CB57E74A9",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "330871F4F79EF8572E4AB3A64A45AF0C88AFC24E"
},
"num_txs": "0"
},
{
"block_id": {
"hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
"parts": {
"total": 1,
"hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
}
},
"block_size": "339",
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "1",
"time": "2022-05-25T17:00:00Z",
"last_block_id": {
"hash": "",
"parts": {
"total": 0,
"hash": ""
}
},
"last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
},
"num_txs": "0"
}
]
}
}
block
Retrieves a block at a specified height.
Parameters
height
(integer; default: 0): the height to return. If no height is provided, the latest block is to be fetched.
Returns
Block information.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "block",
"params": ["1"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"block_id": {
"hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
"parts": {
"total": 1,
"hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
}
},
"block": {
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "1",
"time": "2022-05-25T17:00:00Z",
"last_block_id": {
"hash": "",
"parts": {
"total": 0,
"hash": ""
}
},
"last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
},
"data": {
"txs": []
},
"evidence": {
"evidence": []
},
"last_commit": {
"height": "0",
"round": 0,
"block_id": {
"hash": "",
"parts": {
"total": 0,
"hash": ""
}
},
"signatures": []
}
}
}
}
block_by_hash
Retrieves a block by hash.
Parameters
hash
(string; required): the Base64-encoded block hash.
Returns
Block information.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "block_by_hash",
"params": ["CZDLbPv0DScQ6hUoCceUnqdDEnaoPrG8RoNcoTekAKg="],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": -1,
"result": {
"block_id": {
"hash": "0990CB6CFBF40D2710EA152809C7949EA7431276A83EB1BC46835CA137A400A8",
"parts": {
"total": 1,
"hash": "BDB709FCE6291C69976F6AA6BADFAB768CCF7347CCE381D2DBE581AB1AFF1147"
}
},
"block": {
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "13211369",
"time": "2024-12-23T13:06:40.249128874Z",
"last_block_id": {
"hash": "11E9C2ED7F9E6F494030DD8E6BA2887193FDBE4DCEF694193470780C56838A09",
"parts": {
"total": 1,
"hash": "FE6664A16EA56C07254298EE325FEC08A60473A76200E959C51CABA007FCC423"
}
},
"last_commit_hash": "2612A440646D3101752779E27EFE43EE17363A9B7DCBCFF2C13FD1C211E396AB",
"data_hash": "B9B7F0546E07BB0F1E6837CEDC92C461A545A8E208D4F584A17B5471129DFB2E",
"validators_hash": "98F5D4584BB1DF0122CC6CF68BC8772EE951737F0129502282B972F2CF7F7D89",
"next_validators_hash": "98F5D4584BB1DF0122CC6CF68BC8772EE951737F0129502282B972F2CF7F7D89",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "883C909F30202624527F54653CB35A0A957EA6111ED9436F21F00E9271EB4599",
"last_results_hash": "9EABEC2AD9A87ADAE8B4344675DCC4EECC8251B1FDFC5388A2469D30D1904AE3",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
},
"data": {
"txs": [
"CrALCvwKCh8vZXRoZXJtaW50LmV2bS52MS5Nc2dFdGhlcmV1bVR4EtgKCpEKChovZXRoZXJtaW50LmV2bS52MS5MZWdhY3lUeBLyCQiQiiISCjEwMDAwMDAwMDAY8MghIioweGJENTI5MzBBZjVmMzllMkE3QmIyMUY5YjEwZGQzOTEyNGVjOEZmYmEqATAy5Ai+doO2AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE9DUv06pMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAmJWcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAeAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAADIbHwO+9akmzXocUxfWdmd4JoiWwAAAAAAAAAAAAAAAJGcHCZ7wGpwOeA..."
]
},
"evidence": {
"evidence": []
},
"last_commit": {
"height": "13211368",
"round": 0,
"block_id": {
"hash": "11E9C2ED7F9E6F494030DD8E6BA2887193FDBE4DCEF694193470780C56838A09",
"parts": {
"total": 1,
"hash": "FE6664A16EA56C07254298EE325FEC08A60473A76200E959C51CABA007FCC423"
}
},
"signatures": [
{
"block_id_flag": 2,
"validator_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
"timestamp": "2024-12-23T13:06:40.249128874Z",
"signature": "CwycpLoHveYoT/euba+mH8nfUFWvUimMqPM98IFLZPGGIqJzirAndVRhZ8YqNeBU3QaXQnpGRq5lkbh6qnTeAQ=="
},
{
"block_id_flag": 2,
"validator_address": "BC3E38E217AC3B03E61752C5C2F918FA6539166F",
"timestamp": "2024-12-23T13:06:40.318172526Z",
"signature": "AeGOEuMuAaJ8zB/DJYU8bJ75OL+FAQSfzUX1FnNiKgQ4ykulN+HppLM3rcJ1uXj+pc8pbN5V5db5SKzUJCsDCQ=="
}
]
}
}
}
}
block_results
Retrieves block results at a specified height.
Parameters
height
(integer; default: 0): the height to return. If no height is provided, the latest block info is to be fetched.
Returns
Block results.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "block_results",
"params": ["1"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"height": "1",
"txs_results": null,
"begin_block_events": [
{
"type": "coin_received",
"attributes": [
{
"key": "receiver",
"value": "kava1m3h30wlvsf8llruxtpukdvsy0km2kum85yn938",
"index": true
},
{
"key": "amount",
"value": "38487598ukava",
"index": true
}
]
},
{
"type": "block_gas",
"attributes": [
{
"key": "height",
"value": "1",
"index": true
},
{
"key": "amount",
"value": "0",
"index": true
}
]
}
],
"validator_updates": null,
"consensus_param_updates": {
"block": {
"max_bytes": "200000",
"max_gas": "20000000"
},
"evidence": {
"max_age_num_blocks": "1000000",
"max_age_duration": "6000000000000000",
"max_bytes": "50000"
},
"validator": {
"pub_key_types": [
"ed25519"
]
}
}
}
}
commit
Retrieves commit results at a specified height.
Parameters
height
(integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be fetched.
Returns
Commit results. Canonical switches from false to true for block H once block H+1 has been committed, until then it's subjective and only reflects what this node has seen so far.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "commit",
"params": ["1"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"signed_header": {
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "1",
"time": "2022-05-25T17:00:00Z",
"last_block_id": {
"hash": "",
"parts": {
"total": 0,
"hash": ""
}
},
"last_commit_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"next_validators_hash": "9D8248DFDD2C7571A1FB66F43C21FF698BACE04A4F2802AF63ED70FB7DC91B57",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "BFA6235D95564560A73460860B8D6F847360A31B"
},
"commit": {
"height": "1",
"round": 1,
"block_id": {
"hash": "9D2AF876309BB9174604004A813DCFEE94F4947B08C5BB4C1A042F318488851E",
"parts": {
"total": 1,
"hash": "510794F966632A503431FE4515D6C15D49BCFEA9E6753E06E582C8D26C826294"
}
},
"signatures": [
{
"block_id_flag": 2,
"validator_address": "BD417EAD7FF9AC70A11A01F63FB40BBDEB0F1FD4",
"timestamp": "2022-05-25T18:39:32.196946927Z",
"signature": "6qT1+sJhXk3SmspA9v7FZUqyBegmM0w2LRRNx6NgO045cPmHhhHNl9gNAT4OaU1ISwPXVdaIret3VrPuJtA0AA=="
},
{
"block_id_flag": 2,
"validator_address": "BFA6235D95564560A73460860B8D6F847360A31B",
"timestamp": "2022-05-25T18:39:32.085034348Z",
"signature": "sid5vAgVD5WHlrCTmwBYZBVHvoS1zDft4LPDpDs4vQg6HQfUQ2Pn8d8VaCYNSwSxbfQ2eu1OoJwjPgMwlwDzDQ=="
}
]
}
},
"canonical": true
}
}
validators
Retrieves a validator set at a specified height.
Validators are sorted by voting power.
Parameters
height
(integer; default: 0): the height to return. If no height is provided, the validator set corresponding to the latest block is to be fetched.page
(integer; default: 1): a page number (1-based).per_page
(integer; default: 30; max: 100): a number of entries per page.
Returns
Commit results.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "validators",
"params": ["1","1","30"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"block_height": "1",
"validators": [
{
"address": "BD417EAD7FF9AC70A11A01F63FB40BBDEB0F1FD4",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "sIKgJJY8szFPMmKA0GehzQvKwDNe7KECDE8O+XqPuwU="
},
"voting_power": "29204205",
"proposer_priority": "-82888553"
}
],
"count": "30",
"total": "100"
}
}
genesis_chunked
Retrieves Genesis in multiple chunks.
Gets genesis document in multiple chunks to make it easier to iterate through larger genesis structures. Each chunk is produced by converting the genesis document to JSON and then splitting the resulting payload into 16MB blocks, and then Base64-encoding each block.
Parameters
chunk
(integer; default: 0): a sequence number of the chunk to download.
Returns
A Genesis chunk response.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "genesis_chunked",
"params": ["1"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 0,
"result": {
"chunk": 0,
"total": 1,
"data": "Z2VuZXNpcwo=..."
}
}
dump_consensus_state
Retrieves consensus state.
Not safe to call from inside the ABCI application during a block execution.
Parameters
None.
Returns
A complete consensus state. See the Vote string description (opens in a new tab).
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "dump_consensus_state",
"params": [],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"round_state": {
"height": "13211550",
"round": 0,
"step": 1,
"start_time": "2024-12-23T13:24:44.738595111Z",
"commit_time": "2024-12-23T13:24:39.738595111Z",
"validators": {
"validators": [
{
"address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
},
"voting_power": "21656144",
"proposer_priority": "-52387076"
}
],
"proposer": {
"address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
},
"voting_power": "21656144",
"proposer_priority": "-52387076"
}
},
"proposal": null,
"proposal_block": null,
"proposal_block_parts": null,
"locked_round": -1,
"locked_block": null,
"locked_block_parts": null,
"valid_round": -1,
"valid_block": null,
"valid_block_parts": null,
"votes": [
{
"round": 0,
"prevotes": [
"nil-Vote",
"nil-Vote"
],
"prevotes_bit_array": "BA{88:________________________________________________________________________________________} 0/117388861 = 0.00",
"precommits": [
"nil-Vote",
"nil-Vote"
],
"precommits_bit_array": "BA{88:________________________________________________________________________________________} 0/117388861 = 0.00"
}
],
"commit_round": -1,
"last_commit": {
"votes": [
"Vote{0:279EAD5DD43F 13211549/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 2F31A8E1F581 8B6CEAA65010 @ 2024-12-23T13:24:39.500074271Z}",
"Vote{1:BD417EAD7FF9 13211549/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 2F31A8E1F581 31E4D1FFA299 @ 2024-12-23T13:24:39.553047425Z}"
],
"votes_bit_array": "BA{88:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 117388861/117388861 = 1.00",
"peer_maj_23s": {}
},
"last_validators": {
"validators": [
{
"address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "GFeC1pZ7fslcucbIsx44x9c0MPeJlLRb+WGG/wGflbw="
},
"voting_power": "21656144",
"proposer_priority": "43345641"
}
],
"proposer": {
"address": "5AA4440350230D5BB8CDFE6A5726656B4FC7DC6E",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "BM16Wru6ELaZXCyKZAH5WGxg5YiMYw2WlcpBnfdbnQg="
},
"voting_power": "162210",
"proposer_priority": "-63939004"
}
},
"triggered_timeout_precommit": false
},
"peers": [
{
"node_address": "f8d5e677f1f68f8bd798752595371817f61dc532@178.128.156.131:26656",
"peer_state": {
"round_state": {
"height": "13211550",
"round": 0,
"step": 1,
"start_time": "2024-12-23T13:24:43.982077345Z",
"proposal": false,
"proposal_block_part_set_header": {
"total": 0,
"hash": ""
},
"proposal_block_parts": null,
"proposal_pol_round": -1,
"proposal_pol": "________________________________________________________________________________________",
"prevotes": "________________________________________________________________________________________",
"precommits": "________________________________________________________________________________________",
"last_commit_round": 0,
"last_commit": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"catchup_commit_round": -1,
"catchup_commit": "________________________________________________________________________________________"
},
"stats": {
"votes": "14173",
"block_parts": "45"
}
}
}
]
}
}
consensus_state
Retrieves consensus state.
Not safe to call from inside the ABCI application during a block execution.
Parameters
None.
Returns
Consensus state results.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "consensus_state",
"params": [],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"round_state": {
"height/round/step": "13213043/0/6",
"start_time": "2024-12-23T15:53:01.989949876Z",
"proposal_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
"locked_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
"valid_block_hash": "78CB001605FE99454B82944CB47D65D093629DDD38454260E7B7980874A6A5D7",
"height_vote_set": [
{
"round": 0,
"prevotes": [
"Vote{0:279EAD5DD43F 13213043/00/SIGNED_MSG_TYPE_PREVOTE(Prevote) 78CB001605FE 619E4C697B2C @ 2024-12-23T15:53:02.160332603Z}",
"Vote{1:BD417EAD7FF9 13213043/00/SIGNED_MSG_TYPE_PREVOTE(Prevote) 78CB001605FE 82F0E2036082 @ 2024-12-23T15:53:02.374084828Z}"
],
"prevotes_bit_array": "BA{88:xxxxxxxxxx__xxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxxx_xxxxxxxxxxxxxxx} 110520639/117416870 = 0.94",
"precommits": [
"Vote{0:279EAD5DD43F 13213043/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 78CB001605FE 92F18B4F01EA @ 2024-12-23T15:53:02.551832113Z}",
"nil-Vote",
"Vote{2:BFA6235D9556 13213043/00/SIGNED_MSG_TYPE_PRECOMMIT(Precommit) 78CB001605FE 0FB040BC54A6 @ 2024-12-23T15:53:02.563127503Z}",
"nil-Vote"
],
"precommits_bit_array": "BA{88:x_x_x________x_x__x_xx____x__xxxx___x_xx_xx_xxx_xxx__x___xxx__xx_xxx__x___x___xx___xxxx_} 52462972/117416870 = 0.45"
},
{
"round": 1,
"prevotes": [
"nil-Vote",
"nil-Vote"
],
"prevotes_bit_array": "BA{88:________________________________________________________________________________________} 0/117416870 = 0.00",
"precommits": [
"nil-Vote",
"nil-Vote"
],
"precommits_bit_array": "BA{88:________________________________________________________________________________________} 0/117416870 = 0.00"
}
],
"proposer": {
"address": "026D3C349592A1A1D6534744106D7B0453E3C565",
"index": 29
}
}
}
}
consensus_params
Retrieves consensus parameters.
Parameters
height
(integer; default: 0): the height to return. If no height is provided, the latest block commit info is to be returned.
Returns
Consensus parameters results.
Request parameters
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "consensus_params",
"params": ["1"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"block_height": "1",
"consensus_params": {
"block": {
"max_bytes": "200000",
"max_gas": "20000000"
},
"evidence": {
"max_age_num_blocks": "1000000",
"max_age_duration": "6000000000000000",
"max_bytes": "50000"
},
"validator": {
"pub_key_types": [
"ed25519"
]
},
"version": {
"app": "0"
}
}
}
}
unconfirmed_txs
Retrieves the list of unconfirmed transactions.
Parameters
limit
(integer; default: 30; max: 100): the maximum number of unconfirmed transactions to return.
Returns
The list of unconfirmed transactions.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "unconfirmed_txs",
"params": ["1"],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"n_txs": "2",
"total": "4",
"total_bytes": "2012",
"txs": [
"CoYBCoMBCiQva2F2YS5wcmljZWZlZWQudjFiZXRhMS5Nc2dQb3N0UHJpY2USWwora2F2YTE5cmprNXFtbXd5d256ZmNjd3p5bjAyanl3Z3B3anFmNjBhZmo5MhILdXNkeDp1c2Q6MzAaEjcxODkzMDAwMDAwMDAwMDA2OSILCPHVsLsGEMCO5TcSagpSCkYKHy9jb3Ntb3MuY3J5cHRvLnNlY3AyNTZrMS5QdWJLZXkSIwohA31VSgUTeXh1kcCYwNrx04+4ItSC8M6wuKV96JLq9G0pEgQKAggBGJHBFxIUCg4KBXVrYXZhEgU1MDAwMBDwkwkaQKvIEvEmlpm5Xuw9on+NLx53kPmvw3QI2Fic1/IDowITWeN8bbGHdomSC1cdnrtZ8rxaBUnfpLM7Yisnk4cqcl4=",
"CoQBCoEBCiQva2F2YS5wcmljZWZlZWQudjFiZXRhMS5Nc2dQb3N0UHJpY2USWQora2F2YTF1ZWFrN256ZXNtM3BuZXY2bG5ncDZsZ2swcnkwMmRqejhwanBjZxIIdXNkeDp1c2QaEjczMzg5OTk5OTk5OTk5OTk5NyIMCLSAp7sGEMCR+NQCEmkKUgpGCh8vY29zbW9zLmNyeXB0by5zZWNwMjU2azEuUHViS2V5EiMKIQJh+Rd6tFqIDMHzDY2LUqIfd6iQjaxEk7kCf/PggVVILxIECgIIARj78XASEwoNCgV1a2F2YRIENTAwMBDwkwkaQNH1d9rV6P0l8EktESQ6pSg1htx5I8FNNit3kfg/bOXqJ0c5PxTgBfeitv167yLxWxyXBWaJueQGMVh8KOHi1W0="
]
}
}
num_unconfirmed_txs
Retrieves data on unconfirmed transactions.
Parameters
None.
Returns
The status of unconfirmed transactions.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "num_unconfirmed_txs",
"params": [],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"n_txs": "0",
"total": "0",
"total_bytes": "0",
"txs": null
}
}
tx_search
Searches for transactions with their results.
Parameters
query
(string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be=
,<
,<=
,>
,>=
,CONTAINS
. An operand can be a string (escaped with single quotes), number, date, or time.prove
(boolean; default: false): adds proofs of the transactions inclusion in the block.page
(integer; default: 1): a page number (1-based).per_page
(integer; default: 30, max: 100): a number of entries per page.order_by
(string; default: asc): the order in which transactions are sorted (asc
ordesc
), by height & index. If empty, default sorting still applies.match_events
(boolean; default: false): match attributes in query within events, in addition to the height and txhash.
Returns
The list of unconfirmed transactions.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "tx_search",
"params": {
"query": "tx.height=13225811",
"prove": true,
"page": "1",
"per_page": "5",
"order_by": "desc"
},
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"txs": [],
"total_count": "0"
}
}
block_search
Searches for blocks by
BeginBlock
andEndBlock
events.
Parameters
query
(string; required): query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r()"'=>< are not allowed). operation can be=
,<
,<=
,>
,>=
,CONTAINS
. An operand can be a string (escaped with single quotes), number, date, or time.page
(integer; default: 1): a page number (1-based).per_page
(integer; default: 30, max: 100): a number of entries per page.order_by
(string; default: asc): the order in which transactions are sorted (asc
ordesc
), by height & index. If empty, default sorting still applies.match_events
(boolean; default: false): match attributes in query within events, in addition to the height.
Returns
The list of paginated blocks matching the search criteria.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "block_search",
"params": {
"query": "block.height=13225811",
"page": "1",
"per_page": "10",
"order_by": "desc"
},
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"blocks": [
{
"block_id": {
"hash": "F054E236608C0E65DFE9231F9332D7F54F1A282D4C2C3DA6B35FAED5D4EE9169",
"parts": {
"total": 1,
"hash": "4F02FC67A8503D1D5428EE6D1209FC5BC1BB67382DBDB53F38C3FD0783B2FC8A"
}
},
"block": {
"header": {
"version": {
"block": "11"
},
"chain_id": "kava_2222-10",
"height": "13225811",
"time": "2024-12-24T12:58:00.512093988Z",
"last_block_id": {
"hash": "304F208093FA799825FA221EB9B517B73A0879E6D9B971DD28FDF96F564EEC7C",
"parts": {
"total": 1,
"hash": "4158FCF92A13A2A5F8D466BD0189EB466DDD5D1FCA7ACF0E40069A8A0B775792"
}
},
"last_commit_hash": "CCFD88F120E554844A8DED71E1DAF3FA8089B1D7CFDC276917C8A5E34FDE6DBD",
"data_hash": "2E1EC915F83863741270A49157E2787F5F34F3B0E2E67BB1527368F8BA05D1CD",
"validators_hash": "7C3AABDFAA6A53BF1C63DC025201337CA9CB3F7DE8A51EA0C54B2CEBDCEF6E39",
"next_validators_hash": "7C3AABDFAA6A53BF1C63DC025201337CA9CB3F7DE8A51EA0C54B2CEBDCEF6E39",
"consensus_hash": "AD82B220C509602720D74FD75BCE7CFE9B148039958F236D8894E00EB1599E04",
"app_hash": "2AA5FE48061351DF5DD4F79C25A902466C31975199BEE286FE294273DB4FBF4A",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07"
},
"data": {
"txs": [
"CrIHCv4GCh8vZXRoZXJtaW50LmV2bS52MS5Nc2dFdGhlcmV1bVR4EtoGCpMGChovZXRoZXJtaW50LmV2bS52MS5MZWdhY3lUeBL0BQiXvhMSDDEwMTAwMDAwMDAwMBjJ9hgiKjB4ODE1ZjI3QTU2MTcxMUE2QjA0YmNFM0FhNjVjNUQ5QTE5NDVBNWVFQioBMDLkBHgmYbwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAGdqr9oAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA..."
]
},
"evidence": {
"evidence": []
},
"last_commit": {
"height": "13225810",
"round": 0,
"block_id": {
"hash": "304F208093FA799825FA221EB9B517B73A0879E6D9B971DD28FDF96F564EEC7C",
"parts": {
"total": 1,
"hash": "4158FCF92A13A2A5F8D466BD0189EB466DDD5D1FCA7ACF0E40069A8A0B775792"
}
},
"signatures": [
{
"block_id_flag": 2,
"validator_address": "279EAD5DD43F82490C6B3CFB41EEF4E9A1A49D07",
"timestamp": "2024-12-24T12:58:00.458392974Z",
"signature": "LU+rS0/HPXczwL9jxzAWYHSck0ORgzD9MGLXx6POcKO2XpNnHRG8/QsxDSs4Ouy3hO9AAiG0RNUWBrVlgjlpBg=="
}
]
}
}
}
],
"total_count": "1"
}
}
tx
Retrieves a transaction by hash.
Parameters
hash
(string; required): a hash of a transaction to retrieve.prove
(boolean; default: false): adds proofs of the transaction's inclusion in the block.
Returns
Transaction info.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "tx",
"params": ["4B6D8FEA3786BFC6152EAEA791C4DAF00C41E93DAD56A7230B565179CD29CAA1", true],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"hash": "4B6D8FEA3786BFC6152EAEA791C4DAF00C41E93DAD56A7230B565179CD29CAA1",
"height": "12345",
"index": 2,
"tx_result": {
"code": 0,
"log": "Success",
"events": [
{
"type": "transfer",
"attributes": [
{ "key": "sender", "value": "kava1xyz..." },
{ "key": "recipient", "value": "kava1abc..." },
{ "key": "amount", "value": "10000ukava" }
]
}
]
},
"tx": "BASE64_ENCODED_TX", // The transaction itself in Base64 format
"proof": {
"root_hash": "0xABC123...",
"data": "BASE64_ENCODED_PROOF",
"proof": { /* Detailed proof structure */ }
}
}
}
Transactions
broadcast_tx_sync
Returns with the response from
CheckTx
. Does not wait forDeliverTx
result.
If you want to be sure that the transaction is included in a block, you can subscribe for the result using JSON-RPC via a websocket. See https://docs.cometbft.com/v0.34/core/subscription.html (opens in a new tab) If you haven't received anything after a couple of blocks, resend it. If the same happens again, send it to some other node. A few reasons why it could happen:
- A malicious node drops or pretends it has committed your tx.
- A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).
Please refer to Tendermint docs (opens in a new tab) for formatting/encoding rules.
Parameters
tx
(string; required): the signed transaction, encoded as Base64.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "broadcast_tx_sync",
"params": ["<BASE64_ENCODED_TRANSACTION>"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"code": 0,
"data": "",
"log": "transaction successfully broadcasted",
"hash": "0xABC123..." // The transaction hash
}
}
broadcast_tx_async
Returns right away, with no response. Does not wait for
CheckTx
norDeliverTx
results.
If you want to be sure that the transaction is included in a block, you can subscribe for the result using JSON-RPC via a websocket. See https://docs.cometbft.com/v0.34/core/subscription.html (opens in a new tab) If you haven't received anything after a couple of blocks, resend it. If the same happens again, send it to some other node. A few reasons why it could happen:
- A malicious node drops or pretends it has committed your tx.
- A malicious proposer (not necessary the one you're communicating with) drops transactions, which might become valid in the future (https://github.com/tendermint/tendermint/issues/3322 (opens in a new tab)).
- A node is offline.
Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.
Parameters
tx
(string; required): the Base64-encoded signed transaction.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "broadcast_tx_async",
"params": ["<BASE64_ENCODED_TRANSACTION>"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"code": 0,
"data": "",
"log": "",
"hash": "0xABC123..." // Transaction hash
}
}
broadcast_tx_commit
Returns with the responses from
CheckTx
andDeliverTx
.
Use only for testing and development. In production, use BroadcastTxSync
or BroadcastTxAsync
. You can subscribe for the transaction result using JSON-RPC via a websocket (see CometBFT docs (opens in a new tab)).
CONTRACT: only returns error if mempool.CheckTx()
errs or if we timeout waiting for tx to commit.
If CheckTx
or DeliverTx
fails, no error will be returned, but the result will contain a non-OK ABCI code.
Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.
Parameters
tx
(string; required): the Base64-encoded signed transaction.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "broadcast_tx_commit",
"params": ["<BASE64_ENCODED_TRANSACTION>"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"check_tx": {
"code": 0,
"data": "",
"log": "Transaction checked successfully"
},
"deliver_tx": {
"code": 0,
"data": "",
"log": "Transaction delivered successfully",
"events": [
{
"type": "transfer",
"attributes": [
{ "key": "sender", "value": "kava1xyz..." },
{ "key": "recipient", "value": "kava1abc..." },
{ "key": "amount", "value": "10000ukava" }
]
}
]
},
"hash": "0xABC123...",
"height": "12345"
}
}
check_tx
Checks the transaction without executing it.
The transaction won't be added to the mempool.
Please refer to CometBFT docs (opens in a new tab) for formatting/encoding rules.
Parameters
tx
(string; required): the Base64-encoded signed transaction.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "check_tx",
"params": ["<BASE64_ENCODED_TRANSACTION>"],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"code": 0,
"data": "",
"log": "Transaction is valid",
"events": [
{
"type": "transfer",
"attributes": [
{ "key": "sender", "value": "kava1xyz..." },
{ "key": "recipient", "value": "kava1abc..." },
{ "key": "amount", "value": "10000ukava" }
]
}
]
}
}
ABCI
abci_info
Retrieves application info.
Parameters
None.
Returns
Application info.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "abci_info",
"params": [],
"id": 1
}'
Response example
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"response": {
"data": "kava",
"version": "0.27.0",
"app_version": "8",
"last_block_height": "13239641",
"last_block_app_hash": "wLirVXfBEeq0jZcrshBGWS7AGN19N7p8aQqMAiaIl+I="
}
}
}
abci_query
Queries the application for particular information.
Parameters
path
(string; required): a path to the data ("/a/b/c").data
(string; required): the hex-encoded data.height
(integer; default: 0): the height (0 means latest).prove
(boolean; default: false): adds proofs of the transactions inclusion in the block.
Returns
Particular info according to the query submitted.
Request example
curl -X POST https://rpc.ankr.com/kava_rpc \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"method": "abci_query",
"params": ["a/b/c", "the_data", "1", true],
"id": 1
}'
Response example
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"response": {
"code": 0,
"log": "",
"info": "",
"index": -1,
"key": "0x6b61766131387879377a...",
"value": "0x123456789abcdef", // Hex-encoded value
"proofOps": null,
"height": "12345",
"codespace": ""
}
}
}
Cosmos REST methods
Query:
- Auth methods
- Bank methods
- Distribution methods
- Evidence methods
- Gov methods
- Mint methods
- Slashing methods
- Staking methods
- Upgrade methods
- Ibc core methods
- Ibc applications methods
Service:
Auth methods
/cosmos/auth/v1beta1/accounts/{address}
Retrieves account details based on address.
Parameters
address
(string; required): an address to query for account details.
Returns
Account details.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/auth/v1beta1/accounts/{address}
Response example
{
"account": {
"type_url": "string",
"value": "string"
}
}
/cosmos/auth/v1beta1/params
Retrieves all parameters.
Parameters
None.
Returns
Parameters.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/auth/v1beta1/params
Response example
{
"params": {
"max_memo_characters": "string",
"tx_sig_limit": "string",
"tx_size_cost_per_byte": "string",
"sig_verify_cost_ed25519": "string",
"sig_verify_cost_secp256k1": "string"
}
}
Bank methods
/cosmos/bank/v1beta1/balances/{address}
Retrieves the balance of all coins for a single account.
Parameters
address
(string; required): an address to query balances for.pagination.key
(string, byte): value returned inPageResponse.next_key
to begin querying the next page most efficiently. Only one of offset or key should be set.pagination.offset
(string, uint64): numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.pagination.limit
(string, uint64): total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs.count_total
is only respected whenoffset
is used, it is ignored whenkey
is set.
Returns
Balance of all coins for a single account.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/balances/{address}
Response example
{
"balances": [
{
"denom": "string",
"amount": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/bank/v1beta1/balances/{address}/{denom}
Retrieves balance of a single coin for a single account.
Parameters
address
(string; required): an address to query balances for.denom
(string; required): a coin denom to query balances for.
Returns
Balance of the specific coin for a single account.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/balances/{address}/{denom}
Response example
{
"balance": {
"denom": "string",
"amount": "string"
}
}
/cosmos/bank/v1beta1/params
Retrieves the parameters of x/bank module.
Parameters
None.
Returns
Parameters of x/bank module.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/params
Response example
{
"params": {
"send_enabled": [
{
"denom": "string",
"enabled": true
}
],
"default_send_enabled": true
}
}
/cosmos/bank/v1beta1/supply
Retrieves the total supply of all coins.
Parameters
None.
Returns
Supply of all coins.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/bank/v1beta1/supply
Response example
{
"supply": [
{
"denom": "string",
"amount": "string"
}
]
}
Distribution methods
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards
Retrieves the total rewards accrued by each validator.
Parameters
delegator_address
(string; required): a delegator address to query for.
Returns
Rewards from each validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards
Response example
{
"rewards": [
{
"validator_address": "string",
"reward": [
{
"denom": "string",
"amount": "string"
}
]
}
],
"total": [
{
"denom": "string",
"amount": "string"
}
]
}
/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}
Retrieves the total rewards accrued by a delegation.
Parameters
delegator_address
(string; required): a delegator address to query for.validator_address
(string; required): a validator address to query for.
Returns
Total rewards accrued by a delegation for a specific validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}
Response example
{
"rewards": [
{
"denom": "string",
"amount": "string"
}
]
}
/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators
Retrieves the validators of a delegator.
Parameters
delegator_address
(string; required): a delegator address to query for.
Returns
Validators for a given delegator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators
Response example
{
"validators": [
"string"
]
}
/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address
Retrieves withdraw address of a delegator.
Parameters
delegator_address
(string, required): a delegator address to query for.
Returns
Withdraw address of delegator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address
Response example
{
"withdraw_address": "string"
}
/cosmos/distribution/v1beta1/params
Retrieves params of the distribution module.
Parameters
None.
Returns
Params of the distribution module.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/params
Response example
{
"params": {
"community_tax": "string",
"base_proposer_reward": "string",
"bonus_proposer_reward": "string",
"withdraw_addr_enabled": true
}
}
/cosmos/distribution/v1beta1/validators/{validator_address}/commission
Retrieves accumulated commission for a validator.
Parameters
validator_address
(string; required): a validator address to query for.
Returns
Total commission for a validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/commission
Response example
{
"commission": {
"commission": [
{
"denom": "string",
"amount": "string"
}
]
}
}
/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards
Retrieves the rewards of a validator address.
Parameters
validator_address
(string; required): validator address to query for.
Returns
Total outstanding rewards for a validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards
Response example
{
"rewards": {
"rewards": [
{
"denom": "string",
"amount": "string"
}
]
}
}
/cosmos/distribution/v1beta1/validators/{validator_address}/slashes
Retrieves slash events of a validator.
Parameters
validator_address
(string; required): a validator address to query for.starting_height
(string, uint64): the optional starting height to query the hashesending_height
(string, uint64): the optional ending height to query the hashespagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All slash events of a validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/distribution/v1beta1/validators/{validator_address}/slashes
Response example
{
"slashes": [
{
"validator_period": "string",
"fraction": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
Evidence methods
/cosmos/evidence/v1beta1/evidence
Retrieves all evidence.
Parameters
pagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All evidence.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/evidence/v1beta1/evidence
Response example
{
"evidence": [
{
"type_url": "string",
"value": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/evidence/v1beta1/evidence/{evidence_hash}
Retrieves evidence based on evidence hash.
Parameters
evidence_hash
(string, byte): the hash of the requested evidence.
Returns
Evidence for a given hash.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/evidence/v1beta1/evidence/{evidence_hash}
Response example
{
"evidence": {
"type_url": "string",
"value": "string"
}
}
Gov methods
/cosmos/gov/v1beta1/params/{params_type}
Retrieves all parameters of the gov module.
Parameters
params_type
(string, required): parameters to query for; possible values:voting
,tallying
, ordeposit
.
Returns
Parameters of the gov module.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/params/{params_type}
Response example
{
"voting_params": {
"voting_period": "string"
},
"deposit_params": {
"min_deposit": [
{
"denom": "string",
"amount": "string"
}
],
"max_deposit_period": "string"
},
"tally_params": {
"quorum": "string",
"threshold": "string",
"veto_threshold": "string"
}
}
/cosmos/gov/v1beta1/proposals
Retrieves all proposals based on given status.
Parameters
proposal_status
: defines status of the proposals. See below for different options. Default value = PROPOSAL_STATUS_UNSPECIFIED. Other statuses:PROPOSAL_STATUS_UNSPECIFIED
: default proposal status.PROPOSAL_STATUS_DEPOSIT_PERIOD
: defines a proposal status during the deposit period.PROPOSAL_STATUS_VOTING_PERIOD
: defines a proposal status during the voting period.PROPOSAL_STATUS_PASSED
: defines a proposal status of a proposal that has passed.PROPOSAL_STATUS_REJECTED
: defines a proposal status of a proposal that has been rejected.PROPOSAL_STATUS_FAILED
: defines a proposal status of a proposal that has failed.
voter
(string): defines the voter address for the proposals.depositor
(string): defines the deposit addresses from the proposals.pagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Proposals based on given status.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals
Response example
{
"proposals": [
{
"proposal_id": "string",
"content": {
"type_url": "string",
"value": "string"
},
"status": "PROPOSAL_STATUS_UNSPECIFIED",
"final_tally_result": {
"yes": "string",
"abstain": "string",
"no": "string",
"no_with_veto": "string"
},
"submit_time": "2021-01-19T03:03:05.413Z",
"deposit_end_time": "2021-01-19T03:03:05.413Z",
"total_deposit": [
{
"denom": "string",
"amount": "string"
}
],
"voting_start_time": "2021-01-19T03:03:05.413Z",
"voting_end_time": "2021-01-19T03:03:05.413Z"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}
Retrieves proposal details based on
ProposalID
.
Parameters
proposal_id
(string; required): a unique id of the proposal.
Returns
Proposal details based on proposalID.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}
Response example
{
"proposal": {
"proposal_id": "string",
"content": {
"type_url": "string",
"value": "string"
},
"status": "PROPOSAL_STATUS_UNSPECIFIED",
"final_tally_result": {
"yes": "string",
"abstain": "string",
"no": "string",
"no_with_veto": "string"
},
"submit_time": "2021-01-19T03:30:27.807Z",
"deposit_end_time": "2021-01-19T03:30:27.807Z",
"total_deposit": [
{
"denom": "string",
"amount": "string"
}
],
"voting_start_time": "2021-01-19T03:30:27.807Z",
"voting_end_time": "2021-01-19T03:30:27.807Z"
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits
Retrieves all deposits of a single proposal.
Parameters
proposal_id
(string, uint64; required): a unique id of the proposal.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
All deposits based on a proposalID.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits
Response example
{
"deposits": [
{
"proposal_id": "string",
"depositor": "string",
"amount": [
{
"denom": "string",
"amount": "string"
}
]
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}
Retrieves single deposit information based
proposalID
anddepositAddr
.
Parameters
proposal_id
(string, uint64): a required unique id of the proposal.depositor
(string): the deposit addresses from the proposals.
Returns
Single deposit based on a proposalID.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}
Response example
{
"deposit": {
"proposal_id": "string",
"depositor": "string",
"amount": [
{
"denom": "string",
"amount": "string"
}
]
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}/tally
Retrieves the tally of a proposal vote.
Parameters
proposal_id
(string, uint64): a required unique ID of the proposal.
Returns
Tally of proposal vote.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/tally
Response example
{
"tally": {
"yes": "string",
"abstain": "string",
"no": "string",
"no_with_veto": "string"
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes
Retrieves the votes of a given proposal.
Parameters
proposal_id
(string($uint64), required): a unique id of the proposalpagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Votes for a given proposal.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/votes
Response example
{
"votes": [
{
"proposal_id": "string",
"voter": "string",
"option": "VOTE_OPTION_UNSPECIFIED"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}
Retrieves voted information based on
proposalID
andvoterAddr
.
Parameters
proposal_id
(string, uint64; required): a unique ID of the proposal.voter
(string): the other address for the proposals.
Returns
Votes for a given proposal.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}
Response example
{
"vote": {
"proposal_id": "string",
"voter": "string",
"option": "VOTE_OPTION_UNSPECIFIED"
}
}
Mint methods
/cosmos/mint/v1beta1/annual_provisions
Retrieves the current minting annual provisions value.
Parameters
None.
Returns
Value of minting annual provisions.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/annual_provisions
Response example
{
"error": "string",
"code": 0,
"message": "string",
"details": [
{
"type_url": "string",
"value": "string"
}
]
}
/cosmos/mint/v1beta1/inflation
Retrieves the current minting inflation value.
Parameters
None.
Returns
Current minting inflation value.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/inflation
Response example
{
"inflation": "string"
}
/cosmos/mint/v1beta1/params
Retrieves the total set of minting parameters
Parameters
None.
Returns
Total set of minting params.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/mint/v1beta1/params
Response example
{
"params": {
"mint_denom": "string",
"inflation_rate_change": "string",
"inflation_max": "string",
"inflation_min": "string",
"goal_bonded": "string",
"blocks_per_year": "string"
}
}
Slashing methods
/cosmos/slashing/v1beta1/params
Retrieves the slashing module parameters.
Parameters
None.
Returns
The parameters of a slashing module.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/params
Response example
{
"params": {
"signed_blocks_window": "string",
"min_signed_per_window": "string",
"downtime_jail_duration": "string",
"slash_fraction_double_sign": "string",
"slash_fraction_downtime": "string"
}
}
/cosmos/slashing/v1beta1/signing_infos
Retrieves signing info of all validators.
Parameters
pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
The signing info of all validators.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/signing_infos
Response example
{
"info": [
{
"address": "string",
"start_height": "string",
"index_offset": "string",
"jailed_until": "2021-01-19T06:33:32.230Z",
"tombstoned": true,
"missed_blocks_counter": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/slashing/v1beta1/signing_infos/{cons_address}
Retrieves the signing info of given cons address.
Parameters
cons_address
(string, required): an address to query signing info for.
Returns
The signing info of all specified cons address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/slashing/v1beta1/signing_infos/{cons_address}
Response example
{
"val_signing_info": {
"address": "string",
"start_height": "string",
"index_offset": "string",
"jailed_until": "2021-01-19T06:34:40.106Z",
"tombstoned": true,
"missed_blocks_counter": "string"
}
}
Staking methods
/cosmos/staking/v1beta1/delegations/{delegator_addr}
Retrieves all delegations of a given delegator address.
Parameters
delegator_addr
(string, required): a delegator address to query for.pagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegations from a specific delegator address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegations/{delegator_addr}
Response example
{
"delegation_responses": [
{
"delegation": {
"delegator_address": "string",
"validator_address": "string",
"shares": "string"
},
"balance": {
"denom": "string",
"amount": "string"
}
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations
Retrieves the redelegations of a given address.
Parameters
delegator_addr
(string, required): a delegator address to query for.src_validator_addr
(string): the validator address to redelegate from.dst_validator_addr
(string): the validator address to redelegate to.pagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
string, uint64
: a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegations from a specific delegator address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations
Response example
{
"redelegation_responses": [
{
"redelegation": {
"delegator_address": "string",
"validator_src_address": "string",
"validator_dst_address": "string",
"entries": [
{
"creation_height": "string",
"completion_time": "2021-01-19T06:58:45.718Z",
"initial_balance": "string",
"shares_dst": "string"
}
]
},
"entries": [
{
"redelegation_entry": {
"creation_height": "string",
"completion_time": "2021-01-19T06:58:45.718Z",
"initial_balance": "string",
"shares_dst": "string"
},
"balance": "string"
}
]
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations
Retrieves all unbonding delegations of a given delegator address.
Parameters
delegator_addr
(string, required): a delegator address to query for.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Unbonding delegations from a specific delegator address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations
Response example
{
"unbonding_responses": [
{
"delegator_address": "string",
"validator_address": "string",
"entries": [
{
"creation_height": "string",
"completion_time": "2021-01-19T07:01:25.628Z",
"initial_balance": "string",
"balance": "string"
}
]
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators
Retrieves all validators info for given delegator address.
Parameters
delegator_addr
(string; required): a delegator address to query for.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Validator info for a specific delegator address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators
Response example
{
"validators": [
{
"operator_address": "string",
"consensus_pubkey": {
"type_url": "string",
"value": "string"
},
"jailed": true,
"status": "BOND_STATUS_UNSPECIFIED",
"tokens": "string",
"delegator_shares": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"unbonding_height": "string",
"unbonding_time": "2021-01-19T07:06:38.006Z",
"commission": {
"commission_rates": {
"rate": "string",
"max_rate": "string",
"max_change_rate": "string"
},
"update_time": "2021-01-19T07:06:38.006Z"
},
"min_self_delegation": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}
Retrieves validator info for a given delegator-validator pair.
Parameters
delegator_addr
(string; required): a delegator address to query for.validator_addr
(string; required): a validator address to query for.
Returns
Validator info for a given delegator pair.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}
Response example
{
"validator": {
"operator_address": "string",
"consensus_pubkey": {
"type_url": "string",
"value": "string"
},
"jailed": true,
"status": "BOND_STATUS_UNSPECIFIED",
"tokens": "string",
"delegator_shares": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"unbonding_height": "string",
"unbonding_time": "2021-01-19T07:08:34.100Z",
"commission": {
"commission_rates": {
"rate": "string",
"max_rate": "string",
"max_change_rate": "string"
},
"update_time": "2021-01-19T07:08:34.100Z"
},
"min_self_delegation": "string"
}
}
/cosmos/staking/v1beta1/historical_info/{height}
Retrieves the historical info for a given height.
Parameters
height
(string, int64): defines at which height to query the historical info for.
Returns
Historical info for a given height.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/historical_info/{height}
Response example
{
"hist": {
"header": {
"version": {
"block": "string",
"app": "string"
},
"chain_id": "string",
"height": "string",
"time": "2021-01-19T07:13:57.974Z",
"last_block_id": {
"hash": "string",
"part_set_header": {
"total": 0,
"hash": "string"
}
},
"last_commit_hash": "string",
"data_hash": "string",
"validators_hash": "string",
"next_validators_hash": "string",
"consensus_hash": "string",
"app_hash": "string",
"last_results_hash": "string",
"evidence_hash": "string",
"proposer_address": "string"
},
"valset": [
{
"operator_address": "string",
"consensus_pubkey": {
"type_url": "string",
"value": "string"
},
"jailed": true,
"status": "BOND_STATUS_UNSPECIFIED",
"tokens": "string",
"delegator_shares": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"unbonding_height": "string",
"unbonding_time": "2021-01-19T07:13:57.974Z",
"commission": {
"commission_rates": {
"rate": "string",
"max_rate": "string",
"max_change_rate": "string"
},
"update_time": "2021-01-19T07:13:57.974Z"
},
"min_self_delegation": "string"
}
]
}
}
/cosmos/staking/v1beta1/params
Retrieves the staking parameters.
Parameters
None.
Returns
Staking parameters.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/params
Response example
{
"params": {
"unbonding_time": "string",
"max_validators": 0,
"max_entries": 0,
"historical_entries": 0,
"bond_denom": "string"
}
}
/cosmos/staking/v1beta1/pool
Retrieves the pool info.
Parameters
None.
Returns
Pool info.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/pool
Response example
{
"pool": {
"not_bonded_tokens": "string",
"bonded_tokens": "string"
}
}
/cosmos/staking/v1beta1/validators
Retrieves all validators that match the given status.
Parameters
status
(string): a status to query validators by.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Validators that match the given status.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators
Response example
{
"validators": [
{
"operator_address": "string",
"consensus_pubkey": {
"type_url": "string",
"value": "string"
},
"jailed": true,
"status": "BOND_STATUS_UNSPECIFIED",
"tokens": "string",
"delegator_shares": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"unbonding_height": "string",
"unbonding_time": "2021-01-19T07:21:25.914Z",
"commission": {
"commission_rates": {
"rate": "string",
"max_rate": "string",
"max_change_rate": "string"
},
"update_time": "2021-01-19T07:21:25.914Z"
},
"min_self_delegation": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/validators/{validator_addr}
Retrieves validator info for a given validator address.
Parameters
validator_addr
(string; required): a validator address to query for.
Returns
Validator info for a given validator address.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}
Response example
{
"validator": {
"operator_address": "string",
"consensus_pubkey": {
"type_url": "string",
"value": "string"
},
"jailed": true,
"status": "BOND_STATUS_UNSPECIFIED",
"tokens": "string",
"delegator_shares": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"unbonding_height": "string",
"unbonding_time": "2021-01-19T07:25:26.679Z",
"commission": {
"commission_rates": {
"rate": "string",
"max_rate": "string",
"max_change_rate": "string"
},
"update_time": "2021-01-19T07:25:26.679Z"
},
"min_self_delegation": "string"
}
}
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations
Retrieves delegate info for a given validator.
Parameters
validator_addr
(string; required): a validator address to query for.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
string, uint64
: a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Delegate info for a given validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations
Response example
{
"delegation_responses": [
{
"delegation": {
"delegator_address": "string",
"validator_address": "string",
"shares": "string"
},
"balance": {
"denom": "string",
"amount": "string"
}
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}
Retrieves delegate info for a given validator-delegator pair.
Parameters
validator_addr
(string; required): a validator address to query for.delegator_addr
(string; required): a delegator address to query for.
Returns
Delegate info for a given validator delegator pair.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}
Response example
{
"delegation_response": {
"delegation": {
"delegator_address": "string",
"validator_address": "string",
"shares": "string"
},
"balance": {
"denom": "string",
"amount": "string"
}
}
}
/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation
Retrieves unbonding info for a given validator-delegator pair.
Parameters
validator_addr
(string; required): a validator address to query for.delegator_addr
(string; required): a delegator address to query for.
Returns
Unbonding info for a given validator delegator pair.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation
Response example
{
"unbond": {
"delegator_address": "string",
"validator_address": "string",
"entries": [
{
"creation_height": "string",
"completion_time": "2021-01-19T07:35:28.235Z",
"initial_balance": "string",
"balance": "string"
}
]
}
}
/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations
Retrieves unbonding delegations of a validator.
Parameters
validator_addr
(string, required): a validator address to query for.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Unbonding info for a given validator.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations
Response example
{
"unbonding_responses": [
{
"delegator_address": "string",
"validator_address": "string",
"entries": [
{
"creation_height": "string",
"completion_time": "2021-01-19T07:37:20.281Z",
"initial_balance": "string",
"balance": "string"
}
]
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
Upgrade methods
/cosmos/upgrade/v1beta1/applied_plan/{name}
Retrieves a previously applied upgrade plan by its name.
Parameters
name
(string; required): a name of the applied plan to query for.
Returns
Previously applied upgrade plan.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/applied_plan/{name}
Response example
{
"height": "string"
}
/cosmos/upgrade/v1beta1/current_plan
Retrieves the current upgrade plan.
Parameters
name
(string; required): a name of the applied plan to query for.
Returns
Current upgrade plan.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/current_plan
Response example
{
"plan": {
"name": "string",
"time": "2021-01-19T07:49:08.875Z",
"height": "string",
"info": "string",
"upgraded_client_state": {
"type_url": "string",
"value": "string"
}
}
}
/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}
Retrieves the consensus state that will serve as a trusted kernel for the next version of this chain.
It will only be stored at the last height of this chain, not supported with legacy querier.
Parameters
last_height
(string, int64): a required last height under which next consensus state is stored.
Returns
Consensus state.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}
Response example
{
"upgraded_consensus_state": {
"type_url": "string",
"value": "string"
}
}
Ibc core methods
/ibc/core/channel/v1beta1/channels
Retrieves all the IBC channels of a chain.
Parameters
pagination.key
(string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC channels of a chain.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels
Response example
{
"channels": [
{
"state": "STATE_UNINITIALIZED_UNSPECIFIED",
"ordering": "ORDER_NONE_UNSPECIFIED",
"counterparty": {
"port_id": "string",
"channel_id": "string"
},
"connection_hops": [
"string"
],
"version": "string",
"port_id": "string",
"channel_id": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
},
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}
Retrieves an IBC Channel.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.
Returns
IBC channels of a chain.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}
Response example
{
"channel": {
"state": "STATE_UNINITIALIZED_UNSPECIFIED",
"ordering": "ORDER_NONE_UNSPECIFIED",
"counterparty": {
"port_id": "string",
"channel_id": "string"
},
"connection_hops": [
"string"
],
"version": "string"
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state
Retrieves the client state for the channel associated with the provided channel identifiers.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.
Returns
Client state.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state
Response example
{
"identified_client_state": {
"client_id": "string",
"client_state": {
"type_url": "string",
"value": "string"
}
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Retrieves the consensus state for the channel associated with the provided channel identifiers.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.revision_number
(string, uint64; required): a revision number of the consensus state.revision_height
string, uint64; required: a revision height of the consensus state.
Returns
Consensus state.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Response example
{
"consensus_state": {
"type_url": "string",
"value": "string"
},
"client_id": "string",
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence
Retrieves the next receive sequence for a given channel.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.
Returns
Next receive sequence.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence
Response example
{
"next_sequence_receive": "string",
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements
Retrieves all the packet acknowledgements associated with a channel.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Packet acknowledgements.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements
Response example
{
"acknowledgements": [
{
"port_id": "string",
"channel_id": "string",
"sequence": "string",
"data": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
},
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}
Retrieves a stored packet acknowledgement hash.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.sequence
(string, uint64): a packet sequence.
Returns
Packet acknowledgements.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}
Response example
{
"acknowledgement": "string",
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments
Retrieves all the packet commitments hashes associated with a channel.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Packet commitments.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments
Response example
{
"commitments": [
{
"port_id": "string",
"channel_id": "string",
"sequence": "string",
"data": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
},
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks
Retrieves all the unreceived IBC acknowledgements associated with a channel and sequences.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.packet_ack_sequence
(array[string]): a required list of acknowledgement sequences.
Returns
Unreceived IBC acknowledgements.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks
Response example
{
"sequences": [
"string"
],
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets
Retrieves all the unreceived IBC packets associated with a channel and sequences.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.packet_commitment_sequences
(array[string]): a list of packet sequences.
Returns
Unreceived IBC packets.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets
Response example
{
"sequences": [
"string"
],
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}
Retrieves a stored packet commitment hash.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.packet_commitment_sequences
(array[string]): a list of packet sequences.
Returns
Packet commitment hash.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}
Response example
{
"commitment": "string",
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}
Checks whether a given packet sequence has been received on the queried chain.
Parameters
channel_id
(string; required): a channel unique identifier.port_id
(string; required): a port unique identifier.sequence
(string, uint64): a required packet sequence.
Returns
Whether the given packet has been received or not.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}
Response example
{
"received": true,
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/channel/v1beta1/connections/{connection}/channels
Retrieves all the channels associated with a connection end.
Parameters
connection
(string, required): a connection unique identifier.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
string($uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Channels associated with a connection.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/channel/v1beta1/connections/{connection}/channels
Response example
{
"channels": [
{
"state": "STATE_UNINITIALIZED_UNSPECIFIED",
"ordering": "ORDER_NONE_UNSPECIFIED",
"counterparty": {
"port_id": "string",
"channel_id": "string"
},
"connection_hops": [
"string"
],
"version": "string",
"port_id": "string",
"channel_id": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
},
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/client/v1beta1/params
Retrieves all parameters of the IBC client.
Parameters
None.
Returns
Params of the IBC client.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/client/v1beta1/params
Response example
{
"params": {
"allowed_clients": [
"string"
]
}
}
/ibc/core/client/v1beta1/client_states
Retrieves all the IBC light clients of a chain.
Parameters
pagination.key
(string; byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string; uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string; uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC light clients.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states
Response example
{
"client_states": [
{
"client_id": "string",
"client_state": {
"type_url": "string",
"value": "string"
}
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/ibc/core/client/v1beta1/client_states/{client_id}
Retrieves an IBC light client.
Parameters
client_id
(string; required): a client state unique identifier.
Returns
IBC light client from client_id.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/client_states/{client_id}
Response example
{
"client_state": {
"type_url": "string",
"value": "string"
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/client/v1beta1/consensus_states/{client_id}
Retrieves all the consensus state associated with a given client.
Parameters
client_id
(string; required): a client unique identifier.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Consensus state associated with given client
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}
Response example
{
"consensus_states": [
{
"height": {
"revision_number": "string",
"revision_height": "string"
},
"consensus_state": {
"type_url": "string",
"value": "string"
}
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}
Retrieves a consensus state associated with a client state at a given height.
Parameters
channel_id
(string; required): a channel unique identifier.revision_number
(string, uint64): a required consensus state revision number.revision_height
(string, uint64): a required consensus state revision height.latest_height
(boolean): overrides the height field and queries the latest stored consensus state.
Returns
Consensus state associated with a client state at a given height.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}
Response example
{
"consensus_state": {
"type_url": "string",
"value": "string"
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/connection/v1beta1/client_connections/{client_id}
Retrieves the connection paths associated with a client state.
Parameters
client_id
(string, required): a client identifier associated with a connection.
Returns
Connections paths associated with a client state.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/client_connections/{client_id}
Response example
{
"connection_paths": [
"string"
],
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/connection/v1beta1/connections
Retrieves all the IBC connections of a chain.
Parameters
pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
IBC connections.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections
Response example
{
"connections": [
{
"id": "string",
"client_id": "string",
"versions": [
{
"identifier": "string",
"features": [
"string"
]
}
],
"state": "STATE_UNINITIALIZED_UNSPECIFIED",
"counterparty": {
"client_id": "string",
"connection_id": "string",
"prefix": {
"key_prefix": "string"
}
},
"delay_period": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
},
"height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/connection/v1beta1/connections/{connection_id}
Retrieves an IBC connection end.
Parameters
connection_id
(string; required): a connection unique identifier.
Returns
IBC connections end.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}
Response example
{
"connection": {
"client_id": "string",
"versions": [
{
"identifier": "string",
"features": [
"string"
]
}
],
"state": "STATE_UNINITIALIZED_UNSPECIFIED",
"counterparty": {
"client_id": "string",
"connection_id": "string",
"prefix": {
"key_prefix": "string"
}
},
"delay_period": "string"
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/connection/v1beta1/connections/{connection_id}/client_state
Retrieves the client state associated with the connection.
Parameters
connection_id
(string; required): a connection unique identifier.
Returns
Client state.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}/client_state
Response example
{
"identified_client_state": {
"client_id": "string",
"client_state": {
"type_url": "string",
"value": "string"
}
},
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Retrieves the consensus state associated with the connection.
Parameters
connection_id
(string; required): a connection unique identifier.revision_number
(string, uint64): a required revision number.revision_height
(string, uint64): a required revision height.
Returns
Consensus state.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}
Response example
{
"consensus_state": {
"type_url": "string",
"value": "string"
},
"client_id": "string",
"proof": "string",
"proof_height": {
"revision_number": "string",
"revision_height": "string"
}
}
Ibc applications methods
/ibc/applications/transfer/v1beta1/denom_traces
Retrieves all denomination traces.
Parameters
pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Denomination traces.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/denom_traces
Response example
{
"denom_traces": [
{
"path": "string",
"base_denom": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/ibc/applications/transfer/v1beta1/denom_traces/{hash}
Retrieves a denomination trace information by hash.
Parameters
hash
(string, hex; required): a hash of the denomination trace information.
Returns
Denomination traces.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/denom_traces/{hash}
Response example
{
"denom_trace": {
"path": "string",
"base_denom": "string"
}
}
/ibc/applications/transfer/v1beta1/params
Retrieves all parameters of the IBC transfer module.
Parameters
None.
Returns
Parameters of the IBC transfer module.
Request example
curl https://rpc.ankr.com/http/kava_api/ibc/applications/transfer/v1beta1/params
Response example
{
"params": {
"send_enabled": true,
"receive_enabled": true
}
}
Tx methods
/cosmos/tx/v1beta1/simulate
Simulates executing a transaction for estimating gas usage.
Parameters
<body>
(object; required):
{
"tx": {
"body": {
"messages": [
{
"type_url": "string",
"value": "string"
}
],
"memo": "string",
"timeout_height": "string",
"extension_options": [
{
"type_url": "string",
"value": "string"
}
],
"non_critical_extension_options": [
{
"type_url": "string",
"value": "string"
}
]
},
"auth_info": {
"signer_infos": [
{
"public_key": {
"type_url": "string",
"value": "string"
},
"mode_info": {
"single": {
"mode": "SIGN_MODE_UNSPECIFIED"
},
"multi": {
"bitarray": {
"extra_bits_stored": 0,
"elems": "string"
},
"mode_infos": [
null
]
}
},
"sequence": "string"
}
],
"fee": {
"amount": [
{
"denom": "string",
"amount": "string"
}
],
"gas_limit": "string",
"payer": "string",
"granter": "string"
}
},
"signatures": [
"string"
]
}
}
Returns
Estimated gas usage.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/simulate
Response example
{
"gas_info": {
"gas_wanted": "string",
"gas_used": "string"
},
"result": {
"data": "string",
"log": "string",
"events": [
{
"type": "string",
"attributes": [
{
"key": "string",
"value": "string",
"index": true
}
]
}
]
}
}
/cosmos/tx/v1beta1/txs
Fetches txs by event.
Parameters
events
(array[string]): a list of transaction event type.pagination.key
(string, byte): a value returned inPageResponse.next_key
to begin querying the next page efficiently. Only one ofoffset
orkey
should be set.pagination.key
(string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one ofoffset
orkey
should be set.pagination.limit
(string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.pagination.count_total
(boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected whenoffset
is used, ignored whenkey
is set.
Returns
Transactions.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/txs
Response example
{
"txs": [
{
"body": {
"messages": [
{
"type_url": "string",
"value": "string"
}
],
"memo": "string",
"timeout_height": "string",
"extension_options": [
{
"type_url": "string",
"value": "string"
}
],
"non_critical_extension_options": [
{
"type_url": "string",
"value": "string"
}
]
},
"auth_info": {
"signer_infos": [
{
"public_key": {
"type_url": "string",
"value": "string"
},
"mode_info": {
"single": {
"mode": "SIGN_MODE_UNSPECIFIED"
},
"multi": {
"bitarray": {
"extra_bits_stored": 0,
"elems": "string"
},
"mode_infos": [
null
]
}
},
"sequence": "string"
}
],
"fee": {
"amount": [
{
"denom": "string",
"amount": "string"
}
],
"gas_limit": "string",
"payer": "string",
"granter": "string"
}
},
"signatures": [
"string"
]
}
],
"tx_responses": [
{
"height": "string",
"txhash": "string",
"codespace": "string",
"code": 0,
"data": "string",
"raw_log": "string",
"logs": [
{
"msg_index": 0,
"log": "string",
"events": [
{
"type": "string",
"attributes": [
{
"key": "string",
"value": "string"
}
]
}
]
}
],
"info": "string",
"gas_wanted": "string",
"gas_used": "string",
"tx": {
"type_url": "string",
"value": "string"
},
"timestamp": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
/cosmos/tx/v1beta1/txs
Broadcasts a transaction.
Parameters
<body>
(object; required):
{
"tx_bytes": "string",
"mode": "BROADCAST_MODE_UNSPECIFIED"
}
Returns
Broadcasted transaction.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/txs
Response example
{
"tx_response": {
"height": "string",
"txhash": "string",
"codespace": "string",
"code": 0,
"data": "string",
"raw_log": "string",
"logs": [
{
"msg_index": 0,
"log": "string",
"events": [
{
"type": "string",
"attributes": [
{
"key": "string",
"value": "string"
}
]
}
]
}
],
"info": "string",
"gas_wanted": "string",
"gas_used": "string",
"tx": {
"type_url": "string",
"value": "string"
},
"timestamp": "string"
}
}
/cosmos/tx/v1beta1/txs/{hash}
Fetches a tx by hash.
Parameters
hash
(string, hex; required): a tx hash to query, encoded as a hex string.
Returns
Transaction.
Request example
curl https://rpc.ankr.com/http/kava_api/cosmos/tx/v1beta1/txs/{hash}
Response example
{
"tx": {
"body": {
"messages": [
{
"type_url": "string",
"value": "string"
}
],
"memo": "string",
"timeout_height": "string",
"extension_options": [
{
"type_url": "string",
"value": "string"
}
],
"non_critical_extension_options": [
{
"type_url": "string",
"value": "string"
}
]
},
"auth_info": {
"signer_infos": [
{
"public_key": {
"type_url": "string",
"value": "string"
},
"mode_info": {
"single": {
"mode": "SIGN_MODE_UNSPECIFIED"
},
"multi": {
"bitarray": {
"extra_bits_stored": 0,
"elems": "string"
},
"mode_infos": [
null
]
}
},
"sequence": "string"
}
],
"fee": {
"amount": [
{
"denom": "string",
"amount": "string"
}
],
"gas_limit": "string",
"payer": "string",
"granter": "string"
}
},
"signatures": [
"string"
]
},
"tx_response": {
"height": "string",
"txhash": "string",
"codespace": "string",
"code": 0,
"data": "string",
"raw_log": "string",
"logs": [
{
"msg_index": 0,
"log": "string",
"events": [
{
"type": "string",
"attributes": [
{
"key": "string",
"value": "string"
}
]
}
]
}
],
"info": "string",
"gas_wanted": "string",
"gas_used": "string",
"tx": {
"type_url": "string",
"value": "string"
},
"timestamp": "string"
}
}