SuiSui API Endpoints

sui_executeTransactionBlock

Executes a BCS-serialized transaction on-chain and waits for the result. Supports different execution modes such as waiting for local execution or just effects.

⚠ This endpoint is only available with Blast access.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
tx_bytesstringRequired

BCS serialized transaction data bytes (without type tag), as a base64 string.

signaturestringRequired

Base64-encoded signature bytes (flag || signature || pubkey), committed to the intent message.

optionsobjectOptional
Options to control which parts of the response are returned.
request_typeenumOptional
Defines whether to wait for effects, local execution, or neither.
Allowed values:

Response

The execution response for the transaction block.
digeststring or null
Digest of the transaction.
transactionobject or null
The full transaction input data, including sender, gas, and instructions.
rawTransactionstring or null

Base64-encoded BCS transaction bytes.

effectsobject or null
The computed effects for the transaction block.
eventslist of objects or null
Any emitted events during transaction execution.
objectChangeslist of objects or null
Changes to objects triggered by the transaction.
balanceChangeslist of objects or null
Changes to balances triggered by the transaction.
errorslist of strings or null
List of any execution errors encountered.
checkpointstring or null
The checkpoint number when the transaction was finalized.
confirmedLocalExecutionboolean or null
Whether the transaction was confirmed to have executed locally.
rawEffectslist of strings or null

BCS-encoded transaction effects.

timestampMsstring or null
The timestamp of transaction execution in milliseconds.