PerformanceBlog
Tempo MCP serverGive agents search and read tools for Tempo docs
Skip to content
LogoLogo

RPC

Direct access to the chain over Ethereum JSON-RPC. Not part of the stable API contract; best-effort support only. No compatibility, latency, availability, or data-freshness guarantees. Breaking changes may happen with limited notice.

admin_validatorKey

POST/rpc/{chain}

Returns the validator public key configured on the node, or null for non-validator nodes.

Responses

consensus_getFinalization

POST/rpc/{chain}

Returns a finalized consensus block by height or the latest finalized block.

Parameters

QueryRequired

Responses

consensus_getIdentityTransitionProof

POST/rpc/{chain}

Returns DKG identity transition proofs for the network identity at a requested epoch.

Parameters

from_epoch
integer·min 0
Examplenull
full
boolean
Examplefalse

Responses

consensus_getLatest

POST/rpc/{chain}

Returns the current consensus state snapshot, including the latest finalized block and latest notarized block.

Responses

consensus_subscribe

POST/rpc/{chain}

Subscribes to consensus events over WebSocket.

Responses

consensus_unsubscribe

POST/rpc/{chain}

Unsubscribes from a consensus event subscription.

Parameters

Subscription IDRequired
string

Responses

eth_blockNumber

POST/rpc/{chain}

Returns the number of most recent block.

Responses

eth_call

POST/rpc/{chain}

Executes a new message call immediately without creating a transaction on the block chain.

Parameters

TransactionRequired
object
Example{"to":"0x69498dd54bd25aa0c886cf1f8b8ae0856d55ff13","value":"0x1"}

Block

Responses

eth_chainId

POST/rpc/{chain}

Returns the chain ID of the current network.

Responses

eth_createAccessList

POST/rpc/{chain}

Generates an access list for a transaction.

Parameters

TransactionRequired
object
Example{"data":"0x608060806080608155","from":"0xaea8f8f781326bfe6a7683c2bd48dd6aa4d3ba63"}

Block

Responses

eth_estimateGas

POST/rpc/{chain}

Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.

Parameters

TransactionRequired
object
Example{"from":"0xfe3b557e8fb62b89f4916b721be55ceb828dbd73","to":"0x44aa93095d6749a706051658b970b941c72c1d53","value":"0x1"}

Block

Responses

eth_feeHistory

POST/rpc/{chain}

Transaction fee history

Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range.

Parameters

blockCountRequired
string

Requested range of blocks. Clients will return less than the requested range if not all blocks are available.

Example0x5
newestBlockRequired

Highest block of the requested range.

rewardPercentilesRequired
number[]

A monotonically increasing list of percentile values. For each block in the requested range, the transactions will be sorted in ascending order by effective tip per gas and the corresponding effective tip for the percentile will be determined, accounting for gas consumed.

Example[20,30]

Responses

eth_fillTransaction

POST/rpc/{chain}

Fills the defaults (nonce, gas, fees, chainId, …) on a given unsigned transaction, returning the filled transaction object and its raw EIP-2718 encoding.

Parameters

TransactionRequired
object
Example{"to":"0x44aa93095d6749a706051658b970b941c72c1d53","input":"0xa9059cbb000000000000000000000000627306090abab3a6e1400e9345bc60c78a8bef570000000000000000000000000000000000000000000000000de0b6b3a7640000"}

Responses

eth_gasPrice

POST/rpc/{chain}

Returns the current price per gas in wei.

Responses

eth_getBlockAccessList

POST/rpc/{chain}

Returns the block access list for a given block.

Parameters

BlockRequired

Responses

eth_getBlockByHash

POST/rpc/{chain}

Returns information about a block by hash.

Parameters

Block hashRequired
string
Example0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c
Hydrated transactionsRequired
boolean
Examplefalse

Responses

eth_getBlockByNumber

POST/rpc/{chain}

Returns information about a block by number.

Parameters

BlockRequired
Hydrated transactionsRequired
boolean
Examplefalse

Responses

eth_getBlockReceipts

POST/rpc/{chain}

Returns the receipts of a block by number or hash.

Parameters

BlockRequired

Responses

eth_getBlockTransactionCountByHash

POST/rpc/{chain}

Returns the number of transactions in a block from a block matching the given block hash.

Parameters

Block hash
string
Example0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238

Responses

eth_getBlockTransactionCountByNumber

POST/rpc/{chain}

Returns the number of transactions in a block matching the given block number.

Parameters

Block

Responses

eth_getCode

POST/rpc/{chain}

Returns code at a given address.

Parameters

AddressRequired
string
Example0xa50a51c09a5c451c52bb714527e1974b686d8e77
BlockRequired

Responses

eth_getFilterChanges

POST/rpc/{chain}

Polling method for the filter with the given ID (created using eth_newFilter). Returns an array of logs, block hashes, or transaction hashes since last poll, depending on the installed filter.

Parameters

Filter identifierRequired
string
Example0x01

Responses

eth_getFilterLogs

POST/rpc/{chain}

Returns an array of all logs matching the filter with the given ID (created using eth_newFilter).

Parameters

Filter identifierRequired
string
Example0x01

Responses

eth_getLogs

POST/rpc/{chain}

Returns an array of all logs matching the specified filter.

Parameters

FilterRequired

Responses

