菜单
Read Sui chain state over gRPC — balances, objects, transactions, coin metadata, names. Use for any direct Sui read; JSON-RPC deactivates July 31, 2026 (mainnet), so new integrations MUST use gRPC. Read-only.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Escrow USDC for agent-to-agent deliverable work (A2A jobs). Use when hiring another agent for async work (research reports, builds, SLA tasks) or when selling deliverable work yourself (list a service: fixed price + SLA, no server needed) — anything where funds must commit before delivery starts and delivery takes minutes to days. Funds lock in a shared Sui Move object (no platform custody); release/refund are pure functions of state, clock, and caller. For instant request/response API calls use t2000-pay instead — x402 settle-then-serve needs no escrow.
How to read data from the Sui network. Use when choosing or implementing a data access strategy — queries for on-chain state, indexing pipelines, historical lookups, event subscriptions, cross-chain reads, or off-chain blob storage. Covers the three live Sui APIs (gRPC, GraphQL RPC, deprecated JSON-RPC), the Archival Store, the General-Purpose Indexer, the `sui-indexer-alt` custom indexing framework, and Walrus for off-chain blobs.
Use when writing Move functions on Sui, especially public APIs. Applies to function visibility (public vs entry), parameter ordering, and return patterns. Use whenever designing function signatures or deciding whether functions should transfer objects or return them.
Use when writing Move code on Sui to ensure 2024 edition syntax is used. Applies to method calls, string literals, vector operations, option handling, loops, and struct unpacking. Use whenever writing Move code to avoid legacy function-call syntax patterns.
Use when writing unit tests for Move smart contracts on Sui. Applies to test function naming, assertions, test attributes, context usage, and cleanup patterns. Use whenever user asks to write tests, add tests, or test a Move module.
Use when writing or reviewing Move smart contracts on Sui. Applies to naming structs, error constants, regular constants, events, getter functions, capability types, hot potato types, and dynamic field keys. Use whenever creating new types, functions, or constants in Move code.
| name | sui-grpc |
| description | Read Sui chain state over gRPC — balances, objects, transactions, coin metadata, names. Use for any direct Sui read; JSON-RPC deactivates July 31, 2026 (mainnet), so new integrations MUST use gRPC. Read-only. |
| license | MIT |
| metadata | {"author":"t2000","version":"1.0","requires":"Node 18+ with @mysten/sui@^2"} |
The canonical way to read Sui in 2026. One client covers balances, objects, transactions, metadata, and name service.
JSON-RPC is being retired (mainnet: July 31, 2026).
SuiClient/suix_*/sui_*HTTP methods stop working on public fullnodes. Everything below is the replacement surface, verified against mainnet.
import { SuiGrpcClient } from '@mysten/sui/grpc';
const client = new SuiGrpcClient({
baseUrl: 'https://fullnode.mainnet.sui.io',
network: 'mainnet',
});
// One coin balance (owner + coinType)
const { balance } = await client.core.getBalance({
owner: '0x…',
coinType: '0x2::sui::SUI',
});
// balance.balance = total, split into coinBalance + addressBalance (SIP-58)
// Every balance an address holds
const { balances } = await client.core.listBalances({ owner: '0x…' });
// Coin metadata (decimals, symbol) — never hardcode decimals
const { coinMetadata } = await client.core.getCoinMetadata({
coinType: '0xdba3…::usdc::USDC',
});
// Objects an address owns
const { objects, hasNextPage, cursor } = await client.core.listOwnedObjects({
owner: '0x…',
limit: 50,
});
// each: { objectId, version, digest, type, owner, content }
// One object / one transaction
const obj = await client.core.getObject({ objectId: '0x…' });
const tx = await client.core.getTransaction({ digest: '…' });
// SuiNS
const { record } = await client.nameService.lookupName({ name: 'agent-id.sui' });
coinMetadata.decimals for display; never parseFloat raw chain values into math you'll transact on.coinBalance (coin objects) + addressBalance (address-balance accumulator) sum to balance — report the total unless debugging transfers.listOwnedObjects / listCoins return cursor + hasNextPage; loop until done for full inventories.t2 send · swap · pay) or @t2000/sdk, which run on this same gRPC surface.Large objects/transactions support read masks to fetch only what you need:
const tx = await client.ledgerService.getTransaction({
digest: '…',
readMask: { paths: ['effects', 'events'] },
});
JSON.stringify throws on them; convert with a replacer: (k, v) => typeof v === 'bigint' ? v.toString() : v.getBalance takes owner, not address — a wrong key name errors as missing owner.