devInspectTransactionBlock

abstract suspend fun devInspectTransactionBlock(txBytes: String, txMetaData: TransactionMetaData, options: ExecuteTransactionBlockResponseOptions): Result<DevInspectTransactionBlockQuery.Data?, SuiError>

Runs a special developer-focused inspection of a transaction block.

This is a powerful debugging tool that can reveal detailed effects, potential errors, and execution results without broadcasting the transaction or requiring a valid signature. Unlike a standard dry run, this endpoint requires specifying transaction metadata like the sender and gas information directly.

Return

A Result which is either:

  • Ok: Containing a nullable DevInspectTransactionBlockQuery.Data object with the detailed inspection results.

  • Err: Containing a SuiError object with a list of GraphQLErrors.

Parameters

txBytes

The base64-encoded, BCS-serialized transaction data.

txMetaData

A TransactionMetaData object specifying the sender address, gas object, gas price, and other details for the inspection.

options

The ExecuteTransactionBlockResponseOptions to tailor which details are returned in the response.