sui_executeTransactionBlock - Sui

Example code for the sui_executeTransactionBlock JSON-RPC method. Complete guide on how to use sui_executeTransactionBlock JSON-RPC in GetBlock Web3 documentation.

This method executes a signed transaction block on the SUI network and waits for the results. This is the primary method for submitting transactions, including token transfers, smart contract calls, NFT operations, and staking actions.

Parameters

Parameter	Type	Required	Description	Default/Supported Values
tx_bytes	string	Yes	BCS serialized transaction data (Base64 encoded)	Valid Base64 transaction bytes
signatures	array	Yes	Array of Base64 encoded signatures	Valid signature strings
options	object	No	Response content options	See TransactionBlockResponseOptions
request_type	string	No	Execution wait mode	"WaitForEffectsCert" or "WaitForLocalExecution"

Request Example

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "sui_executeTransactionBlock",
  "params": [
    "AAACACB...<base64_tx_bytes>",
    ["AQ7K...<base64_signature>"],
    {
      "showInput": true,
      "showEffects": true,
      "showEvents": true,
      "showObjectChanges": true,
      "showBalanceChanges": true
    },
    "WaitForLocalExecution"
  ],

    }'

Axios

Request

Rust

Response

{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "result": {
    "digest": "7dp5WtTmtGp83EXYYFMzjBJRFeSgR67AzqMETLrfgeFx",
    "effects": {
      "messageVersion": "v1",
      "status": {"status": "success"},
      "executedEpoch": "100",
      "gasUsed": {
        "computationCost": "1000000",
        "storageCost": "2000000",
        "storageRebate": "500000"
      }
    },
    "events": [],
    "objectChanges": [],
    "balanceChanges": [],
    "confirmedLocalExecution": true
  }
}

Repsonse Parameters

Parameter	Type	Description
result.digest	string	Unique transaction digest
result.transaction	object	Executed transaction data
result.effects	object	Execution results and gas usage
result.events	array	Events emitted during execution
result.objectChanges	array	Objects created, modified, or deleted
result.balanceChanges	array	Balance changes per address
result.confirmedLocalExecution	boolean	Local execution confirmation

Use Cases

1. Token Transfers: Submit signed transactions to transfer SUI or custom tokens between addresses on the network.

2. Smart Contract Execution: Execute Move function calls on deployed packages, enabling interaction with DeFi protocols and dApps.

3. NFT Operations: Mint, transfer, or burn NFTs by executing the appropriate transaction blocks.

Error handling

Error	Description	Solution
InvalidSignature	Signature verification failed	Ensure the transaction is signed correctly
InsufficientGas	Gas budget insufficient	Increase gas budget in transaction
InsufficientCoinBalance	Not enough balance	Verify sender has sufficient funds
ObjectNotFound	Referenced object missing	Check object IDs are valid

SDK Integration

Sui TypeScript SDK

example.ts

import { SuiClient } from '@mysten/sui/client';
import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
import { Transaction } from '@mysten/sui/transactions';

const client = new SuiClient({ url: 'https://go.getblock.io/<ACCESS-TOKEN>/' });
const keypair = new Ed25519Keypair();

const tx = new Transaction();
tx.transferObjects([tx.object('0x...')], tx.pure.address('0x...'));

const result = await client.signAndExecuteTransaction({
  signer: keypair,
  transaction: tx,
  options: { showEffects: true, showEvents: true },
});

console.log(result);

Sui Rust SDK