Block
A Block represents the data associated with a full block on Ethereum.
Extended by
Implements
BlockParamsIterable<string>
Constructors
new Block()
Create a new Block object.
This should generally not be necessary as the unless implementing a low-level library.
Parameters
| Parameter | Type | Description |
|---|---|---|
block | BlockParams | The block parameters. |
provider | Provider | The provider. |
Returns
Source
Properties
| Property | Modifier | Type | Description |
|---|---|---|---|
provider | readonly | Provider | The provider connected to the block used to fetch additional details if necessary. |
Accessors
date
The Date this block was included at.
Returns
null | Date
The date this block was included at, or null if the timestamp is not available.
Source
length
The number of transactions in this block.
Returns
number
The number of transactions.
Source
outboundEtxs
Returns the list of extended transaction hashes, in the order they were executed within the block.
Returns
readonly string[]
The list of extended transaction hashes.
Source
prefetchedExtTransactions
Returns the complete extended transactions, in the order they were executed within the block.
This is only available for blocks which prefetched transactions, by passing true to prefetchTxs into
getBlock.
Throws
If the transactions were not prefetched.
Returns
ExternalTransactionResponse[]
The list of prefetched extended transactions.
Source
prefetchedTransactions
Returns the complete transactions, in the order they were executed within the block.
This is only available for blocks which prefetched transactions, by passing true to prefetchTxs into
getBlock.
Throws
If the transactions were not prefetched.
Returns
The list of prefetched transactions.
Source
transactions
Returns the list of transaction hashes, in the order they were executed within the block.
Returns
readonly string[]
The list of transaction hashes.
Source
Methods
getExtTransaction()
Get the extended transaction at index within this block.
Parameters
| Parameter | Type | Description |
|---|---|---|
indexOrHash | string | number | The index or hash of the extended transaction. |
Returns
Promise<ExternalTransactionResponse>
A promise resolving to the extended transaction.
Throws
If the extended transaction is not found.
Source
getPrefetchedTransaction()
If a Block was fetched with a request to include the transactions this will allow synchronous access to those transactions.
If the transactions were not prefetched, this will throw.
Parameters
| Parameter | Type | Description |
|---|---|---|
indexOrHash | string | number | The index or hash of the transaction. |
Returns
The transaction.
Throws
If the transaction is not found.
Source
getTransaction()
Get the transaction at index within this block.
Parameters
| Parameter | Type | Description |
|---|---|---|
indexOrHash | string | number | The index or hash of the transaction. |
Returns
Promise<TransactionResponse | ExternalTransactionResponse>
A promise resolving to the transaction.
Throws
If the transaction is not found.
Source
isMined()
Returns true if this block been mined. This provides a type guard for all properties on a MinedBlock.
Returns
this is MinedBlock
True if the block has been mined.
Source
toJSON()
Returns a JSON-friendly value.
Returns
The JSON-friendly value.
Source
Was this page helpful?