ABlockTag specifies a specific block location in the Blockchain.
"latest" - The most recently mined block"earliest" - Block #0"pending" - The block currently being prepared for mining; not all operations and backends support this BlockTagANetworkish may be any of the following:
"homestead")name andensAddress will be populated, otherwise, the default name"unknown" and noensAddress is usedANetwork represents an Ethereum network.
The human-readable name of the network, such ashomestead. If the network name is unknown, this will be"unknown".
The Chain ID of the network.
The address at which the ENS registry is deployed on this network.
AFeeData object encapsulates the necessary fee data required to send a transaction, based on the best available recommendations.
The gasPrice to use for legacy transactions or networks which do not support EIP-1559.
ThemaxFeePerGas to use for a transaction. This is based on the most recent block'sbaseFee.
ThemaxPriorityFeePerGas to use for a transaction. This accounts for the uncle risk and for the majority of current MEV risk.
The hash of this block.
The hash of the previous block.
The height (number) of this block.
The timestamp of this block.
The nonce used as part of the proof-of-work to mine this block.
This property is generally of little interest to developers.
The difficulty target required to be met by the miner of the block.
Recently the difficulty frequently exceeds the size that a JavaScript number can safely store (53-bits), so in that case this property may be null. It is recommended to use the `_difficulty` property below, which will always return a value, but as aBigNumber.
This property is generally of little interest to developers.
The difficulty target required to be met by the miner of the block, as aBigNumber.
Recently the difficulty frequently exceeds the size that a JavaScript number can safely store (53-bits), so this property was added to safely encode the value for applications that require it.
This property is generally of little interest to developers.
The maximum amount of gas that this block was permitted to use. This is a value that can be voted up or voted down by miners and is used to automatically adjust the bandwidth requirements of the network.
This property is generally of little interest to developers.
The total amount of gas used by all transactions in this block.
The coinbase address of this block, which indicates the address the miner that mined this block would like the subsidy reward to go to.
This is extra data a miner may choose to include when mining a block.
This property is generally of little interest to developers.
Often only the hashes of the transactions included in a block are needed, so by default a block only contains this information, as it is substantially less data.
A list of the transactions hashes for each transaction this block includes.
If all transactions for a block are needed, this object instead includes the full details on each transaction.
A list of the transactions this block includes.
The address to filter by, ornull to match any address.
The topics to filter by ornull to match any topics.
Each entry represents anAND condition that must match, or may benull to match anything. If a given entry is an Array, then that entry is treated as anOR for any value in the entry.
SeeFilters for more details and examples on specifying complex filters.
The starting block (inclusive) to search for logs matching the filter criteria.
The end block (inclusive) to search for logs matching the filter criteria.
The specific block (by its block hash) to search for logs matching the filter criteria.
The block height (number) of the block including the transaction of this log.
The block hash of the block including the transaction of this log.
During a re-org, if a transaction is orphaned, this will be set to true to indicate the Log entry has been removed; it will likely be emitted again in the near future when another block is mined with the transaction that triggered this log, but keep in mind the values may change.
The address of the contract that generated this log.
The data included in this log.
The list of topics (indexed properties) for this log.
The transaction hash of the transaction of this log.
The index of the transaction in the block of the transaction of this log.
The index of this log across all logs in the entireblock.
A transaction request describes a transaction that is to be sent to the network or otherwise processed.
All fields are optional and may be a promise which resolves to the required type.
The address (or ENS name) this transaction it to.
The address this transaction is from.
The nonce for this transaction. This should be set to the number of transactions ever sentfrom this address.
The transaction data.
The amount (in wei) this transaction is sending.
The maximum amount of gas this transaction is permitted to use.
If left unspecified, ethers will useestimateGas to determine the value to use. For transactions with unpredicatable gas estimates, this may be required to specify explicitly.
The price (in wei) per unit of gas this transaction will pay.
This may not be specified for transactions withtype set to1 or2, or ifmaxFeePerGas ormaxPriorityFeePerGas is given.
The maximum price (in wei) per unit of gas this transaction will pay for the combinedEIP-1559 block's base fee and this transaction's priority fee.
Most developers should leave this unspecified and use the default value that ethers determines from the network.
This may not be specified for transactions withtype set to0 or ifgasPrice is specified..
The price (in wei) per unit of gas this transaction will allow in addition to theEIP-1559 block's base fee to bribe miners into giving this transaction priority. This isincluded in themaxFeePerGas, so this willnot affect the total maximum cost set withmaxFeePerGas.
Most developers should leave this unspecified and use the default value that ethers determines from the network.
This may not be specified for transactions withtype set to0 or ifgasPrice is specified.
The chain ID this transaction is authorized on, as specified byEIP-155.
If the chain ID is 0 will disable EIP-155 and the transaction will be valid on any network. This can bedangerous and care should be taken, since it allows transactions to be replayed on networks that were possibly not intended. Intentionally-replayable transactions are also disabled by default on recent versions of Geth and require configuration to enable.
TheEIP-2718 type of this transaction envelope, ornull for to use the network default. To force using a lagacy transaction without an envelope, use type0.
TheAccessList to include; only available forEIP-2930 andEIP-1559 transactions.
ATransactionResponse includes all properties of aTransaction as well as several properties that are useful once it has been mined.
The number ("height") of the block this transaction was mined in. If the block has not been mined, this isnull.
The hash of the block this transaction was mined in. If the block has not been mined, this isnull.
The timestamp of the block this transaction was mined in. If the block has not been mined, this isnull.
The number of blocks that have been mined (including the initial block) since this transaction was mined.
The serialized transaction. This may be null as some backends do not populate it. If this is required, it can be computed from aTransactionResponse object usingthis cookbook recipe.
Resolves to theTransactionReceipt once the transaction has been included in the chain forconfirms blocks. Ifconfirms is 0, and the transaction has not been mined,null is returned.
If the transaction execution failed (i.e. the receipt status is0), aCALL_EXCEPTION error will be rejected with the following properties:
error.transaction - the original transactionerror.transactionHash - the hash of the transactionerror.receipt - the actual receipt, with the status of0If the transaction is replaced by another transaction, aTRANSACTION_REPLACED error will be rejected with the following properties:
error.hash - the hash of the original transaction which was replacederror.reason - a string reason; one of"repriced","cancelled" or"replaced"error.cancelled - a boolean; a"repriced" transaction is not considered cancelled, but"cancelled" and"replaced" areerror.replacement - the replacement transaction (aTransactionResponse)error.receipt - the receipt of the replacement transaction (aTransactionReceipt)Transactions are replaced when the user uses an option in their client to send a new transaction from the same account with the originalnonce. This is usually to speed up a transaction or to cancel one, by bribing miners with additional fees to prefer the new transaction over the original one.
TheEIP-2718 type of this transaction. If the transaction is a legacy transaction without an envelope, it will have the type0.
TheAccessList included, or null for transaction types which do not support access lists.
The address this transaction is to. This isnull if the transaction was aninit transaction, used to deploy a contract.
The address this transaction is from.
If this transaction has anull to address, it is aninit transaction used to deploy a contract, in which case this is the address created by that contract.
To compute a contract address, thegetContractAddress utility function can also be used with aTransactionResponse object, which requires the transaction nonce and the address of the sender.
The index of this transaction in the list of transactions included in the block this transaction was mined in.
TheEIP-2718 type of this transaction. If the transaction is a legacy transaction without an envelope, it will have the type0.
The intermediate state root of a receipt.
Only transactions included in blocksbefore theByzantium Hard Fork have this property, as it was replaced by thestatus property.
The property is generally of little use to developers. At the time it could be used to verify a state transition with a fraud-proof only considering the single transaction; without it the full block must be considered.
The amount of gas actually used by this transaction.
The effective gas price the transaction was charged at.
Prior to EIP-1559 or on chains that do not support it, this value will simply be equal to the transactiongasPrice.
On EIP-1559 chains, this is equal to the blockbaseFee for the block that the transaction was included in, plus the transactionmaxPriorityFeePerGas clamped to the transactionmaxFeePerGas.
Abloom-filter, which includes all the addresses and topics included in any log in this transaction.
The block hash of the block that this transaction was included in.
The transaction hash of this transaction.
All the logs emitted by this transaction.
The block height (number) of the block that this transaction was included in.
The number of blocks that have been mined since this transaction, including the actual block it was mined in.
For the block this transaction was included in, this is the sum of the gas used by each transaction in the ordered list of transactions up to (and including) this transaction.
This is generally of little interest to developers.
This is true if the block is in apost-Byzantium Hard Fork block.
The status of a transaction is 1 is successful or 0 if it was reverted. Only transactions included in blockspost-Byzantium Hard Fork have this property.
An Access List is optional an includes a list of addresses and storage slots for that address which should bewarmed or pre-fetched for use within the execution of this transaction. Awarmed value has an additional upfront cost to access, but is discounted throughout the code execution for reading and writing.
A looser description of anAccessList, which will be converted internally usingaccessListify.
It may be any of:
When using the object form (the last option), the addresses and storage slots will be sorted. If an explicit order for the access list is required, one of the other forms must be used. Most developersdo not require explicit order.
AnEIP-2930 transaction allows an optionalAccessList which causes a transaction towarm (i.e. pre-cache) another addresses state and the specified storage keys.
This incurs an increased intrinsic cost for the transaction, but provides discounts for storage and state access throughout the execution of the transaction.