[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-accessing-data":3,"mdc--xf164y-key":33,"related-repo-sui-accessing-data":1298,"related-org-sui-accessing-data":1399},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":28,"sourceUrl":31,"mdContent":32},"accessing-data","read data from the Sui network","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 two live Sui APIs (gRPC and GraphQL RPC), the Archival Store, the General-Purpose Indexer, the `sui-indexer-alt` custom indexing framework, and Walrus for off-chain blobs.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"sui","Sui (Mysten Labs)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fsui.png","MystenLabs",[13,16,19],{"name":14,"slug":8,"type":15},"Sui","tag",{"name":17,"slug":18,"type":15},"Data Analysis","data-analysis",{"name":20,"slug":21,"type":15},"Web3","web3",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-08-01T05:44:32.775598",null,2,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":30},[],"Sui development skills maintained by Mysten Labs","https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills\u002Ftree\u002FHEAD\u002Faccessing-data","---\nname: accessing-data\ndescription: >\n  How to read data from the Sui network. Use when choosing or implementing\n  a data access strategy — queries for on-chain state, indexing pipelines,\n  historical lookups, event subscriptions, cross-chain reads, or off-chain\n  blob storage. Covers the two live Sui APIs (gRPC and GraphQL RPC),\n  the Archival Store, the General-Purpose Indexer,\n  the `sui-indexer-alt` custom indexing framework, and Walrus for off-chain\n  blobs.\n---\n\n# Accessing Data on Sui\n\n> **MCP tool:** When available in your environment, also query the Sui documentation MCP server (`https:\u002F\u002Fsui.mcp.kapa.ai`) for up-to-date answers. Use it for verification and for details not covered by these reference files.\n\n\"How do I read data from Sui?\" is the most frequently mis-answered question in agent-written Sui code. The defaults have changed. This skill fixes it.\n\n**Key fact: JSON-RPC is deprecated.** Sui Foundation mainnet full nodes will disable JSON-RPC the week of July 27, 2026, with full code decommission by mid-October 2026. New code must use gRPC or GraphQL RPC. `SuiJsonRpcClient` still exists as a deprecated migration surface but should not be used for new projects.\n\nThe four canonical data surfaces are:\n\n1. **gRPC** (generally available) — low-latency, real-time, code-gen-friendly. Served by full nodes. Supports streaming\u002Fsubscriptions. The default for transaction submission, live reads, and ingestion pipelines.\n2. **GraphQL RPC** (generally available) — flexible relational queries over the General-Purpose Indexer's Postgres + full node + Archival Store. Supports reads, transaction submission, and dry-run. Best for frontends, dashboards, wallets, and any client that benefits from composable queries.\n3. **Archival Store** (generally available) — long-term historical storage of transactions, checkpoints, and object states beyond full-node pruning. GraphQL RPC can route supported historical lookups to the Archival Store transparently when the operator has configured archival backing. For gRPC, clients must query an Archival Service endpoint directly for historical data beyond full-node retention. Archival routing is operator-configured: if the operator hasn't set up archival backing, retention is limited to what the primary store holds.\n4. **Custom indexer (`sui-indexer-alt`)** — build your own data pipeline keyed on exactly the on-chain data your app needs. Writes to any storage layer (Postgres by default, but any backend works). Ingests checkpoints from GCS (backfill) + full node gRPC (steady state).\n\nOff-chain blob data (images, audio, models, large JSON) belongs on **Walrus**, not on-chain. Sui stores blob metadata; the blobs themselves sit on Walrus storage nodes.\n\nAll patterns in this skill are derived from:\n- https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Fdata-serving (overview & deprecation notice)\n- https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Fgraphql-rpc (GraphQL)\n- https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Farchival-store (archival)\n- https:\u002F\u002Fdocs.sui.io\u002Fguides\u002Foperator\u002Findexer-stack-setup (general-purpose indexer)\n- https:\u002F\u002Fdocs.wal.app (Walrus)\n\nIf unsure about an API, fetch from the relevant page before answering. Do not guess from Ethereum\u002FSolana analogs — Sui's data surfaces are distinct.\n\n---\n\n## Reference files\n\n### grpc — gRPC API\n**Path:** `grpc.md`\n**Load when:** writing backend services, indexers, exchanges, market makers, real-time clients, or any high-throughput read path. Also when subscribing to effects streams or doing dry runs \u002F transaction simulation.\n**Covers:** service surface (`ledger_service`, `transaction_execution_service`, `move_package_service`, `name_service`, `subscription_service`), endpoint URLs per network, the TypeScript (`SuiGrpcClient`) and Rust (`sui-rpc` crate) clients, streaming vs request-response, code-gen for arbitrary languages.\n\n### graphql — GraphQL RPC\n**Path:** `graphql.md`\n**Load when:** the app needs flexible, composable queries — e.g., a frontend that joins object data with owner metadata and event history in a single request, transaction submission or dry-run via GraphQL, or historical queries with filters.\n**Covers:** GraphQL endpoint URLs, relationship to the General-Purpose Indexer + Archival Store, `SuiGraphQLClient` usage, typical query shapes, pagination patterns, rate limits, transaction execution and simulation via GraphQL, execution-attached read-after-write consistency.\n\n### indexers — Custom indexing (`sui-indexer-alt`)\n**Path:** `indexers.md`\n**Load when:** a user asks \"how do I track X event across history?\", \"how do I build an explorer \u002F leaderboard \u002F analytics pipeline?\", or when a GraphQL or gRPC query is too slow \u002F not filterable the way they need.\n**Covers:** the checkpoint-streaming pipeline model, backfill (GCS buckets like `gs:\u002F\u002Fmysten-mainnet-checkpoints-use4`) vs steady-state (full node gRPC), writing a pipeline config (`events.toml`, `obj_versions.toml` patterns), concurrency tuning, and when to run the General-Purpose Indexer vs a custom one.\n\n### archival — Archival Store\n**Path:** `archival.md`\n**Load when:** the data you need has been pruned from full nodes — old transactions, old object versions, old checkpoints. GraphQL RPC can route supported historical lookups to archival transparently when operator-configured; for gRPC, clients need a separate Archival Service endpoint.\n**Covers:** what the Archival Store retains, why pruning exists, how GraphQL RPC routes to archival transparently (operator-configured) and how gRPC clients need a separate Archival Service endpoint, use cases (compliance, dispute resolution, long-range analytics).\n\n### walrus — Off-chain blob storage\n**Path:** `walrus.md`\n**Load when:** the user wants to store a file (image, audio, model, document, large JSON, video) \"on Sui\" or is trying to put megabytes of data into a Move object. Route them to Walrus.\n**Covers:** why you don't put blobs on-chain (250 KB per-object cap, storage-fund economics), the Walrus model (erasure-coded blobs stored off-chain with on-chain availability certificates), blob lifecycle, and the `@mysten\u002Fwalrus` client extension.\n\n### use-cases — Use case → method mapping\n**Path:** `use-cases.md`\n**Load when:** the user describes what they want to *do* and you need to pick the right surface. This is the first file to load for an unfamiliar data access request.\n**Covers:** table of common use cases (balance lookup, owned-object list, event subscription, historical point-in-time read, analytics dashboard, cross-table joins, blob storage) mapped to the right API with rationale.\n\n## Routing guide\n\n| Task | Load |\n|------|------|\n| \"How do I read X from Sui?\" (first-pass question) | use-cases |\n| Writing a backend\u002Findexer read path | grpc + indexers |\n| Writing a frontend data query | graphql (+ frontend-apps skill for hook patterns) |\n| Building a custom analytics \u002F explorer pipeline | indexers |\n| Looking up data older than full-node retention | archival + graphql |\n| Storing \u002F retrieving a large file | walrus |\n| Migrating from JSON-RPC | use-cases + grpc + graphql |\n| Designing a new app from scratch | use-cases (then grpc or graphql based on client type) |\n| Full code review of a data-heavy app | **all reference files** |\n\n## Skill Content\n\n### Key concepts\n\n- **JSON-RPC is deprecated.** Sui Foundation mainnet full nodes will disable it the week of **July 27, 2026**; full code decommission by **mid-October 2026**. New code must use gRPC or GraphQL RPC. `SuiJsonRpcClient` still exists in the SDK as a deprecated migration stopgap.\n- **gRPC is the performance default (GA).** Typed protobuf, streaming, low latency, polyglot client code gen (TS, Rust, Go, Python, etc.). Served directly by full nodes. Best for backends, indexers, and apps built in typed systems languages.\n- **GraphQL RPC is the flexibility default (GA).** Reads from the General-Purpose Indexer's Postgres + full node + Archival Store. Also supports transaction submission and dry-run. One request can span multiple entity types. Best for frontends, tools, and apps built in dynamic languages.\n- **Archival routing is operator-configured.** GraphQL RPC can route supported historical point lookups to the Archival Store transparently when the operator has configured archival backing. gRPC does not implicitly fall back to archival — gRPC clients must query an Archival Service endpoint directly for historical data beyond full-node retention. If archival is not configured, retention is limited to what the primary store holds.\n- **Custom indexers exist because no hosted API fits every query shape.** If you need filtered sorts over millions of rows with app-specific indexes, run your own `sui-indexer-alt` pipeline. Custom indexers can write to any storage layer by implementing the framework's `Store` and `Connection` traits — Postgres is the default, not a requirement.\n- **On-chain storage is not general-purpose blob storage.** Max Move object size is 250 KB. Storage is paid once (storage fund redistributes returns to validators). Big files go to Walrus.\n- **The storage fund does not \"hold your data.\"** It's an economic mechanism: a fraction of each write fee goes in; validators earn yield that pays for ongoing storage. It affects pricing, not where you store.\n\n### Rules\n\n1. **No JSON-RPC for new code.** JSON-RPC is deprecated; Sui Foundation mainnet full nodes will disable it the week of July 27, 2026. If a tutorial says `new SuiClient({ url: getFullnodeUrl(...) })`, replace with `new SuiGrpcClient({ network, baseUrl })`. If existing code uses `SuiJsonRpcClient`, migrate it to `SuiGrpcClient` or `SuiGraphQLClient`. Offer `SuiJsonRpcClient` only as a short-term migration stopgap — it still exists in the SDK but is deprecated.\n2. **State GA status when recommending APIs.** gRPC, GraphQL RPC, and the Archival Store are all **generally available**. When recommending any of these — especially when answering archival or history questions — explicitly state they are generally available. Do not call them beta or experimental.\n3. **Choose your initial API based on what you're building.** Front-ends, tools, and apps in dynamic languages → start with **GraphQL RPC** (superset of gRPC functionality, composable queries, transparent archival routing when operator-configured). Backends, indexers, and apps in typed systems languages → start with **gRPC** (performance, streaming, code-gen). Only switch if you hit a limitation. **Current temporary caveats** (will be resolved in the coming months): only gRPC supports subscriptions; only GraphQL supports filtered pagination over historical transactions and events.\n4. **Archival routing differs by API.** GraphQL RPC routes supported historical point lookups to the Archival Store transparently when the operator has configured archival backing. gRPC does not implicitly fall back to archival — gRPC clients must query an Archival Service endpoint directly for historical data beyond full-node retention. If archival is not configured, retention is limited to what the primary store holds.\n5. **Build a custom indexer only when hosted APIs don't fit.** Operating an indexer is ongoing work — Postgres, checkpoint ingestion, failure handling. Evaluate GraphQL RPC first.\n6. **Put large files on Walrus.** Never advise embedding images\u002Faudio\u002Fvideo in Move objects or in transaction inputs. If the user is trying to, route them to the `walrus` reference file.\n7. **Map use case → method correctly.** See `use-cases.md`:\n   - Live balance \u002F owned-object \u002F coin list → **gRPC `client.core.*`**.\n   - Flexible multi-entity query for a frontend → **GraphQL RPC**.\n   - Historical transaction > N days old → **GraphQL RPC** (routes through archival transparently when operator-configured) or **gRPC via a separate Archival Service endpoint**.\n   - Custom leaderboard \u002F analytics across all events → **custom indexer**.\n   - Transaction subscription \u002F real-time effects feed → **gRPC streaming**.\n   - Large files → **Walrus**.\n8. **Read-after-write consistency varies by API.** For **GraphQL RPC**, queries nested under `executeTransaction` or `simulateTransaction` are evaluated in a special scope just after the executed\u002Fsimulated transaction, without waiting for indexing. This provides consistent read-after-write for fields that don't require indexed history (e.g., effects, gas, object changes). Prefer selecting these fields in the same GraphQL request rather than making a separate indexed follow-up query. For **gRPC**, call `client.waitForTransaction({ digest })` before the follow-up read. In both cases, cross-node reads after a write are not guaranteed immediately visible.\n9. **Cite docs when unsure.** All sources listed above.\n\n### Common mistakes\n\n- **Using `client.getObject` \u002F `client.getOwnedObjects` \u002F `client.getCoins`** — these are v1 method names from the deprecated JSON-RPC surface. v2 is `client.core.getObject` \u002F `client.core.listOwnedObjects` \u002F `client.core.listCoins` on any of the v2 clients.\n- **Recommending \"the Sui API\" without specifying which.** \"The Sui API\" conflates different interfaces with different use cases. Always name gRPC or GraphQL.\n- **Telling users to \"use the indexer\"** for a simple query that gRPC covers in one method. Only reach for a custom indexer when you've outgrown the hosted APIs.\n- **Storing images or large JSON \"on Sui.\"** Sui's 250 KB object size limit and pricing model make this wrong. Use Walrus.\n- **Assuming gRPC and GraphQL return the same shape.** gRPC is protobuf; GraphQL is typed GraphQL. Response shapes differ; field names differ; pagination differs.\n- **Polling for events.** Use gRPC streaming \u002F subscriptions instead. Polling is high-cost and high-latency.\n- **Reading from an RPC node and writing to a different one expecting read-after-write consistency.** Fullnodes are eventually consistent across the network. For GraphQL, prefer selecting fields in the same `executeTransaction` mutation (execution-attached scope gives consistent results without indexing). For gRPC, read from the same node you wrote to, or `waitForTransaction` before cross-node reads.\n- **Conflating \"storage fund\" with \"storage service.\"** The storage fund is a tokenomics mechanism. It is not an API you call.\n- **Assuming gRPC transparently routes to archival.** Only GraphQL RPC transparently routes supported historical lookups to the Archival Store (when operator-configured). For gRPC, clients must query an Archival Service endpoint directly for historical data beyond full-node retention.\n- **Assuming archival routing is automatic.** It's operator-configured. If the operator hasn't set up archival backing, retention is limited to what the primary store holds (e.g., the Postgres database's retention policy for GraphQL).\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,72,77,95,100,153,165,170,231,236,240,247,254,337,343,377,389,438,444,470,476,510,516,550,556,704,710,716,833,839,1131,1137],{"type":39,"tag":40,"props":41,"children":43},"element","h1",{"id":42},"accessing-data-on-sui",[44],{"type":45,"value":46},"text","Accessing Data on Sui",{"type":39,"tag":48,"props":49,"children":50},"blockquote",{},[51],{"type":39,"tag":52,"props":53,"children":54},"p",{},[55,61,63,70],{"type":39,"tag":56,"props":57,"children":58},"strong",{},[59],{"type":45,"value":60},"MCP tool:",{"type":45,"value":62}," When available in your environment, also query the Sui documentation MCP server (",{"type":39,"tag":64,"props":65,"children":67},"code",{"className":66},[],[68],{"type":45,"value":69},"https:\u002F\u002Fsui.mcp.kapa.ai",{"type":45,"value":71},") for up-to-date answers. Use it for verification and for details not covered by these reference files.",{"type":39,"tag":52,"props":73,"children":74},{},[75],{"type":45,"value":76},"\"How do I read data from Sui?\" is the most frequently mis-answered question in agent-written Sui code. The defaults have changed. This skill fixes it.",{"type":39,"tag":52,"props":78,"children":79},{},[80,85,87,93],{"type":39,"tag":56,"props":81,"children":82},{},[83],{"type":45,"value":84},"Key fact: JSON-RPC is deprecated.",{"type":45,"value":86}," Sui Foundation mainnet full nodes will disable JSON-RPC the week of July 27, 2026, with full code decommission by mid-October 2026. New code must use gRPC or GraphQL RPC. ",{"type":39,"tag":64,"props":88,"children":90},{"className":89},[],[91],{"type":45,"value":92},"SuiJsonRpcClient",{"type":45,"value":94}," still exists as a deprecated migration surface but should not be used for new projects.",{"type":39,"tag":52,"props":96,"children":97},{},[98],{"type":45,"value":99},"The four canonical data surfaces are:",{"type":39,"tag":101,"props":102,"children":103},"ol",{},[104,115,125,135],{"type":39,"tag":105,"props":106,"children":107},"li",{},[108,113],{"type":39,"tag":56,"props":109,"children":110},{},[111],{"type":45,"value":112},"gRPC",{"type":45,"value":114}," (generally available) — low-latency, real-time, code-gen-friendly. Served by full nodes. Supports streaming\u002Fsubscriptions. The default for transaction submission, live reads, and ingestion pipelines.",{"type":39,"tag":105,"props":116,"children":117},{},[118,123],{"type":39,"tag":56,"props":119,"children":120},{},[121],{"type":45,"value":122},"GraphQL RPC",{"type":45,"value":124}," (generally available) — flexible relational queries over the General-Purpose Indexer's Postgres + full node + Archival Store. Supports reads, transaction submission, and dry-run. Best for frontends, dashboards, wallets, and any client that benefits from composable queries.",{"type":39,"tag":105,"props":126,"children":127},{},[128,133],{"type":39,"tag":56,"props":129,"children":130},{},[131],{"type":45,"value":132},"Archival Store",{"type":45,"value":134}," (generally available) — long-term historical storage of transactions, checkpoints, and object states beyond full-node pruning. GraphQL RPC can route supported historical lookups to the Archival Store transparently when the operator has configured archival backing. For gRPC, clients must query an Archival Service endpoint directly for historical data beyond full-node retention. Archival routing is operator-configured: if the operator hasn't set up archival backing, retention is limited to what the primary store holds.",{"type":39,"tag":105,"props":136,"children":137},{},[138,151],{"type":39,"tag":56,"props":139,"children":140},{},[141,143,149],{"type":45,"value":142},"Custom indexer (",{"type":39,"tag":64,"props":144,"children":146},{"className":145},[],[147],{"type":45,"value":148},"sui-indexer-alt",{"type":45,"value":150},")",{"type":45,"value":152}," — build your own data pipeline keyed on exactly the on-chain data your app needs. Writes to any storage layer (Postgres by default, but any backend works). Ingests checkpoints from GCS (backfill) + full node gRPC (steady state).",{"type":39,"tag":52,"props":154,"children":155},{},[156,158,163],{"type":45,"value":157},"Off-chain blob data (images, audio, models, large JSON) belongs on ",{"type":39,"tag":56,"props":159,"children":160},{},[161],{"type":45,"value":162},"Walrus",{"type":45,"value":164},", not on-chain. Sui stores blob metadata; the blobs themselves sit on Walrus storage nodes.",{"type":39,"tag":52,"props":166,"children":167},{},[168],{"type":45,"value":169},"All patterns in this skill are derived from:",{"type":39,"tag":171,"props":172,"children":173},"ul",{},[174,187,198,209,220],{"type":39,"tag":105,"props":175,"children":176},{},[177,185],{"type":39,"tag":178,"props":179,"children":183},"a",{"href":180,"rel":181},"https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Fdata-serving",[182],"nofollow",[184],{"type":45,"value":180},{"type":45,"value":186}," (overview & deprecation notice)",{"type":39,"tag":105,"props":188,"children":189},{},[190,196],{"type":39,"tag":178,"props":191,"children":194},{"href":192,"rel":193},"https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Fgraphql-rpc",[182],[195],{"type":45,"value":192},{"type":45,"value":197}," (GraphQL)",{"type":39,"tag":105,"props":199,"children":200},{},[201,207],{"type":39,"tag":178,"props":202,"children":205},{"href":203,"rel":204},"https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Fdata-access\u002Farchival-store",[182],[206],{"type":45,"value":203},{"type":45,"value":208}," (archival)",{"type":39,"tag":105,"props":210,"children":211},{},[212,218],{"type":39,"tag":178,"props":213,"children":216},{"href":214,"rel":215},"https:\u002F\u002Fdocs.sui.io\u002Fguides\u002Foperator\u002Findexer-stack-setup",[182],[217],{"type":45,"value":214},{"type":45,"value":219}," (general-purpose indexer)",{"type":39,"tag":105,"props":221,"children":222},{},[223,229],{"type":39,"tag":178,"props":224,"children":227},{"href":225,"rel":226},"https:\u002F\u002Fdocs.wal.app",[182],[228],{"type":45,"value":225},{"type":45,"value":230}," (Walrus)",{"type":39,"tag":52,"props":232,"children":233},{},[234],{"type":45,"value":235},"If unsure about an API, fetch from the relevant page before answering. Do not guess from Ethereum\u002FSolana analogs — Sui's data surfaces are distinct.",{"type":39,"tag":237,"props":238,"children":239},"hr",{},[],{"type":39,"tag":241,"props":242,"children":244},"h2",{"id":243},"reference-files",[245],{"type":45,"value":246},"Reference files",{"type":39,"tag":248,"props":249,"children":251},"h3",{"id":250},"grpc-grpc-api",[252],{"type":45,"value":253},"grpc — gRPC API",{"type":39,"tag":52,"props":255,"children":256},{},[257,262,264,270,275,277,282,284,290,292,298,299,305,306,312,313,319,321,327,329,335],{"type":39,"tag":56,"props":258,"children":259},{},[260],{"type":45,"value":261},"Path:",{"type":45,"value":263}," ",{"type":39,"tag":64,"props":265,"children":267},{"className":266},[],[268],{"type":45,"value":269},"grpc.md",{"type":39,"tag":56,"props":271,"children":272},{},[273],{"type":45,"value":274},"Load when:",{"type":45,"value":276}," writing backend services, indexers, exchanges, market makers, real-time clients, or any high-throughput read path. Also when subscribing to effects streams or doing dry runs \u002F transaction simulation.\n",{"type":39,"tag":56,"props":278,"children":279},{},[280],{"type":45,"value":281},"Covers:",{"type":45,"value":283}," service surface (",{"type":39,"tag":64,"props":285,"children":287},{"className":286},[],[288],{"type":45,"value":289},"ledger_service",{"type":45,"value":291},", ",{"type":39,"tag":64,"props":293,"children":295},{"className":294},[],[296],{"type":45,"value":297},"transaction_execution_service",{"type":45,"value":291},{"type":39,"tag":64,"props":300,"children":302},{"className":301},[],[303],{"type":45,"value":304},"move_package_service",{"type":45,"value":291},{"type":39,"tag":64,"props":307,"children":309},{"className":308},[],[310],{"type":45,"value":311},"name_service",{"type":45,"value":291},{"type":39,"tag":64,"props":314,"children":316},{"className":315},[],[317],{"type":45,"value":318},"subscription_service",{"type":45,"value":320},"), endpoint URLs per network, the TypeScript (",{"type":39,"tag":64,"props":322,"children":324},{"className":323},[],[325],{"type":45,"value":326},"SuiGrpcClient",{"type":45,"value":328},") and Rust (",{"type":39,"tag":64,"props":330,"children":332},{"className":331},[],[333],{"type":45,"value":334},"sui-rpc",{"type":45,"value":336}," crate) clients, streaming vs request-response, code-gen for arbitrary languages.",{"type":39,"tag":248,"props":338,"children":340},{"id":339},"graphql-graphql-rpc",[341],{"type":45,"value":342},"graphql — GraphQL RPC",{"type":39,"tag":52,"props":344,"children":345},{},[346,350,351,357,361,363,367,369,375],{"type":39,"tag":56,"props":347,"children":348},{},[349],{"type":45,"value":261},{"type":45,"value":263},{"type":39,"tag":64,"props":352,"children":354},{"className":353},[],[355],{"type":45,"value":356},"graphql.md",{"type":39,"tag":56,"props":358,"children":359},{},[360],{"type":45,"value":274},{"type":45,"value":362}," the app needs flexible, composable queries — e.g., a frontend that joins object data with owner metadata and event history in a single request, transaction submission or dry-run via GraphQL, or historical queries with filters.\n",{"type":39,"tag":56,"props":364,"children":365},{},[366],{"type":45,"value":281},{"type":45,"value":368}," GraphQL endpoint URLs, relationship to the General-Purpose Indexer + Archival Store, ",{"type":39,"tag":64,"props":370,"children":372},{"className":371},[],[373],{"type":45,"value":374},"SuiGraphQLClient",{"type":45,"value":376}," usage, typical query shapes, pagination patterns, rate limits, transaction execution and simulation via GraphQL, execution-attached read-after-write consistency.",{"type":39,"tag":248,"props":378,"children":380},{"id":379},"indexers-custom-indexing-sui-indexer-alt",[381,383,388],{"type":45,"value":382},"indexers — Custom indexing (",{"type":39,"tag":64,"props":384,"children":386},{"className":385},[],[387],{"type":45,"value":148},{"type":45,"value":150},{"type":39,"tag":52,"props":390,"children":391},{},[392,396,397,403,407,409,413,415,421,423,429,430,436],{"type":39,"tag":56,"props":393,"children":394},{},[395],{"type":45,"value":261},{"type":45,"value":263},{"type":39,"tag":64,"props":398,"children":400},{"className":399},[],[401],{"type":45,"value":402},"indexers.md",{"type":39,"tag":56,"props":404,"children":405},{},[406],{"type":45,"value":274},{"type":45,"value":408}," a user asks \"how do I track X event across history?\", \"how do I build an explorer \u002F leaderboard \u002F analytics pipeline?\", or when a GraphQL or gRPC query is too slow \u002F not filterable the way they need.\n",{"type":39,"tag":56,"props":410,"children":411},{},[412],{"type":45,"value":281},{"type":45,"value":414}," the checkpoint-streaming pipeline model, backfill (GCS buckets like ",{"type":39,"tag":64,"props":416,"children":418},{"className":417},[],[419],{"type":45,"value":420},"gs:\u002F\u002Fmysten-mainnet-checkpoints-use4",{"type":45,"value":422},") vs steady-state (full node gRPC), writing a pipeline config (",{"type":39,"tag":64,"props":424,"children":426},{"className":425},[],[427],{"type":45,"value":428},"events.toml",{"type":45,"value":291},{"type":39,"tag":64,"props":431,"children":433},{"className":432},[],[434],{"type":45,"value":435},"obj_versions.toml",{"type":45,"value":437}," patterns), concurrency tuning, and when to run the General-Purpose Indexer vs a custom one.",{"type":39,"tag":248,"props":439,"children":441},{"id":440},"archival-archival-store",[442],{"type":45,"value":443},"archival — Archival Store",{"type":39,"tag":52,"props":445,"children":446},{},[447,451,452,458,462,464,468],{"type":39,"tag":56,"props":448,"children":449},{},[450],{"type":45,"value":261},{"type":45,"value":263},{"type":39,"tag":64,"props":453,"children":455},{"className":454},[],[456],{"type":45,"value":457},"archival.md",{"type":39,"tag":56,"props":459,"children":460},{},[461],{"type":45,"value":274},{"type":45,"value":463}," the data you need has been pruned from full nodes — old transactions, old object versions, old checkpoints. GraphQL RPC can route supported historical lookups to archival transparently when operator-configured; for gRPC, clients need a separate Archival Service endpoint.\n",{"type":39,"tag":56,"props":465,"children":466},{},[467],{"type":45,"value":281},{"type":45,"value":469}," what the Archival Store retains, why pruning exists, how GraphQL RPC routes to archival transparently (operator-configured) and how gRPC clients need a separate Archival Service endpoint, use cases (compliance, dispute resolution, long-range analytics).",{"type":39,"tag":248,"props":471,"children":473},{"id":472},"walrus-off-chain-blob-storage",[474],{"type":45,"value":475},"walrus — Off-chain blob storage",{"type":39,"tag":52,"props":477,"children":478},{},[479,483,484,490,494,496,500,502,508],{"type":39,"tag":56,"props":480,"children":481},{},[482],{"type":45,"value":261},{"type":45,"value":263},{"type":39,"tag":64,"props":485,"children":487},{"className":486},[],[488],{"type":45,"value":489},"walrus.md",{"type":39,"tag":56,"props":491,"children":492},{},[493],{"type":45,"value":274},{"type":45,"value":495}," the user wants to store a file (image, audio, model, document, large JSON, video) \"on Sui\" or is trying to put megabytes of data into a Move object. Route them to Walrus.\n",{"type":39,"tag":56,"props":497,"children":498},{},[499],{"type":45,"value":281},{"type":45,"value":501}," why you don't put blobs on-chain (250 KB per-object cap, storage-fund economics), the Walrus model (erasure-coded blobs stored off-chain with on-chain availability certificates), blob lifecycle, and the ",{"type":39,"tag":64,"props":503,"children":505},{"className":504},[],[506],{"type":45,"value":507},"@mysten\u002Fwalrus",{"type":45,"value":509}," client extension.",{"type":39,"tag":248,"props":511,"children":513},{"id":512},"use-cases-use-case-method-mapping",[514],{"type":45,"value":515},"use-cases — Use case → method mapping",{"type":39,"tag":52,"props":517,"children":518},{},[519,523,524,530,534,536,542,544,548],{"type":39,"tag":56,"props":520,"children":521},{},[522],{"type":45,"value":261},{"type":45,"value":263},{"type":39,"tag":64,"props":525,"children":527},{"className":526},[],[528],{"type":45,"value":529},"use-cases.md",{"type":39,"tag":56,"props":531,"children":532},{},[533],{"type":45,"value":274},{"type":45,"value":535}," the user describes what they want to ",{"type":39,"tag":537,"props":538,"children":539},"em",{},[540],{"type":45,"value":541},"do",{"type":45,"value":543}," and you need to pick the right surface. This is the first file to load for an unfamiliar data access request.\n",{"type":39,"tag":56,"props":545,"children":546},{},[547],{"type":45,"value":281},{"type":45,"value":549}," table of common use cases (balance lookup, owned-object list, event subscription, historical point-in-time read, analytics dashboard, cross-table joins, blob storage) mapped to the right API with rationale.",{"type":39,"tag":241,"props":551,"children":553},{"id":552},"routing-guide",[554],{"type":45,"value":555},"Routing guide",{"type":39,"tag":557,"props":558,"children":559},"table",{},[560,579],{"type":39,"tag":561,"props":562,"children":563},"thead",{},[564],{"type":39,"tag":565,"props":566,"children":567},"tr",{},[568,574],{"type":39,"tag":569,"props":570,"children":571},"th",{},[572],{"type":45,"value":573},"Task",{"type":39,"tag":569,"props":575,"children":576},{},[577],{"type":45,"value":578},"Load",{"type":39,"tag":580,"props":581,"children":582},"tbody",{},[583,597,610,623,636,649,662,675,688],{"type":39,"tag":565,"props":584,"children":585},{},[586,592],{"type":39,"tag":587,"props":588,"children":589},"td",{},[590],{"type":45,"value":591},"\"How do I read X from Sui?\" (first-pass question)",{"type":39,"tag":587,"props":593,"children":594},{},[595],{"type":45,"value":596},"use-cases",{"type":39,"tag":565,"props":598,"children":599},{},[600,605],{"type":39,"tag":587,"props":601,"children":602},{},[603],{"type":45,"value":604},"Writing a backend\u002Findexer read path",{"type":39,"tag":587,"props":606,"children":607},{},[608],{"type":45,"value":609},"grpc + indexers",{"type":39,"tag":565,"props":611,"children":612},{},[613,618],{"type":39,"tag":587,"props":614,"children":615},{},[616],{"type":45,"value":617},"Writing a frontend data query",{"type":39,"tag":587,"props":619,"children":620},{},[621],{"type":45,"value":622},"graphql (+ frontend-apps skill for hook patterns)",{"type":39,"tag":565,"props":624,"children":625},{},[626,631],{"type":39,"tag":587,"props":627,"children":628},{},[629],{"type":45,"value":630},"Building a custom analytics \u002F explorer pipeline",{"type":39,"tag":587,"props":632,"children":633},{},[634],{"type":45,"value":635},"indexers",{"type":39,"tag":565,"props":637,"children":638},{},[639,644],{"type":39,"tag":587,"props":640,"children":641},{},[642],{"type":45,"value":643},"Looking up data older than full-node retention",{"type":39,"tag":587,"props":645,"children":646},{},[647],{"type":45,"value":648},"archival + graphql",{"type":39,"tag":565,"props":650,"children":651},{},[652,657],{"type":39,"tag":587,"props":653,"children":654},{},[655],{"type":45,"value":656},"Storing \u002F retrieving a large file",{"type":39,"tag":587,"props":658,"children":659},{},[660],{"type":45,"value":661},"walrus",{"type":39,"tag":565,"props":663,"children":664},{},[665,670],{"type":39,"tag":587,"props":666,"children":667},{},[668],{"type":45,"value":669},"Migrating from JSON-RPC",{"type":39,"tag":587,"props":671,"children":672},{},[673],{"type":45,"value":674},"use-cases + grpc + graphql",{"type":39,"tag":565,"props":676,"children":677},{},[678,683],{"type":39,"tag":587,"props":679,"children":680},{},[681],{"type":45,"value":682},"Designing a new app from scratch",{"type":39,"tag":587,"props":684,"children":685},{},[686],{"type":45,"value":687},"use-cases (then grpc or graphql based on client type)",{"type":39,"tag":565,"props":689,"children":690},{},[691,696],{"type":39,"tag":587,"props":692,"children":693},{},[694],{"type":45,"value":695},"Full code review of a data-heavy app",{"type":39,"tag":587,"props":697,"children":698},{},[699],{"type":39,"tag":56,"props":700,"children":701},{},[702],{"type":45,"value":703},"all reference files",{"type":39,"tag":241,"props":705,"children":707},{"id":706},"skill-content",[708],{"type":45,"value":709},"Skill Content",{"type":39,"tag":248,"props":711,"children":713},{"id":712},"key-concepts",[714],{"type":45,"value":715},"Key concepts",{"type":39,"tag":171,"props":717,"children":718},{},[719,750,760,770,780,813,823],{"type":39,"tag":105,"props":720,"children":721},{},[722,727,729,734,736,741,743,748],{"type":39,"tag":56,"props":723,"children":724},{},[725],{"type":45,"value":726},"JSON-RPC is deprecated.",{"type":45,"value":728}," Sui Foundation mainnet full nodes will disable it the week of ",{"type":39,"tag":56,"props":730,"children":731},{},[732],{"type":45,"value":733},"July 27, 2026",{"type":45,"value":735},"; full code decommission by ",{"type":39,"tag":56,"props":737,"children":738},{},[739],{"type":45,"value":740},"mid-October 2026",{"type":45,"value":742},". New code must use gRPC or GraphQL RPC. ",{"type":39,"tag":64,"props":744,"children":746},{"className":745},[],[747],{"type":45,"value":92},{"type":45,"value":749}," still exists in the SDK as a deprecated migration stopgap.",{"type":39,"tag":105,"props":751,"children":752},{},[753,758],{"type":39,"tag":56,"props":754,"children":755},{},[756],{"type":45,"value":757},"gRPC is the performance default (GA).",{"type":45,"value":759}," Typed protobuf, streaming, low latency, polyglot client code gen (TS, Rust, Go, Python, etc.). Served directly by full nodes. Best for backends, indexers, and apps built in typed systems languages.",{"type":39,"tag":105,"props":761,"children":762},{},[763,768],{"type":39,"tag":56,"props":764,"children":765},{},[766],{"type":45,"value":767},"GraphQL RPC is the flexibility default (GA).",{"type":45,"value":769}," Reads from the General-Purpose Indexer's Postgres + full node + Archival Store. Also supports transaction submission and dry-run. One request can span multiple entity types. Best for frontends, tools, and apps built in dynamic languages.",{"type":39,"tag":105,"props":771,"children":772},{},[773,778],{"type":39,"tag":56,"props":774,"children":775},{},[776],{"type":45,"value":777},"Archival routing is operator-configured.",{"type":45,"value":779}," GraphQL RPC can route supported historical point lookups to the Archival Store transparently when the operator has configured archival backing. gRPC does not implicitly fall back to archival — gRPC clients must query an Archival Service endpoint directly for historical data beyond full-node retention. If archival is not configured, retention is limited to what the primary store holds.",{"type":39,"tag":105,"props":781,"children":782},{},[783,788,790,795,797,803,805,811],{"type":39,"tag":56,"props":784,"children":785},{},[786],{"type":45,"value":787},"Custom indexers exist because no hosted API fits every query shape.",{"type":45,"value":789}," If you need filtered sorts over millions of rows with app-specific indexes, run your own ",{"type":39,"tag":64,"props":791,"children":793},{"className":792},[],[794],{"type":45,"value":148},{"type":45,"value":796}," pipeline. Custom indexers can write to any storage layer by implementing the framework's ",{"type":39,"tag":64,"props":798,"children":800},{"className":799},[],[801],{"type":45,"value":802},"Store",{"type":45,"value":804}," and ",{"type":39,"tag":64,"props":806,"children":808},{"className":807},[],[809],{"type":45,"value":810},"Connection",{"type":45,"value":812}," traits — Postgres is the default, not a requirement.",{"type":39,"tag":105,"props":814,"children":815},{},[816,821],{"type":39,"tag":56,"props":817,"children":818},{},[819],{"type":45,"value":820},"On-chain storage is not general-purpose blob storage.",{"type":45,"value":822}," Max Move object size is 250 KB. Storage is paid once (storage fund redistributes returns to validators). Big files go to Walrus.",{"type":39,"tag":105,"props":824,"children":825},{},[826,831],{"type":39,"tag":56,"props":827,"children":828},{},[829],{"type":45,"value":830},"The storage fund does not \"hold your data.\"",{"type":45,"value":832}," It's an economic mechanism: a fraction of each write fee goes in; validators earn yield that pays for ongoing storage. It affects pricing, not where you store.",{"type":39,"tag":248,"props":834,"children":836},{"id":835},"rules",[837],{"type":45,"value":838},"Rules",{"type":39,"tag":101,"props":840,"children":841},{},[842,896,913,942,952,962,979,1076,1121],{"type":39,"tag":105,"props":843,"children":844},{},[845,850,852,858,860,866,868,873,875,880,882,887,889,894],{"type":39,"tag":56,"props":846,"children":847},{},[848],{"type":45,"value":849},"No JSON-RPC for new code.",{"type":45,"value":851}," JSON-RPC is deprecated; Sui Foundation mainnet full nodes will disable it the week of July 27, 2026. If a tutorial says ",{"type":39,"tag":64,"props":853,"children":855},{"className":854},[],[856],{"type":45,"value":857},"new SuiClient({ url: getFullnodeUrl(...) })",{"type":45,"value":859},", replace with ",{"type":39,"tag":64,"props":861,"children":863},{"className":862},[],[864],{"type":45,"value":865},"new SuiGrpcClient({ network, baseUrl })",{"type":45,"value":867},". If existing code uses ",{"type":39,"tag":64,"props":869,"children":871},{"className":870},[],[872],{"type":45,"value":92},{"type":45,"value":874},", migrate it to ",{"type":39,"tag":64,"props":876,"children":878},{"className":877},[],[879],{"type":45,"value":326},{"type":45,"value":881}," or ",{"type":39,"tag":64,"props":883,"children":885},{"className":884},[],[886],{"type":45,"value":374},{"type":45,"value":888},". Offer ",{"type":39,"tag":64,"props":890,"children":892},{"className":891},[],[893],{"type":45,"value":92},{"type":45,"value":895}," only as a short-term migration stopgap — it still exists in the SDK but is deprecated.",{"type":39,"tag":105,"props":897,"children":898},{},[899,904,906,911],{"type":39,"tag":56,"props":900,"children":901},{},[902],{"type":45,"value":903},"State GA status when recommending APIs.",{"type":45,"value":905}," gRPC, GraphQL RPC, and the Archival Store are all ",{"type":39,"tag":56,"props":907,"children":908},{},[909],{"type":45,"value":910},"generally available",{"type":45,"value":912},". When recommending any of these — especially when answering archival or history questions — explicitly state they are generally available. Do not call them beta or experimental.",{"type":39,"tag":105,"props":914,"children":915},{},[916,921,923,927,929,933,935,940],{"type":39,"tag":56,"props":917,"children":918},{},[919],{"type":45,"value":920},"Choose your initial API based on what you're building.",{"type":45,"value":922}," Front-ends, tools, and apps in dynamic languages → start with ",{"type":39,"tag":56,"props":924,"children":925},{},[926],{"type":45,"value":122},{"type":45,"value":928}," (superset of gRPC functionality, composable queries, transparent archival routing when operator-configured). Backends, indexers, and apps in typed systems languages → start with ",{"type":39,"tag":56,"props":930,"children":931},{},[932],{"type":45,"value":112},{"type":45,"value":934}," (performance, streaming, code-gen). Only switch if you hit a limitation. ",{"type":39,"tag":56,"props":936,"children":937},{},[938],{"type":45,"value":939},"Current temporary caveats",{"type":45,"value":941}," (will be resolved in the coming months): only gRPC supports subscriptions; only GraphQL supports filtered pagination over historical transactions and events.",{"type":39,"tag":105,"props":943,"children":944},{},[945,950],{"type":39,"tag":56,"props":946,"children":947},{},[948],{"type":45,"value":949},"Archival routing differs by API.",{"type":45,"value":951}," GraphQL RPC routes supported historical point lookups to the Archival Store transparently when the operator has configured archival backing. gRPC does not implicitly fall back to archival — gRPC clients must query an Archival Service endpoint directly for historical data beyond full-node retention. If archival is not configured, retention is limited to what the primary store holds.",{"type":39,"tag":105,"props":953,"children":954},{},[955,960],{"type":39,"tag":56,"props":956,"children":957},{},[958],{"type":45,"value":959},"Build a custom indexer only when hosted APIs don't fit.",{"type":45,"value":961}," Operating an indexer is ongoing work — Postgres, checkpoint ingestion, failure handling. Evaluate GraphQL RPC first.",{"type":39,"tag":105,"props":963,"children":964},{},[965,970,972,977],{"type":39,"tag":56,"props":966,"children":967},{},[968],{"type":45,"value":969},"Put large files on Walrus.",{"type":45,"value":971}," Never advise embedding images\u002Faudio\u002Fvideo in Move objects or in transaction inputs. If the user is trying to, route them to the ",{"type":39,"tag":64,"props":973,"children":975},{"className":974},[],[976],{"type":45,"value":661},{"type":45,"value":978}," reference file.",{"type":39,"tag":105,"props":980,"children":981},{},[982,987,989,994,996],{"type":39,"tag":56,"props":983,"children":984},{},[985],{"type":45,"value":986},"Map use case → method correctly.",{"type":45,"value":988}," See ",{"type":39,"tag":64,"props":990,"children":992},{"className":991},[],[993],{"type":45,"value":529},{"type":45,"value":995},":\n",{"type":39,"tag":171,"props":997,"children":998},{},[999,1017,1027,1044,1055,1066],{"type":39,"tag":105,"props":1000,"children":1001},{},[1002,1004,1015],{"type":45,"value":1003},"Live balance \u002F owned-object \u002F coin list → ",{"type":39,"tag":56,"props":1005,"children":1006},{},[1007,1009],{"type":45,"value":1008},"gRPC ",{"type":39,"tag":64,"props":1010,"children":1012},{"className":1011},[],[1013],{"type":45,"value":1014},"client.core.*",{"type":45,"value":1016},".",{"type":39,"tag":105,"props":1018,"children":1019},{},[1020,1022,1026],{"type":45,"value":1021},"Flexible multi-entity query for a frontend → ",{"type":39,"tag":56,"props":1023,"children":1024},{},[1025],{"type":45,"value":122},{"type":45,"value":1016},{"type":39,"tag":105,"props":1028,"children":1029},{},[1030,1032,1036,1038,1043],{"type":45,"value":1031},"Historical transaction > N days old → ",{"type":39,"tag":56,"props":1033,"children":1034},{},[1035],{"type":45,"value":122},{"type":45,"value":1037}," (routes through archival transparently when operator-configured) or ",{"type":39,"tag":56,"props":1039,"children":1040},{},[1041],{"type":45,"value":1042},"gRPC via a separate Archival Service endpoint",{"type":45,"value":1016},{"type":39,"tag":105,"props":1045,"children":1046},{},[1047,1049,1054],{"type":45,"value":1048},"Custom leaderboard \u002F analytics across all events → ",{"type":39,"tag":56,"props":1050,"children":1051},{},[1052],{"type":45,"value":1053},"custom indexer",{"type":45,"value":1016},{"type":39,"tag":105,"props":1056,"children":1057},{},[1058,1060,1065],{"type":45,"value":1059},"Transaction subscription \u002F real-time effects feed → ",{"type":39,"tag":56,"props":1061,"children":1062},{},[1063],{"type":45,"value":1064},"gRPC streaming",{"type":45,"value":1016},{"type":39,"tag":105,"props":1067,"children":1068},{},[1069,1071,1075],{"type":45,"value":1070},"Large files → ",{"type":39,"tag":56,"props":1072,"children":1073},{},[1074],{"type":45,"value":162},{"type":45,"value":1016},{"type":39,"tag":105,"props":1077,"children":1078},{},[1079,1084,1086,1090,1092,1098,1099,1105,1107,1111,1113,1119],{"type":39,"tag":56,"props":1080,"children":1081},{},[1082],{"type":45,"value":1083},"Read-after-write consistency varies by API.",{"type":45,"value":1085}," For ",{"type":39,"tag":56,"props":1087,"children":1088},{},[1089],{"type":45,"value":122},{"type":45,"value":1091},", queries nested under ",{"type":39,"tag":64,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":45,"value":1097},"executeTransaction",{"type":45,"value":881},{"type":39,"tag":64,"props":1100,"children":1102},{"className":1101},[],[1103],{"type":45,"value":1104},"simulateTransaction",{"type":45,"value":1106}," are evaluated in a special scope just after the executed\u002Fsimulated transaction, without waiting for indexing. This provides consistent read-after-write for fields that don't require indexed history (e.g., effects, gas, object changes). Prefer selecting these fields in the same GraphQL request rather than making a separate indexed follow-up query. For ",{"type":39,"tag":56,"props":1108,"children":1109},{},[1110],{"type":45,"value":112},{"type":45,"value":1112},", call ",{"type":39,"tag":64,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":45,"value":1118},"client.waitForTransaction({ digest })",{"type":45,"value":1120}," before the follow-up read. In both cases, cross-node reads after a write are not guaranteed immediately visible.",{"type":39,"tag":105,"props":1122,"children":1123},{},[1124,1129],{"type":39,"tag":56,"props":1125,"children":1126},{},[1127],{"type":45,"value":1128},"Cite docs when unsure.",{"type":45,"value":1130}," All sources listed above.",{"type":39,"tag":248,"props":1132,"children":1134},{"id":1133},"common-mistakes",[1135],{"type":45,"value":1136},"Common mistakes",{"type":39,"tag":171,"props":1138,"children":1139},{},[1140,1193,1203,1213,1223,1233,1243,1268,1278,1288],{"type":39,"tag":105,"props":1141,"children":1142},{},[1143,1169,1171,1177,1178,1184,1185,1191],{"type":39,"tag":56,"props":1144,"children":1145},{},[1146,1148,1154,1156,1162,1163],{"type":45,"value":1147},"Using ",{"type":39,"tag":64,"props":1149,"children":1151},{"className":1150},[],[1152],{"type":45,"value":1153},"client.getObject",{"type":45,"value":1155}," \u002F ",{"type":39,"tag":64,"props":1157,"children":1159},{"className":1158},[],[1160],{"type":45,"value":1161},"client.getOwnedObjects",{"type":45,"value":1155},{"type":39,"tag":64,"props":1164,"children":1166},{"className":1165},[],[1167],{"type":45,"value":1168},"client.getCoins",{"type":45,"value":1170}," — these are v1 method names from the deprecated JSON-RPC surface. v2 is ",{"type":39,"tag":64,"props":1172,"children":1174},{"className":1173},[],[1175],{"type":45,"value":1176},"client.core.getObject",{"type":45,"value":1155},{"type":39,"tag":64,"props":1179,"children":1181},{"className":1180},[],[1182],{"type":45,"value":1183},"client.core.listOwnedObjects",{"type":45,"value":1155},{"type":39,"tag":64,"props":1186,"children":1188},{"className":1187},[],[1189],{"type":45,"value":1190},"client.core.listCoins",{"type":45,"value":1192}," on any of the v2 clients.",{"type":39,"tag":105,"props":1194,"children":1195},{},[1196,1201],{"type":39,"tag":56,"props":1197,"children":1198},{},[1199],{"type":45,"value":1200},"Recommending \"the Sui API\" without specifying which.",{"type":45,"value":1202}," \"The Sui API\" conflates different interfaces with different use cases. Always name gRPC or GraphQL.",{"type":39,"tag":105,"props":1204,"children":1205},{},[1206,1211],{"type":39,"tag":56,"props":1207,"children":1208},{},[1209],{"type":45,"value":1210},"Telling users to \"use the indexer\"",{"type":45,"value":1212}," for a simple query that gRPC covers in one method. Only reach for a custom indexer when you've outgrown the hosted APIs.",{"type":39,"tag":105,"props":1214,"children":1215},{},[1216,1221],{"type":39,"tag":56,"props":1217,"children":1218},{},[1219],{"type":45,"value":1220},"Storing images or large JSON \"on Sui.\"",{"type":45,"value":1222}," Sui's 250 KB object size limit and pricing model make this wrong. Use Walrus.",{"type":39,"tag":105,"props":1224,"children":1225},{},[1226,1231],{"type":39,"tag":56,"props":1227,"children":1228},{},[1229],{"type":45,"value":1230},"Assuming gRPC and GraphQL return the same shape.",{"type":45,"value":1232}," gRPC is protobuf; GraphQL is typed GraphQL. Response shapes differ; field names differ; pagination differs.",{"type":39,"tag":105,"props":1234,"children":1235},{},[1236,1241],{"type":39,"tag":56,"props":1237,"children":1238},{},[1239],{"type":45,"value":1240},"Polling for events.",{"type":45,"value":1242}," Use gRPC streaming \u002F subscriptions instead. Polling is high-cost and high-latency.",{"type":39,"tag":105,"props":1244,"children":1245},{},[1246,1251,1253,1258,1260,1266],{"type":39,"tag":56,"props":1247,"children":1248},{},[1249],{"type":45,"value":1250},"Reading from an RPC node and writing to a different one expecting read-after-write consistency.",{"type":45,"value":1252}," Fullnodes are eventually consistent across the network. For GraphQL, prefer selecting fields in the same ",{"type":39,"tag":64,"props":1254,"children":1256},{"className":1255},[],[1257],{"type":45,"value":1097},{"type":45,"value":1259}," mutation (execution-attached scope gives consistent results without indexing). For gRPC, read from the same node you wrote to, or ",{"type":39,"tag":64,"props":1261,"children":1263},{"className":1262},[],[1264],{"type":45,"value":1265},"waitForTransaction",{"type":45,"value":1267}," before cross-node reads.",{"type":39,"tag":105,"props":1269,"children":1270},{},[1271,1276],{"type":39,"tag":56,"props":1272,"children":1273},{},[1274],{"type":45,"value":1275},"Conflating \"storage fund\" with \"storage service.\"",{"type":45,"value":1277}," The storage fund is a tokenomics mechanism. It is not an API you call.",{"type":39,"tag":105,"props":1279,"children":1280},{},[1281,1286],{"type":39,"tag":56,"props":1282,"children":1283},{},[1284],{"type":45,"value":1285},"Assuming gRPC transparently routes to archival.",{"type":45,"value":1287}," Only GraphQL RPC transparently routes supported historical lookups to the Archival Store (when operator-configured). For gRPC, clients must query an Archival Service endpoint directly for historical data beyond full-node retention.",{"type":39,"tag":105,"props":1289,"children":1290},{},[1291,1296],{"type":39,"tag":56,"props":1292,"children":1293},{},[1294],{"type":45,"value":1295},"Assuming archival routing is automatic.",{"type":45,"value":1297}," It's operator-configured. If the operator hasn't set up archival backing, retention is limited to what the primary store holds (e.g., the Postgres database's retention policy for GraphQL).",{"items":1299,"total":1398},[1300,1306,1321,1342,1356,1369,1385],{"slug":4,"name":4,"fn":5,"description":6,"org":1301,"tags":1302,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1303,1304,1305],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":1307,"name":1307,"fn":1308,"description":1309,"org":1310,"tags":1311,"stars":22,"repoUrl":23,"updatedAt":1320},"composable-move-functions","design composable Sui Move functions","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1312,1315,1318,1319],{"name":1313,"slug":1314,"type":15},"API Development","api-development",{"name":1316,"slug":1317,"type":15},"Smart Contracts","smart-contracts",{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},"2026-07-16T06:02:49.198495",{"slug":1322,"name":1322,"fn":1323,"description":1324,"org":1325,"tags":1326,"stars":22,"repoUrl":23,"updatedAt":1341},"frontend-apps","build Sui dApps with dapp-kit","Sui frontend \u002F dApp development with @mysten\u002Fdapp-kit-react (React) and @mysten\u002Fdapp-kit-core (Vue, vanilla JS, Svelte, Web Components, other frameworks). Use when building browser apps that connect Sui wallets, query on-chain state, or submit transactions. Covers wallet connection, network switching, transaction execution, query patterns with TanStack React Query, and the specific pitfalls of browser + wallet + async-indexer environments. Pair with the `sui-sdks` skill for @mysten\u002Fsui Transaction construction patterns and the `ptbs` skill for PTB semantics.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1327,1330,1333,1334,1337,1340],{"name":1328,"slug":1329,"type":15},"Frontend","frontend",{"name":1331,"slug":1332,"type":15},"React","react",{"name":14,"slug":8,"type":15},{"name":1335,"slug":1336,"type":15},"Svelte","svelte",{"name":1338,"slug":1339,"type":15},"Vue","vue",{"name":20,"slug":21,"type":15},"2026-08-01T05:44:28.958473",{"slug":1343,"name":1343,"fn":1344,"description":1345,"org":1346,"tags":1347,"stars":22,"repoUrl":23,"updatedAt":1355},"generate-sui-agent-config","generate configuration files for Sui projects","Generate a CLAUDE.md or AGENT.md configuration file for Sui projects. Use when setting up a new Sui project, when user mentions \"CLAUDE.md\", \"AGENT.md\", \"agent config\", or when working on a Sui project that does not already have a CLAUDE.md or AGENT.md in the project root.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1348,1351,1354],{"name":1349,"slug":1350,"type":15},"Configuration","configuration",{"name":1352,"slug":1353,"type":15},"Documentation","documentation",{"name":14,"slug":8,"type":15},"2026-07-16T06:00:59.981056",{"slug":1357,"name":1357,"fn":1358,"description":1359,"org":1360,"tags":1361,"stars":22,"repoUrl":23,"updatedAt":1368},"modern-move-syntax","write Move 2024 edition code for Sui","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1362,1365,1366,1367],{"name":1363,"slug":1364,"type":15},"Engineering","engineering",{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},"2026-07-16T06:02:43.277596",{"slug":1370,"name":1370,"fn":1371,"description":1372,"org":1373,"tags":1374,"stars":22,"repoUrl":23,"updatedAt":1384},"move-unit-testing","write unit tests for Sui Move contracts","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1375,1378,1379,1380,1383],{"name":1376,"slug":1377,"type":15},"QA","qa",{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":1381,"slug":1382,"type":15},"Testing","testing",{"name":20,"slug":21,"type":15},"2026-08-01T05:44:30.788585",{"slug":1386,"name":1386,"fn":1387,"description":1388,"org":1389,"tags":1390,"stars":22,"repoUrl":23,"updatedAt":1397},"naming-conventions","apply Sui Move naming conventions","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1391,1394,1395,1396],{"name":1392,"slug":1393,"type":15},"Best Practices","best-practices",{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},"2026-07-16T06:02:48.830052",20,{"items":1400,"total":1517},[1401,1415,1424,1434,1449,1467,1473,1480,1489,1495,1502,1510],{"slug":1402,"name":1402,"fn":1403,"description":1404,"org":1405,"tags":1406,"stars":1412,"repoUrl":1413,"updatedAt":1414},"move-bytecode-comprehension","analyze and disassemble Move bytecode","Use when reading or reasoning about compiled Move bytecode or `sui move disassemble` output. Mental model for the binary format, what survives compilation (and what's lost), and how to read disassembly soundly. Trigger on \"what does this package do?\", \"read this .mv module\", \"interpret this disassembly\", or whenever an analysis needs to interpret bytecode faithfully.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1407,1410,1411],{"name":1408,"slug":1409,"type":15},"Code Analysis","code-analysis",{"name":1363,"slug":1364,"type":15},{"name":14,"slug":8,"type":15},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":1416,"name":1416,"fn":1417,"description":1418,"org":1419,"tags":1420,"stars":1412,"repoUrl":1413,"updatedAt":1423},"official-sui-skills","access official Sui development resources","Pointer to the official Mysten Labs skills for building on Sui — language fundamentals, object model, PTBs, SDKs, publishing, upgrades, frontend integration, accessing on-chain data. Maintained upstream at github.com\u002FMystenLabs\u002Fskills; pinned to the same ref the audit catalog derives from (see maintenance\u002FUPSTREAMS.md). Trigger on \"build a contract\", \"publish a package\", \"upgrade a module or package\", \"use the TypeScript SDK\", \"write a PTB\", \"set up a Sui client\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1421,1422],{"name":1352,"slug":1353,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:00:59.641382",{"slug":1425,"name":1425,"fn":1426,"description":1427,"org":1428,"tags":1429,"stars":1412,"repoUrl":1413,"updatedAt":1433},"sui-and-move-tools","disassemble Sui Move bytecode","Use to get bytecode for a deployed Sui package and produce a disassembled working view. One GraphQL call fetches every module's raw bytecode bytes; `sui move disassemble` (already on the system, running `sui prompt`) produces `.asm` files for analysis. Trigger on \"fetch this package's bytecode\", \"get me the .mv for package X\", \"disassemble this package\", or \"I need to read a deployed Sui package\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1430,1431,1432],{"name":1408,"slug":1409,"type":15},{"name":1363,"slug":1364,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:25.3633",{"slug":1435,"name":1435,"fn":1436,"description":1437,"org":1438,"tags":1439,"stars":1412,"repoUrl":1413,"updatedAt":1448},"sui-move-security-review","audit Sui Move smart contracts","Use when auditing, reviewing, or hunting for vulnerabilities in Move code on Sui. Applies equally to source code (.move files) and to disassembly of compiled bytecode (on-chain packages). A checklist of invariants whose VIOLATION causes exploitable bugs: access control & capabilities, struct abilities & type safety, object lifecycle & ownership, shared-object and PTB attack surface, dynamic fields & collections, arithmetic & coins, init\u002FOTW\u002Fpackage upgrades, hot-potato composability, time & on-chain randomness, and test-only code leakage. Trigger on \"audit this Move code\", \"find vulnerabilities in this Sui contract\", \"security review\", \"is this package safe?\", \"I suspect there's a bug in X\", \"something is wrong with this contract\", or when reasoning about whether a Move function can be abused.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1440,1443,1446,1447],{"name":1441,"slug":1442,"type":15},"Code Review","code-review",{"name":1444,"slug":1445,"type":15},"Security","security",{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:55.691149",{"slug":1450,"name":1450,"fn":1451,"description":1452,"org":1453,"tags":1454,"stars":1464,"repoUrl":1465,"updatedAt":1466},"memwal","integrate Walrus Memory SDK","Walrus Memory SDK — portable agent memory that works across apps, sessions, and workflows.\n\nUse when users say:\n- \"add memory to my app\"\n- \"portable agent memory\"\n- \"integrate Walrus Memory\"\n- \"AI agent memory\"\n- \"memory across agents\"\n- \"Walrus memory storage\"\n- \"setup Walrus Memory\"\n- \"recall memories\"\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1455,1458,1461],{"name":1456,"slug":1457,"type":15},"Agents","agents",{"name":1459,"slug":1460,"type":15},"Memory","memory",{"name":1462,"slug":1463,"type":15},"SDK","sdk",57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-07-16T06:02:39.838395",{"slug":4,"name":4,"fn":5,"description":6,"org":1468,"tags":1469,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1470,1471,1472],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":1307,"name":1307,"fn":1308,"description":1309,"org":1474,"tags":1475,"stars":22,"repoUrl":23,"updatedAt":1320},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1476,1477,1478,1479],{"name":1313,"slug":1314,"type":15},{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":1322,"name":1322,"fn":1323,"description":1324,"org":1481,"tags":1482,"stars":22,"repoUrl":23,"updatedAt":1341},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1483,1484,1485,1486,1487,1488],{"name":1328,"slug":1329,"type":15},{"name":1331,"slug":1332,"type":15},{"name":14,"slug":8,"type":15},{"name":1335,"slug":1336,"type":15},{"name":1338,"slug":1339,"type":15},{"name":20,"slug":21,"type":15},{"slug":1343,"name":1343,"fn":1344,"description":1345,"org":1490,"tags":1491,"stars":22,"repoUrl":23,"updatedAt":1355},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1492,1493,1494],{"name":1349,"slug":1350,"type":15},{"name":1352,"slug":1353,"type":15},{"name":14,"slug":8,"type":15},{"slug":1357,"name":1357,"fn":1358,"description":1359,"org":1496,"tags":1497,"stars":22,"repoUrl":23,"updatedAt":1368},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1498,1499,1500,1501],{"name":1363,"slug":1364,"type":15},{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":1370,"name":1370,"fn":1371,"description":1372,"org":1503,"tags":1504,"stars":22,"repoUrl":23,"updatedAt":1384},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1505,1506,1507,1508,1509],{"name":1376,"slug":1377,"type":15},{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":1381,"slug":1382,"type":15},{"name":20,"slug":21,"type":15},{"slug":1386,"name":1386,"fn":1387,"description":1388,"org":1511,"tags":1512,"stars":22,"repoUrl":23,"updatedAt":1397},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1513,1514,1515,1516],{"name":1392,"slug":1393,"type":15},{"name":1316,"slug":1317,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},37]