[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-ptbs":3,"mdc--pkvp2z-key":36,"related-org-sui-ptbs":1535,"related-repo-sui-ptbs":1708},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"ptbs","compose Sui Programmable Transaction Blocks","Sui Programmable Transaction Blocks (PTBs). Use when writing, reviewing, or debugging code that composes multiple Sui transaction commands into a single atomic transaction — including TypeScript SDK `Transaction` usage, CLI PTB construction, gas coin handling, sponsored transactions, shared-object inputs, chaining command results, or troubleshooting PTB execution errors.\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,17,19,22],{"name":14,"slug":15,"type":16},"Blockchain","blockchain","tag",{"name":18,"slug":8,"type":16},"Sui",{"name":20,"slug":21,"type":16},"TypeScript","typescript",{"name":23,"slug":24,"type":16},"Smart Contracts","smart-contracts",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-07-16T06:02:40.181035",null,2,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Sui development skills maintained by Mysten Labs","https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills\u002Ftree\u002FHEAD\u002Fptbs","---\nname: ptbs\ndescription: >\n  Sui Programmable Transaction Blocks (PTBs). Use when writing, reviewing, or\n  debugging code that composes multiple Sui transaction commands into a single\n  atomic transaction — including TypeScript SDK `Transaction` usage, CLI PTB\n  construction, gas coin handling, sponsored transactions, shared-object inputs,\n  chaining command results, or troubleshooting PTB execution errors.\n---\n\n# Sui Programmable Transaction Blocks (PTBs)\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\nA PTB is one Sui transaction that batches up to **1,024 commands** — Move calls, coin splits\u002Fmerges, object transfers, vector construction, package publish\u002Fupgrade — executed in order, atomically (one command fails ⇒ whole block fails), sharing inputs and chaining results. PTBs are the only way to execute transactions on Sui; there is no \"single call\" mode.\n\nThis skill routes to focused reference files. Load only the ones relevant to the current task.\n\nAll patterns in this skill are derived from:\n- https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Ftransactions\u002Fprog-txn-blocks\n- https:\u002F\u002Fdocs.sui.io\u002Fdevelop\u002Ftransactions\u002Fptbs\u002Fbuilding-ptb\n- https:\u002F\u002Fdocs.sui.io\u002Freferences\u002Fptb-commands\n- https:\u002F\u002Fsdk.mystenlabs.com\u002Fsui\u002Ftransactions\u002Fbasics\n- https:\u002F\u002Fdocs.sui.io\u002Freferences\u002Fcli\u002Fclient (CLI `sui client ptb`)\n\nIf unsure about any API, method signature, or error message, fetch the relevant page before answering. Do not guess or extrapolate from Ethereum, Solana, or other chains — PTBs have no direct analog.\n\n---\n\n## Reference files\n\n### fundamentals — PTB data model\n**Path:** `fundamentals.md`\n**Load when:** explaining what a PTB is, talking about `Input`, `Argument`, `NestedResult`, `GasCoin`, owned vs shared vs immutable vs receiving object references, pure-input BCS rules, command chaining semantics, or execution ordering \u002F atomicity.\n**Covers:** PTB structure, `Input` (CallArg) and `ObjectArg` variants, pure input types, `Argument` enum, result chaining, execution semantics (borrow rules, move\u002Fcopy, hot potato cliques, end-of-tx constraints), protocol limits.\n\n### commands — Command reference\n**Path:** `commands.md`\n**Load when:** writing or reviewing any specific command — `MoveCall`, `SplitCoins`, `MergeCoins`, `TransferObjects`, `MakeMoveVec`, `Publish`, `Upgrade` — or debugging argument-type mismatches and return-value shape.\n**Covers:** signature, argument rules, return shape, and common pitfalls for each of the seven commands.\n\n### building — TypeScript SDK `Transaction` class\n**Path:** `building.md`\n**Load when:** writing TS\u002FJS code that constructs a PTB with `@mysten\u002Fsui\u002Ftransactions`, configuring gas, building for wallets, serializing across services, or sending PTBs between app ↔ wallet ↔ sponsor.\n**Covers:** `Transaction` API (`tx.moveCall`, `tx.splitCoins`, `tx.mergeCoins`, `tx.transferObjects`, `tx.makeMoveVec`, `tx.publish`, `tx.upgrade`, `tx.balance`, `tx.coin`, `tx.add`, `tx.object`, `tx.pure`, `tx.gas`, `tx.setSender\u002FsetGasPrice\u002FsetGasBudget\u002FsetGasPayment\u002FsetGasOwner`), `Inputs.*Ref` helpers, result destructuring, `build({ onlyTransactionKind: true })`, `Transaction.from` \u002F `fromKind`, sponsored transaction flow, signing & executing.\n\n### cli — Building PTBs from the CLI\n**Path:** `cli.md`\n**Load when:** constructing PTBs from the command line using `sui client ptb`, scripting transactions without TypeScript, merging coins from the CLI, or teaching CLI-based workflows.\n**Covers:** `sui client ptb` syntax, chaining commands, common CLI PTB patterns (transfers, coin merges, Move calls), gas budget, previewing before execution.\n\n### troubleshooting — Common errors\n**Path:** `troubleshooting.md`\n**Load when:** diagnosing a failing PTB — any `ServerError`, `UnusedValueWithoutDrop`, `VMVerificationOrDeserializationError`, `No valid gas coins`, `InsufficientGas`, shared-object congestion, or cryptic \"transaction failed\" output.\n**Covers:** each error category with the Move\u002FPTB-level cause and concrete fix.\n\n## Routing guide\n\n| Task | Load |\n|------|------|\n| \"What is a PTB?\" \u002F conceptual explanation | fundamentals |\n| Writing a new PTB in TypeScript | building + commands |\n| Writing a new PTB from the CLI | cli + commands |\n| Reviewing a PTB for correctness | fundamentals + commands + building |\n| A specific command fails type checking | commands |\n| Sponsored \u002F gasless transactions | building |\n| Debugging a failing PTB | troubleshooting + (fundamentals if execution-semantics related) |\n| Publishing or upgrading a package in a PTB | commands |\n| Building PTB bytes across services (app\u002Fwallet\u002Fsponsor) | building |\n| Merging coins or simple operations from the CLI | cli |\n| Full code review | **all reference files** |\n\n## Skill Content\n\n### Key concepts\n\n- **A PTB is the transaction.** Every Sui transaction is a PTB — even a single `moveCall` is a one-command PTB. There is no non-PTB execution path.\n- **Inputs vs commands.** `inputs` are values fed in from outside (objects and BCS-encoded \"pure\" bytes). `commands` operate on those inputs and on each other's results. Commands reference values via the `Argument` enum: `Input(i)`, `GasCoin`, `Result(i)`, `NestedResult(cmd, result)`.\n- **Chaining.** Each command produces an array of results. The next command can consume any result (by `NestedResult(cmd, idx)` or, when a command has exactly one return, `Result(cmd)`). The TS SDK surfaces this as destructurable values: `const [coin] = tx.splitCoins(tx.gas, [tx.pure.u64(100)]);`.\n- **Atomicity.** Commands execute in order. Any failure reverts the entire block; no partial effects.\n- **End-of-tx constraints.** Every non-`drop` value produced during execution must be consumed (transferred, destroyed, or fed into another command). Shared objects have exactly two legal endings: re-share or delete — they cannot be transferred or frozen. Gas coin is returned to its owner with unused gas refunded.\n\n### Rules\n\n1. **`tx.gas` must be used by reference, except in `transferObjects`.** To get an owned `Coin\u003CSUI>` from the gas coin, use `SplitCoins(tx.gas, [amount])` first.\n3. **Leave gas config to the wallet when possible.** Do not hardcode `setGasBudget` \u002F `setGasPrice` \u002F `setGasPayment` in app code that will be signed by a user wallet — the wallet dry-runs and selects coins correctly. Only set them for backend-signed flows.\n4. **In app code that hands a PTB to a wallet, use `await tx.toJSON()` (not `tx.build()`).** The wallet must perform gas logic and coin selection itself; building bytes in app code preempts that.\n5. **Use `Transaction.fromKind(kindBytes)` for sponsored flows.** Build in app with `tx.build({ client, onlyTransactionKind: true })`, send the kind-only bytes to the sponsor service, rehydrate there with `fromKind`, then `setSender`, `setGasOwner`, `setGasPayment`. The user (or either party) should submit the fully-signed transaction directly to a full node — not back through the sponsor service — to avoid censorship.\n6. **Every non-`drop` value must be consumed.** If `moveCall` returns a value you don't need, pass it to `transferObjects` (if it has `key + store`), to `public_transfer`, or to a destructor. `UnusedValueWithoutDrop` is the PTB-level error.\n7. **Shared objects cannot be transferred, frozen, or consumed by value if passed as read-only** (`mutable: false`). If you need mutable access, mark them mutable when building the input.\n8. **Types coming from Move calls cannot be references.** `MoveCall` results are values; if a Move function returns `&T`, it cannot be called from a PTB.\n9. **For multi-return Move calls, use destructuring or array indexing.** `const [a, b] = tx.moveCall(...)` or `const r = tx.moveCall(...); r[0]; r[1];`. Do not assume single-return shape.\n10. **Cite the docs when unsure.** Canonical sources above. Legacy `\u002Fdevelop\u002Ftransactions\u002Fptbs\u002F*` URLs still render but prefer `\u002Fconcepts\u002Ftransactions\u002Fprog-txn-blocks` and `\u002Fguides\u002Fdeveloper\u002Fsui-101\u002Fbuilding-ptb`.\n\n### Common mistakes\n\n- **Calling `tx.pure(value)` without a type.** Untyped pure values fail at input resolution. Use typed helpers: `tx.pure.u64(n)`, `tx.pure.address(addr)`, `tx.pure.string(s)`, or the generic `tx.pure('u64', n)`.\n- **Passing a string object ID to `moveCall` arguments without `tx.object(...)`.** Mixed-type arguments require explicit `tx.object(id)` wrapping; otherwise the SDK can't distinguish pure from object.\n- **Transferring or freezing a shared object.** Shared objects cannot be transferred or frozen — but they *can* be deleted. The two legal endings for a shared object in a PTB are re-share or delete. Do not include shared objects in `transferObjects`. Note that consuming a shared object by value permanently marks its hot-potato clique as \"hot\", which blocks subsequent non-public `entry` calls on any entangled value in that clique.\n- **Forgetting to `setSender` on offline builds.** When calling `tx.build()` without signing through a signer that sets the sender, the sender field stays empty and the build fails.\n- **Treating multi-return `moveCall` results as single values.** The return is a vector; index or destructure.\n- **Using `transfer::transfer` \u002F `transfer::share_object` on generic types from a PTB.** Those entries require a module-private type param. From a PTB, use `transfer::public_transfer` \u002F `transfer::public_share_object`, which require the type to have `store`.\n- **Setting a gas budget that's too tight.** A tx that exceeds budget aborts but still charges the gas coin. Prefer the SDK's dry-run-based auto-budget.\n- **Not checking execution status.** A transaction can be accepted by validators but fail at the Move level (assertion, out of gas, etc.). Always check `result.$kind !== 'FailedTransaction'` before treating an operation as successful. The tx digest alone does not mean the effects were applied.\n- **Looping in app code to submit N individual transactions.** Batch into one PTB (up to 1,024 ops). One PTB is cheaper and atomic.\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,50,75,87,92,97,159,164,168,175,182,264,270,346,360,530,536,575,581,643,649,821,827,833,974,980,1288,1294],{"type":42,"tag":43,"props":44,"children":46},"element","h1",{"id":45},"sui-programmable-transaction-blocks-ptbs",[47],{"type":48,"value":49},"text","Sui Programmable Transaction Blocks (PTBs)",{"type":42,"tag":51,"props":52,"children":53},"blockquote",{},[54],{"type":42,"tag":55,"props":56,"children":57},"p",{},[58,64,66,73],{"type":42,"tag":59,"props":60,"children":61},"strong",{},[62],{"type":48,"value":63},"MCP tool:",{"type":48,"value":65}," When available in your environment, also query the Sui documentation MCP server (",{"type":42,"tag":67,"props":68,"children":70},"code",{"className":69},[],[71],{"type":48,"value":72},"https:\u002F\u002Fsui.mcp.kapa.ai",{"type":48,"value":74},") for up-to-date answers. Use it for verification and for details not covered by these reference files.",{"type":42,"tag":55,"props":76,"children":77},{},[78,80,85],{"type":48,"value":79},"A PTB is one Sui transaction that batches up to ",{"type":42,"tag":59,"props":81,"children":82},{},[83],{"type":48,"value":84},"1,024 commands",{"type":48,"value":86}," — Move calls, coin splits\u002Fmerges, object transfers, vector construction, package publish\u002Fupgrade — executed in order, atomically (one command fails ⇒ whole block fails), sharing inputs and chaining results. PTBs are the only way to execute transactions on Sui; there is no \"single call\" mode.",{"type":42,"tag":55,"props":88,"children":89},{},[90],{"type":48,"value":91},"This skill routes to focused reference files. Load only the ones relevant to the current task.",{"type":42,"tag":55,"props":93,"children":94},{},[95],{"type":48,"value":96},"All patterns in this skill are derived from:",{"type":42,"tag":98,"props":99,"children":100},"ul",{},[101,113,122,131,140],{"type":42,"tag":102,"props":103,"children":104},"li",{},[105],{"type":42,"tag":106,"props":107,"children":111},"a",{"href":108,"rel":109},"https:\u002F\u002Fdocs.sui.io\u002Fconcepts\u002Ftransactions\u002Fprog-txn-blocks",[110],"nofollow",[112],{"type":48,"value":108},{"type":42,"tag":102,"props":114,"children":115},{},[116],{"type":42,"tag":106,"props":117,"children":120},{"href":118,"rel":119},"https:\u002F\u002Fdocs.sui.io\u002Fdevelop\u002Ftransactions\u002Fptbs\u002Fbuilding-ptb",[110],[121],{"type":48,"value":118},{"type":42,"tag":102,"props":123,"children":124},{},[125],{"type":42,"tag":106,"props":126,"children":129},{"href":127,"rel":128},"https:\u002F\u002Fdocs.sui.io\u002Freferences\u002Fptb-commands",[110],[130],{"type":48,"value":127},{"type":42,"tag":102,"props":132,"children":133},{},[134],{"type":42,"tag":106,"props":135,"children":138},{"href":136,"rel":137},"https:\u002F\u002Fsdk.mystenlabs.com\u002Fsui\u002Ftransactions\u002Fbasics",[110],[139],{"type":48,"value":136},{"type":42,"tag":102,"props":141,"children":142},{},[143,149,151,157],{"type":42,"tag":106,"props":144,"children":147},{"href":145,"rel":146},"https:\u002F\u002Fdocs.sui.io\u002Freferences\u002Fcli\u002Fclient",[110],[148],{"type":48,"value":145},{"type":48,"value":150}," (CLI ",{"type":42,"tag":67,"props":152,"children":154},{"className":153},[],[155],{"type":48,"value":156},"sui client ptb",{"type":48,"value":158},")",{"type":42,"tag":55,"props":160,"children":161},{},[162],{"type":48,"value":163},"If unsure about any API, method signature, or error message, fetch the relevant page before answering. Do not guess or extrapolate from Ethereum, Solana, or other chains — PTBs have no direct analog.",{"type":42,"tag":165,"props":166,"children":167},"hr",{},[],{"type":42,"tag":169,"props":170,"children":172},"h2",{"id":171},"reference-files",[173],{"type":48,"value":174},"Reference files",{"type":42,"tag":176,"props":177,"children":179},"h3",{"id":178},"fundamentals-ptb-data-model",[180],{"type":48,"value":181},"fundamentals — PTB data model",{"type":42,"tag":55,"props":183,"children":184},{},[185,190,192,198,203,205,211,213,219,220,226,227,233,235,240,242,247,249,255,257,262],{"type":42,"tag":59,"props":186,"children":187},{},[188],{"type":48,"value":189},"Path:",{"type":48,"value":191}," ",{"type":42,"tag":67,"props":193,"children":195},{"className":194},[],[196],{"type":48,"value":197},"fundamentals.md",{"type":42,"tag":59,"props":199,"children":200},{},[201],{"type":48,"value":202},"Load when:",{"type":48,"value":204}," explaining what a PTB is, talking about ",{"type":42,"tag":67,"props":206,"children":208},{"className":207},[],[209],{"type":48,"value":210},"Input",{"type":48,"value":212},", ",{"type":42,"tag":67,"props":214,"children":216},{"className":215},[],[217],{"type":48,"value":218},"Argument",{"type":48,"value":212},{"type":42,"tag":67,"props":221,"children":223},{"className":222},[],[224],{"type":48,"value":225},"NestedResult",{"type":48,"value":212},{"type":42,"tag":67,"props":228,"children":230},{"className":229},[],[231],{"type":48,"value":232},"GasCoin",{"type":48,"value":234},", owned vs shared vs immutable vs receiving object references, pure-input BCS rules, command chaining semantics, or execution ordering \u002F atomicity.\n",{"type":42,"tag":59,"props":236,"children":237},{},[238],{"type":48,"value":239},"Covers:",{"type":48,"value":241}," PTB structure, ",{"type":42,"tag":67,"props":243,"children":245},{"className":244},[],[246],{"type":48,"value":210},{"type":48,"value":248}," (CallArg) and ",{"type":42,"tag":67,"props":250,"children":252},{"className":251},[],[253],{"type":48,"value":254},"ObjectArg",{"type":48,"value":256}," variants, pure input types, ",{"type":42,"tag":67,"props":258,"children":260},{"className":259},[],[261],{"type":48,"value":218},{"type":48,"value":263}," enum, result chaining, execution semantics (borrow rules, move\u002Fcopy, hot potato cliques, end-of-tx constraints), protocol limits.",{"type":42,"tag":176,"props":265,"children":267},{"id":266},"commands-command-reference",[268],{"type":48,"value":269},"commands — Command reference",{"type":42,"tag":55,"props":271,"children":272},{},[273,277,278,284,288,290,296,297,303,304,310,311,317,318,324,325,331,332,338,340,344],{"type":42,"tag":59,"props":274,"children":275},{},[276],{"type":48,"value":189},{"type":48,"value":191},{"type":42,"tag":67,"props":279,"children":281},{"className":280},[],[282],{"type":48,"value":283},"commands.md",{"type":42,"tag":59,"props":285,"children":286},{},[287],{"type":48,"value":202},{"type":48,"value":289}," writing or reviewing any specific command — ",{"type":42,"tag":67,"props":291,"children":293},{"className":292},[],[294],{"type":48,"value":295},"MoveCall",{"type":48,"value":212},{"type":42,"tag":67,"props":298,"children":300},{"className":299},[],[301],{"type":48,"value":302},"SplitCoins",{"type":48,"value":212},{"type":42,"tag":67,"props":305,"children":307},{"className":306},[],[308],{"type":48,"value":309},"MergeCoins",{"type":48,"value":212},{"type":42,"tag":67,"props":312,"children":314},{"className":313},[],[315],{"type":48,"value":316},"TransferObjects",{"type":48,"value":212},{"type":42,"tag":67,"props":319,"children":321},{"className":320},[],[322],{"type":48,"value":323},"MakeMoveVec",{"type":48,"value":212},{"type":42,"tag":67,"props":326,"children":328},{"className":327},[],[329],{"type":48,"value":330},"Publish",{"type":48,"value":212},{"type":42,"tag":67,"props":333,"children":335},{"className":334},[],[336],{"type":48,"value":337},"Upgrade",{"type":48,"value":339}," — or debugging argument-type mismatches and return-value shape.\n",{"type":42,"tag":59,"props":341,"children":342},{},[343],{"type":48,"value":239},{"type":48,"value":345}," signature, argument rules, return shape, and common pitfalls for each of the seven commands.",{"type":42,"tag":176,"props":347,"children":349},{"id":348},"building-typescript-sdk-transaction-class",[350,352,358],{"type":48,"value":351},"building — TypeScript SDK ",{"type":42,"tag":67,"props":353,"children":355},{"className":354},[],[356],{"type":48,"value":357},"Transaction",{"type":48,"value":359}," class",{"type":42,"tag":55,"props":361,"children":362},{},[363,367,368,374,378,380,386,388,392,393,398,400,406,407,413,414,420,421,427,428,434,435,441,442,448,449,455,456,462,463,469,470,476,477,483,484,490,491,497,499,505,507,513,514,520,522,528],{"type":42,"tag":59,"props":364,"children":365},{},[366],{"type":48,"value":189},{"type":48,"value":191},{"type":42,"tag":67,"props":369,"children":371},{"className":370},[],[372],{"type":48,"value":373},"building.md",{"type":42,"tag":59,"props":375,"children":376},{},[377],{"type":48,"value":202},{"type":48,"value":379}," writing TS\u002FJS code that constructs a PTB with ",{"type":42,"tag":67,"props":381,"children":383},{"className":382},[],[384],{"type":48,"value":385},"@mysten\u002Fsui\u002Ftransactions",{"type":48,"value":387},", configuring gas, building for wallets, serializing across services, or sending PTBs between app ↔ wallet ↔ sponsor.\n",{"type":42,"tag":59,"props":389,"children":390},{},[391],{"type":48,"value":239},{"type":48,"value":191},{"type":42,"tag":67,"props":394,"children":396},{"className":395},[],[397],{"type":48,"value":357},{"type":48,"value":399}," API (",{"type":42,"tag":67,"props":401,"children":403},{"className":402},[],[404],{"type":48,"value":405},"tx.moveCall",{"type":48,"value":212},{"type":42,"tag":67,"props":408,"children":410},{"className":409},[],[411],{"type":48,"value":412},"tx.splitCoins",{"type":48,"value":212},{"type":42,"tag":67,"props":415,"children":417},{"className":416},[],[418],{"type":48,"value":419},"tx.mergeCoins",{"type":48,"value":212},{"type":42,"tag":67,"props":422,"children":424},{"className":423},[],[425],{"type":48,"value":426},"tx.transferObjects",{"type":48,"value":212},{"type":42,"tag":67,"props":429,"children":431},{"className":430},[],[432],{"type":48,"value":433},"tx.makeMoveVec",{"type":48,"value":212},{"type":42,"tag":67,"props":436,"children":438},{"className":437},[],[439],{"type":48,"value":440},"tx.publish",{"type":48,"value":212},{"type":42,"tag":67,"props":443,"children":445},{"className":444},[],[446],{"type":48,"value":447},"tx.upgrade",{"type":48,"value":212},{"type":42,"tag":67,"props":450,"children":452},{"className":451},[],[453],{"type":48,"value":454},"tx.balance",{"type":48,"value":212},{"type":42,"tag":67,"props":457,"children":459},{"className":458},[],[460],{"type":48,"value":461},"tx.coin",{"type":48,"value":212},{"type":42,"tag":67,"props":464,"children":466},{"className":465},[],[467],{"type":48,"value":468},"tx.add",{"type":48,"value":212},{"type":42,"tag":67,"props":471,"children":473},{"className":472},[],[474],{"type":48,"value":475},"tx.object",{"type":48,"value":212},{"type":42,"tag":67,"props":478,"children":480},{"className":479},[],[481],{"type":48,"value":482},"tx.pure",{"type":48,"value":212},{"type":42,"tag":67,"props":485,"children":487},{"className":486},[],[488],{"type":48,"value":489},"tx.gas",{"type":48,"value":212},{"type":42,"tag":67,"props":492,"children":494},{"className":493},[],[495],{"type":48,"value":496},"tx.setSender\u002FsetGasPrice\u002FsetGasBudget\u002FsetGasPayment\u002FsetGasOwner",{"type":48,"value":498},"), ",{"type":42,"tag":67,"props":500,"children":502},{"className":501},[],[503],{"type":48,"value":504},"Inputs.*Ref",{"type":48,"value":506}," helpers, result destructuring, ",{"type":42,"tag":67,"props":508,"children":510},{"className":509},[],[511],{"type":48,"value":512},"build({ onlyTransactionKind: true })",{"type":48,"value":212},{"type":42,"tag":67,"props":515,"children":517},{"className":516},[],[518],{"type":48,"value":519},"Transaction.from",{"type":48,"value":521}," \u002F ",{"type":42,"tag":67,"props":523,"children":525},{"className":524},[],[526],{"type":48,"value":527},"fromKind",{"type":48,"value":529},", sponsored transaction flow, signing & executing.",{"type":42,"tag":176,"props":531,"children":533},{"id":532},"cli-building-ptbs-from-the-cli",[534],{"type":48,"value":535},"cli — Building PTBs from the CLI",{"type":42,"tag":55,"props":537,"children":538},{},[539,543,544,550,554,556,561,563,567,568,573],{"type":42,"tag":59,"props":540,"children":541},{},[542],{"type":48,"value":189},{"type":48,"value":191},{"type":42,"tag":67,"props":545,"children":547},{"className":546},[],[548],{"type":48,"value":549},"cli.md",{"type":42,"tag":59,"props":551,"children":552},{},[553],{"type":48,"value":202},{"type":48,"value":555}," constructing PTBs from the command line using ",{"type":42,"tag":67,"props":557,"children":559},{"className":558},[],[560],{"type":48,"value":156},{"type":48,"value":562},", scripting transactions without TypeScript, merging coins from the CLI, or teaching CLI-based workflows.\n",{"type":42,"tag":59,"props":564,"children":565},{},[566],{"type":48,"value":239},{"type":48,"value":191},{"type":42,"tag":67,"props":569,"children":571},{"className":570},[],[572],{"type":48,"value":156},{"type":48,"value":574}," syntax, chaining commands, common CLI PTB patterns (transfers, coin merges, Move calls), gas budget, previewing before execution.",{"type":42,"tag":176,"props":576,"children":578},{"id":577},"troubleshooting-common-errors",[579],{"type":48,"value":580},"troubleshooting — Common errors",{"type":42,"tag":55,"props":582,"children":583},{},[584,588,589,595,599,601,607,608,614,615,621,622,628,629,635,637,641],{"type":42,"tag":59,"props":585,"children":586},{},[587],{"type":48,"value":189},{"type":48,"value":191},{"type":42,"tag":67,"props":590,"children":592},{"className":591},[],[593],{"type":48,"value":594},"troubleshooting.md",{"type":42,"tag":59,"props":596,"children":597},{},[598],{"type":48,"value":202},{"type":48,"value":600}," diagnosing a failing PTB — any ",{"type":42,"tag":67,"props":602,"children":604},{"className":603},[],[605],{"type":48,"value":606},"ServerError",{"type":48,"value":212},{"type":42,"tag":67,"props":609,"children":611},{"className":610},[],[612],{"type":48,"value":613},"UnusedValueWithoutDrop",{"type":48,"value":212},{"type":42,"tag":67,"props":616,"children":618},{"className":617},[],[619],{"type":48,"value":620},"VMVerificationOrDeserializationError",{"type":48,"value":212},{"type":42,"tag":67,"props":623,"children":625},{"className":624},[],[626],{"type":48,"value":627},"No valid gas coins",{"type":48,"value":212},{"type":42,"tag":67,"props":630,"children":632},{"className":631},[],[633],{"type":48,"value":634},"InsufficientGas",{"type":48,"value":636},", shared-object congestion, or cryptic \"transaction failed\" output.\n",{"type":42,"tag":59,"props":638,"children":639},{},[640],{"type":48,"value":239},{"type":48,"value":642}," each error category with the Move\u002FPTB-level cause and concrete fix.",{"type":42,"tag":169,"props":644,"children":646},{"id":645},"routing-guide",[647],{"type":48,"value":648},"Routing guide",{"type":42,"tag":650,"props":651,"children":652},"table",{},[653,672],{"type":42,"tag":654,"props":655,"children":656},"thead",{},[657],{"type":42,"tag":658,"props":659,"children":660},"tr",{},[661,667],{"type":42,"tag":662,"props":663,"children":664},"th",{},[665],{"type":48,"value":666},"Task",{"type":42,"tag":662,"props":668,"children":669},{},[670],{"type":48,"value":671},"Load",{"type":42,"tag":673,"props":674,"children":675},"tbody",{},[676,690,703,716,729,742,755,768,780,792,805],{"type":42,"tag":658,"props":677,"children":678},{},[679,685],{"type":42,"tag":680,"props":681,"children":682},"td",{},[683],{"type":48,"value":684},"\"What is a PTB?\" \u002F conceptual explanation",{"type":42,"tag":680,"props":686,"children":687},{},[688],{"type":48,"value":689},"fundamentals",{"type":42,"tag":658,"props":691,"children":692},{},[693,698],{"type":42,"tag":680,"props":694,"children":695},{},[696],{"type":48,"value":697},"Writing a new PTB in TypeScript",{"type":42,"tag":680,"props":699,"children":700},{},[701],{"type":48,"value":702},"building + commands",{"type":42,"tag":658,"props":704,"children":705},{},[706,711],{"type":42,"tag":680,"props":707,"children":708},{},[709],{"type":48,"value":710},"Writing a new PTB from the CLI",{"type":42,"tag":680,"props":712,"children":713},{},[714],{"type":48,"value":715},"cli + commands",{"type":42,"tag":658,"props":717,"children":718},{},[719,724],{"type":42,"tag":680,"props":720,"children":721},{},[722],{"type":48,"value":723},"Reviewing a PTB for correctness",{"type":42,"tag":680,"props":725,"children":726},{},[727],{"type":48,"value":728},"fundamentals + commands + building",{"type":42,"tag":658,"props":730,"children":731},{},[732,737],{"type":42,"tag":680,"props":733,"children":734},{},[735],{"type":48,"value":736},"A specific command fails type checking",{"type":42,"tag":680,"props":738,"children":739},{},[740],{"type":48,"value":741},"commands",{"type":42,"tag":658,"props":743,"children":744},{},[745,750],{"type":42,"tag":680,"props":746,"children":747},{},[748],{"type":48,"value":749},"Sponsored \u002F gasless transactions",{"type":42,"tag":680,"props":751,"children":752},{},[753],{"type":48,"value":754},"building",{"type":42,"tag":658,"props":756,"children":757},{},[758,763],{"type":42,"tag":680,"props":759,"children":760},{},[761],{"type":48,"value":762},"Debugging a failing PTB",{"type":42,"tag":680,"props":764,"children":765},{},[766],{"type":48,"value":767},"troubleshooting + (fundamentals if execution-semantics related)",{"type":42,"tag":658,"props":769,"children":770},{},[771,776],{"type":42,"tag":680,"props":772,"children":773},{},[774],{"type":48,"value":775},"Publishing or upgrading a package in a PTB",{"type":42,"tag":680,"props":777,"children":778},{},[779],{"type":48,"value":741},{"type":42,"tag":658,"props":781,"children":782},{},[783,788],{"type":42,"tag":680,"props":784,"children":785},{},[786],{"type":48,"value":787},"Building PTB bytes across services (app\u002Fwallet\u002Fsponsor)",{"type":42,"tag":680,"props":789,"children":790},{},[791],{"type":48,"value":754},{"type":42,"tag":658,"props":793,"children":794},{},[795,800],{"type":42,"tag":680,"props":796,"children":797},{},[798],{"type":48,"value":799},"Merging coins or simple operations from the CLI",{"type":42,"tag":680,"props":801,"children":802},{},[803],{"type":48,"value":804},"cli",{"type":42,"tag":658,"props":806,"children":807},{},[808,813],{"type":42,"tag":680,"props":809,"children":810},{},[811],{"type":48,"value":812},"Full code review",{"type":42,"tag":680,"props":814,"children":815},{},[816],{"type":42,"tag":59,"props":817,"children":818},{},[819],{"type":48,"value":820},"all reference files",{"type":42,"tag":169,"props":822,"children":824},{"id":823},"skill-content",[825],{"type":48,"value":826},"Skill Content",{"type":42,"tag":176,"props":828,"children":830},{"id":829},"key-concepts",[831],{"type":48,"value":832},"Key concepts",{"type":42,"tag":98,"props":834,"children":835},{},[836,854,913,946,956],{"type":42,"tag":102,"props":837,"children":838},{},[839,844,846,852],{"type":42,"tag":59,"props":840,"children":841},{},[842],{"type":48,"value":843},"A PTB is the transaction.",{"type":48,"value":845}," Every Sui transaction is a PTB — even a single ",{"type":42,"tag":67,"props":847,"children":849},{"className":848},[],[850],{"type":48,"value":851},"moveCall",{"type":48,"value":853}," is a one-command PTB. There is no non-PTB execution path.",{"type":42,"tag":102,"props":855,"children":856},{},[857,862,863,869,871,876,878,883,885,891,892,897,898,904,905,911],{"type":42,"tag":59,"props":858,"children":859},{},[860],{"type":48,"value":861},"Inputs vs commands.",{"type":48,"value":191},{"type":42,"tag":67,"props":864,"children":866},{"className":865},[],[867],{"type":48,"value":868},"inputs",{"type":48,"value":870}," are values fed in from outside (objects and BCS-encoded \"pure\" bytes). ",{"type":42,"tag":67,"props":872,"children":874},{"className":873},[],[875],{"type":48,"value":741},{"type":48,"value":877}," operate on those inputs and on each other's results. Commands reference values via the ",{"type":42,"tag":67,"props":879,"children":881},{"className":880},[],[882],{"type":48,"value":218},{"type":48,"value":884}," enum: ",{"type":42,"tag":67,"props":886,"children":888},{"className":887},[],[889],{"type":48,"value":890},"Input(i)",{"type":48,"value":212},{"type":42,"tag":67,"props":893,"children":895},{"className":894},[],[896],{"type":48,"value":232},{"type":48,"value":212},{"type":42,"tag":67,"props":899,"children":901},{"className":900},[],[902],{"type":48,"value":903},"Result(i)",{"type":48,"value":212},{"type":42,"tag":67,"props":906,"children":908},{"className":907},[],[909],{"type":48,"value":910},"NestedResult(cmd, result)",{"type":48,"value":912},".",{"type":42,"tag":102,"props":914,"children":915},{},[916,921,923,929,931,937,939,945],{"type":42,"tag":59,"props":917,"children":918},{},[919],{"type":48,"value":920},"Chaining.",{"type":48,"value":922}," Each command produces an array of results. The next command can consume any result (by ",{"type":42,"tag":67,"props":924,"children":926},{"className":925},[],[927],{"type":48,"value":928},"NestedResult(cmd, idx)",{"type":48,"value":930}," or, when a command has exactly one return, ",{"type":42,"tag":67,"props":932,"children":934},{"className":933},[],[935],{"type":48,"value":936},"Result(cmd)",{"type":48,"value":938},"). The TS SDK surfaces this as destructurable values: ",{"type":42,"tag":67,"props":940,"children":942},{"className":941},[],[943],{"type":48,"value":944},"const [coin] = tx.splitCoins(tx.gas, [tx.pure.u64(100)]);",{"type":48,"value":912},{"type":42,"tag":102,"props":947,"children":948},{},[949,954],{"type":42,"tag":59,"props":950,"children":951},{},[952],{"type":48,"value":953},"Atomicity.",{"type":48,"value":955}," Commands execute in order. Any failure reverts the entire block; no partial effects.",{"type":42,"tag":102,"props":957,"children":958},{},[959,964,966,972],{"type":42,"tag":59,"props":960,"children":961},{},[962],{"type":48,"value":963},"End-of-tx constraints.",{"type":48,"value":965}," Every non-",{"type":42,"tag":67,"props":967,"children":969},{"className":968},[],[970],{"type":48,"value":971},"drop",{"type":48,"value":973}," value produced during execution must be consumed (transferred, destroyed, or fed into another command). Shared objects have exactly two legal endings: re-share or delete — they cannot be transferred or frozen. Gas coin is returned to its owner with unused gas refunded.",{"type":42,"tag":176,"props":975,"children":977},{"id":976},"rules",[978],{"type":48,"value":979},"Rules",{"type":42,"tag":981,"props":982,"children":983},"ol",{},[984,1022,1054,1080,1134,1188,1206,1230,1255],{"type":42,"tag":102,"props":985,"children":986},{},[987,1004,1006,1012,1014,1020],{"type":42,"tag":59,"props":988,"children":989},{},[990,995,997,1003],{"type":42,"tag":67,"props":991,"children":993},{"className":992},[],[994],{"type":48,"value":489},{"type":48,"value":996}," must be used by reference, except in ",{"type":42,"tag":67,"props":998,"children":1000},{"className":999},[],[1001],{"type":48,"value":1002},"transferObjects",{"type":48,"value":912},{"type":48,"value":1005}," To get an owned ",{"type":42,"tag":67,"props":1007,"children":1009},{"className":1008},[],[1010],{"type":48,"value":1011},"Coin\u003CSUI>",{"type":48,"value":1013}," from the gas coin, use ",{"type":42,"tag":67,"props":1015,"children":1017},{"className":1016},[],[1018],{"type":48,"value":1019},"SplitCoins(tx.gas, [amount])",{"type":48,"value":1021}," first.",{"type":42,"tag":102,"props":1023,"children":1024},{},[1025,1030,1032,1038,1039,1045,1046,1052],{"type":42,"tag":59,"props":1026,"children":1027},{},[1028],{"type":48,"value":1029},"Leave gas config to the wallet when possible.",{"type":48,"value":1031}," Do not hardcode ",{"type":42,"tag":67,"props":1033,"children":1035},{"className":1034},[],[1036],{"type":48,"value":1037},"setGasBudget",{"type":48,"value":521},{"type":42,"tag":67,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":48,"value":1044},"setGasPrice",{"type":48,"value":521},{"type":42,"tag":67,"props":1047,"children":1049},{"className":1048},[],[1050],{"type":48,"value":1051},"setGasPayment",{"type":48,"value":1053}," in app code that will be signed by a user wallet — the wallet dry-runs and selects coins correctly. Only set them for backend-signed flows.",{"type":42,"tag":102,"props":1055,"children":1056},{},[1057,1078],{"type":42,"tag":59,"props":1058,"children":1059},{},[1060,1062,1068,1070,1076],{"type":48,"value":1061},"In app code that hands a PTB to a wallet, use ",{"type":42,"tag":67,"props":1063,"children":1065},{"className":1064},[],[1066],{"type":48,"value":1067},"await tx.toJSON()",{"type":48,"value":1069}," (not ",{"type":42,"tag":67,"props":1071,"children":1073},{"className":1072},[],[1074],{"type":48,"value":1075},"tx.build()",{"type":48,"value":1077},").",{"type":48,"value":1079}," The wallet must perform gas logic and coin selection itself; building bytes in app code preempts that.",{"type":42,"tag":102,"props":1081,"children":1082},{},[1083,1096,1098,1104,1106,1111,1113,1119,1120,1126,1127,1132],{"type":42,"tag":59,"props":1084,"children":1085},{},[1086,1088,1094],{"type":48,"value":1087},"Use ",{"type":42,"tag":67,"props":1089,"children":1091},{"className":1090},[],[1092],{"type":48,"value":1093},"Transaction.fromKind(kindBytes)",{"type":48,"value":1095}," for sponsored flows.",{"type":48,"value":1097}," Build in app with ",{"type":42,"tag":67,"props":1099,"children":1101},{"className":1100},[],[1102],{"type":48,"value":1103},"tx.build({ client, onlyTransactionKind: true })",{"type":48,"value":1105},", send the kind-only bytes to the sponsor service, rehydrate there with ",{"type":42,"tag":67,"props":1107,"children":1109},{"className":1108},[],[1110],{"type":48,"value":527},{"type":48,"value":1112},", then ",{"type":42,"tag":67,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":48,"value":1118},"setSender",{"type":48,"value":212},{"type":42,"tag":67,"props":1121,"children":1123},{"className":1122},[],[1124],{"type":48,"value":1125},"setGasOwner",{"type":48,"value":212},{"type":42,"tag":67,"props":1128,"children":1130},{"className":1129},[],[1131],{"type":48,"value":1051},{"type":48,"value":1133},". The user (or either party) should submit the fully-signed transaction directly to a full node — not back through the sponsor service — to avoid censorship.",{"type":42,"tag":102,"props":1135,"children":1136},{},[1137,1149,1151,1156,1158,1163,1165,1171,1173,1179,1181,1186],{"type":42,"tag":59,"props":1138,"children":1139},{},[1140,1142,1147],{"type":48,"value":1141},"Every non-",{"type":42,"tag":67,"props":1143,"children":1145},{"className":1144},[],[1146],{"type":48,"value":971},{"type":48,"value":1148}," value must be consumed.",{"type":48,"value":1150}," If ",{"type":42,"tag":67,"props":1152,"children":1154},{"className":1153},[],[1155],{"type":48,"value":851},{"type":48,"value":1157}," returns a value you don't need, pass it to ",{"type":42,"tag":67,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":48,"value":1002},{"type":48,"value":1164}," (if it has ",{"type":42,"tag":67,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":48,"value":1170},"key + store",{"type":48,"value":1172},"), to ",{"type":42,"tag":67,"props":1174,"children":1176},{"className":1175},[],[1177],{"type":48,"value":1178},"public_transfer",{"type":48,"value":1180},", or to a destructor. ",{"type":42,"tag":67,"props":1182,"children":1184},{"className":1183},[],[1185],{"type":48,"value":613},{"type":48,"value":1187}," is the PTB-level error.",{"type":42,"tag":102,"props":1189,"children":1190},{},[1191,1196,1198,1204],{"type":42,"tag":59,"props":1192,"children":1193},{},[1194],{"type":48,"value":1195},"Shared objects cannot be transferred, frozen, or consumed by value if passed as read-only",{"type":48,"value":1197}," (",{"type":42,"tag":67,"props":1199,"children":1201},{"className":1200},[],[1202],{"type":48,"value":1203},"mutable: false",{"type":48,"value":1205},"). If you need mutable access, mark them mutable when building the input.",{"type":42,"tag":102,"props":1207,"children":1208},{},[1209,1214,1215,1220,1222,1228],{"type":42,"tag":59,"props":1210,"children":1211},{},[1212],{"type":48,"value":1213},"Types coming from Move calls cannot be references.",{"type":48,"value":191},{"type":42,"tag":67,"props":1216,"children":1218},{"className":1217},[],[1219],{"type":48,"value":295},{"type":48,"value":1221}," results are values; if a Move function returns ",{"type":42,"tag":67,"props":1223,"children":1225},{"className":1224},[],[1226],{"type":48,"value":1227},"&T",{"type":48,"value":1229},", it cannot be called from a PTB.",{"type":42,"tag":102,"props":1231,"children":1232},{},[1233,1238,1239,1245,1247,1253],{"type":42,"tag":59,"props":1234,"children":1235},{},[1236],{"type":48,"value":1237},"For multi-return Move calls, use destructuring or array indexing.",{"type":48,"value":191},{"type":42,"tag":67,"props":1240,"children":1242},{"className":1241},[],[1243],{"type":48,"value":1244},"const [a, b] = tx.moveCall(...)",{"type":48,"value":1246}," or ",{"type":42,"tag":67,"props":1248,"children":1250},{"className":1249},[],[1251],{"type":48,"value":1252},"const r = tx.moveCall(...); r[0]; r[1];",{"type":48,"value":1254},". Do not assume single-return shape.",{"type":42,"tag":102,"props":1256,"children":1257},{},[1258,1263,1265,1271,1273,1279,1281,1287],{"type":42,"tag":59,"props":1259,"children":1260},{},[1261],{"type":48,"value":1262},"Cite the docs when unsure.",{"type":48,"value":1264}," Canonical sources above. Legacy ",{"type":42,"tag":67,"props":1266,"children":1268},{"className":1267},[],[1269],{"type":48,"value":1270},"\u002Fdevelop\u002Ftransactions\u002Fptbs\u002F*",{"type":48,"value":1272}," URLs still render but prefer ",{"type":42,"tag":67,"props":1274,"children":1276},{"className":1275},[],[1277],{"type":48,"value":1278},"\u002Fconcepts\u002Ftransactions\u002Fprog-txn-blocks",{"type":48,"value":1280}," and ",{"type":42,"tag":67,"props":1282,"children":1284},{"className":1283},[],[1285],{"type":48,"value":1286},"\u002Fguides\u002Fdeveloper\u002Fsui-101\u002Fbuilding-ptb",{"type":48,"value":912},{"type":42,"tag":176,"props":1289,"children":1291},{"id":1290},"common-mistakes",[1292],{"type":48,"value":1293},"Common mistakes",{"type":42,"tag":98,"props":1295,"children":1296},{},[1297,1344,1376,1409,1433,1450,1497,1507,1525],{"type":42,"tag":102,"props":1298,"children":1299},{},[1300,1313,1315,1321,1322,1328,1329,1335,1337,1343],{"type":42,"tag":59,"props":1301,"children":1302},{},[1303,1305,1311],{"type":48,"value":1304},"Calling ",{"type":42,"tag":67,"props":1306,"children":1308},{"className":1307},[],[1309],{"type":48,"value":1310},"tx.pure(value)",{"type":48,"value":1312}," without a type.",{"type":48,"value":1314}," Untyped pure values fail at input resolution. Use typed helpers: ",{"type":42,"tag":67,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":48,"value":1320},"tx.pure.u64(n)",{"type":48,"value":212},{"type":42,"tag":67,"props":1323,"children":1325},{"className":1324},[],[1326],{"type":48,"value":1327},"tx.pure.address(addr)",{"type":48,"value":212},{"type":42,"tag":67,"props":1330,"children":1332},{"className":1331},[],[1333],{"type":48,"value":1334},"tx.pure.string(s)",{"type":48,"value":1336},", or the generic ",{"type":42,"tag":67,"props":1338,"children":1340},{"className":1339},[],[1341],{"type":48,"value":1342},"tx.pure('u64', n)",{"type":48,"value":912},{"type":42,"tag":102,"props":1345,"children":1346},{},[1347,1366,1368,1374],{"type":42,"tag":59,"props":1348,"children":1349},{},[1350,1352,1357,1359,1365],{"type":48,"value":1351},"Passing a string object ID to ",{"type":42,"tag":67,"props":1353,"children":1355},{"className":1354},[],[1356],{"type":48,"value":851},{"type":48,"value":1358}," arguments without ",{"type":42,"tag":67,"props":1360,"children":1362},{"className":1361},[],[1363],{"type":48,"value":1364},"tx.object(...)",{"type":48,"value":912},{"type":48,"value":1367}," Mixed-type arguments require explicit ",{"type":42,"tag":67,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":48,"value":1373},"tx.object(id)",{"type":48,"value":1375}," wrapping; otherwise the SDK can't distinguish pure from object.",{"type":42,"tag":102,"props":1377,"children":1378},{},[1379,1384,1386,1392,1394,1399,1401,1407],{"type":42,"tag":59,"props":1380,"children":1381},{},[1382],{"type":48,"value":1383},"Transferring or freezing a shared object.",{"type":48,"value":1385}," Shared objects cannot be transferred or frozen — but they ",{"type":42,"tag":1387,"props":1388,"children":1389},"em",{},[1390],{"type":48,"value":1391},"can",{"type":48,"value":1393}," be deleted. The two legal endings for a shared object in a PTB are re-share or delete. Do not include shared objects in ",{"type":42,"tag":67,"props":1395,"children":1397},{"className":1396},[],[1398],{"type":48,"value":1002},{"type":48,"value":1400},". Note that consuming a shared object by value permanently marks its hot-potato clique as \"hot\", which blocks subsequent non-public ",{"type":42,"tag":67,"props":1402,"children":1404},{"className":1403},[],[1405],{"type":48,"value":1406},"entry",{"type":48,"value":1408}," calls on any entangled value in that clique.",{"type":42,"tag":102,"props":1410,"children":1411},{},[1412,1424,1426,1431],{"type":42,"tag":59,"props":1413,"children":1414},{},[1415,1417,1422],{"type":48,"value":1416},"Forgetting to ",{"type":42,"tag":67,"props":1418,"children":1420},{"className":1419},[],[1421],{"type":48,"value":1118},{"type":48,"value":1423}," on offline builds.",{"type":48,"value":1425}," When calling ",{"type":42,"tag":67,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":48,"value":1075},{"type":48,"value":1432}," without signing through a signer that sets the sender, the sender field stays empty and the build fails.",{"type":42,"tag":102,"props":1434,"children":1435},{},[1436,1448],{"type":42,"tag":59,"props":1437,"children":1438},{},[1439,1441,1446],{"type":48,"value":1440},"Treating multi-return ",{"type":42,"tag":67,"props":1442,"children":1444},{"className":1443},[],[1445],{"type":48,"value":851},{"type":48,"value":1447}," results as single values.",{"type":48,"value":1449}," The return is a vector; index or destructure.",{"type":42,"tag":102,"props":1451,"children":1452},{},[1453,1473,1475,1481,1482,1488,1490,1496],{"type":42,"tag":59,"props":1454,"children":1455},{},[1456,1458,1464,1465,1471],{"type":48,"value":1457},"Using ",{"type":42,"tag":67,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":48,"value":1463},"transfer::transfer",{"type":48,"value":521},{"type":42,"tag":67,"props":1466,"children":1468},{"className":1467},[],[1469],{"type":48,"value":1470},"transfer::share_object",{"type":48,"value":1472}," on generic types from a PTB.",{"type":48,"value":1474}," Those entries require a module-private type param. From a PTB, use ",{"type":42,"tag":67,"props":1476,"children":1478},{"className":1477},[],[1479],{"type":48,"value":1480},"transfer::public_transfer",{"type":48,"value":521},{"type":42,"tag":67,"props":1483,"children":1485},{"className":1484},[],[1486],{"type":48,"value":1487},"transfer::public_share_object",{"type":48,"value":1489},", which require the type to have ",{"type":42,"tag":67,"props":1491,"children":1493},{"className":1492},[],[1494],{"type":48,"value":1495},"store",{"type":48,"value":912},{"type":42,"tag":102,"props":1498,"children":1499},{},[1500,1505],{"type":42,"tag":59,"props":1501,"children":1502},{},[1503],{"type":48,"value":1504},"Setting a gas budget that's too tight.",{"type":48,"value":1506}," A tx that exceeds budget aborts but still charges the gas coin. Prefer the SDK's dry-run-based auto-budget.",{"type":42,"tag":102,"props":1508,"children":1509},{},[1510,1515,1517,1523],{"type":42,"tag":59,"props":1511,"children":1512},{},[1513],{"type":48,"value":1514},"Not checking execution status.",{"type":48,"value":1516}," A transaction can be accepted by validators but fail at the Move level (assertion, out of gas, etc.). Always check ",{"type":42,"tag":67,"props":1518,"children":1520},{"className":1519},[],[1521],{"type":48,"value":1522},"result.$kind !== 'FailedTransaction'",{"type":48,"value":1524}," before treating an operation as successful. The tx digest alone does not mean the effects were applied.",{"type":42,"tag":102,"props":1526,"children":1527},{},[1528,1533],{"type":42,"tag":59,"props":1529,"children":1530},{},[1531],{"type":48,"value":1532},"Looping in app code to submit N individual transactions.",{"type":48,"value":1534}," Batch into one PTB (up to 1,024 ops). One PTB is cheaper and atomic.",{"items":1536,"total":1707},[1537,1553,1564,1574,1589,1607,1621,1634,1655,1667,1678,1694],{"slug":1538,"name":1538,"fn":1539,"description":1540,"org":1541,"tags":1542,"stars":1550,"repoUrl":1551,"updatedAt":1552},"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},[1543,1546,1549],{"name":1544,"slug":1545,"type":16},"Code Analysis","code-analysis",{"name":1547,"slug":1548,"type":16},"Engineering","engineering",{"name":18,"slug":8,"type":16},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":1554,"name":1554,"fn":1555,"description":1556,"org":1557,"tags":1558,"stars":1550,"repoUrl":1551,"updatedAt":1563},"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},[1559,1562],{"name":1560,"slug":1561,"type":16},"Documentation","documentation",{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.641382",{"slug":1565,"name":1565,"fn":1566,"description":1567,"org":1568,"tags":1569,"stars":1550,"repoUrl":1551,"updatedAt":1573},"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},[1570,1571,1572],{"name":1544,"slug":1545,"type":16},{"name":1547,"slug":1548,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:25.3633",{"slug":1575,"name":1575,"fn":1576,"description":1577,"org":1578,"tags":1579,"stars":1550,"repoUrl":1551,"updatedAt":1588},"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},[1580,1583,1586,1587],{"name":1581,"slug":1582,"type":16},"Code Review","code-review",{"name":1584,"slug":1585,"type":16},"Security","security",{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:55.691149",{"slug":1590,"name":1590,"fn":1591,"description":1592,"org":1593,"tags":1594,"stars":1604,"repoUrl":1605,"updatedAt":1606},"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},[1595,1598,1601],{"name":1596,"slug":1597,"type":16},"Agents","agents",{"name":1599,"slug":1600,"type":16},"Memory","memory",{"name":1602,"slug":1603,"type":16},"SDK","sdk",57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-07-16T06:02:39.838395",{"slug":1608,"name":1608,"fn":1609,"description":1610,"org":1611,"tags":1612,"stars":25,"repoUrl":26,"updatedAt":1620},"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},[1613,1616,1617],{"name":1614,"slug":1615,"type":16},"Data Analysis","data-analysis",{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},"Web3","web3","2026-08-01T05:44:32.775598",{"slug":1622,"name":1622,"fn":1623,"description":1624,"org":1625,"tags":1626,"stars":25,"repoUrl":26,"updatedAt":1633},"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},[1627,1630,1631,1632],{"name":1628,"slug":1629,"type":16},"API Development","api-development",{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},"2026-07-16T06:02:49.198495",{"slug":1635,"name":1635,"fn":1636,"description":1637,"org":1638,"tags":1639,"stars":25,"repoUrl":26,"updatedAt":1654},"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},[1640,1643,1646,1647,1650,1653],{"name":1641,"slug":1642,"type":16},"Frontend","frontend",{"name":1644,"slug":1645,"type":16},"React","react",{"name":18,"slug":8,"type":16},{"name":1648,"slug":1649,"type":16},"Svelte","svelte",{"name":1651,"slug":1652,"type":16},"Vue","vue",{"name":1618,"slug":1619,"type":16},"2026-08-01T05:44:28.958473",{"slug":1656,"name":1656,"fn":1657,"description":1658,"org":1659,"tags":1660,"stars":25,"repoUrl":26,"updatedAt":1666},"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},[1661,1664,1665],{"name":1662,"slug":1663,"type":16},"Configuration","configuration",{"name":1560,"slug":1561,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.981056",{"slug":1668,"name":1668,"fn":1669,"description":1670,"org":1671,"tags":1672,"stars":25,"repoUrl":26,"updatedAt":1677},"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},[1673,1674,1675,1676],{"name":1547,"slug":1548,"type":16},{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},"2026-07-16T06:02:43.277596",{"slug":1679,"name":1679,"fn":1680,"description":1681,"org":1682,"tags":1683,"stars":25,"repoUrl":26,"updatedAt":1693},"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},[1684,1687,1688,1689,1692],{"name":1685,"slug":1686,"type":16},"QA","qa",{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1690,"slug":1691,"type":16},"Testing","testing",{"name":1618,"slug":1619,"type":16},"2026-08-01T05:44:30.788585",{"slug":1695,"name":1695,"fn":1696,"description":1697,"org":1698,"tags":1699,"stars":25,"repoUrl":26,"updatedAt":1706},"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},[1700,1703,1704,1705],{"name":1701,"slug":1702,"type":16},"Best Practices","best-practices",{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},"2026-07-16T06:02:48.830052",37,{"items":1709,"total":1760},[1710,1716,1723,1732,1738,1745,1753],{"slug":1608,"name":1608,"fn":1609,"description":1610,"org":1711,"tags":1712,"stars":25,"repoUrl":26,"updatedAt":1620},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1713,1714,1715],{"name":1614,"slug":1615,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},{"slug":1622,"name":1622,"fn":1623,"description":1624,"org":1717,"tags":1718,"stars":25,"repoUrl":26,"updatedAt":1633},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1719,1720,1721,1722],{"name":1628,"slug":1629,"type":16},{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},{"slug":1635,"name":1635,"fn":1636,"description":1637,"org":1724,"tags":1725,"stars":25,"repoUrl":26,"updatedAt":1654},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1726,1727,1728,1729,1730,1731],{"name":1641,"slug":1642,"type":16},{"name":1644,"slug":1645,"type":16},{"name":18,"slug":8,"type":16},{"name":1648,"slug":1649,"type":16},{"name":1651,"slug":1652,"type":16},{"name":1618,"slug":1619,"type":16},{"slug":1656,"name":1656,"fn":1657,"description":1658,"org":1733,"tags":1734,"stars":25,"repoUrl":26,"updatedAt":1666},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1735,1736,1737],{"name":1662,"slug":1663,"type":16},{"name":1560,"slug":1561,"type":16},{"name":18,"slug":8,"type":16},{"slug":1668,"name":1668,"fn":1669,"description":1670,"org":1739,"tags":1740,"stars":25,"repoUrl":26,"updatedAt":1677},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1741,1742,1743,1744],{"name":1547,"slug":1548,"type":16},{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},{"slug":1679,"name":1679,"fn":1680,"description":1681,"org":1746,"tags":1747,"stars":25,"repoUrl":26,"updatedAt":1693},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1748,1749,1750,1751,1752],{"name":1685,"slug":1686,"type":16},{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1690,"slug":1691,"type":16},{"name":1618,"slug":1619,"type":16},{"slug":1695,"name":1695,"fn":1696,"description":1697,"org":1754,"tags":1755,"stars":25,"repoUrl":26,"updatedAt":1706},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1756,1757,1758,1759],{"name":1701,"slug":1702,"type":16},{"name":23,"slug":24,"type":16},{"name":18,"slug":8,"type":16},{"name":1618,"slug":1619,"type":16},20]