MinedTransactionResponse

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:696

A MinedTransactionResponse is an interface representing a transaction which has been mined and allows for a type guard for its property values being defined.

Extends

TransactionResponse

Properties

accessList

readonly accessList: null | AccessList;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:830

The [[link-eip-2930]] access list for transaction types that support it, otherwise null.

Inherited from

MinedTransactionResponse.accessList

authorizationList

readonly authorizationList:
  | null
  | Authorization[];

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:838

The [[link-eip-7702]] authorizations (if any).

Inherited from

MinedTransactionResponse.authorizationList

blobVersionedHashes

readonly blobVersionedHashes: null | string[];

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:834

The [[link-eip-4844]] BLOb versioned hashes.

Inherited from

MinedTransactionResponse.blobVersionedHashes

blockHash

blockHash: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:704

The block hash this transaction occurred in.

Overrides

ContractTransactionResponse.blockHash

blockNumber

blockNumber: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:700

The block number this transaction occurred in.

Overrides

ContractTransactionResponse.blockNumber

chainId

readonly chainId: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:821

The chain ID.

Inherited from

TransactionResponse.chainId

data

readonly data: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:812

The data.

Inherited from

TransactionResponse.data

date

date: Date;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:708

The date this transaction occurred on.

from

readonly from: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:765

The sender of this transaction. It is implicitly computed from the transaction pre-image hash (as the digest) and the [[signature]] using ecrecover.

Inherited from

TransactionResponse.from

gasLimit

readonly gasLimit: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:780

The maximum units of gas this transaction can consume. If execution exceeds this, the entries transaction is reverted and the sender is charged for the full amount, despite not state changes being made.

Inherited from

TransactionResponse.gasLimit

gasPrice

readonly gasPrice: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:793

The gas price can have various values, depending on the network.

In modern networks, for transactions that are included this is the //effective gas price// (the fee per gas that was actually charged), while for transactions that have not been included yet is the [[maxFeePerGas]].

For legacy transactions, or transactions on legacy networks, this is the fee that will be charged per unit of gas the transaction consumes.

Inherited from

TransactionResponse.gasPrice

hash

readonly hash: string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:745

The transaction hash.

Inherited from

TransactionResponse.hash

index

readonly index: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:741

The index within the block that this transaction resides at.

Inherited from

TransactionResponse.index

maxFeePerBlobGas

readonly maxFeePerBlobGas: null | bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:808

The [[link-eip-4844]] max fee per BLOb gas.

Inherited from

MinedTransactionResponse.maxFeePerBlobGas

maxFeePerGas

readonly maxFeePerGas: null | bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:804

The maximum fee (per unit of gas) to allow this transaction to charge the sender.

Inherited from

MinedTransactionResponse.maxFeePerGas

maxPriorityFeePerGas

readonly maxPriorityFeePerGas: null | bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:799

The maximum priority fee (per unit of gas) to allow a validator to charge the sender. This is inclusive of the [[maxFeeFeePerGas]].

Inherited from

MinedTransactionResponse.maxPriorityFeePerGas

nonce

readonly nonce: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:774

The nonce, which is used to prevent replay attacks and offer a method to ensure transactions from a given sender are explicitly ordered.

When sending a transaction, this must be equal to the number of transactions ever sent by [[from]].

Inherited from

TransactionResponse.nonce

provider

readonly provider: Provider;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:725

The provider this is connected to, which will influence how its methods will resolve its async inspection methods.

Inherited from

TransactionResponse.provider

signature

readonly signature: Signature;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:825

The signature.

Inherited from

TransactionResponse.signature

to

readonly to: null | string;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:759

The receiver of this transaction.

If null, then the transaction is an initcode transaction. This means the result of executing the [[data]] will be deployed as a new contract on chain (assuming it does not revert) and the address may be computed using [[getCreateAddress]].

Inherited from

MinedTransactionResponse.to

type

readonly type: number;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:750

The [[link-eip-2718]] transaction envelope type. This is 0 for legacy transactions types.

Inherited from

TransactionResponse.type

value

readonly value: bigint;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:817

The value, in wei. Use [[formatEther]] to format this value as ether.

Inherited from

TransactionResponse.value

Methods

confirmations()

confirmations(): Promise<number>;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:862

Resolve to the number of confirmations this transaction has.

Returns

Promise<number>

Inherited from

TransactionResponse.confirmations

getBlock()

getBlock(): Promise<null | Block>;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:852

Resolves to the Block that this transaction was included in.

This will return null if the transaction has not been included yet.

Returns

Promise<null | Block>

Inherited from

TransactionResponse.getBlock

getTransaction()

