A QiTransactionResponse includes all properties about a Qi transaction that was sent to the network, which may or may not be included in a block.

The TransactionResponse.isMined | TransactionResponse.isMined can be used to check if the transaction has been mined as well as type guard that the otherwise possibly null properties are defined.

Implements

  • QiTransactionLike
  • QiTransactionResponseParams

Properties

PropertyModifierTypeDescription
blockHashreadonlynull | stringThe blockHash of the block that this transaction was included in.

This is null for pending transactions.
blockNumberreadonlynull | numberThe block number of the block that this transaction was included in.

This is null for pending transactions.
chainIdreadonlybigintThe chain ID.
hashreadonlystringThe transaction hash.
indexreadonlybigintThe index within the block that this transaction resides at.
providerreadonlyProviderThe provider this is connected to, which will influence how its methods will resolve its async inspection
methods.
signaturereadonlystringThe signature.
typereadonlynumberThe EIP-2718 transaction envelope type. This is 0 for legacy
transactions types.

Methods

confirmations()

confirmations(): Promise<number>

Resolve to the number of confirmations this transaction has.

Returns

Promise<number>

A promise resolving to the number of confirmations.

Source

providers/provider.ts:2393


getBlock()

getBlock(shard): Promise<null | Block>

Resolves to the Block that this transaction was included in.

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

Parameters

ParameterTypeDescription
shardShardThe shard to fetch the block from.

Returns

Promise<null | Block>

A promise resolving to the block or null if not found.

Source

providers/provider.ts:2354


getTransaction()

getTransaction(): Promise<null | QiTransactionResponse>

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 | QiTransactionResponse>

A promise resolving to the transaction, or null if not found.

Throws

If the transaction is not found.

Source

providers/provider.ts:2379


isMined()

isMined(): this is QiMinedTransactionResponse

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 QiMinedTransactionResponse

True if the transaction has been mined or false otherwise.

Source

providers/provider.ts:2472


removedEvent()

removedEvent(): OrphanFilter

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

Returns

OrphanFilter

The orphan filter.

Source

providers/provider.ts:2481


reorderedEvent()

reorderedEvent(other?): OrphanFilter

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

Parameters

ParameterTypeDescription
other?TransactionResponseThe other transaction to compare against.

Returns

OrphanFilter

The orphan filter.

Source

providers/provider.ts:2494


replaceableTransaction()

replaceableTransaction(startBlock): QiTransactionResponse

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

ParameterTypeDescription
startBlocknumberThe block number to start scanning for replacements.

Returns

QiTransactionResponse

The replaceable transaction.

Source

providers/provider.ts:2516


toJSON()

toJSON(): any

Returns a JSON-compatible representation of this transaction.

Returns

any

Source

providers/provider.ts:2328