JSON-RPC

The following RPC endpoints are available

  • net_version

  • web3_clientVersion

  • eth_blockNumber

  • eth_call

    • only the latest block is supported

  • eth_chainId

  • eth_estimateGas

    • only the latest block is supported

  • eth_feeHistory

  • eth_gasPrice

    • returns the base fee for the next small block

  • eth_getBalance

    • only the latest block is supported

  • eth_getBlockByHash

  • eth_getBlockByNumber

  • eth_getBlockReceipts

  • eth_getBlockTransactionCountByHash

  • eth_getBlockTransactionCountByNumber

  • eth_getCode

    • only the latest block is supported

  • eth_getLogs

    • up to 4 topics

    • up to 50 blocks in query range

  • eth_getStorageAt

    • only the latest block is supported

  • eth_getTransactionByBlockHashAndIndex

  • eth_getTransactionByBlockNumberAndIndex

  • eth_getTransactionByHash

  • eth_getTransactionCount

    • only the latest block is supported

  • eth_getTransactionReceipt

  • eth_maxPriorityFeePerGas

    • always returns zero currently

  • eth_syncing

    • always returns false

The following custom endpoints are available

  • eth_bigBlockGasPrice

    • returns the base fee for the next big block

  • eth_getSystemTxsByBlockHash and eth_getSystemTxsByBlockNumber

    • similar to the "getTransaction" analogs but returns the system transactions that originate from HyperCore

Unsupported requests

  • Requests that require historical state are not supported at this time on the default RPC implementation. However, independent archive node implementations are available for use, and the GitHub repository has examples on how to get started indexing historical data locally. Note that read precompiles are only recorded for the calls actually made on each block. Hypothetical read precompile results could be obtained from a full L1 replay.

Last updated