Skip to content

TransactionExecutionService.ExecuteTransaction ​

Execute transaction through sui.rpc.v2.TransactionExecutionService/ExecuteTransaction on Inodra's Sui gRPC endpoint.

Endpoint ​

NetworkHostAuthentication
Mainnetmainnet-grpc.inodra.com:443x-api-key metadata
Testnettestnet-grpc.inodra.com:443x-api-key metadata

Full method name: sui.rpc.v2.TransactionExecutionService/ExecuteTransaction. Unary: one request, one response. Get a key from the dashboard; the same key works on every protocol.

Request: ExecuteTransactionRequest ​

FieldTypeDescription
transactionTransactionThe transaction to execute.
signaturesrepeated UserSignatureSet of UserSignatures authorizing the execution of the provided transaction.
read_maskgoogle.protobuf.FieldMaskMask specifying which fields to read. If no mask is specified, defaults to effects.status,checkpoint.

Response: ExecuteTransactionResponse ​

Response message for NodeService.ExecuteTransaction.

FieldTypeDescription
transactionExecutedTransaction

ExecutedTransaction ​

FieldTypeDescription
digeststringThe digest of this Transaction.
transactionTransactionThe transaction itself.
signaturesrepeated UserSignatureList of user signatures that are used to authorize the execution of this transaction.
effectsTransactionEffectsThe TransactionEffects for this transaction.
eventsTransactionEventsThe TransactionEvents for this transaction. This field might be empty, even if it was explicitly requested, if the transaction didn't produce any events. sui.types.TransactionEffects.events_digest is populated if the transaction produced any events.
checkpointuint64The sequence number for the checkpoint that includes this transaction.
timestampgoogle.protobuf.TimestampThe Unix timestamp of the checkpoint that includes this transaction.
balance_changesrepeated BalanceChange
objectsObjectSetSet of objects either referenced as inputs or produced as outputs from this Transaction.
transaction_indexuint64Zero-based position of this transaction within the checkpoint that includes it.

grpcurl ​

bash
grpcurl -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "transaction": {
    "bcs": {
      "value": "AA=="
    }
  },
  "signatures": [
    {
      "bcs": {
        "value": "AA=="
      }
    }
  ],
  "read_mask": {
    "paths": [
      "effects.status",
      "checkpoint"
    ]
  }
}' \
  mainnet-grpc.inodra.com:443 \
  sui.rpc.v2.TransactionExecutionService/ExecuteTransaction

Server reflection is enabled, so no proto files are needed for grpcurl. Field masks are written as {"paths": [...]}.

The body is a template: replace the empty BCS bytes with your own values before the call succeeds.

TypeScript ​

typescript
import { GrpcWebFetchTransport, SuiGrpcClient } from '@mysten/sui/grpc'
import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519'
import { Transaction } from '@mysten/sui/transactions'

const transport = new GrpcWebFetchTransport({
  baseUrl: 'https://mainnet-grpc.inodra.com',
  meta: { 'x-api-key': process.env.INODRA_API_KEY! }
})
const client = new SuiGrpcClient({ network: 'mainnet', transport })

const keypair = Ed25519Keypair.fromSecretKey(process.env.SUI_SECRET_KEY!)
const tx = new Transaction()
tx.setSender(keypair.toSuiAddress())
const [coin] = tx.splitCoins(tx.gas, [1_000_000])
tx.transferObjects([coin], keypair.toSuiAddress())

const bytes = await tx.build({ client })
const { signature } = await keypair.signTransaction(bytes)
const result = await client.executeTransaction({
  transaction: bytes,
  signatures: [signature],
  include: { effects: true }
})
console.log(result)

Uses the typed SuiGrpcClient method from @mysten/sui v2 that calls this RPC. Install with npm install @mysten/sui and set INODRA_API_KEY. The gRPC gateway guide covers native gRPC transport for backends.

Credits ​

5 credits per call. See credits and billing for the full table.

JSON-RPC equivalent ​

Replaces sui_executeTransactionBlock. The JSON-RPC to gRPC migration guide has before and after code for the common calls.

The full-stack Sui data layer.