Standard Ethereum

Supported Ethereum RPC Methods

Introduction

While Phron supports a wide range of Ethereum JSON-RPC methods, not all are available, and some return default values—particularly those related to Ethereum’s Proof of Work (PoW) consensus mechanism. This guide provides a detailed list of the Ethereum JSON-RPC methods supported by Phron, allowing developers to easily reference the available functionality when interacting with Phron’s Ethereum-compatible blockchain.

Standard Ethereum JSON-RPC Methods

The basic JSON-RPC methods from the Ethereum API supported by Phron are:

• eth_protocolVersion — returns 1 by default

• eth_syncing — returns an object with data about the sync status or false

• eth_hashrate — returns "0x0" by default

• eth_coinbase — returns the latest block author. Not necessarily a finalized block

• eth_mining — returns false by default

• eth_chainId — returns the chain ID used for signing at the current block

• eth_gasPrice — returns the base fee per unit of gas used. This is currently the minimum gas price for each network

• eth_accounts — returns a list of addresses owned by the client

• eth_blockNumber — returns the highest available block number

• eth_getBalance — returns the balance of the given address

• eth_getStorageAt — returns the content of the storage at a given address

• eth_getBlockByHash — returns information about the block of the given hash, including baseFeePerGas on post-London blocks

• eth_getBlockByNumber — returns information about the block specified by block number, including baseFeePerGas on post-London blocks

• eth_getBlockReceipts — returns all transaction receipts for a given block

• eth_getTransactionCount — returns the number of transactions sent from the given address (nonce)

• eth_getBlockTransactionCountByHash — returns the number of transactions in a block with a given block hash

• eth_getBlockTransactionCountByNumber — returns the number of transactions in a block with a given block number

• eth_getUncleCountByBlockHash — returns "0x0" by default

• eth_getUncleCountByBlockNumber — returns "0x0" by default

• eth_getCode — returns the code at the given address at the given block number

• eth_sendTransaction — creates a new message call transaction or a contract creation, if the data field contains code. Returns the transaction hash or the zero hash if the transaction is not yet available

• eth_sendRawTransaction — creates a new message call transaction or a contract creation for signed transactions. Returns the transaction hash or the zero hash if the transaction is not yet available

• eth_call — executes a new message call immediately without creating a transaction on the blockchain, returning the value of the executed call

  • Phron supports the use of the optional state override set object. This address-to-state mapping object allows the user to specify some state to be ephemerally overridden before executing a call to eth_call. The state override set is commonly used for tasks like debugging smart contracts. Visit the go-ethereum documentation to learn more

• eth_estimateGas — returns an estimated amount of gas necessary for a given transaction to succeed. You can optionally specify a gasPrice or maxFeePerGas and maxPriorityFeePerGas

• eth_maxPriorityFeePerGas - returns an estimate of how much priority fee, in Wei, is needed for inclusion in a block

• eth_feeHistory — returns baseFeePerGas, gasUsedRatio, oldestBlock, and reward for a specified range of up to 1024 blocks

• eth_getTransactionByHash — returns the information about a transaction with a given hash. EIP-1559 transactions have maxPriorityFeePerGas and maxFeePerGas fields

• eth_getTransactionByBlockHashAndIndex — returns information about a transaction at a given block hash and a given index position. EIP-1559 transactions have maxPriorityFeePerGas and maxFeePerGas fields

• eth_getTransactionByBlockNumberAndIndex — returns information about a transaction at a given block number and a given index position. EIP-1559 transactions have maxPriorityFeePerGas and maxFeePerGas fields

• eth_getTransactionReceipt — returns the transaction receipt of a given transaction hash

• eth_getUncleByBlockHashAndIndex — returns null by default

• eth_getUncleByBlockNumberAndIndex — returns null by default

• eth_getLogs — returns an array of all logs matching a given filter object

• eth_newFilter — creates a filter object based on the input provided. Returns a filter ID

• eth_newBlockFilter — creates a filter in the node to notify when a new block arrives. Returns a filter ID

• eth_newPendingTransactionFilter - creates a filter in the node to notify when new pending transactions arrive. Returns a filter ID

• eth_getFilterChanges — polling method for filters (see methods above). Returns an array of logs that occurred since the last poll

• eth_getFilterLogs — returns an array of all the logs matching the filter with a given ID

• eth_uninstallFilter — uninstall a filter with a given ID. It should be used when polling is no longer needed. Filters timeout when they are not requested using eth_getFilterChanges after some time

Unsupported Ethereum JSON-RPC Methods

Phron does not support the following Ethereum API JSON-RPC methods:

• eth_getProof - returns the account and storage values of the specified account including the Merkle-proof
• eth_blobBaseFee - returns the expected base fee for blobs in the next block
• eth_createAccessList - creates an EIP-2930 type accessList based on a given transaction object
• eth_sign - allows the user to sign an arbitrary hash to be sent at a later time. Presents a security risk as the arbitrary hash can be fraudulently applied to other transactions
• eth_signTransaction - allows the user to sign a transaction to be sent at a later time. It is rarely used due to associated security risks