RPC Reference Guide

Request Format

• HTTP method: always “POST”
• Header: accept: application/json
• Header: content-type: application/json
• Body (JSON):
  • id: an arbitrary string identifier
  • jsonrpc: always “2.0”
  • method: endpoint name (e.g. “eth_sendRawTransaction”)
  • params: an array that differs from endpoint to endpoint

Response Format

• Body (JSON):
  • id: the same identifier in request
  • jsonrpc: always “2.0”
  • result: an object that differs from endpoint to endpoint
  • error (if applicable): error details

eth_sendRawTransaction

Sends a signed transaction.

• Parameters:

• Result:

eth_getTransactionReceipt

Gets the receipt of a sent transaction

• Parameters:

• Result:

eth_getTransactionByBlockNumberAndIndex

Gets transaction by the block number and the index of the transaction in the block

• Parameters:

• Result:

eth_getTransactionByBlockHashAndIndex

Gets transaction by the block hash and the index of the transaction in the block.

• Parameters:

• Result:

eth_getTransactionByHash

Gets transaction by the transaction hash.

• Parameters:

• Result:

eth_getTransactionCount

Gets the number of transactions sent by the account

• Parameters:

• Result:

eth_getBalance

Gets the balance in wei (i.e. 10^-12 usei) of the account

• Parameters:

• Result:

eth_getCode

Gets EVM code stored at the account address

• Parameters:

• Result:

eth_getStorageAt

Gets value at given key of the account

• Parameters:

• Result:

eth_getProof

Gets the IAVL proof of the given keys for an account.

• Parameters:

• Result:

Object Schema:

{
    address: // The requested address.
    hexValues: // An array of the hexdecimal form of the values at the given keys.
    storageProof: // An array of storage proofs.
}

Note: The storage proofs in the return object follow this format .

eth_getBlockTransactionCountByNumber

Gets the count of EVM transactions in a block by its number.

• Parameters:

• Result:

eth_getBlockTransactionCountByHash

Gets the count of EVM transactions in a block by its hash.

• Parameters:

• Result:

eth_getBlockByHash

Gets block metadata and, optionally, its EVM transactions by block hash.

• Parameters:

• Result:

eth_getBlockByNumber

Gets block metadata and, optionally, its EVM transactions by block number.

• Parameters:

• Result:

eth_getBlockReceipts

Gets an array of EVM transaction receipts in a block by its number.

• Parameters:

• Result:

eth_blockNumber

Gets the latest committed block number.

• Parameters:

None

• Result:

eth_chainId

Gets the chain ID.

• Parameters:

None

• Result:

eth_coinbase

Gets the fee-collector (coinbase) address.

• Parameters:

None

• Result:

eth_feeHistory

Gets fee history over a block range.

• Parameters:

• Result:

eth_gasPrice

Gets the 50th-percentile gas price in the most recent block.

• Parameters:

None

• Result:

net_version

Gets the chain ID. Alias for eth_chainId, but returns the chain ID as a decimal instead of hex.

• Parameters: None

• Result:

web3_clientVersion

Gets the RPC node’s client version.

• Parameters:

None

• Result:

eth_newFilter

Creates a new log filter.

• Parameters:

• Result:

eth_newBlockFilter

Creates a new block filter.

• Parameters:

None

• Result:

eth_getFilterChanges

Fetches updates since the last poll for a filter.

• Parameters:

• Result:

eth_getFilterLogs

Retrieves all logs matching a log filter, including historical logs.

• Parameters:

• Result:

eth_getLogs

Fetches logs matching given filter criteria.

• Parameters:

• Result:

eth_uninstallFilter

Removes a previously created filter.

• Parameters:

• Result:

Endpoints for simulating contract execution.

eth_estimateGas

Estimates gas usage for a transaction without broadcasting it.

• Parameters:

• Result:

eth_call

Executes a message call immediately without creating a transaction.

• Parameters:

• Result:

Endpoints for debugging transactions and blocks.

debug_traceTransaction

Traces the execution of a transaction by its hash.

• Parameters:

• Result:

debug_traceBlockByNumber

Traces all transactions in a block specified by number.

• Parameters:

• Result:

debug_traceBlockByHash

Traces all transactions in a block specified by hash.

• Parameters:

• Result:

sei_* methods:

sei2_* methods (block queries with bank transfers included):

sei_associate

Sends a transaction to establish association between the signer’s Sei address and EVM address on-chain.

• Parameters:

Object Schema:

{
    custom_message: // Any string message
    r: // The R-part of the signature over the Keccak256 hash of the custom message.
    s: // The S-part of the signature over the Keccak256 hash of the custom message.
    v: // The V-part of the signature over the Keccak256 hash of the custom message.
}

• Result:

sei_getSeiAddress

Returns the Sei (bech32) address associated with an EVM address.

• Parameters:

• Result:

Example Request

{
  "jsonrpc": "2.0",
  "method": "sei_getSeiAddress",
  "params": ["0x1234567890abcdef1234567890abcdef12345678"],
  "id": 1
}

sei_getEVMAddress

Returns the EVM address associated with a Sei (bech32) address.

• Parameters:

• Result:

Example Request

{
  "jsonrpc": "2.0",
  "method": "sei_getEVMAddress",
  "params": ["sei1..."],
  "id": 1
}

sei_getCosmosTx

Returns the Cosmos transaction details for a given EVM transaction hash.

• Parameters:

• Result:

Example Request

{
  "jsonrpc": "2.0",
  "method": "sei_getCosmosTx",
  "params": ["0xabc123..."],
  "id": 1
}