curl https://mainnet.optimism.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Returns the current price per gas in wei.
This method will use 20
Compute Units.
None
String
- hex string value representing an integer of the current price per gas in WEI.
Returns the chain ID used for signing replay-protected transactions.
This method will use 5
Compute Units.
None
chainId
, hexadecimal value as a string representing the integer of the current chain id.
Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.
from
- [optional] String of the address the transaction is sent from.
to
- [optional] String of the address the transaction is directed to.
gas
- [optional] Integer of the gas provided for the transaction execution.
gasprice
- [optional] Integer of the gasPrice used for each paid gas encoded as a hexadecimal.
value
- [optional] Integer of the value sent with this transaction encoded as a hexadecimal.
String
- hex string value representing an integer of the amount of gas units used.
Returns information about a block by block number.
Boolean
- If true
it returns the full transaction objects, if false
only the hashes of the transactions.
Object
- A block object, or null
when no block was found:
number
: QUANTITY
- the block number. null
when its pending block.
hash
: DATA
, 32 Bytes - hash of the block. null
when its pending block.
parentHash
: DATA
, 32 Bytes - hash of the parent block.
nonce
: DATA
, 8 Bytes - hash of the generated proof-of-work. null
when its pending block.
sha3Uncles
: DATA
, 32 Bytes - SHA3 of the uncles data in the block.
logsBloom
: DATA
, 256 Bytes - the bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
: DATA
, 32 Bytes - the root of the transaction trie of the block.
stateRoot
: DATA
, 32 Bytes - the root of the final state trie of the block.
receiptsRoot
: DATA
, 32 Bytes - the root of the receipts trie of the block.
miner
: DATA
, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.
difficulty
: QUANTITY
- integer of the difficulty for this block.
totalDifficulty
: QUANTITY
- integer of the total difficulty of the chain until this block.
extraData
: DATA
- the "extra data" field of this block.
size
: QUANTITY
- integer the size of this block in bytes.
gasLimit
: QUANTITY
- the maximum gas allowed in this block.
gasUsed
: QUANTITY
- the total used gas by all transactions in this block.
timestamp
: QUANTITY
- the unix timestamp for when the block was collated.
transactions
: Array
- Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
uncles
: Array
- Array of uncle hashes.
This method will use 100
.
data
- [optional] String of the hash of the method signature and encoded parameters. For more information, see the .
This method will use 20
.
QUANTITY|TAG
- integer of a block number, or the string "earliest"
, "latest"
or "pending"
, as in the .
This method will use 10
.
Returns code at a given address.
This method will use 20
Compute Units.
DATA
, 20 Bytes - address.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
, see the default block parameter
DATA
- the code from the given address.
Returns the balance of the account of given address.
This method will use 20
Compute Units.
DATA
, 20 Bytes - address to check for balance.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
, see the default block parameter
INTEGER
- Hex value representing integer of the current balance in WEI.
Returns the number of transactions in a block from a block matching the given block hash.
This method will use 20
Compute Units.
DATA
, 32 Bytes - hash of a block
QUANTITY
- integer of the number of transactions in this block.
Returns the balance of the account of given address.
This method will use 20
Compute Units.
DATA
, 20 Bytes - address of the storage.
QUANTITY
- integer of the position in the storage.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
, see the default block parameter
String
- Hex value representing data at this storage position.
Returns the number of transactions in a block matching the given block number.
This method will use 20
Compute Units.
QUANTITY|TAG
- integer of a block number, or the string "earliest"
, "latest"
or "pending"
, as in the default block parameter.
QUANTITY
- integer of the number of transactions in this block.
Polling method for a filter, which returns an array of logs which occurred since last poll.
This method will use 20
Compute Units.
QUANTITY
- the filter id.
Array
- Array of log objects, or an empty array if nothing has changed since last poll.
For filters created with eth_newBlockFilter
the return are block hashes (DATA
, 32 Bytes), e.g. ["0x3454645634534..."]
.
For filters created with eth_newPendingTransactionFilter
the return are transaction hashes (DATA
, 32 Bytes), e.g. ["0x6345343454645..."]
.
For filters created with eth_newFilter
logs are objects with following params:
removed
: TAG
- true
when the log was removed, due to a chain reorganization. false
if its a valid log.
logIndex
: QUANTITY
- integer of the log index position in the block. null
when its pending log.
transactionIndex
: QUANTITY
- integer of the transactions index position log was created from. null
when its pending log.
transactionHash
: DATA
, 32 Bytes - hash of the transactions this log was created from. null
when its pending log.
blockHash
: DATA
, 32 Bytes - hash of the block where this log was in. null
when its pending. null
when its pending log.
blockNumber
: QUANTITY
- the block number where this log was in. null
when its pending. null
when its pending log.
address
: DATA
, 20 Bytes - address from which this log originated.
data
: DATA
- contains one or more 32 Bytes non-indexed arguments of the log.
topics
: Array of DATA
- Array of 0 to 4 32 Bytes DATA
of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)
), except you declared the event with the anonymous
specifier.)
Executes a new message call immediately without creating a transaction on the block chain.
Object
- The transaction call object
from
- [optional] String of the address the transaction is sent from.
to
- String of the address the transaction is directed to.
gas
- [optional] Integer of the gas provided for the transaction execution.
gasprice
- [optional] Integer of the gasPrice used for each paid gas encoded as a hexadecimal.
value
- [optional] Integer of the value sent with this transaction encoded as a hexadecimal.
data
- hex value of the executed call or contract
Returns an array of all logs matching a given filter object.
Object
- The filter options:
fromBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
toBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
address
: DATA|Array
, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
topics
: Array of DATA
, - (optional) Array of 32 Bytes DATA
topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
blockhash
: DATA
, 32 Bytes - (optional, future) With the addition of EIP-234, blockHash
will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash
. Using blockHash
is equivalent to fromBlock
= toBlock
= the block number with hash blockHash
. If blockHash
is present in in the filter criteria, then neither fromBlock
nor toBlock
are allowed.
Array
- Array of log objects, or an empty array if nothing has changed since last poll.
For filters created with eth_newBlockFilter
the return are block hashes (DATA
, 32 Bytes), e.g. ["0x3454645634534..."]
.
For filters created with eth_newPendingTransactionFilter
the return are transaction hashes (DATA
, 32 Bytes), e.g. ["0x6345343454645..."]
.
For filters created with eth_newFilter
logs are objects with following params:
removed
: TAG
- true
when the log was removed, due to a chain reorganization. false
if its a valid log.
logIndex
: QUANTITY
- integer of the log index position in the block. null
when its pending log.
transactionIndex
: QUANTITY
- integer of the transactions index position log was created from. null
when its pending log.
transactionHash
: DATA
, 32 Bytes - hash of the transactions this log was created from. null
when its pending log.
blockHash
: DATA
, 32 Bytes - hash of the block where this log was in. null
when its pending. null
when its pending log.
blockNumber
: QUANTITY
- the block number where this log was in. null
when its pending. null
when its pending log.
address
: DATA
, 20 Bytes - address from which this log originated.
data
: DATA
- contains one or more 32 Bytes non-indexed arguments of the log.
topics
: Array of DATA
- Array of 0 to 4 32 Bytes DATA
of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)
), except you declared the event with the anonymous
specifier.)
Returns the receipt of a transaction by transaction hash. Note that the receipt is not available for pending transactions.
DATA
, 32 Bytes - hash of a transaction
Object
- A transaction receipt object, or null
when no receipt was found:
transactionHash
: DATA
, 32 Bytes - hash of the transaction.
transactionIndex
: QUANTITY
- integer of the transactions index position in the block.
blockHash
: DATA
, 32 Bytes - hash of the block where this transaction was in.
blockNumber
: QUANTITY
- block number where this transaction was in.
from
: DATA
, 20 Bytes - address of the sender.
to
: DATA
, 20 Bytes - address of the receiver. null when its a contract creation transaction.
cumulativeGasUsed
: QUANTITY
- The total amount of gas used when this transaction was executed in the block.
effectiveGasPrice
: QUANTITY
- The sum of the base fee and tip paid per unit of gas.
gasUsed
: QUANTITY
- The amount of gas used by this specific transaction alone.
contractAddress
: DATA
, 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise null
.
logs
: Array
- Array of log objects, which this transaction generated.
logsBloom
: DATA
, 256 Bytes - Bloom filter for light clients to quickly retrieve related logs.
type
: DATA
- integer of the transaction type, 0x00
for legacy transactions, 0x01
for access list types, 0x02
for dynamic fees. It also returns either :
root
: DATA
32 bytes of post-transaction stateroot (pre Byzantium)
status
: QUANTITY
either 1
(success) or 0
(failure)
Returns information about a transaction by block hash and transaction index position.
DATA
, 32 Bytes - hash of a block.
QUANTITY
- integer of the transaction index position.
Object
- A transaction object, or null
when no transaction was found:
blockHash
: DATA
, 32 Bytes - hash of the block where this transaction was in. null
when its pending.
blockNumber
: QUANTITY
- block number where this transaction was in. null
when its pending.
from
: DATA
, 20 Bytes - address of the sender.
gas
: QUANTITY
- gas provided by the sender.
gasPrice
: QUANTITY
- gas price provided by the sender in Wei.
hash
: DATA
, 32 Bytes - hash of the transaction.
input
: DATA
- the data send along with the transaction.
nonce
: QUANTITY
- the number of transactions made by the sender prior to this one.
to
: DATA
, 20 Bytes - address of the receiver. null
when its a contract creation transaction.
transactionIndex
: QUANTITY
- integer of the transactions index position in the block. null
when its pending.
value
: QUANTITY
- value transferred in Wei.
v
: QUANTITY
- ECDSA recovery id
r
: QUANTITY
- ECDSA signature r
s
: QUANTITY
- ECDSA signature s
Returns an array of all logs matching filter with given id.
QUANTITY
- the filter id.
Array
- Array of log objects, or an empty array if nothing has changed since last poll.
For filters created with eth_newBlockFilter
the return are block hashes (DATA
, 32 Bytes), e.g. ["0x3454645634534..."]
.
For filters created with eth_newPendingTransactionFilter
the return are transaction hashes (DATA
, 32 Bytes), e.g. ["0x6345343454645..."]
.
For filters created with eth_newFilter
logs are objects with following params:
removed
: TAG
- true
when the log was removed, due to a chain reorganization. false
if its a valid log.
logIndex
: QUANTITY
- integer of the log index position in the block. null
when its pending log.
transactionIndex
: QUANTITY
- integer of the transactions index position log was created from. null
when its pending log.
transactionHash
: DATA
, 32 Bytes - hash of the transactions this log was created from. null
when its pending log.
blockHash
: DATA
, 32 Bytes - hash of the block where this log was in. null
when its pending. null
when its pending log.
blockNumber
: QUANTITY
- the block number where this log was in. null
when its pending. null
when its pending log.
address
: DATA
, 20 Bytes - address from which this log originated.
data
: DATA
- contains one or more 32 Bytes non-indexed arguments of the log.
topics
: Array of DATA
- Array of 0 to 4 32 Bytes DATA
of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)
), except you declared the event with the anonymous
specifier.)
This method will use 30
.
data
- [optional] String of the hash of the method signature and encoded parameters. For more information, see the .
QUANTITY | TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
, see the
This method will use 80
.
See
This method will use 30
.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
, see the
This method will use 20
.
This method will use 20
.
This method will use 70
.
Returns information about a uncle of a block by hash and uncle index position.
This method will use 20
Compute Units.
DATA
, 32 Bytes - The hash of a block.
QUANTITY
- The uncle's index position.
Object
- A block object, or null
when no block was found:
number
: QUANTITY
- the block number. null
when its pending block.
hash
: DATA
, 32 Bytes - hash of the block. null
when its pending block.
parentHash
: DATA
, 32 Bytes - hash of the parent block.
nonce
: DATA
, 8 Bytes - hash of the generated proof-of-work. null
when its pending block.
sha3Uncles
: DATA
, 32 Bytes - SHA3 of the uncles data in the block.
logsBloom
: DATA
, 256 Bytes - the bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
: DATA
, 32 Bytes - the root of the transaction trie of the block.
stateRoot
: DATA
, 32 Bytes - the root of the final state trie of the block.
receiptsRoot
: DATA
, 32 Bytes - the root of the receipts trie of the block.
miner
: DATA
, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.
difficulty
: QUANTITY
- integer of the difficulty for this block.
totalDifficulty
: QUANTITY
- integer of the total difficulty of the chain until this block.
extraData
: DATA
- the "extra data" field of this block.
size
: QUANTITY
- integer the size of this block in bytes.
gasLimit
: QUANTITY
- the maximum gas allowed in this block.
gasUsed
: QUANTITY
- the total used gas by all transactions in this block.
timestamp
: QUANTITY
- the unix timestamp for when the block was collated.
transactions
: Array
- Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
uncles
: Array
- Array of uncle hashes.
Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.
This method will use 20
Compute Units.
None
QUANTITY
- A filter id.
Returns the number of uncles in a block from a block matching the given block hash.
This method will use 20
Compute Units.
QUANTITY|TAG
- integer of a block number, or the string "latest", "earliest" or "pending", see the default block parameter
QUANTITY
- integer of the number of uncles in this block.
Returns information about a transaction by block number and transaction index position.
This method will use 20
Compute Units.
QUANTITY|TAG
- a block number, or the string "earliest"
, "latest"
or "pending"
, as in the default block parameter.
QUANTITY
- the transaction index position.
Object
- A transaction object, or null
when no transaction was found:
blockHash
: DATA
, 32 Bytes - hash of the block where this transaction was in. null
when its pending.
blockNumber
: QUANTITY
- block number where this transaction was in. null
when its pending.
from
: DATA
, 20 Bytes - address of the sender.
gas
: QUANTITY
- gas provided by the sender.
gasPrice
: QUANTITY
- gas price provided by the sender in Wei.
hash
: DATA
, 32 Bytes - hash of the transaction.
input
: DATA
- the data send along with the transaction.
nonce
: QUANTITY
- the number of transactions made by the sender prior to this one.
to
: DATA
, 20 Bytes - address of the receiver. null
when its a contract creation transaction.
transactionIndex
: QUANTITY
- integer of the transactions index position in the block. null
when its pending.
value
: QUANTITY
- value transferred in Wei.
v
: QUANTITY
- ECDSA recovery id
r
: QUANTITY
- ECDSA signature r
s
: QUANTITY
- ECDSA signature s
Creates new message call transaction or a contract creation for signed transactions.
This method will use 270
Compute Units.
DATA
, The signed transaction data.
DATA
, 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available.
Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.
Returns information about a uncle of a block by number and uncle index position.
This method will use 20
Compute Units.
QUANTITY|TAG
- a block number, or the string "earliest"
, "latest"
or "pending"
, as in the default block parameter.
QUANTITY
- the uncle's index position.
Returns the number of uncles in a block from a block matching the given block hash.
This method will use 20
Compute Units.
DATA
, 32 Bytes - hash of a block
QUANTITY
- integer of the number of uncles in this block.
Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.
This method will use 20
Compute Units.
None
QUANTITY
- A filter id.
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
This method will use 20
Compute Units.
A note on specifying topic filters: 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)"
Object
- The filter options:
fromBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block, "safe"
for the latest safe block, "finalized"
for the latest finalized block, or "pending"
, "earliest"
for not yet mined transactions.
toBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block, "safe"
for the latest safe block, "finalized"
for the latest finalized block, or "pending"
, "earliest"
for not yet mined transactions.
address
: DATA|Array
, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
topics
: Array of DATA
, - (optional) Array of 32 Bytes DATA
topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
QUANTITY
- A filter id.
Returns number of peers currently connected to the client.
This method will use 10
Compute Units.
None
QUANTITY
- integer of the number of connected peers.
Returns an object with data about the sync status or false.
This method will use 5
Compute Units.
None
Object|Boolean
, An object with sync status data or FALSE
, when not syncing:
startingBlock
: QUANTITY
- The block at which the import started (will only be reset, after the sync reached his head)
currentBlock
: QUANTITY
- The current block, same as eth_blockNumber
highestBlock
: QUANTITY
- The estimated highest block
Cancels an existing subscription so that no further events are sent.
This method will use 10
Compute Units.
subscription name
- string, same as previously returned from an eth_subscribe call
true
if a subscription was successfully cancelled, or false
if no subscription existed with the given ID.
Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additionally Filters timeout when they aren't requested with eth_getFilterChanges for a period of time.
This method will use 10
Compute Units.
QUANTITY
- The filter id.
Boolean
- true
if the filter was successfully uninstalled, otherwise false
.
This method will use 20
.
This method will use 5
.
The full list of current network IDs is available at . Some common ones are:
Returns a list of addresses owned by client.
This method will use 10
Compute Units.
None
array of data
- 20 Bytes - addresses owned by the client
Returns information about a block by hash.
This method will use 30
Compute Units.
DATA
, 32 Bytes - Hash of a block.
Boolean
- If true
it returns the full transaction objects, if false
only the hashes of the transactions are returned.
Object
- A block object, or null
when no block was found:
number
: QUANTITY
- the block number. null
when its pending block.
hash
: DATA
, 32 Bytes - hash of the block. null
when its pending block.
parentHash
: DATA
, 32 Bytes - hash of the parent block.
nonce
: DATA
, 8 Bytes - hash of the generated proof-of-work. null
when its pending block.
sha3Uncles
: DATA
, 32 Bytes - SHA3 of the uncles data in the block.
logsBloom
: DATA
, 256 Bytes - the bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
: DATA
, 32 Bytes - the root of the transaction trie of the block.
stateRoot
: DATA
, 32 Bytes - the root of the final state trie of the block.
receiptsRoot
: DATA
, 32 Bytes - the root of the receipts trie of the block.
miner
: DATA
, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.
difficulty
: QUANTITY
- integer of the difficulty for this block.
totalDifficulty
: QUANTITY
- integer of the total difficulty of the chain until this block.
extraData
: DATA
- the "extra data" field of this block.
size
: QUANTITY
- integer the size of this block in bytes.
gasLimit
: QUANTITY
- the maximum gas allowed in this block.
gasUsed
: QUANTITY
- the total used gas by all transactions in this block.
timestamp
: QUANTITY
- the unix timestamp for when the block was collated.
transactions
: Array
- Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
uncles
: Array
- Array of uncle hashes.
Returns the information about a transaction requested by transaction hash.
This method will use 20
Compute Units.
DATA
, 32 Bytes - hash of a transaction
Object
- A transaction object, or null
when no transaction was found:
blockHash
: DATA
, 32 Bytes - hash of the block where this transaction was in. null
when its pending.
blockNumber
: QUANTITY
- block number where this transaction was in. null
when its pending.
from
: DATA
, 20 Bytes - address of the sender.
gas
: QUANTITY
- gas provided by the sender.
gasPrice
: QUANTITY
- gas price provided by the sender in Wei.
hash
: DATA
, 32 Bytes - hash of the transaction.
input
: DATA
- the data send along with the transaction.
nonce
: QUANTITY
- the number of transactions made by the sender prior to this one.
to
: DATA
, 20 Bytes - address of the receiver. null
when its a contract creation transaction.
transactionIndex
: QUANTITY
- integer of the transactions index position in the block. null
when its pending.
value
: QUANTITY
- value transferred in Wei.
v
: QUANTITY
- ECDSA recovery id
r
: QUANTITY
- ECDSA signature r
s
: QUANTITY
- ECDSA signature s
Returns an object with data about the sync status or false.
This method will use 10
Compute Units.
subscription name
- string - The type of event you want to subscribe to (i.e., newHeads, logs, pendingTransactions, newPendingTransactions). This method supports the following subscription types:
pendingTransactions - Returns full transactions that are sent to the network, marked as pending, and are sent from or to a certain address.\
newPendingTransactions - Returns the hash for all transactions that are added to the pending state and are signed with a key that is available in the node.\
newHeads - Fires a notification each time a new header is appended to the chain, including chain reorganizations.\
logs - Returns logs that are included in new imported blocks and match the given filter criteria.
data - object -
(Optional) - Arguments such as an address, multiple addresses, and topics. Note, only logs that are created from these addresses or match the specified topics will return logs.
result - string
- Hex encoded subscription ID. This ID will be attached to all received events and can also be used to cancel the subscription using eth_unsubscribe.
Returns true
if client is actively listening for network connections.
This method will use 5
Compute Units.
None
Boolean
- true
when listening, otherwise false
.
Returns Keccak-256 (not the standardized SHA3-256) of the given data.
This method will use 20
Compute Units.
DATA
- the data to convert into a SHA3 hash
DATA
- The SHA3 resultant hash of the given string