This proposal defines a standard set of remote procedure call methods that an Ethereum node should implement.
Nodes created by the current generation of Ethereum clients expose inconsistent and incompatible remote procedure call (RPC) methods because no formal Ethereum RPC specification exists. This proposal standardizes such a specification to provide developers with a predictable Ethereum RPC interface regardless of underlying node implementation.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC-2119.
Communication with Ethereum nodes is accomplished using JSON-RPC, a stateless, lightweight remote procedure call protocol that uses JSON as its data format. Ethereum RPC methods MUST be called using JSON-RPC request objects and MUST respond with JSON-RPC response objects.
If an Ethereum RPC method encounters an error, the error member included on the response object MUST be an object containing a code member and descriptive message member. The following list contains all possible error codes and associated messages:
| Code | Message | Meaning | Category |
|---|---|---|---|
| -32700 | Parse error | Invalid JSON | standard |
| -32600 | Invalid request | JSON is not a valid request object | standard |
| -32601 | Method not found | Method does not exist | standard |
| -32602 | Invalid params | Invalid method parameters | standard |
| -32603 | Internal error | Internal JSON-RPC error | standard |
| -32000 | Invalid input | Missing or invalid parameters | non-standard |
| -32001 | Resource not found | Requested resource not found | non-standard |
| -32002 | Resource unavailable | Requested resource not available | non-standard |
| -32003 | Transaction rejected | Transaction creation failed | non-standard |
| -32004 | Method not supported | Method is not implemented | non-standard |
| -32005 | Limit exceeded | Request exceeds defined limit | non-standard |
| -32006 | JSON-RPC version not supported | Version of JSON-RPC protocol is not supported | non-standard |
Example error response:
Specific types of values passed to and returned from Ethereum RPC methods require special encoding:
QuantityQuantity value MUST be hex-encoded.Quantity value MUST be "0x"-prefixed.Quantity value MUST be expressed using the fewest possible hex digits per byte.Quantity value MUST express zero as "0x0".Examples Quantity values:
| Value | Valid | Reason |
|---|---|---|
| 0x | invalid | empty not a valid quantity |
| 0x0 | valid | interpreted as a quantity of zero |
| 0x00 | invalid | leading zeroes not allowed |
| 0x41 | valid | interpreted as a quantity of 65 |
| 0x400 | valid | interpreted as a quantity of 1024 |
| 0x0400 | invalid | leading zeroes not allowed |
| ff | invalid | values must be prefixed |
Block IdentifierThe RPC methods below take a default block identifier as a parameter.
eth_getBalanceeth_getStorageAteth_getTransactionCounteth_getCodeeth_calleth_getProofSince there is no way to clearly distinguish between a Data parameter and a Quantity parameter, EIP-1898 provides a format to specify a block either using the block hash or block number. The block identifier is a JSON object with the following fields:
| Property | Type | Description |
|---|---|---|
[blockNumber] | {Quantity} | The block in the canonical chain with this number |
OR [blockHash] | {Data} | The block uniquely identified by this hash. The blockNumber and blockHash properties are mutually exclusive; exactly one of them must be set. |
requireCanonical | {boolean} | (optional) Whether or not to throw an error if the block is not in the canonical chain as described below. Only allowed in conjunction with the blockHash tag. Defaults to false. |
If the block is not found, the callee SHOULD raise a JSON-RPC error (the recommended error code is -32001: Resource not found. If the tag is blockHash and requireCanonical is true, the callee SHOULD additionally raise a JSON-RPC error if the block is not in the canonical chain (the recommended error code is -32000: Invalid input and in any case should be different than the error code for the block not found case so that the caller can distinguish the cases). The block-not-found check SHOULD take precedence over the block-is-canonical check, so that if the block is not found the callee raises block-not-found rather than block-not-canonical.
DataData value MUST be hex-encoded.Data value MUST be "0x"-prefixed.Data value MUST be expressed using two hex digits per byte.Examples Data values:
| Value | Valid | Reason |
|---|---|---|
| 0x | valid | interpreted as empty data |
| 0x0 | invalid | each byte must be represented using two hex digits |
| 0x00 | valid | interpreted as a single zero byte |
| 0x41 | true | interpreted as a data value of 65 |
| 0x004200 | true | interpreted as a data value of 16896 |
| 0xf0f0f | false | bytes require two hex digits |
| 004200 | false | values must be prefixed |
New Ethereum RPC methods and changes to existing methods MUST be proposed via the traditional EIP process. This allows for community consensus around new method implementations and proposed method modifications. RPC method proposals MUST reach "draft" status before being added to this proposal and the official Ethereum RPC specification defined herein.
Returns the version of the current client
(none)
{string} - client version
Hashes data using the Keccak-256 algorithm
| # | Type | Description |
|---|---|---|
| 1 | {Data} | data to hash |
{Data} - Keccak-256 hash of the given data
Determines if this client is listening for new network connections
(none)
{boolean} - true if listening is active or false if listening is not active
Returns the number of peers currently connected to this client
(none)
{Quantity} - number of connected peers
Returns the chain ID associated with the current network
(none)
{string} - chain ID associated with the current network
Common chain IDs:
"1" - Ethereum mainnet"3" - Ropsten testnet"4" - Rinkeby testnet"42" - Kovan testnetNote: See EIP-155 for a complete list of possible chain IDs.
Returns a list of addresses owned by this client
(none)
{Data[]} - array of addresses
Returns the number of the most recent block seen by this client
(none)
{Quantity} - number of the latest block
Executes a new message call immediately without submitting a transaction to the network
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Data} [from] - transaction sender@property { Data} to - transaction recipient or null if deploying a contract@property { Quantity} [gas] - gas provided for transaction execution@property { Quantity} [gasPrice] - price in wei of each gas used@property { Quantity} [value] - value in wei sent with this transaction@property { Data} [data] - contract code or a hashed method call with encoded args |
| 2 | {Quantity|string|Block Identifier} | block number, or one of "latest", "earliest" or "pending", or a block identifier as described in Block Identifier |
{Data} - return value of executed contract
Returns the coinbase address for this client
(none)
{Data} - coinbase address
Estimates the gas necessary to complete a transaction without submitting it to the network
Note: The resulting gas estimation may be significantly more than the amount of gas actually used by the transaction. This is due to a variety of reasons including EVM mechanics and node performance.
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Data} [from] - transaction sender@property { Data} [to] - transaction recipient@property { Quantity} [gas] - gas provided for transaction execution@property { Quantity} [gasPrice] - price in wei of each gas used@property { Quantity} [value] - value in wei sent with this transaction@property { Data} [data] - contract code or a hashed method call with encoded args |
| 2 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
{Quantity} - amount of gas required by transaction
Returns the current price of gas expressed in wei
(none)
{Quantity} - current gas price in wei
Returns the balance of an address in wei
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address to query for balance |
| 2 | {Quantity|string|Block Identifier} | block number, or one of "latest", "earliest" or "pending", or a block identifier as described in Block Identifier |
{Quantity} - balance of the provided account in wei
Returns information about a block specified by hash
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a block |
| 2 | {boolean} | true will pull full transaction objects, false will pull transaction hashes |
{null|object} - null if no block is found, otherwise a block object with the following members:
Data} extraData - "extra data" field of this blockData} hash - block hash or null if pendingData} logsBloom - logs bloom filter or null if pendingData} miner - address that received this block's mining rewardsData} nonce - proof-of-work hash or null if pendingData} parentHash - parent block hashData} receiptsRoot -root of this block's receipts trieData} sha3Uncles - SHA3 of the uncles data in this blockData} stateRoot - root of this block's final state trieData} transactionsRoot - root of this block's transaction trieQuantity} difficulty - difficulty for this blockQuantity} gasLimit - maximum gas allowed in this blockQuantity} gasUsed - total used gas by all transactions in this blockQuantity} number - block number or null if pendingQuantity} size - size of this block in bytesQuantity} timestamp - unix timestamp of when this block was collatedQuantity} totalDifficulty - total difficulty of the chain until this blockArray<Transaction>} transactions - list of transaction objects or hashesArray<Transaction>} uncles - list of uncle hashesReturns information about a block specified by number
| # | Type | Description |
|---|---|---|
| 1 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
| 2 | {boolean} | true will pull full transaction objects, false will pull transaction hashes |
{null|object} - null if no block is found, otherwise a block object with the following members:
Data} extraData - "extra data" field of this blockData} hash - block hash or null if pendingData} logsBloom - logs bloom filter or null if pendingData} miner - address that received this block's mining rewardsData} nonce - proof-of-work hash or null if pendingData} parentHash - parent block hashData} receiptsRoot -root of this block's receipts trieData} sha3Uncles - SHA3 of the uncles data in this blockData} stateRoot - root of this block's final state trieData} transactionsRoot - root of this block's transaction trieQuantity} difficulty - difficulty for this blockQuantity} gasLimit - maximum gas allowed in this blockQuantity} gasUsed - total used gas by all transactions in this blockQuantity} number - block number or null if pendingQuantity} size - size of this block in bytesQuantity} timestamp - unix timestamp of when this block was collatedQuantity} totalDifficulty - total difficulty of the chain until this blockArray<Transaction>} transactions - list of transaction objects or hashesArray<Transaction>} uncles - list of uncle hashesReturns the number of transactions in a block specified by block hash
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a block |
{Quantity} - number of transactions in the specified block
Returns the number of transactions in a block specified by block number
| # | Type | Description |
|---|---|---|
| 1 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
{Quantity} - number of transactions in the specified block
Returns the contract code stored at a given address
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address to query for code |
| 2 | {Quantity|string|Block Identifier} | block number, or one of "latest", "earliest" or "pending", or a block identifier as described in Block Identifier |
{Data} - code from the specified address
Returns a list of all logs based on filter ID since the last log retrieval
| # | Type | Description |
|---|---|---|
| 1 | {Quantity} | ID of the filter |
{Array<Log>} - array of log objects with the following members:
Data} address - address from which this log originatedData} blockHash - hash of block containing this log or null if pendingData} data - contains the non-indexed arguments of the logData} transactionHash - hash of the transaction that created this log or null if pendingQuantity} blockNumber - number of block containing this log or null if pendingQuantity} logIndex - index of this log within its block or null if pendingQuantity} transactionIndex - index of the transaction that created this log or null if pendingData[]} topics - list of order-dependent topicsboolean} removed - true if this filter has been destroyed and is invalidNote: The return value of eth_getFilterChanges when retrieving logs from eth_newBlockFilter and eth_newPendingTransactionFilter filters will be an array of hashes, not an array of Log objects.
Returns a list of all logs based on filter ID
| # | Type | Description |
|---|---|---|
| 1 | {Quantity} | ID of the filter |
{Array<Log>} - array of log objects with the following members:
Data} address - address from which this log originatedData} blockHash - hash of block containing this log or null if pendingData} data - contains the non-indexed arguments of the logData} transactionHash - hash of the transaction that created this log or null if pendingQuantity} blockNumber - number of block containing this log or null if pendingQuantity} logIndex - index of this log within its block or null if pendingQuantity} transactionIndex - index of the transaction that created this log or null if pendingArray<Data>} topics - list of order-dependent topicsboolean} removed - true if this filter has been destroyed and is invalidNote: The return value of eth_getFilterLogs when retrieving logs from eth_newBlockFilter and eth_newPendingTransactionFilter filters will be an array of hashes, not an array of Log objects.
Returns a list of all logs based on a filter object
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Quantity|string} [fromBlock] - block number, or one of "latest", "earliest" or "pending"@property { Quantity|string} [toBlock] - block number, or one of "latest", "earliest" or "pending"@property { Data|Data[]} [address] - contract address or a list of addresses from which logs should originate@property { Data[]} [topics] - list of order-dependent topics@property { Data} [blockhash] - restrict logs to a block by hash |
Note: If blockhash is passed, neither fromBlock nor toBlock are allowed or respected.
{Array<Log>} - array of log objects with the following members:
Data} address - address from which this log originatedData} blockHash - hash of block containing this log or null if pendingData} data - contains the non-indexed arguments of the logData} transactionHash - hash of the transaction that created this log or null if pendingQuantity} blockNumber - number of block containing this log or null if pendingQuantity} logIndex - index of this log within its block or null if pendingQuantity} transactionIndex - index of the transaction that created this log or null if pendingData} topics - list of order-dependent topicsboolean} removed - true if this filter has been destroyed and is invalidReturns the value from a storage position at an address
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address of stored data |
| 2 | {Quantity} | index into stored data |
| 3 | {Quantity|string|Block Identifier} | block number, or one of "latest", "earliest" or "pending", or a block identifier as described in Block Identifier |
{Data} - value stored at the given address and data index
Returns information about a transaction specified by block hash and transaction index
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a block |
| 2 | {Quantity} | index of a transaction in the specified block |
{null|object} - null if no transaction is found, otherwise a transaction object with the following members:
Data} r - ECDSA signature rData} s - ECDSA signature sData} blockHash - hash of block containing this transaction or null if pendingData} from - transaction senderData} hash - hash of this transactionData} input - contract code or a hashed method callData} to - transaction recipient or null if deploying a contractQuantity} v - ECDSA recovery IDQuantity} blockNumber - number of block containing this transaction or null if pendingQuantity} gas - gas provided for transaction executionQuantity} gasPrice - price in wei of each gas usedQuantity} nonce - unique number identifying this transactionQuantity} transactionIndex - index of this transaction in the block or null if pendingQuantity} value - value in wei sent with this transactionReturns information about a transaction specified by block number and transaction index
| # | Type | Description |
|---|---|---|
| 1 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
| 2 | {Quantity} | index of a transaction in the specified block |
{null|object} - null if no transaction is found, otherwise a transaction object with the following members:
Data} r - ECDSA signature rData} s - ECDSA signature sData} blockHash - hash of block containing this transaction or null if pendingData} from - transaction senderData} hash - hash of this transactionData} input - contract code or a hashed method callData} to - transaction recipient or null if deploying a contractQuantity} v - ECDSA recovery IDQuantity} blockNumber - number of block containing this transaction or null if pendingQuantity} gas - gas provided for transaction executionQuantity} gasPrice - price in wei of each gas usedQuantity} nonce - unique number identifying this transactionQuantity} transactionIndex - index of this transaction in the block or null if pendingQuantity} value - value in wei sent with this transactionReturns information about a transaction specified by hash
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a transaction |
{null|object} - null if no transaction is found, otherwise a transaction object with the following members:
Data} r - ECDSA signature rData} s - ECDSA signature sData} blockHash - hash of block containing this transaction or null if pendingData} from - transaction senderData} hash - hash of this transactionData} input - contract code or a hashed method callData} to - transaction recipient or null if deploying a contractQuantity} v - ECDSA recovery IDQuantity} blockNumber - number of block containing this transaction or null if pendingQuantity} gas - gas provided for transaction executionQuantity} gasPrice - price in wei of each gas usedQuantity} nonce - unique number identifying this transactionQuantity} transactionIndex - index of this transaction in the block or null if pendingQuantity} value - value in wei sent with this transactionReturns the number of transactions sent from an address
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address to query for sent transactions |
| 2 | {Quantity|string|Block Identifier} | block number, or one of "latest", "earliest" or "pending", or a block identifier as described in Block Identifier |
{Quantity} - number of transactions sent from the specified address
Returns the receipt of a transaction specified by hash
Note: Transaction receipts are unavailable for pending transactions.
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a transaction |
{null|object} - null if no transaction is found, otherwise a transaction receipt object with the following members:
Data} blockHash - hash of block containing this transactionData} contractAddress - address of new contract or null if no contract was createdData} from - transaction senderData} logsBloom - logs bloom filterData} to - transaction recipient or null if deploying a contractData} transactionHash - hash of this transactionQuantity} blockNumber - number of block containing this transactionQuantity} cumulativeGasUsed - gas used by this and all preceding transactions in this blockQuantity} gasUsed - gas used by this transactionQuantity} status - 1 if this transaction was successful or 0 if it failedQuantity} transactionIndex - index of this transaction in the blockArray<Log>} logs - list of log objects generated by this transactionReturns information about an uncle specified by block hash and uncle index position
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a block |
| 2 | {Quantity} | index of uncle |
{null|object} - null if no block or uncle is found, otherwise an uncle object with the following members:
Data} extraData - "extra data" field of this blockData} hash - block hash or null if pendingData} logsBloom - logs bloom filter or null if pendingData} miner - address that received this block's mining rewardsData} nonce - proof-of-work hash or null if pendingData} parentHash - parent block hashData} receiptsRoot -root of this block's receipts trieData} sha3Uncles - SHA3 of the uncles data in this blockData} stateRoot - root of this block's final state trieData} transactionsRoot - root of this block's transaction trieQuantity} difficulty - difficulty for this blockQuantity} gasLimit - maximum gas allowed in this blockQuantity} gasUsed - total used gas by all transactions in this blockQuantity} number - block number or null if pendingQuantity} size - size of this block in bytesQuantity} timestamp - unix timestamp of when this block was collatedQuantity} totalDifficulty - total difficulty of the chain until this blockArray<Transaction>} uncles - list of uncle hashesReturns information about an uncle specified by block number and uncle index position
| # | Type | Description |
|---|---|---|
| 1 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
| 2 | {Quantity} | index of uncle |
{null|object} - null if no block or uncle is found, otherwise an uncle object with the following members:
Data} extraData - "extra data" field of this blockData} hash - block hash or null if pendingData} logsBloom - logs bloom filter or null if pendingData} miner - address that received this block's mining rewardsData} nonce - proof-of-work hash or null if pendingData} parentHash - parent block hashData} receiptsRoot -root of this block's receipts trieData} sha3Uncles - SHA3 of the uncles data in this blockData} stateRoot - root of this block's final state trieData} transactionsRoot - root of this block's transaction trieQuantity} difficulty - difficulty for this blockQuantity} gasLimit - maximum gas allowed in this blockQuantity} gasUsed - total used gas by all transactions in this blockQuantity} number - block number or null if pendingQuantity} size - size of this block in bytesQuantity} timestamp - unix timestamp of when this block was collatedQuantity} totalDifficulty - total difficulty of the chain until this blockArray<Transaction>} uncles - list of uncle hashesReturns the number of uncles in a block specified by block hash
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash of a block |
{Quantity} - number of uncles in the specified block
Returns the number of uncles in a block specified by block number
| # | Type | Description |
|---|---|---|
| 1 | {Quantity|string} | block number, or one of "latest", "earliest" or "pending" |
{Quantity} - number of uncles in the specified block
Returns a list containing relevant information for proof-of-work
none
{Data[]} - array with the following items:
Data} - current block header pow-hashData} - seed hash used for the DAGData} - boundary condition ("target"), 2^256 / difficultyReturns the number of hashes-per-second this node is mining at
(none)
{Quantity} - number of hashes-per-second
Determines if this client is mining new blocks
(none)
{boolean} - true if this client is mining or false if it is not mining
Creates a filter to listen for new blocks that can be used with eth_getFilterChanges
none
{Quantity} - ID of the newly-created filter that can be used with eth_getFilterChanges
Creates a filter to listen for specific state changes that can then be used with eth_getFilterChanges
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Quantity|string} [fromBlock] - block number, or one of "latest", "earliest" or "pending"@property { Quantity|string} [toBlock] - block number, or one of "latest", "earliest" or "pending"@property { Data|Data[]} [address] - contract address or a list of addresses from which logs should originate@property { Data[]} [topics] - list of order-dependent topics |
Note: Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:
[] - "anything"[A] - "A in first position (and anything after)"[null, B] - "anything in first position AND B in second position (and anything after)"[A, B] - "A in first position AND B in second position (and anything after)"[[A, B], [A, B]] - "(A OR B) in first position AND (A OR B) in second position (and anything after)"{Quantity} - ID of the newly-created filter that can be used with eth_getFilterChanges
Creates a filter to listen for new pending transactions that can be used with eth_getFilterChanges
none
{Quantity} - ID of the newly-created filter that can be used with eth_getFilterChanges
Returns the current Ethereum protocol version
(none)
{string} - current Ethereum protocol version
Sends and already-signed transaction to the network
| # | Type | Description |
|---|---|---|
| 1 | {Data} | signed transaction data |
{Data} - transaction hash, or the zero hash if the transaction is not yet available
Creates, signs, and sends a new transaction to the network
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Data} from - transaction sender@property { Data} [to] - transaction recipient@property { Quantity} [gas="0x15f90"] - gas provided for transaction execution@property { Quantity} [gasPrice] - price in wei of each gas used@property { Quantity} [value] - value in wei sent with this transaction@property { Data} [data] - contract code or a hashed method call with encoded args@property { Quantity} [nonce] - unique number identifying this transaction |
{Data} - transaction hash, or the zero hash if the transaction is not yet available
Calculates an Ethereum-specific signature in the form of keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address to use for signing |
| 2 | {Data} | data to sign |
{Data} - signature hash of the provided data
Signs a transaction that can be submitted to the network at a later time using with eth_sendRawTransaction
| # | Type | Description |
|---|---|---|
| 1 | {object} | @property {Data} from - transaction sender@property { Data} [to] - transaction recipient@property { Quantity} [gas="0x15f90"] - gas provided for transaction execution@property { Quantity} [gasPrice] - price in wei of each gas used@property { Quantity} [value] - value in wei sent with this transaction@property { Data} [data] - contract code or a hashed method call with encoded args@property { Quantity} [nonce] - unique number identifying this transaction |
{Data} - signature hash of the transaction object
Calculates an Ethereum-specific signature in the form of keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))
| # | Type | Description |
|---|---|---|
| 1 | {Data} | address to use for signing |
| 2 | {Data} | message to sign containing type information, a domain separator, and data |
Note: Client developers should refer to EIP-712 for complete semantics around encoding and signing data. Dapp developers should refer to EIP-712 for the expected structure of RPC method input parameters.
{Data} - signature hash of the provided message
Submit a mining hashrate
| # | Type | Description |
|---|---|---|
| 1 | {Data} | hash rate |
| 2 | {Data} | random ID identifying this node |
{boolean} - true if submitting went through successfully, false otherwise
Submit a proof-of-work solution
| # | Type | Description |
|---|---|---|
| 1 | {Data} | nonce found |
| 2 | {Data} | header's pow-hash |
| 3 | {Data} | mix digest |
{boolean} - true if the provided solution is valid, false otherwise
Returns information about the status of this client's network synchronization
(none)
{boolean|object} - false if this client is not syncing with the network, otherwise an object with the following members:
Quantity} currentBlock - number of the most-recent block syncedQuantity} highestBlock - number of latest block on the networkQuantity} startingBlock - block number at which syncing startedDestroys a filter based on filter ID
Note: This should only be called if a filter and its notifications are no longer needed. This will also be called automatically on a filter if its notifications are not retrieved using eth_getFilterChanges for a period of time.
| # | Type | Description |
|---|---|---|
| 1 | {Quantity} | ID of the filter to destroy |
{boolean} - true if the filter is found and successfully destroyed or false if it is not
Much of Ethereum's effectiveness as an enterprise-grade application platform depends on its ability to provide a reliable and predictable developer experience. Nodes created by the current generation of Ethereum clients expose RPC endpoints with differing method signatures; this forces applications to work around method inconsistencies to maintain compatibility with various Ethereum RPC implementations.
Both Ethereum client developers and downstream dapp developers lack a formal Ethereum RPC specification. This proposal standardizes such a specification in a way that's versionable and modifiable through the traditional EIP process.
This proposal impacts Ethereum client developers by requiring that any exposed RPC interface adheres to this specification. This proposal impacts dapp developers by requiring that any RPC calls currently used in applications are made according to this specification.
The current generation of Ethereum clients includes several implementations that attempt to expose this RPC specification:
| Client Name | Language | Homepage |
|---|---|---|
| Geth | Go | geth.ethereum.org |
| Parity | Rust | parity.io/ethereum |
| Aleth | C++ | cpp-ethereum.org |
Copyright and related rights waived via CC0.