Skip to main content

sui_executeTransactionBlock RPC Method

Execute the transaction and wait for results if desired.

Updated on
Dec 10, 2024

sui_executeTransactionBlock RPC Method

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
1
curl --location 'https://docs-demo.sui-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
  "jsonrpc": "2.0",
5
  "id": 1,
6
  "method": "sui_executeTransactionBlock",
7
  "params": [
8
    "YOUR_TXS_BYTES",
9
    [
10
      "SIGNATURE"
11
    ],
12
    {
13
      "showInput": true,
14
      "showRawInput": true,
15
      "showEffects": true,
16
      "showEvents": true,
17
      "showObjectChanges": true,
18
      "showBalanceChanges": true,
19
      "showRawEffects": false
20
    },
21
    "WaitForLocalExecution"
22
  ]
23
}
24
'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free