Skip to main content

sui_executeTransactionBlock RPC Method

Execute the transaction and wait for results if desired.

Updated on
Dec 10, 2024

Parameters

tx_bytes
string
REQUIRED

The BCS encoded TransactionKind(as opposed to TransactionData, which include gasBudget and gasPrice)

signatures
array
REQUIRED

An array of signatures (flag || signature || pubkey bytes, as base-64 encoded string). Signature is committed to the intent message of the transaction data, as base-64 encoded string

TransactionBlockResponseOptions
object

Optional settings to configure the details returned for an object

showBalanceChanges
boolean

Whether to show balance changes. Default is false

showEffects
boolean

Whether to show transaction effects. Default is false

showEvents
boolean

Whether to show transaction events. Default is false

showInput
boolean

Whether to show transaction input data. Default is false

showObjectChanges
boolean

Whether to show object changes. Default is false

showRawEffects
boolean

Whether to show raw transaction effects. Default is false

showRawInput
boolean

Whether to show BCS-encoded transaction input data. Default is false

ExecuteTransactionRequestType
string

It can be one of - 'WaitForEffectsCert' or 'WaitForLocalExecution'

Returns

result
object

The result object which contains the following fields:

digest
string

The unique identifier (hash) of the transaction

transaction
object

The transaction object which contains the following fields:

data
object

The data object which contains the following fields:

messageVersion
string

The version of the message format being used

transaction
object

The transaction object which contains the following fields:

kind
string

The type of transaction being executed

inputs
array

The array of input objects used in the transaction

type
string

The type of the input

valueType
string

The value type of the input

value
string

The actual value of the input, such as an address or object ID

transactions
array

An array of individual transaction operations included in this transaction

TransferObjects
array

The operation specifying the transfer of objects

Input
integer

The reference to an input used in the transfer

sender
string

The address of the account that initiated the transaction

gasData
object

The gasData object which contains the following fields:

payment
array

An array of payment

objectId
string

The ID of the object used for gas payment.

version
integer

The version of the gas payment object.

digest
string

The hash of the gas payment object

owner
string

The address of the account owning the gas payment object

price
string

The price of gas per unit

budget
string

The total gas budget allocated for the transaction

txSignatures
array

The array of digital signatures verifying the transaction

rawTransaction
string

The raw serialized transaction data

effects
object

The effects object which contains the following fields:

messageVersion
string

The version of the message format used for transaction effects.

status
object

The status object which contains the following fields:

status
string

The string indicating the outcome

executedEpoch
string

The epoch in which the transaction was executed

gasUsed
object

The gasUsed object which contains the following fields:

computationCost
string

The gas cost for computation

storageCost
string

The gas cost for storage usage

storageRebate
string

The rebate returned for storage usage

nonRefundableStorageFee
string

The storage fee that is not refundable

transactionDigest
string

The unique hash of the transaction's effects

mutated
array

The array of objects that were modified during the transaction

owner
object

The owner object which contains the following fields:

AddressOwner
string

The address of the owner

reference
object

The reference object which contains the following fields:

objectId
string

The ID of the object

version
integer

The updated version of the object

digest
string

The hash of the object

gasObject
object

The gasObject object which contains the following fields:

owner
object

The owner object which contains the following fields:

ObjectOwner
string

The address of the gas object owner

reference
object

The reference object which contains the following fields:

objectId
string

The ID of the gas object.

version
integer

The updated version of the gas object

digest
string

The hash of the gas object

eventsDigest
string

The hash summarizing all events emitted during the transaction

objectChanges
array

An array of objectChanges

type
string

The type of object change

sender
string

The address of the account that initiated the object transfer.

recipient
object

The recipient object which contains the following fields:

AddressOwner
string

The address of the recipient

objectType
string

The type of the object being changed

objectId
string

The ID of the object being changed

version
string

The version of the object after the change

digest
string

The hash of the object after the change

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free