sui_dryRunTransactionBlock

Executes a transaction in dry-run mode, which simulates transaction execution and returns expected effects, gas cost summary, object changes, and events — without actually committing to chain.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
tx_bytesstringRequired

Base64-encoded BCS TransactionKind.

Response

Simulated result of executing the transaction.

digeststringOptional

The digest of the simulated transaction.

transactionobjectOptional

Full transaction object with data and signatures.

rawTransactionstringOptional

Base64-encoded raw transaction blob.

effectsobjectOptional

The transaction effects as they would occur on-chain.

balanceChangeslist of objectsOptional

List of balance changes resulting from the simulation.

objectChangeslist of objectsOptional

List of object-level changes that would occur.

eventslist of objectsOptional

Events that would be emitted during execution.