Eth module
Returns current block number
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.blockNumber
Executes a tx call (does not create a transaction)
Invocation |
|
Parameter | Type | Description |
transactionCall |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_call","params":[transactionCall, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
Returns ChainID
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_chainId","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
UInt64
Field name | Type |
Executes a tx call and returns gas used (does not create a transaction)
Invocation |
|
Parameter | Type | Description |
transactionCall |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_estimateGas","params":[transactionCall, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
See also CLI eth.estimateGas
Returns account balance
Invocation |
|
Parameter | Type | Description |
address |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getBalance","params":[address, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
Retrieves a block by hash
Invocation |
|
Parameter | Type | Description |
blockHash |
| |
returnFullTransactionObjects |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getBlockByHash","params":[blockHash, returnFullTransactionObjects],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockForRpc
Field name | Type |
Author |
|
Difficulty |
|
ExtraData |
|
GasLimit |
|
GasUsed |
|
Hash |
|
LogsBloom |
|
Miner |
|
MixHash |
|
Nonce |
|
Number |
|
ParentHash |
|
ReceiptsRoot |
|
Sha3Uncles |
|
Signature |
|
Size |
|
StateRoot |
|
Step |
|
TotalDifficulty |
|
Timestamp |
|
Transactions |
|
TransactionsRoot |
|
Uncles |
|
See also CLI eth.getBlockByHash
Retrieves a block by number
Invocation |
|
Parameter | Type | Description |
blockParameter |
| |
returnFullTransactionObjects |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getBlockByNumber","params":[blockParameter, returnFullTransactionObjects],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
BlockForRpc
Field name | Type |
Author |
|
Difficulty |
|
ExtraData |
|
GasLimit |
|
GasUsed |
|
Hash |
|
LogsBloom |
|
Miner |
|
MixHash |
|
Nonce |
|
Number |
|
ParentHash |
|
ReceiptsRoot |
|
Sha3Uncles |
|
Signature |
|
Size |
|
StateRoot |
|
Step |
|
TotalDifficulty |
|
Timestamp |
|
Transactions |
|
TransactionsRoot |
|
Uncles |
|
See also CLI eth.getBlockByNumber
Returns number of transactions in the block block hash
Invocation |
|
Parameter | Type | Description |
blockHash |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getBlockTransactionCountByHash","params":[blockHash],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.getBlockTransactionCountByHash
Returns number of transactions in the block by block number
Invocation |
|
Parameter | Type | Description |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getBlockTransactionCountByNumber","params":[blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
See also CLI eth.getBlockTransactionCountByNumber
Returns account code at given address and block
Invocation |
|
Parameter | Type | Description |
address |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getCode","params":[address, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
Reads filter changes
Invocation |
|
Parameter | Type | Description |
filterId |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getFilterChanges","params":[filterId],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.getFilterChanges
Reads filter changes
Invocation |
|
Parameter | Type | Description |
filterId |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getFilterLogs","params":[filterId],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
Reads logs
Invocation |
|
Parameter | Type | Description |
filter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getLogs","params":[filter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
Filter
Field name | Type |
FromBlock |
|
ToBlock |
|
Address |
|
Topics |
|
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
https://github.com/ethereum/EIPs/issues/1186
Invocation |
|
Parameter | Type | Description |
accountAddress |
| |
hashRate |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getProof","params":[accountAddress, hashRate, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
AccountProof
Field name | Type |
Address |
|
Proof |
|
Balance |
|
CodeHash |
|
Nonce |
|
StorageRoot |
|
StorageProofs |
|
StorageProof[]
Field name | Type |
Length |
|
LongLength |
|
Rank |
|
SyncRoot |
|
IsReadOnly |
|
IsFixedSize |
|
IsSynchronized |
|
Returns storage data at address. storage_index
Invocation |
|
Parameter | Type | Description |
address |
| |
positionIndex |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getStorageAt","params":[address, positionIndex, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
See also CLI eth.getStorageAt
Retrieves a transaction by block hash and index
Invocation |
|
Parameter | Type | Description |
blockHash |
| |
positionIndex |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getTransactionByBlockHashAndIndex","params":[blockHash, positionIndex],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
Retrieves a transaction by block number and index
Invocation |
|
Parameter | Type | Description |
blockParameter |
| |
positionIndex |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getTransactionByBlockNumberAndIndex","params":[blockParameter, positionIndex],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
See also CLI eth.getTransactionByBlockNumberAndIndex
Retrieves a transaction by hash
Invocation |
|
Parameter | Type | Description |
transactionHash |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getTransactionByHash","params":[transactionHash],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
See also CLI eth.getTransactionByHash
Returns account nonce (number of trnsactions from the account since genesis) at the given block number
Invocation |
|
Parameter | Type | Description |
address |
| |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getTransactionCount","params":[address, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
See also CLI eth.getTransactionCount
Retrieves a transaction receipt by tx hash
Invocation |
|
Parameter | Type | Description |
txHashData |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getTransactionReceipt","params":[txHashData],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
ReceiptForRpc
Field name | Type |
TransactionHash |
|
TransactionIndex |
|
BlockHash |
|
BlockNumber |
|
CumulativeGasUsed |
|
GasUsed |
|
From |
|
To |
|
ContractAddress |
|
Logs |
|
LogsBloom |
|
Root |
|
Status |
|
Error |
|
LogEntryForRpc[]
Field name | Type |
Length |
|
LongLength |
|
Rank |
|
SyncRoot |
|
IsReadOnly |
|
IsFixedSize |
|
IsSynchronized |
|
See also CLI eth.getTransactionReceipt
Retrieves an uncle block header by block hash and uncle index
Invocation |
|
Parameter | Type | Description |
blockHashData |
| |
positionIndex |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getUncleByBlockHashAndIndex","params":[blockHashData, positionIndex],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockForRpc
Field name | Type |
Author |
|
Difficulty |
|
ExtraData |
|
GasLimit |
|
GasUsed |
|
Hash |
|
LogsBloom |
|
Miner |
|
MixHash |
|
Nonce |
|
Number |
|
ParentHash |
|
ReceiptsRoot |
|
Sha3Uncles |
|
Signature |
|
Size |
|
StateRoot |
|
Step |
|
TotalDifficulty |
|
Timestamp |
|
Transactions |
|
TransactionsRoot |
|
Uncles |
|
See also CLI eth.getUncleByBlockHashAndIndex
Retrieves an uncle block header by block number and uncle index
Invocation |
|
Parameter | Type | Description |
blockParameter |
| |
positionIndex |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getUncleByBlockNumberAndIndex","params":[blockParameter, positionIndex],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
BlockForRpc
Field name | Type |
Author |
|
Difficulty |
|
ExtraData |
|
GasLimit |
|
GasUsed |
|
Hash |
|
LogsBloom |
|
Miner |
|
MixHash |
|
Nonce |
|
Number |
|
ParentHash |
|
ReceiptsRoot |
|
Sha3Uncles |
|
Signature |
|
Size |
|
StateRoot |
|
Step |
|
TotalDifficulty |
|
Timestamp |
|
Transactions |
|
TransactionsRoot |
|
Uncles |
|
See also CLI eth.getUncleByBlockNumberAndIndex
Returns number of uncles in the block by block hash
Invocation |
|
Parameter | Type | Description |
blockHash |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getUncleCountByBlockHash","params":[blockHash],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
Returns number of uncles in the block by block number
Invocation |
|
Parameter | Type | Description |
blockParameter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_getUncleCountByBlockNumber","params":[blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
BlockParameterType
QuantityorString(latest, earliest, pending)
See also CLI eth.getUncleCountByBlockNumber
Creates an update filter
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_newBlockFilter","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
Creates an update filter
Invocation |
|
Parameter | Type | Description |
filter |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_newFilter","params":[filter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
Filter
Field name | Type |
FromBlock |
|
ToBlock |
|
Address |
|
Topics |
|
BlockParameter
Field name | Type |
Type |
|
BlockNumber |
|
BlockHash |
|
RequireCanonical |
|
Creates an update filter
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_newPendingTransactionFilter","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.newPendingTransactionFilter
Returns the pending transactions list
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_pendingTransactions","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
See also CLI eth.pendingTransactions
Returns ETH protocol version
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_protocolVersion","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.protocolVersion
Send a raw transaction to the tx pool and broadcasting
Invocation |
|
Parameter | Type | Description |
transaction |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_sendRawTransaction","params":[transaction],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
See also CLI eth.sendRawTransaction
Send a transaction to the tx pool and broadcasting
Invocation |
|
Parameter | Type | Description |
rpcTx |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_sendTransaction","params":[rpcTx],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name | Type |
Hash |
|
Nonce |
|
BlockHash |
|
BlockNumber |
|
TransactionIndex |
|
From |
|
To |
|
Value |
|
GasPrice |
|
Gas |
|
Data |
|
Input |
|
V |
|
S |
|
R |
|
See also CLI eth.sendTransaction
Returns syncing status
Invocation |
|
This method doesn't have parameters. |
Returned type | Description |
| |
curl --data '{"method":"eth_syncing","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
SyncingResult
Field name | Type |
IsSyncing |
|
StartingBlock |
|
CurrentBlock |
|
HighestBlock |
|
Creates an update filter
Invocation |
|
Parameter | Type | Description |
filterId |
| |
Returned type | Description |
| |
curl --data '{"method":"eth_uninstallFilter","params":[filterId],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
