[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-sui-move-project":3,"mdc--yadn4j-key":33,"related-repo-sui-sui-move-project":2265,"related-org-sui-sui-move-project":2371},{"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-move-project","configure Sui Move projects","Move project setup and configuration on Sui. Use this skill when the user needs to create a Move project, configure Move.toml, resolve dependency or build errors, set up the canonical sui-stack-hello-world project, use MVR dependencies, or migrate from old Move.toml formats. Also use when the user sees errors about \"legacy system name\", \"old dependencies\", \"Cannot upgrade package without having a published id\", edition mismatches, or asks about Move.toml, Published.toml, Move.lock, or the [environments] section.\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},"Engineering","engineering",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-08-01T05:44:31.754114",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\u002Fsui-move-project","---\nname: sui-move-project\ndescription: >\n  Move project setup and configuration on Sui. Use this skill when the user needs\n  to create a Move project, configure Move.toml, resolve dependency or build errors,\n  set up the canonical sui-stack-hello-world project, use MVR dependencies, or\n  migrate from old Move.toml formats. Also use when the user sees errors about\n  \"legacy system name\", \"old dependencies\", \"Cannot upgrade package without having\n  a published id\", edition mismatches, or asks about Move.toml, Published.toml,\n  Move.lock, or the [environments] section.\n---\n\n# Move Project Setup\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 sourced exclusively from [docs.sui.io](https:\u002F\u002Fdocs.sui.io), [move-book.com](https:\u002F\u002Fmove-book.com), and [MystenLabs\u002Fsui-stack-hello-world](https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui-stack-hello-world).\n\n## Creating a Move project\n\n### Canonical full-stack hello-world project\n\nFor an end-to-end Sui developer environment with Move and frontend, use the Sui Stack hello-world repository as the single project root:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui-stack-hello-world.git\ncd sui-stack-hello-world\n```\n\nUse this existing layout:\n\n```\nsui-stack-hello-world\u002F\n├── move\u002F\n│   └── hello-world\u002F   # publish this Move package\n└── ui\u002F                # run this existing frontend\n```\n\nDo not run `sui move new`, do not create a counter package, and do not run `npm create @mysten\u002Fdapp` for this workflow. If current Sui tooling requires a package-management migration, keep the change inside `move\u002Fhello-world` and continue deploying the hello-world package.\n\n### New project from scratch\n\nUse this only when the user explicitly wants a standalone Move package rather than the full-stack hello-world app.\n\n```bash\nsui move new my_project\ncd my_project\n```\n\nThis creates:\n\n```\nmy_project\u002F\n├── sources\u002F       # .move source files go here\n├── tests\u002F         # test files\n└── Move.toml      # package manifest\n```\n\n### Multi-package workspace layout\n\nWhen a project contains more than one Move package (for example, a core library and an example or integration package), use a flat `packages\u002F` directory with each package as a sibling:\n\n```\nmy_project\u002F\n├── packages\u002F\n│   ├── core\u002F\n│   │   ├── sources\u002F\n│   │   ├── tests\u002F\n│   │   └── Move.toml\n│   └── examples\u002F\n│       ├── sources\u002F\n│       ├── tests\u002F\n│       └── Move.toml\n└── ui\u002F\n```\n\n**Do not nest packages inside each other** (for example, placing `examples\u002F` inside `core\u002Fsources\u002F` or `core\u002Ftests\u002F`). Nested package directories trigger test runner bugs such as spurious \"address with no value\" errors because the toolchain picks up the inner package's `Move.toml` when building the outer one.\n\nTo depend on a sibling package, use a `local` path in `Move.toml`:\n\n```toml\n# packages\u002Fexamples\u002FMove.toml\n[package]\nname = \"examples\"\nedition = \"2024\"\n\n[dependencies]\ncore = { local = \"..\u002Fcore\" }\n```\n\n### Move.toml (current format — Sui CLI v1.63+)\n\n> **CRITICAL: The Sui framework dependency is automatic. Do NOT add it to Move.toml.**\n\nA correct, minimal `Move.toml` for any Sui Move project is:\n\n```toml\n[package]\nname = \"my_project\"\nedition = \"2024\"\n# No [dependencies] section needed — Sui framework is resolved automatically\n```\n\nThis is **all you need**. The `edition = \"2024\"` line tells the CLI to resolve Sui and MoveStdlib automatically. There is no `[dependencies]` section unless you need third-party or local packages.\n\n### Complete working project templates\n\n**Always use these exact templates when generating Move projects.** Copy them verbatim — do not modify the Move.toml format.\n\n#### Template: Single Move package with TypeScript client\n\n```\nproject\u002F\n├── move\u002F\n│   ├── Move.toml\n│   └── sources\u002F\n│       └── my_module.move\n└── client\u002F\n    ├── package.json\n    └── src\u002F\n        └── index.ts\n```\n\n**move\u002FMove.toml** — copy exactly:\n```toml\n[package]\nname = \"my_project\"\nedition = \"2024\"\n```\n\n**move\u002Fsources\u002Fmy_module.move** — starter pattern:\n```move\nmodule my_project::my_module;\n\nuse sui::event;\n\npublic struct MyEvent has copy, drop {\n    value: u64,\n}\n\npublic fun do_something(ctx: &mut TxContext) {\n    event::emit(MyEvent { value: 42 });\n}\n```\n\n**client\u002Fpackage.json** — copy exactly:\n```json\n{\n  \"name\": \"my-client\",\n  \"type\": \"module\",\n  \"dependencies\": {\n    \"@mysten\u002Fsui\": \"^2.0.0\"\n  }\n}\n```\n\n**client\u002Ftsconfig.json** — copy exactly:\n```json\n{\n  \"compilerOptions\": {\n    \"moduleResolution\": \"nodenext\",\n    \"module\": \"nodenext\",\n    \"target\": \"es2022\",\n    \"strict\": true\n  }\n}\n```\n\n#### Template: Move package with frontend\n\nSame as above, plus a `frontend\u002F` directory:\n\n**frontend\u002Fpackage.json** — copy exactly:\n```json\n{\n  \"name\": \"my-frontend\",\n  \"type\": \"module\",\n  \"dependencies\": {\n    \"@mysten\u002Fsui\": \"^2.0.0\",\n    \"@mysten\u002Fdapp-kit-react\": \"^2.0.0\",\n    \"react\": \"^19.0.0\"\n  }\n}\n```\n\n### Wrong formats that WILL error\n\n**All of these are WRONG and will cause build failures:**\n```toml\n# WRONG — legacy system name error:\nSui = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"framework\u002Ftestnet\" }\n\n# WRONG — version syntax doesn't exist in Move:\nsui = { version = \"0.34.0\" }\n\n# WRONG — local path doesn't exist:\nSui = { local = \"..\u002Fsui-framework\" }\n\n# WRONG — implicit dependency error:\nsui = { package = \"sui\", version = \"0.1.0\" }\n```\n\nOnly add `[dependencies]` when you need third-party or local packages (e.g., MVR or sibling workspace packages). The `[environments]` section is optional — only add it when deploying to multiple networks (see migration section below).\n\n**Migrating from `[addresses]`:** The old `[addresses]` section with `my_project = \"0x0\"` is no longer needed and should be removed. If your project previously used `[addresses]` to set package addresses for different networks, replace it with an `[environments]` section that maps environment names to chain IDs:\n\n```toml\n[environments]\ntestnet = \"4c78adac\"\nmainnet = \"35834a8a\"\n```\n\n### Module declaration (2024 edition)\n\nWith `edition = \"2024\"`, use single-line module declarations — no curly braces:\n\n```move\nmodule my_project::my_module;\n\n\u002F\u002F imports, structs, and functions follow at the top level\nuse sui::object::UID;\n```\n\nDo **not** use the old curly-brace syntax (`module my_project::my_module { ... }`). The 2024 edition treats the entire file as the module body after the semicolon.\n\n### Published.toml and Move.lock\n\nAfter publishing, the toolchain creates or updates:\n\n- **`Published.toml`:** Tracks your published package addresses per environment. Contains `published-at` and `upgrade-capability-id` values for each network.\n- **`Move.lock`:** Auto-generated lock file that pins every resolved dependency to a specific git revision and records manifest digests. **Do not edit manually.** Commit this to version control.\n\nTo publish to a different environment (for example, after publishing to Testnet, now deploying to Devnet), switch environments and publish again. Each network gives the package a separate ID. The `Published.toml` tracks both.\n\n### Inspecting Move.lock\n\n> **Note:** `Move.lock` is auto-generated — never copy its contents into `Move.toml`. The git URLs below appear in `Move.lock` only, not in `Move.toml`.\n\n`Move.lock` contains one `[pinned.\u003Cenv>.\u003CDependency>]` section per resolved dependency per environment. Each section records the git source, revision, manifest digest, and dependency graph. Example:\n\n```toml\n# This is Move.lock (auto-generated) — NOT Move.toml\n[pinned.testnet.Sui]\nsource = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"73dd2c...\" }\nuse_environment = \"testnet\"\nmanifest_digest = \"7AFB6669...\"\ndeps = { MoveStdlib = \"MoveStdlib\" }\n```\n\n- If `Move.lock` pins a different environment than you expect, or revisions look outdated, delete `Move.lock` and run `sui move build` to regenerate it.\n- If you see build errors after switching networks or updating the CLI, deleting `Move.lock` and rebuilding often resolves stale-lock issues.\n\n### Using MVR dependencies\n\nThe Move Registry (MVR) is an onchain package manager for Sui. Install it with:\n\n```bash\nsuiup install mvr\n```\n\nAdd an MVR dependency using the CLI:\n\n```bash\nmvr add @org\u002Fpackage --network testnet\n```\n\nOr declare it directly in `Move.toml`:\n\n```toml\n[dependencies]\nsuins = { r.mvr = \"@suins\u002Fcore\" }\n```\n\nThe `r.mvr` key tells the resolver to look up the package in the onchain Move Registry instead of fetching from a git URL. Prefer MVR dependencies over git URLs when the package is published to the registry — they are versioned, auditable, and do not depend on git history.\n\n### Common dependency and build issues\n\n- **\"Dependency 'Sui' is a legacy system name\":** Remove the `Sui = { git = \"...\" }` line from `[dependencies]`. The current CLI resolves the Sui framework automatically. This error occurs when using the old git-based dependency format.\n- **\"Packages with old dependencies\" error:** Your CLI version does not match the network. The new package management format introduced in Sui CLI v1.63 changed how dependencies are resolved. Run `suiup update sui@testnet` then `suiup switch sui@testnet` to get the latest CLI.\n- **\"Cannot upgrade package without having a published id\":** You need a `published-at` value in `Published.toml` to upgrade. This is created automatically after your first `sui client publish`. If you migrated from the old format, make sure the `Published.toml` file exists and contains the correct package address.\n- **\"Could not determine the correct dependencies\":** The build requires a `--build-env` flag or an `[environments]` section in `Move.toml`. Add the `[environments]` section with your target chain IDs.\n- **Edition mismatch:** If you get errors about `public struct` syntax, set `edition = \"2024\"` in `Move.toml`. The `legacy` edition does not support Move 2024 features like public struct visibility.\n- **Old Move.toml format:** If you are using the pre-v1.63 format with `[addresses]` and `published-at` inside `Move.toml`, migrate to the new format: remove `[addresses]`, add `[environments]`, and let the toolchain manage `Published.toml`.\n\n## Rules\n\n- Use `public(package)` visibility for non-library functions. `public` function signatures cannot be deleted or modified in upgrades.\n- Struct definitions cannot be deleted, modified, or have abilities added through upgrades.\n- Objects cannot exceed 256 KB. Avoid ever-growing vectors inside objects.\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,72,114,121,128,133,181,186,196,225,231,236,276,281,290,296,309,318,360,380,451,457,468,480,517,545,551,561,568,577,587,615,625,721,730,902,911,1097,1103,1116,1125,1351,1357,1365,1457,1477,1523,1554,1560,1572,1609,1629,1635,1640,1698,1710,1716,1756,1774,1829,1871,1877,1882,1907,1912,1947,1958,1980,1993,1999,2219,2225,2259],{"type":39,"tag":40,"props":41,"children":43},"element","h1",{"id":42},"move-project-setup",[44],{"type":45,"value":46},"text","Move Project Setup",{"type":39,"tag":48,"props":49,"children":50},"blockquote",{},[51],{"type":39,"tag":52,"props":53,"children":54},"p",{},[55,61,63,70],{"type":39,"tag":56,"props":57,"children":58},"strong",{},[59],{"type":45,"value":60},"MCP tool:",{"type":45,"value":62}," When available in your environment, also query the Sui documentation MCP server (",{"type":39,"tag":64,"props":65,"children":67},"code",{"className":66},[],[68],{"type":45,"value":69},"https:\u002F\u002Fsui.mcp.kapa.ai",{"type":45,"value":71},") for up-to-date answers. Use it for verification and for details not covered by these reference files.",{"type":39,"tag":48,"props":73,"children":74},{},[75],{"type":39,"tag":52,"props":76,"children":77},{},[78,83,85,94,96,103,105,112],{"type":39,"tag":56,"props":79,"children":80},{},[81],{"type":45,"value":82},"Source constraint:",{"type":45,"value":84}," All information sourced exclusively from ",{"type":39,"tag":86,"props":87,"children":91},"a",{"href":88,"rel":89},"https:\u002F\u002Fdocs.sui.io",[90],"nofollow",[92],{"type":45,"value":93},"docs.sui.io",{"type":45,"value":95},", ",{"type":39,"tag":86,"props":97,"children":100},{"href":98,"rel":99},"https:\u002F\u002Fmove-book.com",[90],[101],{"type":45,"value":102},"move-book.com",{"type":45,"value":104},", and ",{"type":39,"tag":86,"props":106,"children":109},{"href":107,"rel":108},"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui-stack-hello-world",[90],[110],{"type":45,"value":111},"MystenLabs\u002Fsui-stack-hello-world",{"type":45,"value":113},".",{"type":39,"tag":115,"props":116,"children":118},"h2",{"id":117},"creating-a-move-project",[119],{"type":45,"value":120},"Creating a Move project",{"type":39,"tag":122,"props":123,"children":125},"h3",{"id":124},"canonical-full-stack-hello-world-project",[126],{"type":45,"value":127},"Canonical full-stack hello-world project",{"type":39,"tag":52,"props":129,"children":130},{},[131],{"type":45,"value":132},"For an end-to-end Sui developer environment with Move and frontend, use the Sui Stack hello-world repository as the single project root:",{"type":39,"tag":134,"props":135,"children":140},"pre",{"className":136,"code":137,"language":138,"meta":139,"style":139},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","git clone https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui-stack-hello-world.git\ncd sui-stack-hello-world\n","bash","",[141],{"type":39,"tag":64,"props":142,"children":143},{"__ignoreMap":139},[144,167],{"type":39,"tag":145,"props":146,"children":149},"span",{"class":147,"line":148},"line",1,[150,156,162],{"type":39,"tag":145,"props":151,"children":153},{"style":152},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[154],{"type":45,"value":155},"git",{"type":39,"tag":145,"props":157,"children":159},{"style":158},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[160],{"type":45,"value":161}," clone",{"type":39,"tag":145,"props":163,"children":164},{"style":158},[165],{"type":45,"value":166}," https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui-stack-hello-world.git\n",{"type":39,"tag":145,"props":168,"children":169},{"class":147,"line":26},[170,176],{"type":39,"tag":145,"props":171,"children":173},{"style":172},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[174],{"type":45,"value":175},"cd",{"type":39,"tag":145,"props":177,"children":178},{"style":158},[179],{"type":45,"value":180}," sui-stack-hello-world\n",{"type":39,"tag":52,"props":182,"children":183},{},[184],{"type":45,"value":185},"Use this existing layout:",{"type":39,"tag":134,"props":187,"children":191},{"className":188,"code":190,"language":45},[189],"language-text","sui-stack-hello-world\u002F\n├── move\u002F\n│   └── hello-world\u002F   # publish this Move package\n└── ui\u002F                # run this existing frontend\n",[192],{"type":39,"tag":64,"props":193,"children":194},{"__ignoreMap":139},[195],{"type":45,"value":190},{"type":39,"tag":52,"props":197,"children":198},{},[199,201,207,209,215,217,223],{"type":45,"value":200},"Do not run ",{"type":39,"tag":64,"props":202,"children":204},{"className":203},[],[205],{"type":45,"value":206},"sui move new",{"type":45,"value":208},", do not create a counter package, and do not run ",{"type":39,"tag":64,"props":210,"children":212},{"className":211},[],[213],{"type":45,"value":214},"npm create @mysten\u002Fdapp",{"type":45,"value":216}," for this workflow. If current Sui tooling requires a package-management migration, keep the change inside ",{"type":39,"tag":64,"props":218,"children":220},{"className":219},[],[221],{"type":45,"value":222},"move\u002Fhello-world",{"type":45,"value":224}," and continue deploying the hello-world package.",{"type":39,"tag":122,"props":226,"children":228},{"id":227},"new-project-from-scratch",[229],{"type":45,"value":230},"New project from scratch",{"type":39,"tag":52,"props":232,"children":233},{},[234],{"type":45,"value":235},"Use this only when the user explicitly wants a standalone Move package rather than the full-stack hello-world app.",{"type":39,"tag":134,"props":237,"children":239},{"className":136,"code":238,"language":138,"meta":139,"style":139},"sui move new my_project\ncd my_project\n",[240],{"type":39,"tag":64,"props":241,"children":242},{"__ignoreMap":139},[243,265],{"type":39,"tag":145,"props":244,"children":245},{"class":147,"line":148},[246,250,255,260],{"type":39,"tag":145,"props":247,"children":248},{"style":152},[249],{"type":45,"value":8},{"type":39,"tag":145,"props":251,"children":252},{"style":158},[253],{"type":45,"value":254}," move",{"type":39,"tag":145,"props":256,"children":257},{"style":158},[258],{"type":45,"value":259}," new",{"type":39,"tag":145,"props":261,"children":262},{"style":158},[263],{"type":45,"value":264}," my_project\n",{"type":39,"tag":145,"props":266,"children":267},{"class":147,"line":26},[268,272],{"type":39,"tag":145,"props":269,"children":270},{"style":172},[271],{"type":45,"value":175},{"type":39,"tag":145,"props":273,"children":274},{"style":158},[275],{"type":45,"value":264},{"type":39,"tag":52,"props":277,"children":278},{},[279],{"type":45,"value":280},"This creates:",{"type":39,"tag":134,"props":282,"children":285},{"className":283,"code":284,"language":45},[189],"my_project\u002F\n├── sources\u002F       # .move source files go here\n├── tests\u002F         # test files\n└── Move.toml      # package manifest\n",[286],{"type":39,"tag":64,"props":287,"children":288},{"__ignoreMap":139},[289],{"type":45,"value":284},{"type":39,"tag":122,"props":291,"children":293},{"id":292},"multi-package-workspace-layout",[294],{"type":45,"value":295},"Multi-package workspace layout",{"type":39,"tag":52,"props":297,"children":298},{},[299,301,307],{"type":45,"value":300},"When a project contains more than one Move package (for example, a core library and an example or integration package), use a flat ",{"type":39,"tag":64,"props":302,"children":304},{"className":303},[],[305],{"type":45,"value":306},"packages\u002F",{"type":45,"value":308}," directory with each package as a sibling:",{"type":39,"tag":134,"props":310,"children":313},{"className":311,"code":312,"language":45},[189],"my_project\u002F\n├── packages\u002F\n│   ├── core\u002F\n│   │   ├── sources\u002F\n│   │   ├── tests\u002F\n│   │   └── Move.toml\n│   └── examples\u002F\n│       ├── sources\u002F\n│       ├── tests\u002F\n│       └── Move.toml\n└── ui\u002F\n",[314],{"type":39,"tag":64,"props":315,"children":316},{"__ignoreMap":139},[317],{"type":45,"value":312},{"type":39,"tag":52,"props":319,"children":320},{},[321,326,328,334,336,342,344,350,352,358],{"type":39,"tag":56,"props":322,"children":323},{},[324],{"type":45,"value":325},"Do not nest packages inside each other",{"type":45,"value":327}," (for example, placing ",{"type":39,"tag":64,"props":329,"children":331},{"className":330},[],[332],{"type":45,"value":333},"examples\u002F",{"type":45,"value":335}," inside ",{"type":39,"tag":64,"props":337,"children":339},{"className":338},[],[340],{"type":45,"value":341},"core\u002Fsources\u002F",{"type":45,"value":343}," or ",{"type":39,"tag":64,"props":345,"children":347},{"className":346},[],[348],{"type":45,"value":349},"core\u002Ftests\u002F",{"type":45,"value":351},"). Nested package directories trigger test runner bugs such as spurious \"address with no value\" errors because the toolchain picks up the inner package's ",{"type":39,"tag":64,"props":353,"children":355},{"className":354},[],[356],{"type":45,"value":357},"Move.toml",{"type":45,"value":359}," when building the outer one.",{"type":39,"tag":52,"props":361,"children":362},{},[363,365,371,373,378],{"type":45,"value":364},"To depend on a sibling package, use a ",{"type":39,"tag":64,"props":366,"children":368},{"className":367},[],[369],{"type":45,"value":370},"local",{"type":45,"value":372}," path in ",{"type":39,"tag":64,"props":374,"children":376},{"className":375},[],[377],{"type":45,"value":357},{"type":45,"value":379},":",{"type":39,"tag":134,"props":381,"children":385},{"className":382,"code":383,"language":384,"meta":139,"style":139},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# packages\u002Fexamples\u002FMove.toml\n[package]\nname = \"examples\"\nedition = \"2024\"\n\n[dependencies]\ncore = { local = \"..\u002Fcore\" }\n","toml",[386],{"type":39,"tag":64,"props":387,"children":388},{"__ignoreMap":139},[389,397,405,414,423,433,442],{"type":39,"tag":145,"props":390,"children":391},{"class":147,"line":148},[392],{"type":39,"tag":145,"props":393,"children":394},{},[395],{"type":45,"value":396},"# packages\u002Fexamples\u002FMove.toml\n",{"type":39,"tag":145,"props":398,"children":399},{"class":147,"line":26},[400],{"type":39,"tag":145,"props":401,"children":402},{},[403],{"type":45,"value":404},"[package]\n",{"type":39,"tag":145,"props":406,"children":408},{"class":147,"line":407},3,[409],{"type":39,"tag":145,"props":410,"children":411},{},[412],{"type":45,"value":413},"name = \"examples\"\n",{"type":39,"tag":145,"props":415,"children":417},{"class":147,"line":416},4,[418],{"type":39,"tag":145,"props":419,"children":420},{},[421],{"type":45,"value":422},"edition = \"2024\"\n",{"type":39,"tag":145,"props":424,"children":426},{"class":147,"line":425},5,[427],{"type":39,"tag":145,"props":428,"children":430},{"emptyLinePlaceholder":429},true,[431],{"type":45,"value":432},"\n",{"type":39,"tag":145,"props":434,"children":436},{"class":147,"line":435},6,[437],{"type":39,"tag":145,"props":438,"children":439},{},[440],{"type":45,"value":441},"[dependencies]\n",{"type":39,"tag":145,"props":443,"children":445},{"class":147,"line":444},7,[446],{"type":39,"tag":145,"props":447,"children":448},{},[449],{"type":45,"value":450},"core = { local = \"..\u002Fcore\" }\n",{"type":39,"tag":122,"props":452,"children":454},{"id":453},"movetoml-current-format-sui-cli-v163",[455],{"type":45,"value":456},"Move.toml (current format — Sui CLI v1.63+)",{"type":39,"tag":48,"props":458,"children":459},{},[460],{"type":39,"tag":52,"props":461,"children":462},{},[463],{"type":39,"tag":56,"props":464,"children":465},{},[466],{"type":45,"value":467},"CRITICAL: The Sui framework dependency is automatic. Do NOT add it to Move.toml.",{"type":39,"tag":52,"props":469,"children":470},{},[471,473,478],{"type":45,"value":472},"A correct, minimal ",{"type":39,"tag":64,"props":474,"children":476},{"className":475},[],[477],{"type":45,"value":357},{"type":45,"value":479}," for any Sui Move project is:",{"type":39,"tag":134,"props":481,"children":483},{"className":382,"code":482,"language":384,"meta":139,"style":139},"[package]\nname = \"my_project\"\nedition = \"2024\"\n# No [dependencies] section needed — Sui framework is resolved automatically\n",[484],{"type":39,"tag":64,"props":485,"children":486},{"__ignoreMap":139},[487,494,502,509],{"type":39,"tag":145,"props":488,"children":489},{"class":147,"line":148},[490],{"type":39,"tag":145,"props":491,"children":492},{},[493],{"type":45,"value":404},{"type":39,"tag":145,"props":495,"children":496},{"class":147,"line":26},[497],{"type":39,"tag":145,"props":498,"children":499},{},[500],{"type":45,"value":501},"name = \"my_project\"\n",{"type":39,"tag":145,"props":503,"children":504},{"class":147,"line":407},[505],{"type":39,"tag":145,"props":506,"children":507},{},[508],{"type":45,"value":422},{"type":39,"tag":145,"props":510,"children":511},{"class":147,"line":416},[512],{"type":39,"tag":145,"props":513,"children":514},{},[515],{"type":45,"value":516},"# No [dependencies] section needed — Sui framework is resolved automatically\n",{"type":39,"tag":52,"props":518,"children":519},{},[520,522,527,529,535,537,543],{"type":45,"value":521},"This is ",{"type":39,"tag":56,"props":523,"children":524},{},[525],{"type":45,"value":526},"all you need",{"type":45,"value":528},". The ",{"type":39,"tag":64,"props":530,"children":532},{"className":531},[],[533],{"type":45,"value":534},"edition = \"2024\"",{"type":45,"value":536}," line tells the CLI to resolve Sui and MoveStdlib automatically. There is no ",{"type":39,"tag":64,"props":538,"children":540},{"className":539},[],[541],{"type":45,"value":542},"[dependencies]",{"type":45,"value":544}," section unless you need third-party or local packages.",{"type":39,"tag":122,"props":546,"children":548},{"id":547},"complete-working-project-templates",[549],{"type":45,"value":550},"Complete working project templates",{"type":39,"tag":52,"props":552,"children":553},{},[554,559],{"type":39,"tag":56,"props":555,"children":556},{},[557],{"type":45,"value":558},"Always use these exact templates when generating Move projects.",{"type":45,"value":560}," Copy them verbatim — do not modify the Move.toml format.",{"type":39,"tag":562,"props":563,"children":565},"h4",{"id":564},"template-single-move-package-with-typescript-client",[566],{"type":45,"value":567},"Template: Single Move package with TypeScript client",{"type":39,"tag":134,"props":569,"children":572},{"className":570,"code":571,"language":45},[189],"project\u002F\n├── move\u002F\n│   ├── Move.toml\n│   └── sources\u002F\n│       └── my_module.move\n└── client\u002F\n    ├── package.json\n    └── src\u002F\n        └── index.ts\n",[573],{"type":39,"tag":64,"props":574,"children":575},{"__ignoreMap":139},[576],{"type":45,"value":571},{"type":39,"tag":52,"props":578,"children":579},{},[580,585],{"type":39,"tag":56,"props":581,"children":582},{},[583],{"type":45,"value":584},"move\u002FMove.toml",{"type":45,"value":586}," — copy exactly:",{"type":39,"tag":134,"props":588,"children":590},{"className":382,"code":589,"language":384,"meta":139,"style":139},"[package]\nname = \"my_project\"\nedition = \"2024\"\n",[591],{"type":39,"tag":64,"props":592,"children":593},{"__ignoreMap":139},[594,601,608],{"type":39,"tag":145,"props":595,"children":596},{"class":147,"line":148},[597],{"type":39,"tag":145,"props":598,"children":599},{},[600],{"type":45,"value":404},{"type":39,"tag":145,"props":602,"children":603},{"class":147,"line":26},[604],{"type":39,"tag":145,"props":605,"children":606},{},[607],{"type":45,"value":501},{"type":39,"tag":145,"props":609,"children":610},{"class":147,"line":407},[611],{"type":39,"tag":145,"props":612,"children":613},{},[614],{"type":45,"value":422},{"type":39,"tag":52,"props":616,"children":617},{},[618,623],{"type":39,"tag":56,"props":619,"children":620},{},[621],{"type":45,"value":622},"move\u002Fsources\u002Fmy_module.move",{"type":45,"value":624}," — starter pattern:",{"type":39,"tag":134,"props":626,"children":630},{"className":627,"code":628,"language":629,"meta":139,"style":139},"language-move shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","module my_project::my_module;\n\nuse sui::event;\n\npublic struct MyEvent has copy, drop {\n    value: u64,\n}\n\npublic fun do_something(ctx: &mut TxContext) {\n    event::emit(MyEvent { value: 42 });\n}\n","move",[631],{"type":39,"tag":64,"props":632,"children":633},{"__ignoreMap":139},[634,642,649,657,664,672,680,688,696,704,713],{"type":39,"tag":145,"props":635,"children":636},{"class":147,"line":148},[637],{"type":39,"tag":145,"props":638,"children":639},{},[640],{"type":45,"value":641},"module my_project::my_module;\n",{"type":39,"tag":145,"props":643,"children":644},{"class":147,"line":26},[645],{"type":39,"tag":145,"props":646,"children":647},{"emptyLinePlaceholder":429},[648],{"type":45,"value":432},{"type":39,"tag":145,"props":650,"children":651},{"class":147,"line":407},[652],{"type":39,"tag":145,"props":653,"children":654},{},[655],{"type":45,"value":656},"use sui::event;\n",{"type":39,"tag":145,"props":658,"children":659},{"class":147,"line":416},[660],{"type":39,"tag":145,"props":661,"children":662},{"emptyLinePlaceholder":429},[663],{"type":45,"value":432},{"type":39,"tag":145,"props":665,"children":666},{"class":147,"line":425},[667],{"type":39,"tag":145,"props":668,"children":669},{},[670],{"type":45,"value":671},"public struct MyEvent has copy, drop {\n",{"type":39,"tag":145,"props":673,"children":674},{"class":147,"line":435},[675],{"type":39,"tag":145,"props":676,"children":677},{},[678],{"type":45,"value":679},"    value: u64,\n",{"type":39,"tag":145,"props":681,"children":682},{"class":147,"line":444},[683],{"type":39,"tag":145,"props":684,"children":685},{},[686],{"type":45,"value":687},"}\n",{"type":39,"tag":145,"props":689,"children":691},{"class":147,"line":690},8,[692],{"type":39,"tag":145,"props":693,"children":694},{"emptyLinePlaceholder":429},[695],{"type":45,"value":432},{"type":39,"tag":145,"props":697,"children":698},{"class":147,"line":22},[699],{"type":39,"tag":145,"props":700,"children":701},{},[702],{"type":45,"value":703},"public fun do_something(ctx: &mut TxContext) {\n",{"type":39,"tag":145,"props":705,"children":707},{"class":147,"line":706},10,[708],{"type":39,"tag":145,"props":709,"children":710},{},[711],{"type":45,"value":712},"    event::emit(MyEvent { value: 42 });\n",{"type":39,"tag":145,"props":714,"children":716},{"class":147,"line":715},11,[717],{"type":39,"tag":145,"props":718,"children":719},{},[720],{"type":45,"value":687},{"type":39,"tag":52,"props":722,"children":723},{},[724,729],{"type":39,"tag":56,"props":725,"children":726},{},[727],{"type":45,"value":728},"client\u002Fpackage.json",{"type":45,"value":586},{"type":39,"tag":134,"props":731,"children":735},{"className":732,"code":733,"language":734,"meta":139,"style":139},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"name\": \"my-client\",\n  \"type\": \"module\",\n  \"dependencies\": {\n    \"@mysten\u002Fsui\": \"^2.0.0\"\n  }\n}\n","json",[736],{"type":39,"tag":64,"props":737,"children":738},{"__ignoreMap":139},[739,748,790,827,852,887,895],{"type":39,"tag":145,"props":740,"children":741},{"class":147,"line":148},[742],{"type":39,"tag":145,"props":743,"children":745},{"style":744},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[746],{"type":45,"value":747},"{\n",{"type":39,"tag":145,"props":749,"children":750},{"class":147,"line":26},[751,756,762,767,771,776,781,785],{"type":39,"tag":145,"props":752,"children":753},{"style":744},[754],{"type":45,"value":755},"  \"",{"type":39,"tag":145,"props":757,"children":759},{"style":758},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[760],{"type":45,"value":761},"name",{"type":39,"tag":145,"props":763,"children":764},{"style":744},[765],{"type":45,"value":766},"\"",{"type":39,"tag":145,"props":768,"children":769},{"style":744},[770],{"type":45,"value":379},{"type":39,"tag":145,"props":772,"children":773},{"style":744},[774],{"type":45,"value":775}," \"",{"type":39,"tag":145,"props":777,"children":778},{"style":158},[779],{"type":45,"value":780},"my-client",{"type":39,"tag":145,"props":782,"children":783},{"style":744},[784],{"type":45,"value":766},{"type":39,"tag":145,"props":786,"children":787},{"style":744},[788],{"type":45,"value":789},",\n",{"type":39,"tag":145,"props":791,"children":792},{"class":147,"line":407},[793,797,802,806,810,814,819,823],{"type":39,"tag":145,"props":794,"children":795},{"style":744},[796],{"type":45,"value":755},{"type":39,"tag":145,"props":798,"children":799},{"style":758},[800],{"type":45,"value":801},"type",{"type":39,"tag":145,"props":803,"children":804},{"style":744},[805],{"type":45,"value":766},{"type":39,"tag":145,"props":807,"children":808},{"style":744},[809],{"type":45,"value":379},{"type":39,"tag":145,"props":811,"children":812},{"style":744},[813],{"type":45,"value":775},{"type":39,"tag":145,"props":815,"children":816},{"style":158},[817],{"type":45,"value":818},"module",{"type":39,"tag":145,"props":820,"children":821},{"style":744},[822],{"type":45,"value":766},{"type":39,"tag":145,"props":824,"children":825},{"style":744},[826],{"type":45,"value":789},{"type":39,"tag":145,"props":828,"children":829},{"class":147,"line":416},[830,834,839,843,847],{"type":39,"tag":145,"props":831,"children":832},{"style":744},[833],{"type":45,"value":755},{"type":39,"tag":145,"props":835,"children":836},{"style":758},[837],{"type":45,"value":838},"dependencies",{"type":39,"tag":145,"props":840,"children":841},{"style":744},[842],{"type":45,"value":766},{"type":39,"tag":145,"props":844,"children":845},{"style":744},[846],{"type":45,"value":379},{"type":39,"tag":145,"props":848,"children":849},{"style":744},[850],{"type":45,"value":851}," {\n",{"type":39,"tag":145,"props":853,"children":854},{"class":147,"line":425},[855,860,865,869,873,877,882],{"type":39,"tag":145,"props":856,"children":857},{"style":744},[858],{"type":45,"value":859},"    \"",{"type":39,"tag":145,"props":861,"children":862},{"style":152},[863],{"type":45,"value":864},"@mysten\u002Fsui",{"type":39,"tag":145,"props":866,"children":867},{"style":744},[868],{"type":45,"value":766},{"type":39,"tag":145,"props":870,"children":871},{"style":744},[872],{"type":45,"value":379},{"type":39,"tag":145,"props":874,"children":875},{"style":744},[876],{"type":45,"value":775},{"type":39,"tag":145,"props":878,"children":879},{"style":158},[880],{"type":45,"value":881},"^2.0.0",{"type":39,"tag":145,"props":883,"children":884},{"style":744},[885],{"type":45,"value":886},"\"\n",{"type":39,"tag":145,"props":888,"children":889},{"class":147,"line":435},[890],{"type":39,"tag":145,"props":891,"children":892},{"style":744},[893],{"type":45,"value":894},"  }\n",{"type":39,"tag":145,"props":896,"children":897},{"class":147,"line":444},[898],{"type":39,"tag":145,"props":899,"children":900},{"style":744},[901],{"type":45,"value":687},{"type":39,"tag":52,"props":903,"children":904},{},[905,910],{"type":39,"tag":56,"props":906,"children":907},{},[908],{"type":45,"value":909},"client\u002Ftsconfig.json",{"type":45,"value":586},{"type":39,"tag":134,"props":912,"children":914},{"className":732,"code":913,"language":734,"meta":139,"style":139},"{\n  \"compilerOptions\": {\n    \"moduleResolution\": \"nodenext\",\n    \"module\": \"nodenext\",\n    \"target\": \"es2022\",\n    \"strict\": true\n  }\n}\n",[915],{"type":39,"tag":64,"props":916,"children":917},{"__ignoreMap":139},[918,925,949,986,1021,1058,1083,1090],{"type":39,"tag":145,"props":919,"children":920},{"class":147,"line":148},[921],{"type":39,"tag":145,"props":922,"children":923},{"style":744},[924],{"type":45,"value":747},{"type":39,"tag":145,"props":926,"children":927},{"class":147,"line":26},[928,932,937,941,945],{"type":39,"tag":145,"props":929,"children":930},{"style":744},[931],{"type":45,"value":755},{"type":39,"tag":145,"props":933,"children":934},{"style":758},[935],{"type":45,"value":936},"compilerOptions",{"type":39,"tag":145,"props":938,"children":939},{"style":744},[940],{"type":45,"value":766},{"type":39,"tag":145,"props":942,"children":943},{"style":744},[944],{"type":45,"value":379},{"type":39,"tag":145,"props":946,"children":947},{"style":744},[948],{"type":45,"value":851},{"type":39,"tag":145,"props":950,"children":951},{"class":147,"line":407},[952,956,961,965,969,973,978,982],{"type":39,"tag":145,"props":953,"children":954},{"style":744},[955],{"type":45,"value":859},{"type":39,"tag":145,"props":957,"children":958},{"style":152},[959],{"type":45,"value":960},"moduleResolution",{"type":39,"tag":145,"props":962,"children":963},{"style":744},[964],{"type":45,"value":766},{"type":39,"tag":145,"props":966,"children":967},{"style":744},[968],{"type":45,"value":379},{"type":39,"tag":145,"props":970,"children":971},{"style":744},[972],{"type":45,"value":775},{"type":39,"tag":145,"props":974,"children":975},{"style":158},[976],{"type":45,"value":977},"nodenext",{"type":39,"tag":145,"props":979,"children":980},{"style":744},[981],{"type":45,"value":766},{"type":39,"tag":145,"props":983,"children":984},{"style":744},[985],{"type":45,"value":789},{"type":39,"tag":145,"props":987,"children":988},{"class":147,"line":416},[989,993,997,1001,1005,1009,1013,1017],{"type":39,"tag":145,"props":990,"children":991},{"style":744},[992],{"type":45,"value":859},{"type":39,"tag":145,"props":994,"children":995},{"style":152},[996],{"type":45,"value":818},{"type":39,"tag":145,"props":998,"children":999},{"style":744},[1000],{"type":45,"value":766},{"type":39,"tag":145,"props":1002,"children":1003},{"style":744},[1004],{"type":45,"value":379},{"type":39,"tag":145,"props":1006,"children":1007},{"style":744},[1008],{"type":45,"value":775},{"type":39,"tag":145,"props":1010,"children":1011},{"style":158},[1012],{"type":45,"value":977},{"type":39,"tag":145,"props":1014,"children":1015},{"style":744},[1016],{"type":45,"value":766},{"type":39,"tag":145,"props":1018,"children":1019},{"style":744},[1020],{"type":45,"value":789},{"type":39,"tag":145,"props":1022,"children":1023},{"class":147,"line":425},[1024,1028,1033,1037,1041,1045,1050,1054],{"type":39,"tag":145,"props":1025,"children":1026},{"style":744},[1027],{"type":45,"value":859},{"type":39,"tag":145,"props":1029,"children":1030},{"style":152},[1031],{"type":45,"value":1032},"target",{"type":39,"tag":145,"props":1034,"children":1035},{"style":744},[1036],{"type":45,"value":766},{"type":39,"tag":145,"props":1038,"children":1039},{"style":744},[1040],{"type":45,"value":379},{"type":39,"tag":145,"props":1042,"children":1043},{"style":744},[1044],{"type":45,"value":775},{"type":39,"tag":145,"props":1046,"children":1047},{"style":158},[1048],{"type":45,"value":1049},"es2022",{"type":39,"tag":145,"props":1051,"children":1052},{"style":744},[1053],{"type":45,"value":766},{"type":39,"tag":145,"props":1055,"children":1056},{"style":744},[1057],{"type":45,"value":789},{"type":39,"tag":145,"props":1059,"children":1060},{"class":147,"line":435},[1061,1065,1070,1074,1078],{"type":39,"tag":145,"props":1062,"children":1063},{"style":744},[1064],{"type":45,"value":859},{"type":39,"tag":145,"props":1066,"children":1067},{"style":152},[1068],{"type":45,"value":1069},"strict",{"type":39,"tag":145,"props":1071,"children":1072},{"style":744},[1073],{"type":45,"value":766},{"type":39,"tag":145,"props":1075,"children":1076},{"style":744},[1077],{"type":45,"value":379},{"type":39,"tag":145,"props":1079,"children":1080},{"style":744},[1081],{"type":45,"value":1082}," true\n",{"type":39,"tag":145,"props":1084,"children":1085},{"class":147,"line":444},[1086],{"type":39,"tag":145,"props":1087,"children":1088},{"style":744},[1089],{"type":45,"value":894},{"type":39,"tag":145,"props":1091,"children":1092},{"class":147,"line":690},[1093],{"type":39,"tag":145,"props":1094,"children":1095},{"style":744},[1096],{"type":45,"value":687},{"type":39,"tag":562,"props":1098,"children":1100},{"id":1099},"template-move-package-with-frontend",[1101],{"type":45,"value":1102},"Template: Move package with frontend",{"type":39,"tag":52,"props":1104,"children":1105},{},[1106,1108,1114],{"type":45,"value":1107},"Same as above, plus a ",{"type":39,"tag":64,"props":1109,"children":1111},{"className":1110},[],[1112],{"type":45,"value":1113},"frontend\u002F",{"type":45,"value":1115}," directory:",{"type":39,"tag":52,"props":1117,"children":1118},{},[1119,1124],{"type":39,"tag":56,"props":1120,"children":1121},{},[1122],{"type":45,"value":1123},"frontend\u002Fpackage.json",{"type":45,"value":586},{"type":39,"tag":134,"props":1126,"children":1128},{"className":732,"code":1127,"language":734,"meta":139,"style":139},"{\n  \"name\": \"my-frontend\",\n  \"type\": \"module\",\n  \"dependencies\": {\n    \"@mysten\u002Fsui\": \"^2.0.0\",\n    \"@mysten\u002Fdapp-kit-react\": \"^2.0.0\",\n    \"react\": \"^19.0.0\"\n  }\n}\n",[1129],{"type":39,"tag":64,"props":1130,"children":1131},{"__ignoreMap":139},[1132,1139,1175,1210,1233,1268,1304,1337,1344],{"type":39,"tag":145,"props":1133,"children":1134},{"class":147,"line":148},[1135],{"type":39,"tag":145,"props":1136,"children":1137},{"style":744},[1138],{"type":45,"value":747},{"type":39,"tag":145,"props":1140,"children":1141},{"class":147,"line":26},[1142,1146,1150,1154,1158,1162,1167,1171],{"type":39,"tag":145,"props":1143,"children":1144},{"style":744},[1145],{"type":45,"value":755},{"type":39,"tag":145,"props":1147,"children":1148},{"style":758},[1149],{"type":45,"value":761},{"type":39,"tag":145,"props":1151,"children":1152},{"style":744},[1153],{"type":45,"value":766},{"type":39,"tag":145,"props":1155,"children":1156},{"style":744},[1157],{"type":45,"value":379},{"type":39,"tag":145,"props":1159,"children":1160},{"style":744},[1161],{"type":45,"value":775},{"type":39,"tag":145,"props":1163,"children":1164},{"style":158},[1165],{"type":45,"value":1166},"my-frontend",{"type":39,"tag":145,"props":1168,"children":1169},{"style":744},[1170],{"type":45,"value":766},{"type":39,"tag":145,"props":1172,"children":1173},{"style":744},[1174],{"type":45,"value":789},{"type":39,"tag":145,"props":1176,"children":1177},{"class":147,"line":407},[1178,1182,1186,1190,1194,1198,1202,1206],{"type":39,"tag":145,"props":1179,"children":1180},{"style":744},[1181],{"type":45,"value":755},{"type":39,"tag":145,"props":1183,"children":1184},{"style":758},[1185],{"type":45,"value":801},{"type":39,"tag":145,"props":1187,"children":1188},{"style":744},[1189],{"type":45,"value":766},{"type":39,"tag":145,"props":1191,"children":1192},{"style":744},[1193],{"type":45,"value":379},{"type":39,"tag":145,"props":1195,"children":1196},{"style":744},[1197],{"type":45,"value":775},{"type":39,"tag":145,"props":1199,"children":1200},{"style":158},[1201],{"type":45,"value":818},{"type":39,"tag":145,"props":1203,"children":1204},{"style":744},[1205],{"type":45,"value":766},{"type":39,"tag":145,"props":1207,"children":1208},{"style":744},[1209],{"type":45,"value":789},{"type":39,"tag":145,"props":1211,"children":1212},{"class":147,"line":416},[1213,1217,1221,1225,1229],{"type":39,"tag":145,"props":1214,"children":1215},{"style":744},[1216],{"type":45,"value":755},{"type":39,"tag":145,"props":1218,"children":1219},{"style":758},[1220],{"type":45,"value":838},{"type":39,"tag":145,"props":1222,"children":1223},{"style":744},[1224],{"type":45,"value":766},{"type":39,"tag":145,"props":1226,"children":1227},{"style":744},[1228],{"type":45,"value":379},{"type":39,"tag":145,"props":1230,"children":1231},{"style":744},[1232],{"type":45,"value":851},{"type":39,"tag":145,"props":1234,"children":1235},{"class":147,"line":425},[1236,1240,1244,1248,1252,1256,1260,1264],{"type":39,"tag":145,"props":1237,"children":1238},{"style":744},[1239],{"type":45,"value":859},{"type":39,"tag":145,"props":1241,"children":1242},{"style":152},[1243],{"type":45,"value":864},{"type":39,"tag":145,"props":1245,"children":1246},{"style":744},[1247],{"type":45,"value":766},{"type":39,"tag":145,"props":1249,"children":1250},{"style":744},[1251],{"type":45,"value":379},{"type":39,"tag":145,"props":1253,"children":1254},{"style":744},[1255],{"type":45,"value":775},{"type":39,"tag":145,"props":1257,"children":1258},{"style":158},[1259],{"type":45,"value":881},{"type":39,"tag":145,"props":1261,"children":1262},{"style":744},[1263],{"type":45,"value":766},{"type":39,"tag":145,"props":1265,"children":1266},{"style":744},[1267],{"type":45,"value":789},{"type":39,"tag":145,"props":1269,"children":1270},{"class":147,"line":435},[1271,1275,1280,1284,1288,1292,1296,1300],{"type":39,"tag":145,"props":1272,"children":1273},{"style":744},[1274],{"type":45,"value":859},{"type":39,"tag":145,"props":1276,"children":1277},{"style":152},[1278],{"type":45,"value":1279},"@mysten\u002Fdapp-kit-react",{"type":39,"tag":145,"props":1281,"children":1282},{"style":744},[1283],{"type":45,"value":766},{"type":39,"tag":145,"props":1285,"children":1286},{"style":744},[1287],{"type":45,"value":379},{"type":39,"tag":145,"props":1289,"children":1290},{"style":744},[1291],{"type":45,"value":775},{"type":39,"tag":145,"props":1293,"children":1294},{"style":158},[1295],{"type":45,"value":881},{"type":39,"tag":145,"props":1297,"children":1298},{"style":744},[1299],{"type":45,"value":766},{"type":39,"tag":145,"props":1301,"children":1302},{"style":744},[1303],{"type":45,"value":789},{"type":39,"tag":145,"props":1305,"children":1306},{"class":147,"line":444},[1307,1311,1316,1320,1324,1328,1333],{"type":39,"tag":145,"props":1308,"children":1309},{"style":744},[1310],{"type":45,"value":859},{"type":39,"tag":145,"props":1312,"children":1313},{"style":152},[1314],{"type":45,"value":1315},"react",{"type":39,"tag":145,"props":1317,"children":1318},{"style":744},[1319],{"type":45,"value":766},{"type":39,"tag":145,"props":1321,"children":1322},{"style":744},[1323],{"type":45,"value":379},{"type":39,"tag":145,"props":1325,"children":1326},{"style":744},[1327],{"type":45,"value":775},{"type":39,"tag":145,"props":1329,"children":1330},{"style":158},[1331],{"type":45,"value":1332},"^19.0.0",{"type":39,"tag":145,"props":1334,"children":1335},{"style":744},[1336],{"type":45,"value":886},{"type":39,"tag":145,"props":1338,"children":1339},{"class":147,"line":690},[1340],{"type":39,"tag":145,"props":1341,"children":1342},{"style":744},[1343],{"type":45,"value":894},{"type":39,"tag":145,"props":1345,"children":1346},{"class":147,"line":22},[1347],{"type":39,"tag":145,"props":1348,"children":1349},{"style":744},[1350],{"type":45,"value":687},{"type":39,"tag":122,"props":1352,"children":1354},{"id":1353},"wrong-formats-that-will-error",[1355],{"type":45,"value":1356},"Wrong formats that WILL error",{"type":39,"tag":52,"props":1358,"children":1359},{},[1360],{"type":39,"tag":56,"props":1361,"children":1362},{},[1363],{"type":45,"value":1364},"All of these are WRONG and will cause build failures:",{"type":39,"tag":134,"props":1366,"children":1368},{"className":382,"code":1367,"language":384,"meta":139,"style":139},"# WRONG — legacy system name error:\nSui = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"framework\u002Ftestnet\" }\n\n# WRONG — version syntax doesn't exist in Move:\nsui = { version = \"0.34.0\" }\n\n# WRONG — local path doesn't exist:\nSui = { local = \"..\u002Fsui-framework\" }\n\n# WRONG — implicit dependency error:\nsui = { package = \"sui\", version = \"0.1.0\" }\n",[1369],{"type":39,"tag":64,"props":1370,"children":1371},{"__ignoreMap":139},[1372,1380,1388,1395,1403,1411,1418,1426,1434,1441,1449],{"type":39,"tag":145,"props":1373,"children":1374},{"class":147,"line":148},[1375],{"type":39,"tag":145,"props":1376,"children":1377},{},[1378],{"type":45,"value":1379},"# WRONG — legacy system name error:\n",{"type":39,"tag":145,"props":1381,"children":1382},{"class":147,"line":26},[1383],{"type":39,"tag":145,"props":1384,"children":1385},{},[1386],{"type":45,"value":1387},"Sui = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"framework\u002Ftestnet\" }\n",{"type":39,"tag":145,"props":1389,"children":1390},{"class":147,"line":407},[1391],{"type":39,"tag":145,"props":1392,"children":1393},{"emptyLinePlaceholder":429},[1394],{"type":45,"value":432},{"type":39,"tag":145,"props":1396,"children":1397},{"class":147,"line":416},[1398],{"type":39,"tag":145,"props":1399,"children":1400},{},[1401],{"type":45,"value":1402},"# WRONG — version syntax doesn't exist in Move:\n",{"type":39,"tag":145,"props":1404,"children":1405},{"class":147,"line":425},[1406],{"type":39,"tag":145,"props":1407,"children":1408},{},[1409],{"type":45,"value":1410},"sui = { version = \"0.34.0\" }\n",{"type":39,"tag":145,"props":1412,"children":1413},{"class":147,"line":435},[1414],{"type":39,"tag":145,"props":1415,"children":1416},{"emptyLinePlaceholder":429},[1417],{"type":45,"value":432},{"type":39,"tag":145,"props":1419,"children":1420},{"class":147,"line":444},[1421],{"type":39,"tag":145,"props":1422,"children":1423},{},[1424],{"type":45,"value":1425},"# WRONG — local path doesn't exist:\n",{"type":39,"tag":145,"props":1427,"children":1428},{"class":147,"line":690},[1429],{"type":39,"tag":145,"props":1430,"children":1431},{},[1432],{"type":45,"value":1433},"Sui = { local = \"..\u002Fsui-framework\" }\n",{"type":39,"tag":145,"props":1435,"children":1436},{"class":147,"line":22},[1437],{"type":39,"tag":145,"props":1438,"children":1439},{"emptyLinePlaceholder":429},[1440],{"type":45,"value":432},{"type":39,"tag":145,"props":1442,"children":1443},{"class":147,"line":706},[1444],{"type":39,"tag":145,"props":1445,"children":1446},{},[1447],{"type":45,"value":1448},"# WRONG — implicit dependency error:\n",{"type":39,"tag":145,"props":1450,"children":1451},{"class":147,"line":715},[1452],{"type":39,"tag":145,"props":1453,"children":1454},{},[1455],{"type":45,"value":1456},"sui = { package = \"sui\", version = \"0.1.0\" }\n",{"type":39,"tag":52,"props":1458,"children":1459},{},[1460,1462,1467,1469,1475],{"type":45,"value":1461},"Only add ",{"type":39,"tag":64,"props":1463,"children":1465},{"className":1464},[],[1466],{"type":45,"value":542},{"type":45,"value":1468}," when you need third-party or local packages (e.g., MVR or sibling workspace packages). The ",{"type":39,"tag":64,"props":1470,"children":1472},{"className":1471},[],[1473],{"type":45,"value":1474},"[environments]",{"type":45,"value":1476}," section is optional — only add it when deploying to multiple networks (see migration section below).",{"type":39,"tag":52,"props":1478,"children":1479},{},[1480,1492,1494,1499,1501,1507,1509,1514,1516,1521],{"type":39,"tag":56,"props":1481,"children":1482},{},[1483,1485,1491],{"type":45,"value":1484},"Migrating from ",{"type":39,"tag":64,"props":1486,"children":1488},{"className":1487},[],[1489],{"type":45,"value":1490},"[addresses]",{"type":45,"value":379},{"type":45,"value":1493}," The old ",{"type":39,"tag":64,"props":1495,"children":1497},{"className":1496},[],[1498],{"type":45,"value":1490},{"type":45,"value":1500}," section with ",{"type":39,"tag":64,"props":1502,"children":1504},{"className":1503},[],[1505],{"type":45,"value":1506},"my_project = \"0x0\"",{"type":45,"value":1508}," is no longer needed and should be removed. If your project previously used ",{"type":39,"tag":64,"props":1510,"children":1512},{"className":1511},[],[1513],{"type":45,"value":1490},{"type":45,"value":1515}," to set package addresses for different networks, replace it with an ",{"type":39,"tag":64,"props":1517,"children":1519},{"className":1518},[],[1520],{"type":45,"value":1474},{"type":45,"value":1522}," section that maps environment names to chain IDs:",{"type":39,"tag":134,"props":1524,"children":1526},{"className":382,"code":1525,"language":384,"meta":139,"style":139},"[environments]\ntestnet = \"4c78adac\"\nmainnet = \"35834a8a\"\n",[1527],{"type":39,"tag":64,"props":1528,"children":1529},{"__ignoreMap":139},[1530,1538,1546],{"type":39,"tag":145,"props":1531,"children":1532},{"class":147,"line":148},[1533],{"type":39,"tag":145,"props":1534,"children":1535},{},[1536],{"type":45,"value":1537},"[environments]\n",{"type":39,"tag":145,"props":1539,"children":1540},{"class":147,"line":26},[1541],{"type":39,"tag":145,"props":1542,"children":1543},{},[1544],{"type":45,"value":1545},"testnet = \"4c78adac\"\n",{"type":39,"tag":145,"props":1547,"children":1548},{"class":147,"line":407},[1549],{"type":39,"tag":145,"props":1550,"children":1551},{},[1552],{"type":45,"value":1553},"mainnet = \"35834a8a\"\n",{"type":39,"tag":122,"props":1555,"children":1557},{"id":1556},"module-declaration-2024-edition",[1558],{"type":45,"value":1559},"Module declaration (2024 edition)",{"type":39,"tag":52,"props":1561,"children":1562},{},[1563,1565,1570],{"type":45,"value":1564},"With ",{"type":39,"tag":64,"props":1566,"children":1568},{"className":1567},[],[1569],{"type":45,"value":534},{"type":45,"value":1571},", use single-line module declarations — no curly braces:",{"type":39,"tag":134,"props":1573,"children":1575},{"className":627,"code":1574,"language":629,"meta":139,"style":139},"module my_project::my_module;\n\n\u002F\u002F imports, structs, and functions follow at the top level\nuse sui::object::UID;\n",[1576],{"type":39,"tag":64,"props":1577,"children":1578},{"__ignoreMap":139},[1579,1586,1593,1601],{"type":39,"tag":145,"props":1580,"children":1581},{"class":147,"line":148},[1582],{"type":39,"tag":145,"props":1583,"children":1584},{},[1585],{"type":45,"value":641},{"type":39,"tag":145,"props":1587,"children":1588},{"class":147,"line":26},[1589],{"type":39,"tag":145,"props":1590,"children":1591},{"emptyLinePlaceholder":429},[1592],{"type":45,"value":432},{"type":39,"tag":145,"props":1594,"children":1595},{"class":147,"line":407},[1596],{"type":39,"tag":145,"props":1597,"children":1598},{},[1599],{"type":45,"value":1600},"\u002F\u002F imports, structs, and functions follow at the top level\n",{"type":39,"tag":145,"props":1602,"children":1603},{"class":147,"line":416},[1604],{"type":39,"tag":145,"props":1605,"children":1606},{},[1607],{"type":45,"value":1608},"use sui::object::UID;\n",{"type":39,"tag":52,"props":1610,"children":1611},{},[1612,1614,1619,1621,1627],{"type":45,"value":1613},"Do ",{"type":39,"tag":56,"props":1615,"children":1616},{},[1617],{"type":45,"value":1618},"not",{"type":45,"value":1620}," use the old curly-brace syntax (",{"type":39,"tag":64,"props":1622,"children":1624},{"className":1623},[],[1625],{"type":45,"value":1626},"module my_project::my_module { ... }",{"type":45,"value":1628},"). The 2024 edition treats the entire file as the module body after the semicolon.",{"type":39,"tag":122,"props":1630,"children":1632},{"id":1631},"publishedtoml-and-movelock",[1633],{"type":45,"value":1634},"Published.toml and Move.lock",{"type":39,"tag":52,"props":1636,"children":1637},{},[1638],{"type":45,"value":1639},"After publishing, the toolchain creates or updates:",{"type":39,"tag":1641,"props":1642,"children":1643},"ul",{},[1644,1676],{"type":39,"tag":1645,"props":1646,"children":1647},"li",{},[1648,1658,1660,1666,1668,1674],{"type":39,"tag":56,"props":1649,"children":1650},{},[1651,1657],{"type":39,"tag":64,"props":1652,"children":1654},{"className":1653},[],[1655],{"type":45,"value":1656},"Published.toml",{"type":45,"value":379},{"type":45,"value":1659}," Tracks your published package addresses per environment. Contains ",{"type":39,"tag":64,"props":1661,"children":1663},{"className":1662},[],[1664],{"type":45,"value":1665},"published-at",{"type":45,"value":1667}," and ",{"type":39,"tag":64,"props":1669,"children":1671},{"className":1670},[],[1672],{"type":45,"value":1673},"upgrade-capability-id",{"type":45,"value":1675}," values for each network.",{"type":39,"tag":1645,"props":1677,"children":1678},{},[1679,1689,1691,1696],{"type":39,"tag":56,"props":1680,"children":1681},{},[1682,1688],{"type":39,"tag":64,"props":1683,"children":1685},{"className":1684},[],[1686],{"type":45,"value":1687},"Move.lock",{"type":45,"value":379},{"type":45,"value":1690}," Auto-generated lock file that pins every resolved dependency to a specific git revision and records manifest digests. ",{"type":39,"tag":56,"props":1692,"children":1693},{},[1694],{"type":45,"value":1695},"Do not edit manually.",{"type":45,"value":1697}," Commit this to version control.",{"type":39,"tag":52,"props":1699,"children":1700},{},[1701,1703,1708],{"type":45,"value":1702},"To publish to a different environment (for example, after publishing to Testnet, now deploying to Devnet), switch environments and publish again. Each network gives the package a separate ID. The ",{"type":39,"tag":64,"props":1704,"children":1706},{"className":1705},[],[1707],{"type":45,"value":1656},{"type":45,"value":1709}," tracks both.",{"type":39,"tag":122,"props":1711,"children":1713},{"id":1712},"inspecting-movelock",[1714],{"type":45,"value":1715},"Inspecting Move.lock",{"type":39,"tag":48,"props":1717,"children":1718},{},[1719],{"type":39,"tag":52,"props":1720,"children":1721},{},[1722,1727,1729,1734,1736,1741,1743,1748,1750,1755],{"type":39,"tag":56,"props":1723,"children":1724},{},[1725],{"type":45,"value":1726},"Note:",{"type":45,"value":1728}," ",{"type":39,"tag":64,"props":1730,"children":1732},{"className":1731},[],[1733],{"type":45,"value":1687},{"type":45,"value":1735}," is auto-generated — never copy its contents into ",{"type":39,"tag":64,"props":1737,"children":1739},{"className":1738},[],[1740],{"type":45,"value":357},{"type":45,"value":1742},". The git URLs below appear in ",{"type":39,"tag":64,"props":1744,"children":1746},{"className":1745},[],[1747],{"type":45,"value":1687},{"type":45,"value":1749}," only, not in ",{"type":39,"tag":64,"props":1751,"children":1753},{"className":1752},[],[1754],{"type":45,"value":357},{"type":45,"value":113},{"type":39,"tag":52,"props":1757,"children":1758},{},[1759,1764,1766,1772],{"type":39,"tag":64,"props":1760,"children":1762},{"className":1761},[],[1763],{"type":45,"value":1687},{"type":45,"value":1765}," contains one ",{"type":39,"tag":64,"props":1767,"children":1769},{"className":1768},[],[1770],{"type":45,"value":1771},"[pinned.\u003Cenv>.\u003CDependency>]",{"type":45,"value":1773}," section per resolved dependency per environment. Each section records the git source, revision, manifest digest, and dependency graph. Example:",{"type":39,"tag":134,"props":1775,"children":1777},{"className":382,"code":1776,"language":384,"meta":139,"style":139},"# This is Move.lock (auto-generated) — NOT Move.toml\n[pinned.testnet.Sui]\nsource = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"73dd2c...\" }\nuse_environment = \"testnet\"\nmanifest_digest = \"7AFB6669...\"\ndeps = { MoveStdlib = \"MoveStdlib\" }\n",[1778],{"type":39,"tag":64,"props":1779,"children":1780},{"__ignoreMap":139},[1781,1789,1797,1805,1813,1821],{"type":39,"tag":145,"props":1782,"children":1783},{"class":147,"line":148},[1784],{"type":39,"tag":145,"props":1785,"children":1786},{},[1787],{"type":45,"value":1788},"# This is Move.lock (auto-generated) — NOT Move.toml\n",{"type":39,"tag":145,"props":1790,"children":1791},{"class":147,"line":26},[1792],{"type":39,"tag":145,"props":1793,"children":1794},{},[1795],{"type":45,"value":1796},"[pinned.testnet.Sui]\n",{"type":39,"tag":145,"props":1798,"children":1799},{"class":147,"line":407},[1800],{"type":39,"tag":145,"props":1801,"children":1802},{},[1803],{"type":45,"value":1804},"source = { git = \"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui.git\", subdir = \"crates\u002Fsui-framework\u002Fpackages\u002Fsui-framework\", rev = \"73dd2c...\" }\n",{"type":39,"tag":145,"props":1806,"children":1807},{"class":147,"line":416},[1808],{"type":39,"tag":145,"props":1809,"children":1810},{},[1811],{"type":45,"value":1812},"use_environment = \"testnet\"\n",{"type":39,"tag":145,"props":1814,"children":1815},{"class":147,"line":425},[1816],{"type":39,"tag":145,"props":1817,"children":1818},{},[1819],{"type":45,"value":1820},"manifest_digest = \"7AFB6669...\"\n",{"type":39,"tag":145,"props":1822,"children":1823},{"class":147,"line":435},[1824],{"type":39,"tag":145,"props":1825,"children":1826},{},[1827],{"type":45,"value":1828},"deps = { MoveStdlib = \"MoveStdlib\" }\n",{"type":39,"tag":1641,"props":1830,"children":1831},{},[1832,1859],{"type":39,"tag":1645,"props":1833,"children":1834},{},[1835,1837,1842,1844,1849,1851,1857],{"type":45,"value":1836},"If ",{"type":39,"tag":64,"props":1838,"children":1840},{"className":1839},[],[1841],{"type":45,"value":1687},{"type":45,"value":1843}," pins a different environment than you expect, or revisions look outdated, delete ",{"type":39,"tag":64,"props":1845,"children":1847},{"className":1846},[],[1848],{"type":45,"value":1687},{"type":45,"value":1850}," and run ",{"type":39,"tag":64,"props":1852,"children":1854},{"className":1853},[],[1855],{"type":45,"value":1856},"sui move build",{"type":45,"value":1858}," to regenerate it.",{"type":39,"tag":1645,"props":1860,"children":1861},{},[1862,1864,1869],{"type":45,"value":1863},"If you see build errors after switching networks or updating the CLI, deleting ",{"type":39,"tag":64,"props":1865,"children":1867},{"className":1866},[],[1868],{"type":45,"value":1687},{"type":45,"value":1870}," and rebuilding often resolves stale-lock issues.",{"type":39,"tag":122,"props":1872,"children":1874},{"id":1873},"using-mvr-dependencies",[1875],{"type":45,"value":1876},"Using MVR dependencies",{"type":39,"tag":52,"props":1878,"children":1879},{},[1880],{"type":45,"value":1881},"The Move Registry (MVR) is an onchain package manager for Sui. Install it with:",{"type":39,"tag":134,"props":1883,"children":1885},{"className":136,"code":1884,"language":138,"meta":139,"style":139},"suiup install mvr\n",[1886],{"type":39,"tag":64,"props":1887,"children":1888},{"__ignoreMap":139},[1889],{"type":39,"tag":145,"props":1890,"children":1891},{"class":147,"line":148},[1892,1897,1902],{"type":39,"tag":145,"props":1893,"children":1894},{"style":152},[1895],{"type":45,"value":1896},"suiup",{"type":39,"tag":145,"props":1898,"children":1899},{"style":158},[1900],{"type":45,"value":1901}," install",{"type":39,"tag":145,"props":1903,"children":1904},{"style":158},[1905],{"type":45,"value":1906}," mvr\n",{"type":39,"tag":52,"props":1908,"children":1909},{},[1910],{"type":45,"value":1911},"Add an MVR dependency using the CLI:",{"type":39,"tag":134,"props":1913,"children":1915},{"className":136,"code":1914,"language":138,"meta":139,"style":139},"mvr add @org\u002Fpackage --network testnet\n",[1916],{"type":39,"tag":64,"props":1917,"children":1918},{"__ignoreMap":139},[1919],{"type":39,"tag":145,"props":1920,"children":1921},{"class":147,"line":148},[1922,1927,1932,1937,1942],{"type":39,"tag":145,"props":1923,"children":1924},{"style":152},[1925],{"type":45,"value":1926},"mvr",{"type":39,"tag":145,"props":1928,"children":1929},{"style":158},[1930],{"type":45,"value":1931}," add",{"type":39,"tag":145,"props":1933,"children":1934},{"style":158},[1935],{"type":45,"value":1936}," @org\u002Fpackage",{"type":39,"tag":145,"props":1938,"children":1939},{"style":158},[1940],{"type":45,"value":1941}," --network",{"type":39,"tag":145,"props":1943,"children":1944},{"style":158},[1945],{"type":45,"value":1946}," testnet\n",{"type":39,"tag":52,"props":1948,"children":1949},{},[1950,1952,1957],{"type":45,"value":1951},"Or declare it directly in ",{"type":39,"tag":64,"props":1953,"children":1955},{"className":1954},[],[1956],{"type":45,"value":357},{"type":45,"value":379},{"type":39,"tag":134,"props":1959,"children":1961},{"className":382,"code":1960,"language":384,"meta":139,"style":139},"[dependencies]\nsuins = { r.mvr = \"@suins\u002Fcore\" }\n",[1962],{"type":39,"tag":64,"props":1963,"children":1964},{"__ignoreMap":139},[1965,1972],{"type":39,"tag":145,"props":1966,"children":1967},{"class":147,"line":148},[1968],{"type":39,"tag":145,"props":1969,"children":1970},{},[1971],{"type":45,"value":441},{"type":39,"tag":145,"props":1973,"children":1974},{"class":147,"line":26},[1975],{"type":39,"tag":145,"props":1976,"children":1977},{},[1978],{"type":45,"value":1979},"suins = { r.mvr = \"@suins\u002Fcore\" }\n",{"type":39,"tag":52,"props":1981,"children":1982},{},[1983,1985,1991],{"type":45,"value":1984},"The ",{"type":39,"tag":64,"props":1986,"children":1988},{"className":1987},[],[1989],{"type":45,"value":1990},"r.mvr",{"type":45,"value":1992}," key tells the resolver to look up the package in the onchain Move Registry instead of fetching from a git URL. Prefer MVR dependencies over git URLs when the package is published to the registry — they are versioned, auditable, and do not depend on git history.",{"type":39,"tag":122,"props":1994,"children":1996},{"id":1995},"common-dependency-and-build-issues",[1997],{"type":45,"value":1998},"Common dependency and build issues",{"type":39,"tag":1641,"props":2000,"children":2001},{},[2002,2027,2053,2092,2131,2170],{"type":39,"tag":1645,"props":2003,"children":2004},{},[2005,2010,2012,2018,2020,2025],{"type":39,"tag":56,"props":2006,"children":2007},{},[2008],{"type":45,"value":2009},"\"Dependency 'Sui' is a legacy system name\":",{"type":45,"value":2011}," Remove the ",{"type":39,"tag":64,"props":2013,"children":2015},{"className":2014},[],[2016],{"type":45,"value":2017},"Sui = { git = \"...\" }",{"type":45,"value":2019}," line from ",{"type":39,"tag":64,"props":2021,"children":2023},{"className":2022},[],[2024],{"type":45,"value":542},{"type":45,"value":2026},". The current CLI resolves the Sui framework automatically. This error occurs when using the old git-based dependency format.",{"type":39,"tag":1645,"props":2028,"children":2029},{},[2030,2035,2037,2043,2045,2051],{"type":39,"tag":56,"props":2031,"children":2032},{},[2033],{"type":45,"value":2034},"\"Packages with old dependencies\" error:",{"type":45,"value":2036}," Your CLI version does not match the network. The new package management format introduced in Sui CLI v1.63 changed how dependencies are resolved. Run ",{"type":39,"tag":64,"props":2038,"children":2040},{"className":2039},[],[2041],{"type":45,"value":2042},"suiup update sui@testnet",{"type":45,"value":2044}," then ",{"type":39,"tag":64,"props":2046,"children":2048},{"className":2047},[],[2049],{"type":45,"value":2050},"suiup switch sui@testnet",{"type":45,"value":2052}," to get the latest CLI.",{"type":39,"tag":1645,"props":2054,"children":2055},{},[2056,2061,2063,2068,2070,2075,2077,2083,2085,2090],{"type":39,"tag":56,"props":2057,"children":2058},{},[2059],{"type":45,"value":2060},"\"Cannot upgrade package without having a published id\":",{"type":45,"value":2062}," You need a ",{"type":39,"tag":64,"props":2064,"children":2066},{"className":2065},[],[2067],{"type":45,"value":1665},{"type":45,"value":2069}," value in ",{"type":39,"tag":64,"props":2071,"children":2073},{"className":2072},[],[2074],{"type":45,"value":1656},{"type":45,"value":2076}," to upgrade. This is created automatically after your first ",{"type":39,"tag":64,"props":2078,"children":2080},{"className":2079},[],[2081],{"type":45,"value":2082},"sui client publish",{"type":45,"value":2084},". If you migrated from the old format, make sure the ",{"type":39,"tag":64,"props":2086,"children":2088},{"className":2087},[],[2089],{"type":45,"value":1656},{"type":45,"value":2091}," file exists and contains the correct package address.",{"type":39,"tag":1645,"props":2093,"children":2094},{},[2095,2100,2102,2108,2110,2115,2117,2122,2124,2129],{"type":39,"tag":56,"props":2096,"children":2097},{},[2098],{"type":45,"value":2099},"\"Could not determine the correct dependencies\":",{"type":45,"value":2101}," The build requires a ",{"type":39,"tag":64,"props":2103,"children":2105},{"className":2104},[],[2106],{"type":45,"value":2107},"--build-env",{"type":45,"value":2109}," flag or an ",{"type":39,"tag":64,"props":2111,"children":2113},{"className":2112},[],[2114],{"type":45,"value":1474},{"type":45,"value":2116}," section in ",{"type":39,"tag":64,"props":2118,"children":2120},{"className":2119},[],[2121],{"type":45,"value":357},{"type":45,"value":2123},". Add the ",{"type":39,"tag":64,"props":2125,"children":2127},{"className":2126},[],[2128],{"type":45,"value":1474},{"type":45,"value":2130}," section with your target chain IDs.",{"type":39,"tag":1645,"props":2132,"children":2133},{},[2134,2139,2141,2147,2149,2154,2156,2161,2162,2168],{"type":39,"tag":56,"props":2135,"children":2136},{},[2137],{"type":45,"value":2138},"Edition mismatch:",{"type":45,"value":2140}," If you get errors about ",{"type":39,"tag":64,"props":2142,"children":2144},{"className":2143},[],[2145],{"type":45,"value":2146},"public struct",{"type":45,"value":2148}," syntax, set ",{"type":39,"tag":64,"props":2150,"children":2152},{"className":2151},[],[2153],{"type":45,"value":534},{"type":45,"value":2155}," in ",{"type":39,"tag":64,"props":2157,"children":2159},{"className":2158},[],[2160],{"type":45,"value":357},{"type":45,"value":528},{"type":39,"tag":64,"props":2163,"children":2165},{"className":2164},[],[2166],{"type":45,"value":2167},"legacy",{"type":45,"value":2169}," edition does not support Move 2024 features like public struct visibility.",{"type":39,"tag":1645,"props":2171,"children":2172},{},[2173,2178,2180,2185,2186,2191,2192,2197,2199,2204,2206,2211,2213,2218],{"type":39,"tag":56,"props":2174,"children":2175},{},[2176],{"type":45,"value":2177},"Old Move.toml format:",{"type":45,"value":2179}," If you are using the pre-v1.63 format with ",{"type":39,"tag":64,"props":2181,"children":2183},{"className":2182},[],[2184],{"type":45,"value":1490},{"type":45,"value":1667},{"type":39,"tag":64,"props":2187,"children":2189},{"className":2188},[],[2190],{"type":45,"value":1665},{"type":45,"value":335},{"type":39,"tag":64,"props":2193,"children":2195},{"className":2194},[],[2196],{"type":45,"value":357},{"type":45,"value":2198},", migrate to the new format: remove ",{"type":39,"tag":64,"props":2200,"children":2202},{"className":2201},[],[2203],{"type":45,"value":1490},{"type":45,"value":2205},", add ",{"type":39,"tag":64,"props":2207,"children":2209},{"className":2208},[],[2210],{"type":45,"value":1474},{"type":45,"value":2212},", and let the toolchain manage ",{"type":39,"tag":64,"props":2214,"children":2216},{"className":2215},[],[2217],{"type":45,"value":1656},{"type":45,"value":113},{"type":39,"tag":115,"props":2220,"children":2222},{"id":2221},"rules",[2223],{"type":45,"value":2224},"Rules",{"type":39,"tag":1641,"props":2226,"children":2227},{},[2228,2249,2254],{"type":39,"tag":1645,"props":2229,"children":2230},{},[2231,2233,2239,2241,2247],{"type":45,"value":2232},"Use ",{"type":39,"tag":64,"props":2234,"children":2236},{"className":2235},[],[2237],{"type":45,"value":2238},"public(package)",{"type":45,"value":2240}," visibility for non-library functions. ",{"type":39,"tag":64,"props":2242,"children":2244},{"className":2243},[],[2245],{"type":45,"value":2246},"public",{"type":45,"value":2248}," function signatures cannot be deleted or modified in upgrades.",{"type":39,"tag":1645,"props":2250,"children":2251},{},[2252],{"type":45,"value":2253},"Struct definitions cannot be deleted, modified, or have abilities added through upgrades.",{"type":39,"tag":1645,"props":2255,"children":2256},{},[2257],{"type":45,"value":2258},"Objects cannot exceed 256 KB. Avoid ever-growing vectors inside objects.",{"type":39,"tag":2260,"props":2261,"children":2262},"style",{},[2263],{"type":45,"value":2264},"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":2266,"total":2370},[2267,2281,2296,2316,2330,2341,2357],{"slug":2268,"name":2268,"fn":2269,"description":2270,"org":2271,"tags":2272,"stars":22,"repoUrl":23,"updatedAt":2280},"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},[2273,2276,2277],{"name":2274,"slug":2275,"type":16},"Data Analysis","data-analysis",{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},"Web3","web3","2026-08-01T05:44:32.775598",{"slug":2282,"name":2282,"fn":2283,"description":2284,"org":2285,"tags":2286,"stars":22,"repoUrl":23,"updatedAt":2295},"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},[2287,2290,2293,2294],{"name":2288,"slug":2289,"type":16},"API Development","api-development",{"name":2291,"slug":2292,"type":16},"Smart Contracts","smart-contracts",{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},"2026-07-16T06:02:49.198495",{"slug":2297,"name":2297,"fn":2298,"description":2299,"org":2300,"tags":2301,"stars":22,"repoUrl":23,"updatedAt":2315},"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},[2302,2305,2307,2308,2311,2314],{"name":2303,"slug":2304,"type":16},"Frontend","frontend",{"name":2306,"slug":1315,"type":16},"React",{"name":18,"slug":8,"type":16},{"name":2309,"slug":2310,"type":16},"Svelte","svelte",{"name":2312,"slug":2313,"type":16},"Vue","vue",{"name":2278,"slug":2279,"type":16},"2026-08-01T05:44:28.958473",{"slug":2317,"name":2317,"fn":2318,"description":2319,"org":2320,"tags":2321,"stars":22,"repoUrl":23,"updatedAt":2329},"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},[2322,2325,2328],{"name":2323,"slug":2324,"type":16},"Configuration","configuration",{"name":2326,"slug":2327,"type":16},"Documentation","documentation",{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.981056",{"slug":2331,"name":2331,"fn":2332,"description":2333,"org":2334,"tags":2335,"stars":22,"repoUrl":23,"updatedAt":2340},"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},[2336,2337,2338,2339],{"name":20,"slug":21,"type":16},{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},"2026-07-16T06:02:43.277596",{"slug":2342,"name":2342,"fn":2343,"description":2344,"org":2345,"tags":2346,"stars":22,"repoUrl":23,"updatedAt":2356},"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},[2347,2350,2351,2352,2355],{"name":2348,"slug":2349,"type":16},"QA","qa",{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2353,"slug":2354,"type":16},"Testing","testing",{"name":2278,"slug":2279,"type":16},"2026-08-01T05:44:30.788585",{"slug":2358,"name":2358,"fn":2359,"description":2360,"org":2361,"tags":2362,"stars":22,"repoUrl":23,"updatedAt":2369},"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},[2363,2366,2367,2368],{"name":2364,"slug":2365,"type":16},"Best Practices","best-practices",{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},"2026-07-16T06:02:48.830052",20,{"items":2372,"total":2489},[2373,2387,2396,2406,2421,2439,2445,2452,2461,2467,2474,2482],{"slug":2374,"name":2374,"fn":2375,"description":2376,"org":2377,"tags":2378,"stars":2384,"repoUrl":2385,"updatedAt":2386},"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},[2379,2382,2383],{"name":2380,"slug":2381,"type":16},"Code Analysis","code-analysis",{"name":20,"slug":21,"type":16},{"name":18,"slug":8,"type":16},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":2388,"name":2388,"fn":2389,"description":2390,"org":2391,"tags":2392,"stars":2384,"repoUrl":2385,"updatedAt":2395},"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},[2393,2394],{"name":2326,"slug":2327,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:00:59.641382",{"slug":2397,"name":2397,"fn":2398,"description":2399,"org":2400,"tags":2401,"stars":2384,"repoUrl":2385,"updatedAt":2405},"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},[2402,2403,2404],{"name":2380,"slug":2381,"type":16},{"name":20,"slug":21,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:25.3633",{"slug":2407,"name":2407,"fn":2408,"description":2409,"org":2410,"tags":2411,"stars":2384,"repoUrl":2385,"updatedAt":2420},"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},[2412,2415,2418,2419],{"name":2413,"slug":2414,"type":16},"Code Review","code-review",{"name":2416,"slug":2417,"type":16},"Security","security",{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},"2026-07-16T06:02:55.691149",{"slug":2422,"name":2422,"fn":2423,"description":2424,"org":2425,"tags":2426,"stars":2436,"repoUrl":2437,"updatedAt":2438},"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},[2427,2430,2433],{"name":2428,"slug":2429,"type":16},"Agents","agents",{"name":2431,"slug":2432,"type":16},"Memory","memory",{"name":2434,"slug":2435,"type":16},"SDK","sdk",57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-07-16T06:02:39.838395",{"slug":2268,"name":2268,"fn":2269,"description":2270,"org":2440,"tags":2441,"stars":22,"repoUrl":23,"updatedAt":2280},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2442,2443,2444],{"name":2274,"slug":2275,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},{"slug":2282,"name":2282,"fn":2283,"description":2284,"org":2446,"tags":2447,"stars":22,"repoUrl":23,"updatedAt":2295},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2448,2449,2450,2451],{"name":2288,"slug":2289,"type":16},{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},{"slug":2297,"name":2297,"fn":2298,"description":2299,"org":2453,"tags":2454,"stars":22,"repoUrl":23,"updatedAt":2315},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2455,2456,2457,2458,2459,2460],{"name":2303,"slug":2304,"type":16},{"name":2306,"slug":1315,"type":16},{"name":18,"slug":8,"type":16},{"name":2309,"slug":2310,"type":16},{"name":2312,"slug":2313,"type":16},{"name":2278,"slug":2279,"type":16},{"slug":2317,"name":2317,"fn":2318,"description":2319,"org":2462,"tags":2463,"stars":22,"repoUrl":23,"updatedAt":2329},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2464,2465,2466],{"name":2323,"slug":2324,"type":16},{"name":2326,"slug":2327,"type":16},{"name":18,"slug":8,"type":16},{"slug":2331,"name":2331,"fn":2332,"description":2333,"org":2468,"tags":2469,"stars":22,"repoUrl":23,"updatedAt":2340},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2470,2471,2472,2473],{"name":20,"slug":21,"type":16},{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},{"slug":2342,"name":2342,"fn":2343,"description":2344,"org":2475,"tags":2476,"stars":22,"repoUrl":23,"updatedAt":2356},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2477,2478,2479,2480,2481],{"name":2348,"slug":2349,"type":16},{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2353,"slug":2354,"type":16},{"name":2278,"slug":2279,"type":16},{"slug":2358,"name":2358,"fn":2359,"description":2360,"org":2483,"tags":2484,"stars":22,"repoUrl":23,"updatedAt":2369},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[2485,2486,2487,2488],{"name":2364,"slug":2365,"type":16},{"name":2291,"slug":2292,"type":16},{"name":18,"slug":8,"type":16},{"name":2278,"slug":2279,"type":16},37]