Skip to content

LedgerService.GetTransaction ​

Get transaction through sui.rpc.v2.LedgerService/GetTransaction 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.LedgerService/GetTransaction. Unary: one request, one response. Get a key from the dashboard; the same key works on every protocol.

Request: GetTransactionRequest ​

FieldTypeDescription
digeststringRequired. The digest of the requested transaction.
read_maskgoogle.protobuf.FieldMaskMask specifying which fields to read. If no mask is specified, defaults to digest.

Response: GetTransactionResponse ​

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 '{
  "digest": "Dt6oY3qKzLm1aB4S9v8cXwPn2R5J7hFgT1kEqU3yWzA",
  "read_mask": {
    "paths": [
      "digest"
    ]
  }
}' \
  mainnet-grpc.inodra.com:443 \
  sui.rpc.v2.LedgerService/GetTransaction

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 made-up digest with your own values before the call succeeds.

TypeScript ​

typescript
import { GrpcWebFetchTransport, SuiGrpcClient } from '@mysten/sui/grpc'

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 result = await client.getTransaction({
  digest: 'Dt6oY3qKzLm1aB4S9v8cXwPn2R5J7hFgT1kEqU3yWzA',
  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 ​

1 credit per call. Reads served from the archival tier cost 2x; the response metadata carries x-inodra-backend naming the tier that answered. See credits and billing for the full table.

JSON-RPC equivalent ​

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

The full-stack Sui data layer.