Executes a sequence of message calls building on each other's state without creating transactions on the block chain, optionally overriding block and state data
https://api.1inch.com/web3/1
Parameters
Payload (required)
Payload
* any
blockStateCalls
* array
Definition of blocks that can contain calls and overrides
blockOverrides
object
Block overrides can be used to replace fields in a block.
default: no block override.
number
string
When overriding block numbers across multiple blocks, block number need to be increasing. Skipping over blocks numbers is possible. If block number is not specified, it's incremented by one for each block.
prevRandao
string
time
string
Time must either increase or remain constant relative to the previous block. If time is not specified, it's incremented by one for each block.
gasLimit
string
feeRecipient
string
baseFeePerGas
string
withdrawals
array
This array can have a maximum length of 16.
items
any
blobBaseFee
string
stateOverrides
object
State overrides can be used to replace existing blockchain state with new state.
Default: no state overrides
additionalProperties
none
calls
array
List of transactions to execute at this block/state.
Default: []
items
object
type
string
Default: 0x2
nonce
string
Default: Defaults to correct nonce
to
string
Default: 0x0
from
string
Default: null
gas
string
Default: Remaining gas in the current block
value
string
Default: 0
input
string
Default: no data
gasPrice
string
The gas price willing to be paid by the sender in wei
Default: 0
maxPriorityFeePerGas
string
Maximum fee per gas the sender is willing to pay to miners in wei
Default: 0
maxFeePerGas
string
The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
Default: 0
maxFeePerBlobGas
string
The maximum total fee per blob gas the sender is willing to pay in wei
Default: 0
accessList
array
EIP-2930 access list
Default: []
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
blobVersionedHashes
string
EIP-4844 versioned hashes
Default: []
traceTransfers
boolean
Adds ETH transfers as ERC20 transfer events to the logs. These transfers have emitter contract parameter set as address(0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee).
Default: false.
validation
boolean
When true, the eth_simulateV1 does all validations that a normal EVM would do, except contract sender and signature checks. When false, eth_simulateV1 behaves like eth_call.
Default: false.
returnFullTransactions
boolean
When true, the method returns full transaction objects, otherwise, just hashes are returned.
Block tag
default: 'latest'
Block tag
any
anyOf[0]
string
anyOf[1]
string (Enum)
`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error
earliest
finalized
safe
latest
pending
anyOf[2]
string
Request
Request
object
jsonrpc
* string (Enum)
JSON-RPC version
2.0
method
* string
The method to call
params
array
Method parameters
items
any
oneOf[0]
any
blockStateCalls
* array
Definition of blocks that can contain calls and overrides
blockOverrides
object
Block overrides can be used to replace fields in a block.
default: no block override.
number
string
When overriding block numbers across multiple blocks, block number need to be increasing. Skipping over blocks numbers is possible. If block number is not specified, it's incremented by one for each block.
prevRandao
string
time
string
Time must either increase or remain constant relative to the previous block. If time is not specified, it's incremented by one for each block.
gasLimit
string
feeRecipient
string
baseFeePerGas
string
withdrawals
array
This array can have a maximum length of 16.
items
any
blobBaseFee
string
stateOverrides
object
State overrides can be used to replace existing blockchain state with new state.
Default: no state overrides
additionalProperties
none
calls
array
List of transactions to execute at this block/state.
Default: []
items
object
type
string
Default: 0x2
nonce
string
Default: Defaults to correct nonce
to
string
Default: 0x0
from
string
Default: null
gas
string
Default: Remaining gas in the current block
value
string
Default: 0
input
string
Default: no data
gasPrice
string
The gas price willing to be paid by the sender in wei
Default: 0
maxPriorityFeePerGas
string
Maximum fee per gas the sender is willing to pay to miners in wei
Default: 0
maxFeePerGas
string
The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
Default: 0
maxFeePerBlobGas
string
The maximum total fee per blob gas the sender is willing to pay in wei
Default: 0
accessList
array
EIP-2930 access list
Default: []
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
blobVersionedHashes
string
EIP-4844 versioned hashes
Default: []
traceTransfers
boolean
Adds ETH transfers as ERC20 transfer events to the logs. These transfers have emitter contract parameter set as address(0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee).
Default: false.
validation
boolean
When true, the eth_simulateV1 does all validations that a normal EVM would do, except contract sender and signature checks. When false, eth_simulateV1 behaves like eth_call.
Default: false.
returnFullTransactions
boolean
When true, the method returns full transaction objects, otherwise, just hashes are returned.
oneOf[1]
any
anyOf[0]
string
anyOf[1]
string (Enum)
`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error
The error messages are suggestions and a client might decide to return a different errror message than specified here. However, the error codes are enforced by this specification.
error
* any
oneOf[0]
any
oneOf[1]
any
oneOf[2]
any
oneOf[3]
any
oneOf[4]
any
oneOf[5]
any
oneOf[6]
any
oneOf[7]
any
oneOf[8]
any
oneOf[9]
any
oneOf[10]
any
oneOf[11]
any
oneOf[12]
any
oneOf[13]
any
oneOf[14]
any
oneOf[15]
any
oneOf[16]
any
oneOf[17]
any
oneOf[18]
any
oneOf[1]
array
items
object
hash
* string
parentHash
* string
sha3Uncles
* string
miner
* string
stateRoot
* string
transactionsRoot
* string
receiptsRoot
* string
logsBloom
* string
difficulty
string
number
* string
gasLimit
* string
gasUsed
* string
timestamp
* string
extraData
* string
mixHash
* string
nonce
* string
baseFeePerGas
string
withdrawalsRoot
string
blobGasUsed
string
excessBlobGas
string
parentBeaconBlockRoot
string
size
* string
transactions
* any
anyOf[0]
array
items
string
anyOf[1]
array
items
object
oneOf[0]
object
type
* string
nonce
* string
to
* string
gas
* string
value
* string
input
* string
maxPriorityFeePerGas
* string
Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string
The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
gasPrice
string
The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.
accessList
* array
EIP-2930 access lists
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
chainId
* string
Chain ID that this transaction is valid on
authorizationList
* array
List of authorizations for the transaction
items
object
chainId
* string
Chain ID on which this transaction is valid
nonce
* string
address
* string
yParity
* string
The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature
r
* string
s
* string
yParity
* string
The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string
For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
r
* string
s
* string
oneOf[1]
object
type
* string
nonce
* string
to
* string
gas
* string
value
* string
input
* string
maxPriorityFeePerGas
* string
Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string
The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
maxFeePerBlobGas
* string
The maximum total fee per gas the sender is willing to pay for blob gas in wei
gasPrice
string
The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.
accessList
* array
EIP-2930 access list
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
blobVersionedHashes
* array
List of versioned blob hashes associated with the transaction's EIP-4844 data blobs
items
string
chainId
* string
Chain ID that this transaction is valid on
yParity
* string
The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string
For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
r
* string
s
* string
oneOf[2]
object
type
* string
nonce
* string
to
any
oneOf[0]
null
oneOf[1]
string
gas
* string
value
* string
input
* string
maxPriorityFeePerGas
* string
Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string
The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
gasPrice
* string
The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.
accessList
* array
EIP-2930 access list
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
chainId
* string
Chain ID that this transaction is valid on.
yParity
* string
The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string
For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
r
* string
s
* string
oneOf[3]
object
type
* string
nonce
* string
to
any
oneOf[0]
null
oneOf[1]
string
gas
* string
value
* string
input
* string
gasPrice
* string
The gas price willing to be paid by the sender in wei
accessList
* array
EIP-2930 access list
items
object
address
* string
storageKeys
* array
items
string
additionalProperties
none
chainId
* string
Chain ID that this transaction is valid on.
yParity
* string
The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string
For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.
r
* string
s
* string
oneOf[4]
object
type
* string
nonce
* string
to
any
oneOf[0]
null
oneOf[1]
string
gas
* string
value
* string
input
* string
gasPrice
* string
The gas price willing to be paid by the sender in wei