[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-sui-object-model":3,"mdc--4zqdfn-key":33,"related-repo-sui-sui-object-model":1595,"related-org-sui-sui-object-model":1702},{"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},"sui-object-model","reference Sui object model patterns","Deep reference for the Sui object model: ownership types, object abilities, dynamic fields, collections, versioning, transfer patterns, and derived objects. Use this skill whenever the user asks about Sui objects, object ownership (address-owned, shared, immutable, wrapped), how to transfer or share or freeze objects, dynamic fields vs dynamic object fields, Table vs Bag vs VecMap, object versioning, wrapping and unwrapping, the Receiving type, custom transfer rules, hot potato pattern, capability pattern, object deletion, Object Display, or how to model data (inventories, registries, nested items) in Sui Move. Also use when the user needs to choose between ownership types or storage patterns for their use case.\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],{"name":14,"slug":15,"type":16},"Blockchain","blockchain","tag",{"name":18,"slug":8,"type":16},"Sui",{"name":20,"slug":21,"type":16},"Web3","web3",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-07-16T06:00:55.712847",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\u002Fobject-model","---\nname: sui-object-model\ndescription: >\n  Deep reference for the Sui object model: ownership types, object abilities,\n  dynamic fields, collections, versioning, transfer patterns, and derived objects.\n  Use this skill whenever the user asks about Sui objects, object ownership\n  (address-owned, shared, immutable, wrapped), how to transfer or share or freeze\n  objects, dynamic fields vs dynamic object fields, Table vs Bag vs VecMap,\n  object versioning, wrapping and unwrapping, the Receiving type, custom transfer\n  rules, hot potato pattern, capability pattern, object deletion, Object Display,\n  or how to model data (inventories, registries, nested items) in Sui Move. Also\n  use when the user needs to choose between ownership types or storage patterns\n  for their use case.\n---\n\n# Sui Object Model\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> **Source constraint:** All information in this skill is sourced exclusively from [docs.sui.io](https:\u002F\u002Fdocs.sui.io) and [move-book.com](https:\u002F\u002Fmove-book.com). When extending or updating this skill, only pull from these two sources. Do not use third-party blogs, tutorials, or unofficial documentation.\n\nObjects are the fundamental unit of storage on Sui. Every resource, asset, and piece of data onchain is an object. Unlike account-based blockchains where state lives in shared mappings inside contracts, Sui gives each piece of state its own identity, version, and owner. Transactions consume objects as inputs and produce modified versions as outputs.\n\nThis skill routes to focused reference files. Load only the ones relevant to the current task.\n\n---\n\n## Reference files\n\n### ownership — Ownership Types and Versioning\n**Path:** `ownership.md`\n**Load when:** asking about ownership types (address-owned, consensus-address-owned, shared, immutable, wrapped), choosing between shared and owned, parallel execution, consensus, Mysticeti, fastpath, object versioning, Lamport timestamps, or frontend access to shared objects.\n**Covers:** all five ownership types with consensus implications, consensus-address-owned objects, shared object access mode optimization, frontend PTB access pattern, wrapped object behavior, Lamport timestamp versioning, fastpath vs consensus versioning.\n\n### transfers — Transferring and Deleting Objects\n**Path:** `transfers.md`\n**Load when:** transferring objects, choosing between `transfer` and `public_transfer`, implementing custom transfer rules, using `Receiving\u003CT>`, transfer-to-object, or deleting\u002Fdestroying objects.\n**Covers:** eight core transfer functions (module-restricted vs public, including party_transfer variants), custom transfer rules, transfer-to-object with `Receiving\u003CT>`, `receive` vs `public_receive`, object deletion\u002Funpacking pattern, dynamic field cleanup warning.\n\n### dynamic-fields-and-collections — Dynamic Fields and Collections\n**Path:** `dynamic-fields-and-collections.md`\n**Load when:** using dynamic fields, choosing between `dynamic_field` and `dynamic_object_field`, working with collections (`Table`, `Bag`, `VecMap`, `LinkedTable`), or designing storage for large datasets.\n**Covers:** dynamic field vs dynamic object field visibility, field naming, core API (add\u002Fborrow\u002Fremove\u002Fexists_), all collection types with decision table, cleanup requirements, system limits (256 KB object size, 2048 objects\u002Ftxn).\n\n### patterns — Common Patterns and Derived Objects\n**Path:** `patterns.md`\n**Load when:** implementing hot potato, capability, soulbound, inventory, or borrow patterns, or working with derived objects.\n**Covers:** hot potato pattern (no-ability structs), capability pattern (AdminCap\u002FTreasuryCap), borrow pattern with `sui::borrow` module, soulbound objects, inventory pattern (ObjectBag), derived objects with deterministic IDs, derived objects vs dynamic fields comparison.\n\n### display — Object Display (V2)\n**Path:** `display.md`\n**Load when:** setting up how objects render in wallets, explorers, or apps, working with Display templates, configuring NFT metadata, or migrating from Display V1.\n**Covers:** V2 `Display\u003CT>` creation via `display_registry::new_with_publisher`, `DisplayCap\u003CT>` for updates, `set`\u002F`unset`\u002F`clear`\u002F`share` API, `{field_name}` template syntax with nested field access, common display properties, V1 to V2 migration.\n\n---\n\n## Routing guide\n\n| Task | Load |\n|------|------|\n| What is an object \u002F object structure | SKILL.md only |\n| Abilities: key, store, copy, drop | SKILL.md only |\n| Ownership types, shared vs owned vs consensus-address-owned | ownership |\n| Parallel execution, consensus, fastpath | ownership |\n| Object versioning, Lamport timestamps | ownership |\n| Wrapped objects and accessibility | ownership |\n| Frontend access to shared objects | ownership |\n| Transferring objects, transfer vs public_transfer | transfers |\n| Custom transfer rules | transfers + patterns |\n| Transfer to object, Receiving | transfers |\n| Deleting \u002F destroying objects | transfers |\n| Dynamic fields, dynamic object fields | dynamic-fields-and-collections |\n| Collections: Table, Bag, VecMap, LinkedTable | dynamic-fields-and-collections |\n| Scalability, large collection design | dynamic-fields-and-collections |\n| Hot potato pattern | patterns |\n| Capability pattern, AdminCap | patterns |\n| Borrow pattern, cap inside object | patterns |\n| Soulbound \u002F non-transferable objects | transfers + patterns |\n| Inventory for arbitrary objects | patterns + dynamic-fields-and-collections |\n| Derived objects | patterns |\n| Object Display, NFT rendering | display |\n| Full project \u002F code review | **all reference files** |\n\n---\n\n## Object structure\n\nEvery Sui object contains four components:\n\n- **Globally unique ID:** A 32-byte identifier derived from the creation transaction digest plus a generation counter. The ID never changes across the object's lifetime.\n- **Version number:** An 8-byte integer that increments with each modification. Uses Lamport timestamps: the new version for all objects a transaction touches is `1 + max(version of all input objects)`.\n- **Owner field:** A 32-byte value designating access control (an address, another object's ID, or a sentinel for shared\u002Fimmutable).\n- **Transaction digest:** A 32-byte hash referencing the last transaction that modified the object.\n\nObjects can be referenced three ways: by ID alone (query current state), by versioned ID (read historical state), or by full object reference containing ID + version + digest (transaction inputs, authenticated snapshot).\n\n## Defining objects in Move\n\nA Sui object is a Move struct with the `key` ability and an `id: UID` as the first field:\n\n```move\npublic struct Sword has key, store {\n    id: UID,\n    damage: u64,\n    element: String,\n}\n```\n\n`object::new(ctx)` is the only way to create a `UID`. You cannot call `ctx.new()` directly.\n\n## Move abilities and objects\n\n| Ability | What it controls |\n|---|---|\n| `key` | The struct is a Sui object. Must have `id: UID` as first field. Required for all onchain objects. |\n| `store` | The struct can be stored inside other objects, and transferred by any module using `public_transfer`. Without it, only the defining module can transfer the object. Adding `store` permanently removes the ability to enforce custom transfer rules. |\n| `copy` | The struct can be duplicated. **Cannot be used on objects** — `UID` lacks `copy`, so any struct with `key` cannot have `copy`. Used only on non-object structs (configs, event data, read-only values). |\n| `drop` | The struct can be silently discarded at end of scope. **Cannot be used on objects** — `UID` lacks `drop`, so any struct with `key` cannot have `drop`. Used only on non-object structs (ephemeral receipts, events). Objects must always be explicitly unpacked to destroy. |\n\n### Object ability combinations\n\nBecause `UID` has neither `copy` nor `drop`, objects (structs with `key`) can only combine `key` and `store`:\n\n- **`has key`:** Only the defining module can transfer, share, or freeze. Use for custom transfer rules.\n- **`has key, store`:** Any module can transfer, share, freeze, or wrap. Use for freely composable assets. Once `store` is granted, you cannot re-add custom transfer restrictions.\n\n### Non-object struct combinations (no `key`)\n\n- **`has store`:** Can be stored as a field inside an object. Cannot exist independently.\n- **`has copy, drop`:** A plain data struct for events, intermediate values, and configs.\n- **`has copy, drop, store`:** Can be used as dynamic field names.\n- **No abilities:** A hot potato. Must be consumed in the same transaction. See patterns reference file.\n\n## Rules\n\n- `object::new(ctx)` is the only way to create a UID. The `id: UID` field must be first.\n- Once `store` is added to a type, custom transfer rules are permanently disabled.\n- Once an object is shared, it cannot be converted back to address-owned.\n- Always remove all dynamic fields before deleting a parent object — orphaned fields become permanently inaccessible.\n- Accessing a nonexistent dynamic field (via `borrow`, `borrow_mut`, or `remove`) aborts the transaction. Use `exists_` to check first.\n- Wrapping and unwrapping can happen within the same transaction — a PTB can wrap an object and later unwrap it atomically.\n- Common capabilities: `AdminCap`, `TreasuryCap`, `UpgradeCap`. Always mention all three when discussing the capability pattern.\n- Each `Table` entry is a separate storage operation — gas cost scales linearly with entries accessed per transaction.\n- Prefer immutable references (`&`) on shared objects to maximize parallel execution.\n- Do not use `VecMap` for collections larger than ~100 entries. Use `Table` instead.\n\n## Common mistakes\n\n- **Adding `store` when you need custom transfer rules.** Once granted, any module can call `public_transfer` and your enforcement logic is bypassed permanently.\n- **Using `VecMap` for large collections.** It has O(n) lookup and is stored inline, hitting the 256 KB object size limit quickly.\n- **Confusing `dynamic_field` with `dynamic_object_field`.** Use `dynamic_object_field` when the child must remain queryable by ID in explorers. Use `dynamic_field` for plain values.\n- **Deleting an object without removing its dynamic fields first.** Those fields become permanently inaccessible.\n- **Using the legacy `sui::display` module for new code.** Use `sui::display_registry` (Display V2). V1 was migrated to V2 via a system snapshot migration.\n- **Forgetting to `display_registry::share(display)` after setting fields.** The display must be shared to be discoverable.\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,46,71,104,109,114,118,125,132,162,168,240,246,316,322,356,362,449,452,458,762,765,771,776,829,834,840,861,918,945,951,1126,1132,1178,1218,1231,1289,1295,1449,1455,1589],{"type":39,"tag":40,"props":41,"children":42},"element","h1",{"id":4},[43],{"type":44,"value":45},"text","Sui Object Model",{"type":39,"tag":47,"props":48,"children":49},"blockquote",{},[50],{"type":39,"tag":51,"props":52,"children":53},"p",{},[54,60,62,69],{"type":39,"tag":55,"props":56,"children":57},"strong",{},[58],{"type":44,"value":59},"MCP tool:",{"type":44,"value":61}," When available in your environment, also query the Sui documentation MCP server (",{"type":39,"tag":63,"props":64,"children":66},"code",{"className":65},[],[67],{"type":44,"value":68},"https:\u002F\u002Fsui.mcp.kapa.ai",{"type":44,"value":70},") for up-to-date answers. Use it for verification and for details not covered by these reference files.",{"type":39,"tag":47,"props":72,"children":73},{},[74],{"type":39,"tag":51,"props":75,"children":76},{},[77,82,84,93,95,102],{"type":39,"tag":55,"props":78,"children":79},{},[80],{"type":44,"value":81},"Source constraint:",{"type":44,"value":83}," All information in this skill is sourced exclusively from ",{"type":39,"tag":85,"props":86,"children":90},"a",{"href":87,"rel":88},"https:\u002F\u002Fdocs.sui.io",[89],"nofollow",[91],{"type":44,"value":92},"docs.sui.io",{"type":44,"value":94}," and ",{"type":39,"tag":85,"props":96,"children":99},{"href":97,"rel":98},"https:\u002F\u002Fmove-book.com",[89],[100],{"type":44,"value":101},"move-book.com",{"type":44,"value":103},". When extending or updating this skill, only pull from these two sources. Do not use third-party blogs, tutorials, or unofficial documentation.",{"type":39,"tag":51,"props":105,"children":106},{},[107],{"type":44,"value":108},"Objects are the fundamental unit of storage on Sui. Every resource, asset, and piece of data onchain is an object. Unlike account-based blockchains where state lives in shared mappings inside contracts, Sui gives each piece of state its own identity, version, and owner. Transactions consume objects as inputs and produce modified versions as outputs.",{"type":39,"tag":51,"props":110,"children":111},{},[112],{"type":44,"value":113},"This skill routes to focused reference files. Load only the ones relevant to the current task.",{"type":39,"tag":115,"props":116,"children":117},"hr",{},[],{"type":39,"tag":119,"props":120,"children":122},"h2",{"id":121},"reference-files",[123],{"type":44,"value":124},"Reference files",{"type":39,"tag":126,"props":127,"children":129},"h3",{"id":128},"ownership-ownership-types-and-versioning",[130],{"type":44,"value":131},"ownership — Ownership Types and Versioning",{"type":39,"tag":51,"props":133,"children":134},{},[135,140,142,148,153,155,160],{"type":39,"tag":55,"props":136,"children":137},{},[138],{"type":44,"value":139},"Path:",{"type":44,"value":141}," ",{"type":39,"tag":63,"props":143,"children":145},{"className":144},[],[146],{"type":44,"value":147},"ownership.md",{"type":39,"tag":55,"props":149,"children":150},{},[151],{"type":44,"value":152},"Load when:",{"type":44,"value":154}," asking about ownership types (address-owned, consensus-address-owned, shared, immutable, wrapped), choosing between shared and owned, parallel execution, consensus, Mysticeti, fastpath, object versioning, Lamport timestamps, or frontend access to shared objects.\n",{"type":39,"tag":55,"props":156,"children":157},{},[158],{"type":44,"value":159},"Covers:",{"type":44,"value":161}," all five ownership types with consensus implications, consensus-address-owned objects, shared object access mode optimization, frontend PTB access pattern, wrapped object behavior, Lamport timestamp versioning, fastpath vs consensus versioning.",{"type":39,"tag":126,"props":163,"children":165},{"id":164},"transfers-transferring-and-deleting-objects",[166],{"type":44,"value":167},"transfers — Transferring and Deleting Objects",{"type":39,"tag":51,"props":169,"children":170},{},[171,175,176,182,186,188,194,195,201,203,209,211,215,217,222,224,230,232,238],{"type":39,"tag":55,"props":172,"children":173},{},[174],{"type":44,"value":139},{"type":44,"value":141},{"type":39,"tag":63,"props":177,"children":179},{"className":178},[],[180],{"type":44,"value":181},"transfers.md",{"type":39,"tag":55,"props":183,"children":184},{},[185],{"type":44,"value":152},{"type":44,"value":187}," transferring objects, choosing between ",{"type":39,"tag":63,"props":189,"children":191},{"className":190},[],[192],{"type":44,"value":193},"transfer",{"type":44,"value":94},{"type":39,"tag":63,"props":196,"children":198},{"className":197},[],[199],{"type":44,"value":200},"public_transfer",{"type":44,"value":202},", implementing custom transfer rules, using ",{"type":39,"tag":63,"props":204,"children":206},{"className":205},[],[207],{"type":44,"value":208},"Receiving\u003CT>",{"type":44,"value":210},", transfer-to-object, or deleting\u002Fdestroying objects.\n",{"type":39,"tag":55,"props":212,"children":213},{},[214],{"type":44,"value":159},{"type":44,"value":216}," eight core transfer functions (module-restricted vs public, including party_transfer variants), custom transfer rules, transfer-to-object with ",{"type":39,"tag":63,"props":218,"children":220},{"className":219},[],[221],{"type":44,"value":208},{"type":44,"value":223},", ",{"type":39,"tag":63,"props":225,"children":227},{"className":226},[],[228],{"type":44,"value":229},"receive",{"type":44,"value":231}," vs ",{"type":39,"tag":63,"props":233,"children":235},{"className":234},[],[236],{"type":44,"value":237},"public_receive",{"type":44,"value":239},", object deletion\u002Funpacking pattern, dynamic field cleanup warning.",{"type":39,"tag":126,"props":241,"children":243},{"id":242},"dynamic-fields-and-collections-dynamic-fields-and-collections",[244],{"type":44,"value":245},"dynamic-fields-and-collections — Dynamic Fields and Collections",{"type":39,"tag":51,"props":247,"children":248},{},[249,253,254,260,264,266,272,273,279,281,287,288,294,295,301,302,308,310,314],{"type":39,"tag":55,"props":250,"children":251},{},[252],{"type":44,"value":139},{"type":44,"value":141},{"type":39,"tag":63,"props":255,"children":257},{"className":256},[],[258],{"type":44,"value":259},"dynamic-fields-and-collections.md",{"type":39,"tag":55,"props":261,"children":262},{},[263],{"type":44,"value":152},{"type":44,"value":265}," using dynamic fields, choosing between ",{"type":39,"tag":63,"props":267,"children":269},{"className":268},[],[270],{"type":44,"value":271},"dynamic_field",{"type":44,"value":94},{"type":39,"tag":63,"props":274,"children":276},{"className":275},[],[277],{"type":44,"value":278},"dynamic_object_field",{"type":44,"value":280},", working with collections (",{"type":39,"tag":63,"props":282,"children":284},{"className":283},[],[285],{"type":44,"value":286},"Table",{"type":44,"value":223},{"type":39,"tag":63,"props":289,"children":291},{"className":290},[],[292],{"type":44,"value":293},"Bag",{"type":44,"value":223},{"type":39,"tag":63,"props":296,"children":298},{"className":297},[],[299],{"type":44,"value":300},"VecMap",{"type":44,"value":223},{"type":39,"tag":63,"props":303,"children":305},{"className":304},[],[306],{"type":44,"value":307},"LinkedTable",{"type":44,"value":309},"), or designing storage for large datasets.\n",{"type":39,"tag":55,"props":311,"children":312},{},[313],{"type":44,"value":159},{"type":44,"value":315}," dynamic field vs dynamic object field visibility, field naming, core API (add\u002Fborrow\u002Fremove\u002Fexists_), all collection types with decision table, cleanup requirements, system limits (256 KB object size, 2048 objects\u002Ftxn).",{"type":39,"tag":126,"props":317,"children":319},{"id":318},"patterns-common-patterns-and-derived-objects",[320],{"type":44,"value":321},"patterns — Common Patterns and Derived Objects",{"type":39,"tag":51,"props":323,"children":324},{},[325,329,330,336,340,342,346,348,354],{"type":39,"tag":55,"props":326,"children":327},{},[328],{"type":44,"value":139},{"type":44,"value":141},{"type":39,"tag":63,"props":331,"children":333},{"className":332},[],[334],{"type":44,"value":335},"patterns.md",{"type":39,"tag":55,"props":337,"children":338},{},[339],{"type":44,"value":152},{"type":44,"value":341}," implementing hot potato, capability, soulbound, inventory, or borrow patterns, or working with derived objects.\n",{"type":39,"tag":55,"props":343,"children":344},{},[345],{"type":44,"value":159},{"type":44,"value":347}," hot potato pattern (no-ability structs), capability pattern (AdminCap\u002FTreasuryCap), borrow pattern with ",{"type":39,"tag":63,"props":349,"children":351},{"className":350},[],[352],{"type":44,"value":353},"sui::borrow",{"type":44,"value":355}," module, soulbound objects, inventory pattern (ObjectBag), derived objects with deterministic IDs, derived objects vs dynamic fields comparison.",{"type":39,"tag":126,"props":357,"children":359},{"id":358},"display-object-display-v2",[360],{"type":44,"value":361},"display — Object Display (V2)",{"type":39,"tag":51,"props":363,"children":364},{},[365,369,370,376,380,382,386,388,394,396,402,403,409,411,417,419,425,426,432,433,439,441,447],{"type":39,"tag":55,"props":366,"children":367},{},[368],{"type":44,"value":139},{"type":44,"value":141},{"type":39,"tag":63,"props":371,"children":373},{"className":372},[],[374],{"type":44,"value":375},"display.md",{"type":39,"tag":55,"props":377,"children":378},{},[379],{"type":44,"value":152},{"type":44,"value":381}," setting up how objects render in wallets, explorers, or apps, working with Display templates, configuring NFT metadata, or migrating from Display V1.\n",{"type":39,"tag":55,"props":383,"children":384},{},[385],{"type":44,"value":159},{"type":44,"value":387}," V2 ",{"type":39,"tag":63,"props":389,"children":391},{"className":390},[],[392],{"type":44,"value":393},"Display\u003CT>",{"type":44,"value":395}," creation via ",{"type":39,"tag":63,"props":397,"children":399},{"className":398},[],[400],{"type":44,"value":401},"display_registry::new_with_publisher",{"type":44,"value":223},{"type":39,"tag":63,"props":404,"children":406},{"className":405},[],[407],{"type":44,"value":408},"DisplayCap\u003CT>",{"type":44,"value":410}," for updates, ",{"type":39,"tag":63,"props":412,"children":414},{"className":413},[],[415],{"type":44,"value":416},"set",{"type":44,"value":418},"\u002F",{"type":39,"tag":63,"props":420,"children":422},{"className":421},[],[423],{"type":44,"value":424},"unset",{"type":44,"value":418},{"type":39,"tag":63,"props":427,"children":429},{"className":428},[],[430],{"type":44,"value":431},"clear",{"type":44,"value":418},{"type":39,"tag":63,"props":434,"children":436},{"className":435},[],[437],{"type":44,"value":438},"share",{"type":44,"value":440}," API, ",{"type":39,"tag":63,"props":442,"children":444},{"className":443},[],[445],{"type":44,"value":446},"{field_name}",{"type":44,"value":448}," template syntax with nested field access, common display properties, V1 to V2 migration.",{"type":39,"tag":115,"props":450,"children":451},{},[],{"type":39,"tag":119,"props":453,"children":455},{"id":454},"routing-guide",[456],{"type":44,"value":457},"Routing guide",{"type":39,"tag":459,"props":460,"children":461},"table",{},[462,481],{"type":39,"tag":463,"props":464,"children":465},"thead",{},[466],{"type":39,"tag":467,"props":468,"children":469},"tr",{},[470,476],{"type":39,"tag":471,"props":472,"children":473},"th",{},[474],{"type":44,"value":475},"Task",{"type":39,"tag":471,"props":477,"children":478},{},[479],{"type":44,"value":480},"Load",{"type":39,"tag":482,"props":483,"children":484},"tbody",{},[485,499,511,524,536,548,560,572,585,598,610,622,635,647,659,672,684,696,708,721,733,746],{"type":39,"tag":467,"props":486,"children":487},{},[488,494],{"type":39,"tag":489,"props":490,"children":491},"td",{},[492],{"type":44,"value":493},"What is an object \u002F object structure",{"type":39,"tag":489,"props":495,"children":496},{},[497],{"type":44,"value":498},"SKILL.md only",{"type":39,"tag":467,"props":500,"children":501},{},[502,507],{"type":39,"tag":489,"props":503,"children":504},{},[505],{"type":44,"value":506},"Abilities: key, store, copy, drop",{"type":39,"tag":489,"props":508,"children":509},{},[510],{"type":44,"value":498},{"type":39,"tag":467,"props":512,"children":513},{},[514,519],{"type":39,"tag":489,"props":515,"children":516},{},[517],{"type":44,"value":518},"Ownership types, shared vs owned vs consensus-address-owned",{"type":39,"tag":489,"props":520,"children":521},{},[522],{"type":44,"value":523},"ownership",{"type":39,"tag":467,"props":525,"children":526},{},[527,532],{"type":39,"tag":489,"props":528,"children":529},{},[530],{"type":44,"value":531},"Parallel execution, consensus, fastpath",{"type":39,"tag":489,"props":533,"children":534},{},[535],{"type":44,"value":523},{"type":39,"tag":467,"props":537,"children":538},{},[539,544],{"type":39,"tag":489,"props":540,"children":541},{},[542],{"type":44,"value":543},"Object versioning, Lamport timestamps",{"type":39,"tag":489,"props":545,"children":546},{},[547],{"type":44,"value":523},{"type":39,"tag":467,"props":549,"children":550},{},[551,556],{"type":39,"tag":489,"props":552,"children":553},{},[554],{"type":44,"value":555},"Wrapped objects and accessibility",{"type":39,"tag":489,"props":557,"children":558},{},[559],{"type":44,"value":523},{"type":39,"tag":467,"props":561,"children":562},{},[563,568],{"type":39,"tag":489,"props":564,"children":565},{},[566],{"type":44,"value":567},"Frontend access to shared objects",{"type":39,"tag":489,"props":569,"children":570},{},[571],{"type":44,"value":523},{"type":39,"tag":467,"props":573,"children":574},{},[575,580],{"type":39,"tag":489,"props":576,"children":577},{},[578],{"type":44,"value":579},"Transferring objects, transfer vs public_transfer",{"type":39,"tag":489,"props":581,"children":582},{},[583],{"type":44,"value":584},"transfers",{"type":39,"tag":467,"props":586,"children":587},{},[588,593],{"type":39,"tag":489,"props":589,"children":590},{},[591],{"type":44,"value":592},"Custom transfer rules",{"type":39,"tag":489,"props":594,"children":595},{},[596],{"type":44,"value":597},"transfers + patterns",{"type":39,"tag":467,"props":599,"children":600},{},[601,606],{"type":39,"tag":489,"props":602,"children":603},{},[604],{"type":44,"value":605},"Transfer to object, Receiving",{"type":39,"tag":489,"props":607,"children":608},{},[609],{"type":44,"value":584},{"type":39,"tag":467,"props":611,"children":612},{},[613,618],{"type":39,"tag":489,"props":614,"children":615},{},[616],{"type":44,"value":617},"Deleting \u002F destroying objects",{"type":39,"tag":489,"props":619,"children":620},{},[621],{"type":44,"value":584},{"type":39,"tag":467,"props":623,"children":624},{},[625,630],{"type":39,"tag":489,"props":626,"children":627},{},[628],{"type":44,"value":629},"Dynamic fields, dynamic object fields",{"type":39,"tag":489,"props":631,"children":632},{},[633],{"type":44,"value":634},"dynamic-fields-and-collections",{"type":39,"tag":467,"props":636,"children":637},{},[638,643],{"type":39,"tag":489,"props":639,"children":640},{},[641],{"type":44,"value":642},"Collections: Table, Bag, VecMap, LinkedTable",{"type":39,"tag":489,"props":644,"children":645},{},[646],{"type":44,"value":634},{"type":39,"tag":467,"props":648,"children":649},{},[650,655],{"type":39,"tag":489,"props":651,"children":652},{},[653],{"type":44,"value":654},"Scalability, large collection design",{"type":39,"tag":489,"props":656,"children":657},{},[658],{"type":44,"value":634},{"type":39,"tag":467,"props":660,"children":661},{},[662,667],{"type":39,"tag":489,"props":663,"children":664},{},[665],{"type":44,"value":666},"Hot potato pattern",{"type":39,"tag":489,"props":668,"children":669},{},[670],{"type":44,"value":671},"patterns",{"type":39,"tag":467,"props":673,"children":674},{},[675,680],{"type":39,"tag":489,"props":676,"children":677},{},[678],{"type":44,"value":679},"Capability pattern, AdminCap",{"type":39,"tag":489,"props":681,"children":682},{},[683],{"type":44,"value":671},{"type":39,"tag":467,"props":685,"children":686},{},[687,692],{"type":39,"tag":489,"props":688,"children":689},{},[690],{"type":44,"value":691},"Borrow pattern, cap inside object",{"type":39,"tag":489,"props":693,"children":694},{},[695],{"type":44,"value":671},{"type":39,"tag":467,"props":697,"children":698},{},[699,704],{"type":39,"tag":489,"props":700,"children":701},{},[702],{"type":44,"value":703},"Soulbound \u002F non-transferable objects",{"type":39,"tag":489,"props":705,"children":706},{},[707],{"type":44,"value":597},{"type":39,"tag":467,"props":709,"children":710},{},[711,716],{"type":39,"tag":489,"props":712,"children":713},{},[714],{"type":44,"value":715},"Inventory for arbitrary objects",{"type":39,"tag":489,"props":717,"children":718},{},[719],{"type":44,"value":720},"patterns + dynamic-fields-and-collections",{"type":39,"tag":467,"props":722,"children":723},{},[724,729],{"type":39,"tag":489,"props":725,"children":726},{},[727],{"type":44,"value":728},"Derived objects",{"type":39,"tag":489,"props":730,"children":731},{},[732],{"type":44,"value":671},{"type":39,"tag":467,"props":734,"children":735},{},[736,741],{"type":39,"tag":489,"props":737,"children":738},{},[739],{"type":44,"value":740},"Object Display, NFT rendering",{"type":39,"tag":489,"props":742,"children":743},{},[744],{"type":44,"value":745},"display",{"type":39,"tag":467,"props":747,"children":748},{},[749,754],{"type":39,"tag":489,"props":750,"children":751},{},[752],{"type":44,"value":753},"Full project \u002F code review",{"type":39,"tag":489,"props":755,"children":756},{},[757],{"type":39,"tag":55,"props":758,"children":759},{},[760],{"type":44,"value":761},"all reference files",{"type":39,"tag":115,"props":763,"children":764},{},[],{"type":39,"tag":119,"props":766,"children":768},{"id":767},"object-structure",[769],{"type":44,"value":770},"Object structure",{"type":39,"tag":51,"props":772,"children":773},{},[774],{"type":44,"value":775},"Every Sui object contains four components:",{"type":39,"tag":777,"props":778,"children":779},"ul",{},[780,791,809,819],{"type":39,"tag":781,"props":782,"children":783},"li",{},[784,789],{"type":39,"tag":55,"props":785,"children":786},{},[787],{"type":44,"value":788},"Globally unique ID:",{"type":44,"value":790}," A 32-byte identifier derived from the creation transaction digest plus a generation counter. The ID never changes across the object's lifetime.",{"type":39,"tag":781,"props":792,"children":793},{},[794,799,801,807],{"type":39,"tag":55,"props":795,"children":796},{},[797],{"type":44,"value":798},"Version number:",{"type":44,"value":800}," An 8-byte integer that increments with each modification. Uses Lamport timestamps: the new version for all objects a transaction touches is ",{"type":39,"tag":63,"props":802,"children":804},{"className":803},[],[805],{"type":44,"value":806},"1 + max(version of all input objects)",{"type":44,"value":808},".",{"type":39,"tag":781,"props":810,"children":811},{},[812,817],{"type":39,"tag":55,"props":813,"children":814},{},[815],{"type":44,"value":816},"Owner field:",{"type":44,"value":818}," A 32-byte value designating access control (an address, another object's ID, or a sentinel for shared\u002Fimmutable).",{"type":39,"tag":781,"props":820,"children":821},{},[822,827],{"type":39,"tag":55,"props":823,"children":824},{},[825],{"type":44,"value":826},"Transaction digest:",{"type":44,"value":828}," A 32-byte hash referencing the last transaction that modified the object.",{"type":39,"tag":51,"props":830,"children":831},{},[832],{"type":44,"value":833},"Objects can be referenced three ways: by ID alone (query current state), by versioned ID (read historical state), or by full object reference containing ID + version + digest (transaction inputs, authenticated snapshot).",{"type":39,"tag":119,"props":835,"children":837},{"id":836},"defining-objects-in-move",[838],{"type":44,"value":839},"Defining objects in Move",{"type":39,"tag":51,"props":841,"children":842},{},[843,845,851,853,859],{"type":44,"value":844},"A Sui object is a Move struct with the ",{"type":39,"tag":63,"props":846,"children":848},{"className":847},[],[849],{"type":44,"value":850},"key",{"type":44,"value":852}," ability and an ",{"type":39,"tag":63,"props":854,"children":856},{"className":855},[],[857],{"type":44,"value":858},"id: UID",{"type":44,"value":860}," as the first field:",{"type":39,"tag":862,"props":863,"children":868},"pre",{"className":864,"code":865,"language":866,"meta":867,"style":867},"language-move shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","public struct Sword has key, store {\n    id: UID,\n    damage: u64,\n    element: String,\n}\n","move","",[869],{"type":39,"tag":63,"props":870,"children":871},{"__ignoreMap":867},[872,883,891,900,909],{"type":39,"tag":873,"props":874,"children":877},"span",{"class":875,"line":876},"line",1,[878],{"type":39,"tag":873,"props":879,"children":880},{},[881],{"type":44,"value":882},"public struct Sword has key, store {\n",{"type":39,"tag":873,"props":884,"children":885},{"class":875,"line":26},[886],{"type":39,"tag":873,"props":887,"children":888},{},[889],{"type":44,"value":890},"    id: UID,\n",{"type":39,"tag":873,"props":892,"children":894},{"class":875,"line":893},3,[895],{"type":39,"tag":873,"props":896,"children":897},{},[898],{"type":44,"value":899},"    damage: u64,\n",{"type":39,"tag":873,"props":901,"children":903},{"class":875,"line":902},4,[904],{"type":39,"tag":873,"props":905,"children":906},{},[907],{"type":44,"value":908},"    element: String,\n",{"type":39,"tag":873,"props":910,"children":912},{"class":875,"line":911},5,[913],{"type":39,"tag":873,"props":914,"children":915},{},[916],{"type":44,"value":917},"}\n",{"type":39,"tag":51,"props":919,"children":920},{},[921,927,929,935,937,943],{"type":39,"tag":63,"props":922,"children":924},{"className":923},[],[925],{"type":44,"value":926},"object::new(ctx)",{"type":44,"value":928}," is the only way to create a ",{"type":39,"tag":63,"props":930,"children":932},{"className":931},[],[933],{"type":44,"value":934},"UID",{"type":44,"value":936},". You cannot call ",{"type":39,"tag":63,"props":938,"children":940},{"className":939},[],[941],{"type":44,"value":942},"ctx.new()",{"type":44,"value":944}," directly.",{"type":39,"tag":119,"props":946,"children":948},{"id":947},"move-abilities-and-objects",[949],{"type":44,"value":950},"Move abilities and objects",{"type":39,"tag":459,"props":952,"children":953},{},[954,970],{"type":39,"tag":463,"props":955,"children":956},{},[957],{"type":39,"tag":467,"props":958,"children":959},{},[960,965],{"type":39,"tag":471,"props":961,"children":962},{},[963],{"type":44,"value":964},"Ability",{"type":39,"tag":471,"props":966,"children":967},{},[968],{"type":44,"value":969},"What it controls",{"type":39,"tag":482,"props":971,"children":972},{},[973,996,1027,1079],{"type":39,"tag":467,"props":974,"children":975},{},[976,984],{"type":39,"tag":489,"props":977,"children":978},{},[979],{"type":39,"tag":63,"props":980,"children":982},{"className":981},[],[983],{"type":44,"value":850},{"type":39,"tag":489,"props":985,"children":986},{},[987,989,994],{"type":44,"value":988},"The struct is a Sui object. Must have ",{"type":39,"tag":63,"props":990,"children":992},{"className":991},[],[993],{"type":44,"value":858},{"type":44,"value":995}," as first field. Required for all onchain objects.",{"type":39,"tag":467,"props":997,"children":998},{},[999,1008],{"type":39,"tag":489,"props":1000,"children":1001},{},[1002],{"type":39,"tag":63,"props":1003,"children":1005},{"className":1004},[],[1006],{"type":44,"value":1007},"store",{"type":39,"tag":489,"props":1009,"children":1010},{},[1011,1013,1018,1020,1025],{"type":44,"value":1012},"The struct can be stored inside other objects, and transferred by any module using ",{"type":39,"tag":63,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":44,"value":200},{"type":44,"value":1019},". Without it, only the defining module can transfer the object. Adding ",{"type":39,"tag":63,"props":1021,"children":1023},{"className":1022},[],[1024],{"type":44,"value":1007},{"type":44,"value":1026}," permanently removes the ability to enforce custom transfer rules.",{"type":39,"tag":467,"props":1028,"children":1029},{},[1030,1039],{"type":39,"tag":489,"props":1031,"children":1032},{},[1033],{"type":39,"tag":63,"props":1034,"children":1036},{"className":1035},[],[1037],{"type":44,"value":1038},"copy",{"type":39,"tag":489,"props":1040,"children":1041},{},[1042,1044,1049,1051,1056,1058,1063,1065,1070,1072,1077],{"type":44,"value":1043},"The struct can be duplicated. ",{"type":39,"tag":55,"props":1045,"children":1046},{},[1047],{"type":44,"value":1048},"Cannot be used on objects",{"type":44,"value":1050}," — ",{"type":39,"tag":63,"props":1052,"children":1054},{"className":1053},[],[1055],{"type":44,"value":934},{"type":44,"value":1057}," lacks ",{"type":39,"tag":63,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":44,"value":1038},{"type":44,"value":1064},", so any struct with ",{"type":39,"tag":63,"props":1066,"children":1068},{"className":1067},[],[1069],{"type":44,"value":850},{"type":44,"value":1071}," cannot have ",{"type":39,"tag":63,"props":1073,"children":1075},{"className":1074},[],[1076],{"type":44,"value":1038},{"type":44,"value":1078},". Used only on non-object structs (configs, event data, read-only values).",{"type":39,"tag":467,"props":1080,"children":1081},{},[1082,1091],{"type":39,"tag":489,"props":1083,"children":1084},{},[1085],{"type":39,"tag":63,"props":1086,"children":1088},{"className":1087},[],[1089],{"type":44,"value":1090},"drop",{"type":39,"tag":489,"props":1092,"children":1093},{},[1094,1096,1100,1101,1106,1107,1112,1113,1118,1119,1124],{"type":44,"value":1095},"The struct can be silently discarded at end of scope. ",{"type":39,"tag":55,"props":1097,"children":1098},{},[1099],{"type":44,"value":1048},{"type":44,"value":1050},{"type":39,"tag":63,"props":1102,"children":1104},{"className":1103},[],[1105],{"type":44,"value":934},{"type":44,"value":1057},{"type":39,"tag":63,"props":1108,"children":1110},{"className":1109},[],[1111],{"type":44,"value":1090},{"type":44,"value":1064},{"type":39,"tag":63,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":44,"value":850},{"type":44,"value":1071},{"type":39,"tag":63,"props":1120,"children":1122},{"className":1121},[],[1123],{"type":44,"value":1090},{"type":44,"value":1125},". Used only on non-object structs (ephemeral receipts, events). Objects must always be explicitly unpacked to destroy.",{"type":39,"tag":126,"props":1127,"children":1129},{"id":1128},"object-ability-combinations",[1130],{"type":44,"value":1131},"Object ability combinations",{"type":39,"tag":51,"props":1133,"children":1134},{},[1135,1137,1142,1144,1149,1151,1156,1158,1163,1165,1170,1171,1176],{"type":44,"value":1136},"Because ",{"type":39,"tag":63,"props":1138,"children":1140},{"className":1139},[],[1141],{"type":44,"value":934},{"type":44,"value":1143}," has neither ",{"type":39,"tag":63,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":44,"value":1038},{"type":44,"value":1150}," nor ",{"type":39,"tag":63,"props":1152,"children":1154},{"className":1153},[],[1155],{"type":44,"value":1090},{"type":44,"value":1157},", objects (structs with ",{"type":39,"tag":63,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":44,"value":850},{"type":44,"value":1164},") can only combine ",{"type":39,"tag":63,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":44,"value":850},{"type":44,"value":94},{"type":39,"tag":63,"props":1172,"children":1174},{"className":1173},[],[1175],{"type":44,"value":1007},{"type":44,"value":1177},":",{"type":39,"tag":777,"props":1179,"children":1180},{},[1181,1196],{"type":39,"tag":781,"props":1182,"children":1183},{},[1184,1194],{"type":39,"tag":55,"props":1185,"children":1186},{},[1187,1193],{"type":39,"tag":63,"props":1188,"children":1190},{"className":1189},[],[1191],{"type":44,"value":1192},"has key",{"type":44,"value":1177},{"type":44,"value":1195}," Only the defining module can transfer, share, or freeze. Use for custom transfer rules.",{"type":39,"tag":781,"props":1197,"children":1198},{},[1199,1209,1211,1216],{"type":39,"tag":55,"props":1200,"children":1201},{},[1202,1208],{"type":39,"tag":63,"props":1203,"children":1205},{"className":1204},[],[1206],{"type":44,"value":1207},"has key, store",{"type":44,"value":1177},{"type":44,"value":1210}," Any module can transfer, share, freeze, or wrap. Use for freely composable assets. Once ",{"type":39,"tag":63,"props":1212,"children":1214},{"className":1213},[],[1215],{"type":44,"value":1007},{"type":44,"value":1217}," is granted, you cannot re-add custom transfer restrictions.",{"type":39,"tag":126,"props":1219,"children":1221},{"id":1220},"non-object-struct-combinations-no-key",[1222,1224,1229],{"type":44,"value":1223},"Non-object struct combinations (no ",{"type":39,"tag":63,"props":1225,"children":1227},{"className":1226},[],[1228],{"type":44,"value":850},{"type":44,"value":1230},")",{"type":39,"tag":777,"props":1232,"children":1233},{},[1234,1249,1264,1279],{"type":39,"tag":781,"props":1235,"children":1236},{},[1237,1247],{"type":39,"tag":55,"props":1238,"children":1239},{},[1240,1246],{"type":39,"tag":63,"props":1241,"children":1243},{"className":1242},[],[1244],{"type":44,"value":1245},"has store",{"type":44,"value":1177},{"type":44,"value":1248}," Can be stored as a field inside an object. Cannot exist independently.",{"type":39,"tag":781,"props":1250,"children":1251},{},[1252,1262],{"type":39,"tag":55,"props":1253,"children":1254},{},[1255,1261],{"type":39,"tag":63,"props":1256,"children":1258},{"className":1257},[],[1259],{"type":44,"value":1260},"has copy, drop",{"type":44,"value":1177},{"type":44,"value":1263}," A plain data struct for events, intermediate values, and configs.",{"type":39,"tag":781,"props":1265,"children":1266},{},[1267,1277],{"type":39,"tag":55,"props":1268,"children":1269},{},[1270,1276],{"type":39,"tag":63,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":44,"value":1275},"has copy, drop, store",{"type":44,"value":1177},{"type":44,"value":1278}," Can be used as dynamic field names.",{"type":39,"tag":781,"props":1280,"children":1281},{},[1282,1287],{"type":39,"tag":55,"props":1283,"children":1284},{},[1285],{"type":44,"value":1286},"No abilities:",{"type":44,"value":1288}," A hot potato. Must be consumed in the same transaction. See patterns reference file.",{"type":39,"tag":119,"props":1290,"children":1292},{"id":1291},"rules",[1293],{"type":44,"value":1294},"Rules",{"type":39,"tag":777,"props":1296,"children":1297},{},[1298,1315,1327,1332,1337,1373,1378,1405,1417,1430],{"type":39,"tag":781,"props":1299,"children":1300},{},[1301,1306,1308,1313],{"type":39,"tag":63,"props":1302,"children":1304},{"className":1303},[],[1305],{"type":44,"value":926},{"type":44,"value":1307}," is the only way to create a UID. The ",{"type":39,"tag":63,"props":1309,"children":1311},{"className":1310},[],[1312],{"type":44,"value":858},{"type":44,"value":1314}," field must be first.",{"type":39,"tag":781,"props":1316,"children":1317},{},[1318,1320,1325],{"type":44,"value":1319},"Once ",{"type":39,"tag":63,"props":1321,"children":1323},{"className":1322},[],[1324],{"type":44,"value":1007},{"type":44,"value":1326}," is added to a type, custom transfer rules are permanently disabled.",{"type":39,"tag":781,"props":1328,"children":1329},{},[1330],{"type":44,"value":1331},"Once an object is shared, it cannot be converted back to address-owned.",{"type":39,"tag":781,"props":1333,"children":1334},{},[1335],{"type":44,"value":1336},"Always remove all dynamic fields before deleting a parent object — orphaned fields become permanently inaccessible.",{"type":39,"tag":781,"props":1338,"children":1339},{},[1340,1342,1348,1349,1355,1357,1363,1365,1371],{"type":44,"value":1341},"Accessing a nonexistent dynamic field (via ",{"type":39,"tag":63,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":44,"value":1347},"borrow",{"type":44,"value":223},{"type":39,"tag":63,"props":1350,"children":1352},{"className":1351},[],[1353],{"type":44,"value":1354},"borrow_mut",{"type":44,"value":1356},", or ",{"type":39,"tag":63,"props":1358,"children":1360},{"className":1359},[],[1361],{"type":44,"value":1362},"remove",{"type":44,"value":1364},") aborts the transaction. Use ",{"type":39,"tag":63,"props":1366,"children":1368},{"className":1367},[],[1369],{"type":44,"value":1370},"exists_",{"type":44,"value":1372}," to check first.",{"type":39,"tag":781,"props":1374,"children":1375},{},[1376],{"type":44,"value":1377},"Wrapping and unwrapping can happen within the same transaction — a PTB can wrap an object and later unwrap it atomically.",{"type":39,"tag":781,"props":1379,"children":1380},{},[1381,1383,1389,1390,1396,1397,1403],{"type":44,"value":1382},"Common capabilities: ",{"type":39,"tag":63,"props":1384,"children":1386},{"className":1385},[],[1387],{"type":44,"value":1388},"AdminCap",{"type":44,"value":223},{"type":39,"tag":63,"props":1391,"children":1393},{"className":1392},[],[1394],{"type":44,"value":1395},"TreasuryCap",{"type":44,"value":223},{"type":39,"tag":63,"props":1398,"children":1400},{"className":1399},[],[1401],{"type":44,"value":1402},"UpgradeCap",{"type":44,"value":1404},". Always mention all three when discussing the capability pattern.",{"type":39,"tag":781,"props":1406,"children":1407},{},[1408,1410,1415],{"type":44,"value":1409},"Each ",{"type":39,"tag":63,"props":1411,"children":1413},{"className":1412},[],[1414],{"type":44,"value":286},{"type":44,"value":1416}," entry is a separate storage operation — gas cost scales linearly with entries accessed per transaction.",{"type":39,"tag":781,"props":1418,"children":1419},{},[1420,1422,1428],{"type":44,"value":1421},"Prefer immutable references (",{"type":39,"tag":63,"props":1423,"children":1425},{"className":1424},[],[1426],{"type":44,"value":1427},"&",{"type":44,"value":1429},") on shared objects to maximize parallel execution.",{"type":39,"tag":781,"props":1431,"children":1432},{},[1433,1435,1440,1442,1447],{"type":44,"value":1434},"Do not use ",{"type":39,"tag":63,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":44,"value":300},{"type":44,"value":1441}," for collections larger than ~100 entries. Use ",{"type":39,"tag":63,"props":1443,"children":1445},{"className":1444},[],[1446],{"type":44,"value":286},{"type":44,"value":1448}," instead.",{"type":39,"tag":119,"props":1450,"children":1452},{"id":1451},"common-mistakes",[1453],{"type":44,"value":1454},"Common mistakes",{"type":39,"tag":777,"props":1456,"children":1457},{},[1458,1482,1499,1536,1546,1571],{"type":39,"tag":781,"props":1459,"children":1460},{},[1461,1473,1475,1480],{"type":39,"tag":55,"props":1462,"children":1463},{},[1464,1466,1471],{"type":44,"value":1465},"Adding ",{"type":39,"tag":63,"props":1467,"children":1469},{"className":1468},[],[1470],{"type":44,"value":1007},{"type":44,"value":1472}," when you need custom transfer rules.",{"type":44,"value":1474}," Once granted, any module can call ",{"type":39,"tag":63,"props":1476,"children":1478},{"className":1477},[],[1479],{"type":44,"value":200},{"type":44,"value":1481}," and your enforcement logic is bypassed permanently.",{"type":39,"tag":781,"props":1483,"children":1484},{},[1485,1497],{"type":39,"tag":55,"props":1486,"children":1487},{},[1488,1490,1495],{"type":44,"value":1489},"Using ",{"type":39,"tag":63,"props":1491,"children":1493},{"className":1492},[],[1494],{"type":44,"value":300},{"type":44,"value":1496}," for large collections.",{"type":44,"value":1498}," It has O(n) lookup and is stored inline, hitting the 256 KB object size limit quickly.",{"type":39,"tag":781,"props":1500,"children":1501},{},[1502,1520,1522,1527,1529,1534],{"type":39,"tag":55,"props":1503,"children":1504},{},[1505,1507,1512,1514,1519],{"type":44,"value":1506},"Confusing ",{"type":39,"tag":63,"props":1508,"children":1510},{"className":1509},[],[1511],{"type":44,"value":271},{"type":44,"value":1513}," with ",{"type":39,"tag":63,"props":1515,"children":1517},{"className":1516},[],[1518],{"type":44,"value":278},{"type":44,"value":808},{"type":44,"value":1521}," Use ",{"type":39,"tag":63,"props":1523,"children":1525},{"className":1524},[],[1526],{"type":44,"value":278},{"type":44,"value":1528}," when the child must remain queryable by ID in explorers. Use ",{"type":39,"tag":63,"props":1530,"children":1532},{"className":1531},[],[1533],{"type":44,"value":271},{"type":44,"value":1535}," for plain values.",{"type":39,"tag":781,"props":1537,"children":1538},{},[1539,1544],{"type":39,"tag":55,"props":1540,"children":1541},{},[1542],{"type":44,"value":1543},"Deleting an object without removing its dynamic fields first.",{"type":44,"value":1545}," Those fields become permanently inaccessible.",{"type":39,"tag":781,"props":1547,"children":1548},{},[1549,1562,1563,1569],{"type":39,"tag":55,"props":1550,"children":1551},{},[1552,1554,1560],{"type":44,"value":1553},"Using the legacy ",{"type":39,"tag":63,"props":1555,"children":1557},{"className":1556},[],[1558],{"type":44,"value":1559},"sui::display",{"type":44,"value":1561}," module for new code.",{"type":44,"value":1521},{"type":39,"tag":63,"props":1564,"children":1566},{"className":1565},[],[1567],{"type":44,"value":1568},"sui::display_registry",{"type":44,"value":1570}," (Display V2). V1 was migrated to V2 via a system snapshot migration.",{"type":39,"tag":781,"props":1572,"children":1573},{},[1574,1587],{"type":39,"tag":55,"props":1575,"children":1576},{},[1577,1579,1585],{"type":44,"value":1578},"Forgetting to ",{"type":39,"tag":63,"props":1580,"children":1582},{"className":1581},[],[1583],{"type":44,"value":1584},"display_registry::share(display)",{"type":44,"value":1586}," after setting fields.",{"type":44,"value":1588}," The display must be shared to be discoverable.",{"type":39,"tag":1590,"props":1591,"children":1592},"style",{},[1593],{"type":44,"value":1594},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1596,"total":1701},[1597,1609,1624,1645,1659,1672,1688],{"slug":1598,"name":1598,"fn":1599,"description":1600,"org":1601,"tags":1602,"stars":22,"repoUrl":23,"updatedAt":1608},"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},[1603,1606,1607],{"name":1604,"slug":1605,"type":16},"Data Analysis","data-analysis",{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},"2026-08-01T05:44:32.775598",{"slug":1610,"name":1610,"fn":1611,"description":1612,"org":1613,"tags":1614,"stars":22,"repoUrl":23,"updatedAt":1623},"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},[1615,1618,1621,1622],{"name":1616,"slug":1617,"type":16},"API Development","api-development",{"name":1619,"slug":1620,"type":16},"Smart Contracts","smart-contracts",{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},"2026-07-16T06:02:49.198495",{"slug":1625,"name":1625,"fn":1626,"description":1627,"org":1628,"tags":1629,"stars":22,"repoUrl":23,"updatedAt":1644},"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},[1630,1633,1636,1637,1640,1643],{"name":1631,"slug":1632,"type":16},"Frontend","frontend",{"name":1634,"slug":1635,"type":16},"React","react",{"name":18,"slug":8,"type":16},{"name":1638,"slug":1639,"type":16},"Svelte","svelte",{"name":1641,"slug":1642,"type":16},"Vue","vue",{"name":20,"slug":21,"type":16},"2026-08-01T05:44:28.958473",{"slug":1646,"name":1646,"fn":1647,"description":1648,"org":1649,"tags":1650,"stars":22,"repoUrl":23,"updatedAt":1658},"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},[1651,1654,1657],{"name":1652,"slug":1653,"type":16},"Configuration","configuration",{"name":1655,"slug":1656,"type":16},"Documentation","documentation",{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.981056",{"slug":1660,"name":1660,"fn":1661,"description":1662,"org":1663,"tags":1664,"stars":22,"repoUrl":23,"updatedAt":1671},"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},[1665,1668,1669,1670],{"name":1666,"slug":1667,"type":16},"Engineering","engineering",{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},"2026-07-16T06:02:43.277596",{"slug":1673,"name":1673,"fn":1674,"description":1675,"org":1676,"tags":1677,"stars":22,"repoUrl":23,"updatedAt":1687},"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},[1678,1681,1682,1683,1686],{"name":1679,"slug":1680,"type":16},"QA","qa",{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":1684,"slug":1685,"type":16},"Testing","testing",{"name":20,"slug":21,"type":16},"2026-08-01T05:44:30.788585",{"slug":1689,"name":1689,"fn":1690,"description":1691,"org":1692,"tags":1693,"stars":22,"repoUrl":23,"updatedAt":1700},"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},[1694,1697,1698,1699],{"name":1695,"slug":1696,"type":16},"Best Practices","best-practices",{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},"2026-07-16T06:02:48.830052",20,{"items":1703,"total":1820},[1704,1718,1727,1737,1752,1770,1776,1783,1792,1798,1805,1813],{"slug":1705,"name":1705,"fn":1706,"description":1707,"org":1708,"tags":1709,"stars":1715,"repoUrl":1716,"updatedAt":1717},"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},[1710,1713,1714],{"name":1711,"slug":1712,"type":16},"Code Analysis","code-analysis",{"name":1666,"slug":1667,"type":16},{"name":18,"slug":8,"type":16},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":1719,"name":1719,"fn":1720,"description":1721,"org":1722,"tags":1723,"stars":1715,"repoUrl":1716,"updatedAt":1726},"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},[1724,1725],{"name":1655,"slug":1656,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.641382",{"slug":1728,"name":1728,"fn":1729,"description":1730,"org":1731,"tags":1732,"stars":1715,"repoUrl":1716,"updatedAt":1736},"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},[1733,1734,1735],{"name":1711,"slug":1712,"type":16},{"name":1666,"slug":1667,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:25.3633",{"slug":1738,"name":1738,"fn":1739,"description":1740,"org":1741,"tags":1742,"stars":1715,"repoUrl":1716,"updatedAt":1751},"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},[1743,1746,1749,1750],{"name":1744,"slug":1745,"type":16},"Code Review","code-review",{"name":1747,"slug":1748,"type":16},"Security","security",{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:55.691149",{"slug":1753,"name":1753,"fn":1754,"description":1755,"org":1756,"tags":1757,"stars":1767,"repoUrl":1768,"updatedAt":1769},"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},[1758,1761,1764],{"name":1759,"slug":1760,"type":16},"Agents","agents",{"name":1762,"slug":1763,"type":16},"Memory","memory",{"name":1765,"slug":1766,"type":16},"SDK","sdk",57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-07-16T06:02:39.838395",{"slug":1598,"name":1598,"fn":1599,"description":1600,"org":1771,"tags":1772,"stars":22,"repoUrl":23,"updatedAt":1608},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1773,1774,1775],{"name":1604,"slug":1605,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},{"slug":1610,"name":1610,"fn":1611,"description":1612,"org":1777,"tags":1778,"stars":22,"repoUrl":23,"updatedAt":1623},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1779,1780,1781,1782],{"name":1616,"slug":1617,"type":16},{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},{"slug":1625,"name":1625,"fn":1626,"description":1627,"org":1784,"tags":1785,"stars":22,"repoUrl":23,"updatedAt":1644},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1786,1787,1788,1789,1790,1791],{"name":1631,"slug":1632,"type":16},{"name":1634,"slug":1635,"type":16},{"name":18,"slug":8,"type":16},{"name":1638,"slug":1639,"type":16},{"name":1641,"slug":1642,"type":16},{"name":20,"slug":21,"type":16},{"slug":1646,"name":1646,"fn":1647,"description":1648,"org":1793,"tags":1794,"stars":22,"repoUrl":23,"updatedAt":1658},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1795,1796,1797],{"name":1652,"slug":1653,"type":16},{"name":1655,"slug":1656,"type":16},{"name":18,"slug":8,"type":16},{"slug":1660,"name":1660,"fn":1661,"description":1662,"org":1799,"tags":1800,"stars":22,"repoUrl":23,"updatedAt":1671},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1801,1802,1803,1804],{"name":1666,"slug":1667,"type":16},{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},{"slug":1673,"name":1673,"fn":1674,"description":1675,"org":1806,"tags":1807,"stars":22,"repoUrl":23,"updatedAt":1687},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1808,1809,1810,1811,1812],{"name":1679,"slug":1680,"type":16},{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":1684,"slug":1685,"type":16},{"name":20,"slug":21,"type":16},{"slug":1689,"name":1689,"fn":1690,"description":1691,"org":1814,"tags":1815,"stars":22,"repoUrl":23,"updatedAt":1700},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1816,1817,1818,1819],{"name":1695,"slug":1696,"type":16},{"name":1619,"slug":1620,"type":16},{"name":18,"slug":8,"type":16},{"name":20,"slug":21,"type":16},37]