Transaction Methods

Methods for fetching transactions, waiting for receipts, estimating gas, and debugging execution traces.

waitForTransactionReceipt

Polls until a transaction reaches the specified status. Returns the transaction receipt.

Returns: GenLayerTransaction

waitForDecision

Polls until the stored transaction state contains a materialized decision.

Returns: GenLayerTransaction

waitForFinalization

Polls until the stored transaction state is finalized.

Returns: GenLayerTransaction

getTransactionLifecycle

advanced.getTransactionLifecycle exposes stored/projected status, resolution action/source, and active decision identity. Contract networks use one fixed-block lifecycle read. Finalize is an action, not a status or separate readiness field. A Studio deployment that does not yet serve gen_getTransactionLifecycle degrades to the stored status its consumer surface does prove, rather than failing the whole read.

Returns: TransactionProtocolLifecycle

getTransaction

Fetches a transaction with a simple stored lifecycle and split round data. Use advanced.getTransactionLifecycle for protocol projection/action details.

Returns: GenLayerTransaction

getTriggeredTransactionIds

Returns transaction IDs of child transactions created from emitted messages.

Returns: TransactionHash[]

debugTraceTransaction

Fetches the full execution trace including return data, stdout, stderr, and GenVM logs.

Returns: DebugTraceResult

cancelTransaction

Cancels a pending transaction. Studio networks only.

Returns: {transaction_hash: string; status: string}

getTransactionQueuePosition

Returns the queue slot position of a transaction in the pending queue.

Returns: number

estimateTransactionGas

Estimates gas required for a transaction.

Returns: bigint