ContractTransactionResponse
A ContractTransactionResponse will return a ContractTransactionReceipt when waited on.
Extends
Properties
| Property | Modifier | Type | Description | Inherited from |
|---|---|---|---|---|
accessList | readonly | null | AccessList | The EIP-2930 access list for transaction types that support it, otherwise null. | QuaiTransactionResponse.accessList |
blockHash | readonly | null | string | The blockHash of the block that this transaction was included in. This is null for pending transactions. | QuaiTransactionResponse.blockHash |
blockNumber | readonly | null | number | The block number of the block that this transaction was included in. This is null for pending transactions. | QuaiTransactionResponse.blockNumber |
chainId | readonly | bigint | The chain ID. | QuaiTransactionResponse.chainId |
data | readonly | string | The data. | QuaiTransactionResponse.data |
from | readonly | string | The sender of this transaction. It is implicitly computed from the transaction pre-image hash (as the digest) and the signature using ecrecover. | QuaiTransactionResponse.from |
gasLimit | readonly | bigint | 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. | QuaiTransactionResponse.gasLimit |
gasPrice | readonly | null | bigint | The maximum fee (per unit of gas) to allow this transaction to charge the sender. | QuaiTransactionResponse.gasPrice |
hash | readonly | string | The transaction hash. | QuaiTransactionResponse.hash |
index | readonly | bigint | The index within the block that this transaction resides at. | QuaiTransactionResponse.index |
minerTip | readonly | null | bigint | The maximum priority fee (per unit of gas) to allow a validator to charge the sender. This is inclusive of the gasPrice . | QuaiTransactionResponse.minerTip |
nonce | readonly | number | 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 . | QuaiTransactionResponse.nonce |
provider | readonly | Provider | The provider this is connected to, which will influence how its methods will resolve its async inspection methods. | QuaiTransactionResponse.provider |
signature | readonly | Signature | The signature. | QuaiTransactionResponse.signature |
to | readonly | null | string | The receiver of this transaction. If null, then the transaction is an initcode transaction. This means the result of executing thedata will be deployed as a new contract on chain (assuming it does not revert) and the address may be computed using getCreateAddress. | QuaiTransactionResponse.to |
type | readonly | number | The EIP-2718 transaction envelope type. This is 0 for legacytransactions types. | QuaiTransactionResponse.type |
value | readonly | bigint | The value, in wei. Use formatEther to format this value as ether. | QuaiTransactionResponse.value |
Methods
confirmations()
Resolve to the number of confirmations this transaction has.
Returns
Promise<number>
A promise resolving to the number of confirmations.
Inherited from
QuaiTransactionResponse.confirmations
Throws
If the block is not found.
Source
getBlock()
Resolves to the Block that this transaction was included in.
This will return null if the transaction has not been included yet.
Parameters
| Parameter | Type | Description |
|---|---|---|
shard | Shard | The shard to fetch the block from. |
Returns
Promise<null | Block>
A promise resolving to the block.
Inherited from
QuaiTransactionResponse.getBlock
Source
getTransaction()
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 | QuaiTransactionResponse>
A promise resolving to the transaction, or null if not found.
Inherited from
QuaiTransactionResponse.getTransaction
Source
isMined()
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 QuaiMinedTransactionResponse
True if the transaction has been mined.
Inherited from
QuaiTransactionResponse.isMined
Throws
If the transaction was replaced, repriced, or cancelled.
Source
removedEvent()
Returns a filter which can be used to listen for orphan events that evict this transaction.
Returns
The orphan filter.
Inherited from
QuaiTransactionResponse.removedEvent
Source
reorderedEvent()
Returns a filter which can be used to listen for orphan events that re-order this event against other.
Parameters
| Parameter | Type | Description |
|---|---|---|
other? | TransactionResponse | The other transaction to compare against. |
Returns
The orphan filter.
Inherited from
QuaiTransactionResponse.reorderedEvent
Source
replaceableTransaction()
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 | Description |
|---|---|---|
startBlock | number | The block number to start scanning for replacements. |
Returns
The replaceable transaction.
Inherited from
QuaiTransactionResponse.replaceableTransaction
Source
toJSON()
Returns a JSON-compatible representation of this transaction.
Returns
any
Inherited from
QuaiTransactionResponse.toJSON
Source
wait()
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 | Description |
|---|---|---|
confirms? | number | The number of confirmations to wait for. |
Returns
Promise<null | ContractTransactionReceipt>
The transaction receipt, or null if confirms is 0.
Overrides
Source
Was this page helpful?