eth_getProof

POST/rpc/{chain}

Returns the merkle proof for a given account and optionally some storage keys.

Parameters

AddressRequired
string
Example0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8
StorageKeysRequired
string[]
Example["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"]
BlockRequired

Responses

eth_getStorageAt

POST/rpc/{chain}

Returns the value from a storage position at a given address.

Parameters

AddressRequired
string
Example0xfe3b557e8fb62b89f4916b721be55ceb828dbd73
Storage slotRequired
string
Example0x0
BlockRequired

Responses

eth_getStorageValues

POST/rpc/{chain}

Returns the values of multiple storage slots for multiple accounts in a single request.

Parameters

RequestsRequired
object
Example{"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48":["0x0000000000000000000000000000000000000000000000000000000000000003"],"0xdAC17F958D2ee523a2206206994597C13D831ec7":["0x0000000000000000000000000000000000000000000000000000000000000002","0x0000000000000000000000000000000000000000000000000000000000000006"]}
BlockRequired

Responses

eth_getTransactionByBlockHashAndIndex

POST/rpc/{chain}

Returns information about a transaction by block hash and transaction index position.

Parameters

Block hashRequired
string
Example0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7
Transaction indexRequired
string
Example0x2

Responses

eth_getTransactionByBlockNumberAndIndex

POST/rpc/{chain}

Returns information about a transaction by block number and transaction index position.

Parameters

BlockRequired
Transaction indexRequired
string
Example0x2

Responses

eth_getTransactionByHash

POST/rpc/{chain}

Returns the information about a transaction requested by transaction hash.

Parameters

Transaction hashRequired
string
Example0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44

Responses

eth_getTransactionCount

POST/rpc/{chain}

Returns the nonce of an account in the state. NOTE: The name eth_getTransactionCount reflects the historical fact that an account's nonce and sent transaction count were the same. After the Pectra fork, with the inclusion of EIP-7702, this is no longer true.

Parameters

AddressRequired
string
Example0xc94770007dda54cF92009BFF0dE90c06F603a09f
BlockRequired

Responses

eth_getTransactionReceipt

POST/rpc/{chain}

Returns the receipt of a transaction by transaction hash.

Parameters

Transaction hashRequired
string
Example0x504ce587a65bdbdb6414a0c6c16d86a04dd79bfcc4f2950eec9634b30ce5370f

Responses

eth_maxPriorityFeePerGas

POST/rpc/{chain}

Returns the current maxPriorityFeePerGas per gas in wei.

Responses

eth_newBlockFilter

POST/rpc/{chain}

Creates a filter in the node, allowing for later polling. Registers client interest in new blocks, and returns an identifier.

Responses

eth_newFilter

POST/rpc/{chain}

Install a log filter in the server, allowing for later polling. Registers client interest in logs matching the filter, and returns an identifier.

Parameters

FilterRequired

Responses

eth_newPendingTransactionFilter

POST/rpc/{chain}

Creates a filter in the node, allowing for later polling. Registers client interest in new transactions, and returns an identifier.

Responses

eth_sendRawTransaction

POST/rpc/{chain}

Submits a raw transaction. You can create and sign a transaction externally using a library such as web3.js or ethers.js. For EIP-4844 transactions, the raw form must be the network form. This means it includes the blobs, KZG commitments, and KZG proofs. For EIP-7594 transactions, the raw format must be the network form. This means it includes the blobs, KZG commitments, and cell proofs. The logic for handling the new transaction during fork boundaries are 1. When receiving an encoded transaction with cell proofs before the PeerDAS fork activates, we reject it. Only blob proofs are accepted into the pool. 2. At the time of fork activation, the implementer could (not mandatory) - Drop all old-format transactions - Convert old proofs to new format (computationally expensive) - Convert only when including in a locally produced block 3. After the fork has activated, only txs with cell proofs are accepted via p2p relay. 4. On RPC (eth_sendRawTransaction), txs with blob proofs may still be accepted and will be auto-converted by the node. At implementer discretion, this facility can be deprecated later when users have switched to new client libraries that can create cell proofs.

Parameters

TransactionRequired
string
Example0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833

Responses

eth_sendRawTransactionSync

POST/rpc/{chain}

Submits a raw (signed) transaction and waits for it to be included, returning its receipt. Returns a timeout error if the transaction is not included within the node-configured window.

Parameters

TransactionRequired
string
Example0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833

Responses

eth_simulateV1

POST/rpc/{chain}

Executes a sequence of message calls building on each other's state without creating transactions on the block chain, optionally overriding block and state data

Parameters

PayloadRequired
object

Block tag

default: 'latest'

Responses

eth_syncing

POST/rpc/{chain}

Returns an object with data about the sync status or false.

Responses

eth_uninstallFilter

POST/rpc/{chain}

Uninstalls a filter with given id.

Parameters

Filter identifierRequired
string
Example0x01

Responses

tempo_forkSchedule

POST/rpc/{chain}

Returns the Tempo fork schedule and the currently active fork at the chain head.

Responses

tempo_fundAddress

POST/rpc/{chain}

Mints test stablecoins to an address on faucet-enabled testnet endpoints and returns the transaction hashes.

Parameters

AddressRequired
string
Example0x627306090abab3a6e1400e9345bc60c78a8bef57

Responses