Class: TransactionResponse
@fuel-ts/account.TransactionResponse
Represents a response for a transaction.
Constructors
constructor
• new TransactionResponse(tx
, provider
, abis?
): TransactionResponse
Constructor for TransactionResponse
.
Parameters
Name | Type | Description |
---|---|---|
tx | string | TransactionRequest | The transaction ID or TransactionRequest. |
provider | Provider | The provider. |
abis? | JsonAbisFromAllCalls | - |
Returns
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:149
Properties
abis
• Optional
abis: JsonAbisFromAllCalls
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:139
expectedStatus
• Private
Optional
expectedStatus: GqlTransactionStatusesNames
The expected status from the getTransactionWithReceipts response
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:141
gasUsed
• gasUsed: BN
Gas used on the transaction
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:134
gqlTransaction
• Private
Optional
gqlTransaction: Object
The graphql Transaction with receipts object.
Type declaration
Name | Type |
---|---|
id | string |
rawPayload | string |
status? | null | { block : { id : string } ; reason : string ; receipts : { amount? : null | string ; assetId? : null | string ; contractId? : null | string ; data? : null | string ; digest? : null | string ; gas? : null | string ; gasUsed? : null | string ; id? : null | string ; is? : null | string ; len? : null | string ; nonce? : null | string ; param1? : null | string ; param2? : null | string ; pc? : null | string ; ptr? : null | string ; ra? : null | string ; rb? : null | string ; rc? : null | string ; rd? : null | string ; reason? : null | string ; receiptType : GqlReceiptType ; recipient? : null | string ; result? : null | string ; sender? : null | string ; subId? : null | string ; to? : null | string ; toAddress? : null | string ; val? : null | string }[] ; time : string ; totalFee : string ; totalGas : string ; type : "FailureStatus" } | { reason : string ; type : "SqueezedOutStatus" } | { time : string ; type : "SubmittedStatus" } | { block : { id : string } ; programState? : null | { data : string ; returnType : GqlReturnType } ; receipts : { amount? : null | string ; assetId? : null | string ; contractId? : null | string ; data? : null | string ; digest? : null | string ; gas? : null | string ; gasUsed? : null | string ; id? : null | string ; is? : null | string ; len? : null | string ; nonce? : null | string ; param1? : null | string ; param2? : null | string ; pc? : null | string ; ptr? : null | string ; ra? : null | string ; rb? : null | string ; rc? : null | string ; rd? : null | string ; reason? : null | string ; receiptType : GqlReceiptType ; recipient? : null | string ; result? : null | string ; sender? : null | string ; subId? : null | string ; to? : null | string ; toAddress? : null | string ; val? : null | string }[] ; time : string ; totalFee : string ; totalGas : string ; type : "SuccessStatus" } |
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:136
id
• id: string
Transaction ID
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:130
provider
• provider: Provider
Current provider
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:132
request
• Private
Optional
request: TransactionRequest
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:137
status
• Private
Optional
status: { block
: { id
: string
} ; reason
: string
; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; transaction
: { inputs?
: null
| ({ txPointer
: string
; type
: "InputCoin"
} | { txPointer
: string
; type
: "InputContract"
} | { type
: "InputMessage"
})[] ; outputs
: ({ amount
: string
; assetId
: string
; to
: string
; type
: "ChangeOutput"
} | { amount
: string
; assetId
: string
; to
: string
; type
: "CoinOutput"
} | { contract
: string
; stateRoot
: string
; type
: "ContractCreated"
} | { balanceRoot
: string
; inputIndex
: string
; stateRoot
: string
; type
: "ContractOutput"
} | { amount
: string
; assetId
: string
; to
: string
; type
: "VariableOutput"
})[] ; receiptsRoot?
: null
| string
} ; type
: "FailureStatus"
} | { reason
: string
; type
: "SqueezedOutStatus"
} | { time
: string
; type
: "SubmittedStatus"
} | { block
: { id
: string
} ; programState?
: null
| { data
: string
; returnType
: GqlReturnType
} ; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; transaction
: { inputs?
: null
| ({ txPointer
: string
; type
: "InputCoin"
} | { txPointer
: string
; type
: "InputContract"
} | { type
: "InputMessage"
})[] ; outputs
: ({ amount
: string
; assetId
: string
; to
: string
; type
: "ChangeOutput"
} | { amount
: string
; assetId
: string
; to
: string
; type
: "CoinOutput"
} | { contract
: string
; stateRoot
: string
; type
: "ContractCreated"
} | { balanceRoot
: string
; inputIndex
: string
; stateRoot
: string
; type
: "ContractOutput"
} | { amount
: string
; assetId
: string
; to
: string
; type
: "VariableOutput"
})[] ; receiptsRoot?
: null
| string
} ; type
: "SuccessStatus"
}
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:138
Methods
applyMalleableSubscriptionFields
▸ applyMalleableSubscriptionFields<TTransactionType
>(transaction
): void
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Parameters
Name | Type |
---|---|
transaction | Transaction <TTransactionType > |
Returns
void
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:175
assembleResult
▸ assembleResult<TTransactionType
>(contractsAbiMap?
): Promise
<TransactionResult
<TTransactionType
>>
Assembles the result of a transaction by retrieving the transaction summary, decoding logs (if available), and handling transaction failure.
This method can be used to obtain the result of a transaction that has just been submitted or one that has already been processed.
Throws
If the transaction status is a failure.
Type parameters
Name | Type | Description |
---|---|---|
TTransactionType | void | The type of the transaction. |
Parameters
Name | Type | Description |
---|---|---|
contractsAbiMap? | AbiMap | The map of contract ABIs. |
Returns
Promise
<TransactionResult
<TTransactionType
>>
- The assembled transaction result.
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:367
decodeTransaction
▸ decodeTransaction<TTransactionType
>(transactionWithReceipts
): Transaction
<TTransactionType
>
Decode the raw payload of the transaction.
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Parameters
Name | Type | Description |
---|---|---|
transactionWithReceipts | Object | The transaction with receipts object. |
transactionWithReceipts.id | string | - |
transactionWithReceipts.rawPayload | string | - |
transactionWithReceipts.status? | null | { block : { id : string } ; reason : string ; receipts : { amount? : null | string ; assetId? : null | string ; contractId? : null | string ; data? : null | string ; digest? : null | string ; gas? : null | string ; gasUsed? : null | string ; id? : null | string ; is? : null | string ; len? : null | string ; nonce? : null | string ; param1? : null | string ; param2? : null | string ; pc? : null | string ; ptr? : null | string ; ra? : null | string ; rb? : null | string ; rc? : null | string ; rd? : null | string ; reason? : null | string ; receiptType : GqlReceiptType ; recipient? : null | string ; result? : null | string ; sender? : null | string ; subId? : null | string ; to? : null | string ; toAddress? : null | string ; val? : null | string }[] ; time : string ; totalFee : string ; totalGas : string ; type : "FailureStatus" } | { reason : string ; type : "SqueezedOutStatus" } | { time : string ; type : "SubmittedStatus" } | { block : { id : string } ; programState? : null | { data : string ; returnType : GqlReturnType } ; receipts : { amount? : null | string ; assetId? : null | string ; contractId? : null | string ; data? : null | string ; digest? : null | string ; gas? : null | string ; gasUsed? : null | string ; id? : null | string ; is? : null | string ; len? : null | string ; nonce? : null | string ; param1? : null | string ; param2? : null | string ; pc? : null | string ; ptr? : null | string ; ra? : null | string ; rb? : null | string ; rc? : null | string ; rd? : null | string ; reason? : null | string ; receiptType : GqlReceiptType ; recipient? : null | string ; result? : null | string ; sender? : null | string ; subId? : null | string ; to? : null | string ; toAddress? : null | string ; val? : null | string }[] ; time : string ; totalFee : string ; totalGas : string ; type : "SuccessStatus" } | - |
Returns
Transaction
<TTransactionType
>
The decoded transaction.
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:283
fetch
▸ fetch(): Promise
<{ id
: string
; rawPayload
: string
; status?
: null
| { block
: { id
: string
} ; reason
: string
; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; type
: "FailureStatus"
} | { reason
: string
; type
: "SqueezedOutStatus"
} | { time
: string
; type
: "SubmittedStatus"
} | { block
: { id
: string
} ; programState?
: null
| { data
: string
; returnType
: GqlReturnType
} ; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; type
: "SuccessStatus"
} }>
Fetch the transaction with receipts from the provider.
Returns
Promise
<{ id
: string
; rawPayload
: string
; status?
: null
| { block
: { id
: string
} ; reason
: string
; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; type
: "FailureStatus"
} | { reason
: string
; type
: "SqueezedOutStatus"
} | { time
: string
; type
: "SubmittedStatus"
} | { block
: { id
: string
} ; programState?
: null
| { data
: string
; returnType
: GqlReturnType
} ; receipts
: { amount?
: null
| string
; assetId?
: null
| string
; contractId?
: null
| string
; data?
: null
| string
; digest?
: null
| string
; gas?
: null
| string
; gasUsed?
: null
| string
; id?
: null
| string
; is?
: null
| string
; len?
: null
| string
; nonce?
: null
| string
; param1?
: null
| string
; param2?
: null
| string
; pc?
: null
| string
; ptr?
: null
| string
; ra?
: null
| string
; rb?
: null
| string
; rc?
: null
| string
; rd?
: null
| string
; reason?
: null
| string
; receiptType
: GqlReceiptType
; recipient?
: null
| string
; result?
: null
| string
; sender?
: null
| string
; subId?
: null
| string
; to?
: null
| string
; toAddress?
: null
| string
; val?
: null
| string
}[] ; time
: string
; totalFee
: string
; totalGas
: string
; type
: "SuccessStatus"
} }>
Transaction with receipts query result.
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:246
getReceipts
▸ getReceipts(): TransactionResultReceipt
[]
Returns
TransactionResultReceipt
[]
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:229
getTransaction
▸ getTransaction<TTransactionType
>(): Promise
<{ bytes
: Uint8Array
; tx
: Transaction
<TTransactionType
> }>
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Returns
Promise
<{ bytes
: Uint8Array
; tx
: Transaction
<TTransactionType
> }>
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:209
getTransactionSummary
▸ getTransactionSummary<TTransactionType
>(contractsAbiMap?
): Promise
<TransactionSummary
<TTransactionType
>>
Retrieves the TransactionSummary. If the gqlTransaction
is not set, it will fetch it from the provider
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Parameters
Name | Type | Description |
---|---|---|
contractsAbiMap? | AbiMap | The contracts ABI map. |
Returns
Promise
<TransactionSummary
<TTransactionType
>>
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:297
unsetResourceCache
▸ unsetResourceCache(): void
Returns
void
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:427
wait
▸ wait<TTransactionType
>(contractsAbiMap?
): Promise
<TransactionResult
<TTransactionType
>>
Waits for transaction to complete and returns the result.
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Parameters
Name | Type | Description |
---|---|---|
contractsAbiMap? | AbiMap | The contracts ABI map. |
Returns
Promise
<TransactionResult
<TTransactionType
>>
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:421
waitForResult
▸ waitForResult<TTransactionType
>(contractsAbiMap?
): Promise
<TransactionResult
<TTransactionType
>>
Waits for transaction to complete and returns the result.
Type parameters
Name | Type |
---|---|
TTransactionType | void |
Parameters
Name | Type |
---|---|
contractsAbiMap? | AbiMap |
Returns
Promise
<TransactionResult
<TTransactionType
>>
The completed transaction result
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:409
waitForStatusChange
▸ waitForStatusChange(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:327
create
▸ create(id
, provider
, abis?
): Promise
<TransactionResponse
>
Async constructor for TransactionResponse
. This method can be used to create an instance of TransactionResponse
and wait for the transaction to be fetched from the chain, ensuring that the gqlTransaction
property is set.
Parameters
Name | Type | Description |
---|---|---|
id | string | The transaction ID. |
provider | Provider | The provider. |
abis? | JsonAbisFromAllCalls | - |
Returns
Promise
<TransactionResponse
>
Defined in
packages/account/src/providers/transaction-response/transaction-response.ts:165