Ethereum Node RPC

JSON-RPC Endpoint https://api.chain-rpc.online/ethereum
This page groups methods by their function to simplify navigation and understanding for developers working with Ethereum.

curl example

curl https://api.chain-rpc.online/ethereum \
  -X POST -H "Content-Type: application/json" \
  -H "x-api-key: test" \
  -d '{ "jsonrpc": "2.0", "id": 1,
    "method": "eth_getBalance",
    "params": [
      "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
      "finalized"
    ]
}'

Refferences
JSON-RPC doc

Getting Block Information

Retrieve data about specific blocks in the Ethereum blockchain. Block data is foundational for accessing transactions, timestamps, miner information, and more. Use these methods to obtain in-depth details about a block by its hash, number, or transaction count.

• eth_blockNumber - Returns the latest block number in the chain.
• eth_getBlockByHash - Fetches block details using its hash.
• eth_getBlockByNumber - Retrieves block information by block number.
• eth_getBlockTransactionCountByHash - Counts transactions in a block specified by hash.
• eth_getBlockTransactionCountByNumber - Counts transactions in a block specified by number.

Reading Transactions

Retrieve detailed transaction data for specific addresses, whether they’re user accounts or smart contracts. These methods provide transaction insights that are critical for analyzing transaction history and validating data.

• eth_getTransactionByHash - Finds a transaction using its hash.
• eth_getTransactionByBlockHashAndIndex - Retrieves a transaction in a block by its hash and index.
• eth_getTransactionByBlockNumberAndIndex - Retrieves a transaction by block number and index.
• eth_getTransactionReceipt - Returns the receipt of a specific transaction.
• eth_getTransactionCount - Counts transactions sent from an address.

Writing Transactions & Executing EVM Code

Enables developers to send ETH, write on-chain data, and interact with Ethereum smart contracts. These are essential for deploying contracts, managing assets, and performing EVM (Ethereum Virtual Machine) executions.

• eth_sendRawTransaction - Sends a signed transaction to the network.
• eth_call - Executes a new message call (interaction) on the Ethereum blockchain.

Accessing Account Information

Retrieve information related to Ethereum accounts, including balance, stored code, and data. Useful for checking account status, balance, and on-chain data storage.

• eth_getCode - Fetches the bytecode of a smart contract.
• eth_getBalance - Returns integer in hex format of the current balance in wei. Wei is the smallest unit of ether (1 ether = wei 10^18 wei).
• eth_accounts - Lists accounts owned by the client.
• eth_getStorageAt - Reads data from an address's storage.
• eth_getProof - Provides a Merkle proof for storage or an account.

Event Logs

Event logs are records of specific actions within smart contracts, such as transfers or ownership changes. These methods allow you to monitor and retrieve log entries related to particular events.

• eth_getLogs - Retrieves event logs from the blockchain.
• eth_newFilter - Creates a filter for capturing new log events.
• eth_newPendingTransactionFilter - Creates a filter for new pending transactions.
• eth_newBlockFilter - Sets up a filter for new blocks.
• eth_getFilterChanges - Checks changes in a specified filter.
• eth_getFilterLogs - Gets logs based on filter parameters.
• eth_uninstallFilter - Removes an existing filter.

Chain Information

Retrieve details about the Ethereum network, including chain ID, protocol version, and network status. This information is essential for ensuring compatibility with different network configurations.

• eth_chainId - Returns the unique ID of the Ethereum chain.
• eth_protocolVersion - Specifies the protocol version of the Ethereum network.
• net_listening - Checks if the client is actively listening for connections.
• net_version - Provides the network version.

Accessing Uncle Blocks

Uncle blocks are blocks that were initially valid but ultimately replaced by another block. These methods allow you to gather information about uncle blocks, which can offer insight into block validation and network reorganization.

• eth_getUncleCountByBlockHash - Counts uncle blocks by parent block hash.
• eth_getUncleByBlockNumberAndIndex - Fetches an uncle block by number and index.
• eth_getUncleByBlockHashAndIndex - Retrieves an uncle by hash and index.
• eth_getUncleCountByBlockNumber - Counts uncles by block number.

Gas Estimation

Gas estimation methods provide information on gas prices and fees, which are crucial for developers to estimate transaction costs and ensure transactions are processed promptly.

• eth_estimateGas - Estimates the gas required for a transaction.
• eth_gasPrice - Returns the current gas price.
• eth_feeHistory - Provides historical gas fee data.
• eth_maxPriorityFeePerGas - Suggests a priority fee for prompt transaction processing.
• eth_createAccessList - Generates access lists for transactions to optimize gas usage.

Web3 Client Interaction

These Web3 methods are designed for general client interaction and network configuration, allowing for client and version verification.

• web3_clientVersion - Shows the version of the client.
• web3_sha3 - Computes the Keccak-256 (SHA3) hash of input data.