getTransaction(): Promise<
  | null
| TransactionResponse>;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:858

Resolves to this transaction being re-requested from the provider. This can be used if you have an unmined transaction and wish to get an up-to-date populated instance.

Returns

Promise< | null | TransactionResponse>

Inherited from

TransactionResponse.getTransaction

isBerlin()

isBerlin(): this is TransactionResponse & { accessList: AccessList; maxFeePerGas: null; maxPriorityFeePerGas: null };

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:904

Returns true if the transaction is a Berlin (i.e. type == 1) transaction. See [[link-eip-2070]].

This provides a Type Guard that this transaction will have the null-ness for hardfork-specific properties set correctly.

Returns

this is TransactionResponse & { accessList: AccessList; maxFeePerGas: null; maxPriorityFeePerGas: null }

Inherited from

TransactionResponse.isBerlin

isCancun()

isCancun(): this is TransactionResponse & { accessList: AccessList; blobVersionedHashes: string[]; maxFeePerBlobGas: bigint; maxFeePerGas: bigint; maxPriorityFeePerGas: bigint };

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:925

Returns true if hte transaction is a Cancun (i.e. type == 3) transaction. See [[link-eip-4844]].

Returns

this is TransactionResponse & { accessList: AccessList; blobVersionedHashes: string[]; maxFeePerBlobGas: bigint; maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }

Inherited from

TransactionResponse.isCancun

isLegacy()

isLegacy(): this is TransactionResponse & { accessList: null; maxFeePerGas: null; maxPriorityFeePerGas: null };

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:892

Returns true if the transaction is a legacy (i.e. type == 0) transaction.

This provides a Type Guard that this transaction will have the null-ness for hardfork-specific properties set correctly.

Returns

this is TransactionResponse & { accessList: null; maxFeePerGas: null; maxPriorityFeePerGas: null }

Inherited from

TransactionResponse.isLegacy

isLondon()

isLondon(): this is TransactionResponse & { accessList: AccessList; maxFeePerGas: bigint; maxPriorityFeePerGas: bigint };

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:916

Returns true if the transaction is a London (i.e. type == 2) transaction. See [[link-eip-1559]].

This provides a Type Guard that this transaction will have the null-ness for hardfork-specific properties set correctly.

Returns

this is TransactionResponse & { accessList: AccessList; maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }

Inherited from

TransactionResponse.isLondon

isMined()

isMined(): this is MinedTransactionResponse;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:884

Returns true if this transaction has been included.

This is effective only as of the time the TransactionResponse was instantiated. To get up-to-date information, use [[getTransaction]].

This provides a Type Guard that this transaction will have non-null property values for properties that are null for unmined transactions.

Returns

this is MinedTransactionResponse

Inherited from

TransactionResponse.isMined

removedEvent()

removedEvent(): OrphanFilter;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:936

Returns a filter which can be used to listen for orphan events that evict this transaction.

Returns

OrphanFilter

Inherited from

TransactionResponse.removedEvent

reorderedEvent()

reorderedEvent(other?): OrphanFilter;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:941

Returns a filter which can be used to listen for orphan events that re-order this event against %%other%%.

Parameters

Parameter	Type
`other?`	`TransactionResponse`

Returns

OrphanFilter

Inherited from

TransactionResponse.reorderedEvent

replaceableTransaction()

replaceableTransaction(startBlock): TransactionResponse;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:951

Returns a new TransactionResponse instance which has the ability to detect (and throw an error) if the transaction is replaced, which will begin scanning at %%startBlock%%.

This should generally not be used by developers and is intended primarily for internal use. Setting an incorrect %%startBlock%% can have devastating performance consequences if used incorrectly.

Parameters

Parameter	Type
`startBlock`	`number`

Returns

TransactionResponse

Inherited from

TransactionResponse.replaceableTransaction

toJSON()

toJSON(): any;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:846

Returns a JSON-compatible representation of this transaction.

Returns

any

Inherited from

TransactionResponse.toJSON

wait()

wait(_confirms?, _timeout?): Promise<
  | null
| TransactionReceipt>;

Defined in: node_modules/.pnpm/ethers@6.15.0/node_modules/ethers/lib.esm/providers/provider.d.ts:872

Resolves once this transaction has been mined and has %%confirms%% blocks including it (default: 1) with an optional %%timeout%%.

This can resolve to null only if %%confirms%% is 0 and the transaction has not been mined, otherwise this will wait until enough confirmations have completed.

Parameters

Parameter	Type
`_confirms?`	`number`
`_timeout?`	`number`

Returns

Promise< | null | TransactionReceipt>

Inherited from

TransactionResponse.wait