[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openzeppelin-setup-sui-contracts":3,"mdc--34cpa6-key":36,"related-org-openzeppelin-setup-sui-contracts":3001,"related-repo-openzeppelin-setup-sui-contracts":3132},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"setup-sui-contracts","set up Sui Move smart contracts","Set up a Sui Move smart contract project with OpenZeppelin Contracts for Sui. Use when users need to: (1) install the Sui CLI and Move toolchain, (2) create a new Sui Move package, (3) discover and add OpenZeppelin Sui dependencies to Move.toml via the Move Registry (MVR), (4) learn the integration pattern from the library's examples and API docs before implementing, or (5) understand Sui Move import conventions and build\u002Ftest commands for OpenZeppelin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"openzeppelin","OpenZeppelin","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenzeppelin.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Blockchain","blockchain","tag",{"name":17,"slug":18,"type":15},"CLI","cli",{"name":20,"slug":21,"type":15},"Rust","rust",{"name":23,"slug":24,"type":15},"Smart Contracts","smart-contracts",193,"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-skills","2026-07-16T05:59:21.671811","AGPL-3.0-only",25,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Agent skills for secure smart contract development with OpenZeppelin Contracts libraries","https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fsetup-sui-contracts","---\nname: setup-sui-contracts\ndescription: \"Set up a Sui Move smart contract project with OpenZeppelin Contracts for Sui. Use when users need to: (1) install the Sui CLI and Move toolchain, (2) create a new Sui Move package, (3) discover and add OpenZeppelin Sui dependencies to Move.toml via the Move Registry (MVR), (4) learn the integration pattern from the library's examples and API docs before implementing, or (5) understand Sui Move import conventions and build\u002Ftest commands for OpenZeppelin.\"\nlicense: AGPL-3.0-only\nmetadata:\n  author: OpenZeppelin\n---\n\n# Sui Setup\n\n## Prerequisites\n\nInstall the Sui CLI by following the [Sui installation guide](https:\u002F\u002Fdocs.sui.io\u002Fgetting-started\u002Fonboarding\u002Fsui-install). The CLI bundles the Move toolchain and the Move Registry (MVR) resolver, so no separate Move install is needed.\n\nAny time you need to investigate the library, start from its AI discovery entry point, [`llms.txt`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt) — it maps the library's content (the architecture doc, the `contracts\u002F` and `math\u002F` package catalogs, each package's README\u002Fexamples\u002FAPI reference, and audits). Follow its links rather than guessing paths.\n\nOpenZeppelin Contracts for Sui pins a specific Sui CLI version in its top-level [README](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FREADME.md) (this is repo metadata, not linked from `llms.txt`) — read the required version there and check your local install against it. The pinned version is the tested one and safest to match; a newer patch\u002Fminor generally works too, so treat a small drift as a warning, not a blocker:\n\n```bash\nsui --version\n```\n\n## Create a Project\n\nInitialize a new Move package (only if starting a new project):\n\n```bash\nsui move new my_project\ncd my_project\n```\n\nThis creates `Move.toml`, a `.gitignore`, and commented-out stub modules `sources\u002Fmy_project.move` and `tests\u002Fmy_project_tests.move`, using Move `edition = \"2024\"`. The stubs are inert placeholders (fully wrapped in `\u002F* … *\u002F`); replace or delete them when you add your own modules.\n\n## OpenZeppelin Dependencies\n\nOpenZeppelin packages are published to the **Move Registry (MVR)** and added to `Move.toml` under `[dependencies]` with the `r.mvr` format, mapping the Move package name to its MVR slug:\n\n```toml\n[dependencies]\n\u003Cmove_package_name> = { r.mvr = \"@openzeppelin-move\u002F\u003Cslug>\" }\n```\n\nDo **not** rely on a memorized package list — it drifts as the library evolves. Discover what is available from the library's own metadata, which is the single source of truth:\n\n1. Start — as always — at the AI discovery entry point, [`llms.txt`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt).\n2. Follow its links to **every package catalog it lists** — `llms.txt` is the authority on which catalogs exist, so read the set from there rather than assuming a fixed one (new top-level catalogs get added over time). Each catalog table lists the MVR slug, the Move package name, docs, and highlights.\n3. Read the individual package's `README.md` for the exact `r.mvr` install snippet and its module list. Confirm the slug resolves — either by looking it up on [moveregistry.com](https:\u002F\u002Fwww.moveregistry.com) or, definitively, by running the build (below), which resolves every slug against the MVR.\n\n> **Catalog paths are relative to the catalog file's own directory.** A catalog at `\u003Ccatalog-dir>\u002FREADME.md` lists each package by a `Path` relative to `\u003Ccatalog-dir>\u002F`, so the package's raw README is `...\u002Fmain\u002F\u003Ccatalog-dir>\u002F\u003Cpath>\u002FREADME.md` — resolve `\u003Cpath>` against the directory of the catalog that links it, not the repo root (the bare `...\u002Fmain\u002F\u003Cpath>\u002FREADME.md` 404s). When in doubt, list the tree: `gh api 'repos\u002FOpenZeppelin\u002Fcontracts-sui\u002Fgit\u002Ftrees\u002Fmain?recursive=1'` (quote the endpoint — an unquoted `?` is a glob in some shells).\n\n> The Move package name (used in `use` statements) differs from the MVR slug — slug `@openzeppelin-move\u002Finteger-math` is Move package `openzeppelin_math`. Only add the packages the project actually uses.\n\n> **A package usually contains several modules.** The catalog lists *packages*; the building block you want is often one module among several inside a package. Read the package README's module list and its `examples\u002F` to see what a package actually exposes — don't assume one package equals one component, and don't rely on a fixed mental catalog: the set of packages and modules grows over time.\n\n> The OpenZeppelin **Sui MCP** exposes this same metadata as deterministic tool calls — `sui-list-recipes` (discover recipes), `sui-get-recipe` (a recipe's source plus the packages it uses, each with its install line), and `sui-get-package` (a package's install line + docs). When the MCP is available, query it instead of crawling the files by hand, then wire the returned install lines into `Move.toml` and re-home the recipe source into your package. The MCP returns data, not a buildable package — that wiring and re-homing are what turn it into one.\n\n### Packages not on the Move Registry\n\nNot every package is on the Move Registry — some are not published there at all. When a package's `README.md` has no `r.mvr` install snippet, depend on it from a **GitHub release** instead — a git dependency pinned to a release tag, never a moving branch:\n\n```toml\n[dependencies]\n\u003Cmove_package_name> = { git = \"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui.git\", subdir = \"\u003Ccatalog-dir>\u002F\u003Cpath>\", rev = \"\u003Crelease-tag>\" }\n```\n\n`\u003Ccatalog-dir>\u002F\u003Cpath>` is the package's directory in the repo (the same `Path` its catalog row lists); pin `rev` to a published GitHub **release** tag, not a branch. Keep every OpenZeppelin dependency on one consistent revision to avoid the diamond conflict below.\n\n### Resolving version conflicts (diamond dependencies)\n\nTwo OZ packages can pull *different revisions* of a shared transitive dependency — for example, if one package embeds its own revision of a math package that you also depend on directly. When that happens the build aborts:\n\n```\nPackage depends on multiple versions of the package with ID 0x…\n```\n\nResolve it by adding `override = true` to the directly-declared dependency, which forces every consumer onto that revision:\n\n```toml\n[dependencies]\nopenzeppelin_math = { r.mvr = \"@openzeppelin-move\u002Finteger-math\", override = true }\nopenzeppelin_fp_math = { r.mvr = \"@openzeppelin-move\u002Ffixed-point-math\" }\n```\n\n## Study the Examples and Docs Before Implementing\n\nDo this before writing any integration code — most users don't know the full catalog, and it grows over time, so let the library show you what it provides and how it's meant to be composed. For each package you plan to use:\n\n1. **Study its `examples\u002F`.** Every package ships compilable, CI-tested integration examples — these are the canonical composition recipes and the fastest way to see the real usage pattern (initialization, capability\u002Fwitness flow, object ownership, tests). Prefer copying and adapting an example into `sources\u002F` over writing from scratch.\n\n   > **Read examples and metadata from `main`; pin dependencies to a release.** All AI metadata — `llms.txt`, the catalogs, package READMEs, `STYLEGUIDE.md`, and the `examples\u002F` — should be read from the **`main` branch**, which carries the latest and most complete set (a package may have examples on `main` that a tagged release does not). Your build *dependencies*, by contrast, resolve to a pinned **release** — an MVR slug or a git `rev = \"\u003Crelease-tag>\"` (above) — so builds stay reproducible. The two can differ: an example copied from `main` may reference an API newer than your pinned release, in which case adapt it (or bump the pinned release) when you re-home.\n\n   > **Re-home a copied example.** Example modules are declared under the *library's* own address (e.g. `module openzeppelin_access::example_reward_treasury;`) — they are illustrations inside the library, not drop-in consumer code. When you copy one into `sources\u002F`, rename its module to your package (`module \u003Cyour_package>::\u003Cmodule>;`, where `\u003Cyour_package>` is your `Move.toml` `[package]` name). Keep the `use openzeppelin_*::…` lines as-is — those reference the dependencies. **If the example defines a one-time witness** — a struct whose name is the module name upper-cased, consumed by `init` — rename that struct to match your new module name too, or `init` fails with \"Invalid parameter … Expected a one-time witness type\". You cannot define a module under a dependency's address, so a verbatim copy will not build until it is re-homed.\n2. **Read the docs.** Start at the [documentation site](https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui) for concepts and guides, then the generated API reference — reached via the `Docs` link in each catalog table (it points at the correct version), path `...\u002Fcontracts-sui\u002F\u003Cmajor>.x\u002Fapi\u002F\u003Ccatalog_package>` where `\u003Cmajor>` matches your contracts-sui release and `\u003Ccatalog_package>` is the short catalog name, not the Move package name — for exact signatures, parameters, and abort conditions.\n3. **Read the code docs.** The API reference is generated from the modules' doc-comments, so the installed source is the ground truth. Generate the same docs locally with `sui move build --doc --build-env testnet` (the `--build-env` is required whenever there are MVR deps) — this also emits the docs for every OZ dependency under `build\u002F\u003Cyour_package>\u002Fdocs\u002Fdependencies\u002F\u003Cmove_package_name>\u002F` — or just read the doc-comments in the installed source.\n\nDiscover the available examples from `llms.txt` and each package README, then browse them in the [contracts-sui repo](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui).\n\n## Import Conventions\n\nImport modules through the Move package name (the left side of the `Move.toml` entry) followed by the module name — `use \u003Cmove_package_name>::\u003Cmodule>;` — then follow the usage patterns from the package's `examples\u002F` and API docs.\n\n> Some operations are exposed as **method syntax** (`value.op(...)`) via `public use fun` re-exports, so the underlying function may live in a different module than the type. If a free function you expect isn't found, check the package source for the `public use fun` lines and call it as a method.\n\n## Generate Agent Guidance\n\nCreate an `AGENTS.md` at the project root so any agent that later opens this project knows it is built on OpenZeppelin Contracts for Sui and where the sources of truth live. Follow the same philosophy as the [contracts-sui `AGENTS.md`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FAGENTS.md): a lean pointer file that does **not** restate rules — it links to the authoritative sources. Also add a `CLAUDE.md` containing only `@AGENTS.md` so Claude Code picks it up (mirroring how contracts-sui itself is set up).\n\n```markdown\n# AGENTS.md\n\nThis is a Sui Move project built on **OpenZeppelin Contracts for Sui**.\n\n## Sources of truth — read these first\n- AI discovery entry point: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt\n  (points to the package catalogs, each package's `examples\u002F`, the generated API reference, and audits)\n- Docs: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\n- API reference: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\u002F\u003Cmajor>.x\u002Fapi\u002F\u003Ccatalog_package> (`\u003Cmajor>` matches your contracts-sui release and `\u003Ccatalog_package>` is the short catalog name; the catalog's `Docs` links carry the correct version)\n- Code docs (local): `sui move build --doc --build-env testnet` → `build\u002F\u003Cyour_package>\u002Fdocs\u002F` (named after your own package; includes OZ dependencies)\n\n## Conventions\n- Before implementing, study each package's `examples\u002F` (compilable, CI-tested composition recipes) and its API docs; prefer audited library components over custom logic.\n- Import modules via the Move package name (`use \u003Cmove_package_name>::\u003Cmodule>;`); a package typically exposes several modules — check its README and `examples\u002F`.\n- MVR-backed builds require a build env: `sui move build --build-env testnet`. If two OZ deps pull different revisions of a shared transitive package, add `override = true` to the directly-declared one.\n- For fungible-asset custody, consider Sui [Address Balances](https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fasset-custody\u002Faddress-balances\u002F) (SIP-58) over summing `Coin` objects where it fits.\n- Code style follows the OpenZeppelin Sui conventions — see Code Quality below.\n\n## Code quality\nThe library's conventions are the single source of truth for Move style:\n- Rules: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FSTYLEGUIDE.md\n- Design rationale: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md\n- Review procedure (reads STYLEGUIDE.md, reports\u002Ffixes violations): https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002F.claude\u002Fcommands\u002Fcode-quality.md\n\n## MCP\nThe OpenZeppelin Sui MCP (https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp) serves recipes and per-package install lines as deterministic tool calls (`sui-list-recipes`, `sui-get-recipe`, `sui-get-package`) — a queryable alternative to reading `llms.txt` + the catalogs by hand. This project ships it pre-wired in `.mcp.json`. It returns data, not a buildable package — wiring the install lines into `Move.toml` and re-homing the source into this package is what turns it into one.\n```\n\nAlso write a pre-wired MCP config at the project root so any agent understands the OpenZeppelin-on-Sui context on clone, without manual setup. Claude Code reads `.mcp.json`; other assistants (Cursor, Cline) take the same server URL in their own MCP config.\n\n```json\n{\n  \"mcpServers\": {\n    \"openzeppelin-sui\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp\"\n    }\n  }\n}\n```\n\n## Build & Test\n\nBecause dependencies resolve through MVR, builds and tests must specify a build environment. Use `testnet` for development (`mainnet` is also available for release builds):\n\n```bash\nsui move build --build-env testnet\nsui move test --build-env testnet\n```\n\n> Without `--build-env`, the CLI cannot resolve `r.mvr` dependencies and errors with \"Could not determine the correct dependencies to use for `local`\". A green `build` + `test` on a freshly scaffolded project is the acceptance bar.\n\nAdd `--lint --warnings-are-errors` once the project has real code to catch style and dead-code issues early:\n\n```bash\nsui move test --build-env testnet --lint --warnings-are-errors\n```\n\n### Testing patterns to know\n\nA couple of Sui conventions recur when testing code built on these packages — the library's own `examples\u002F` tests are the canonical reference:\n\n- **One-Time Witness (OTW) in tests.** Modules that take an OTW consume it in `init`, and it can't be constructed at runtime. To exercise such a module in a unit test, expose a `#[test_only]` initializer that builds the OTW (its struct *is* constructible inside a `#[test_only]` context):\n\n  ```move\n  #[test_only]\n  public fun init_for_testing(ctx: &mut TxContext) { init(MY_OTW {}, ctx) }\n  ```\n\n- **Clock.** Modules that depend on time take a `sui::clock::Clock`. In tests use `create_for_testing`, `increment_for_testing`, and `destroy_for_testing`.\n\n- **Assertions.** Under `--warnings-are-errors`, a literal abort code (`assert!(cond, 0)`) trips the `abort_without_constant` lint. In tests, use `assert_eq!` (from `std::unit_test`) or a bare `assert!(cond)`; in non-test code, assert against a named error constant rather than a literal.\n\n> **Composition constraint:** a Sui `init` function receives no `Clock` (nor other runtime arguments). A component whose constructor needs a `Clock` therefore can't be fully built in `init` — create\u002Fshare the object in `init`, then complete setup in a later entry function that takes the `Clock`. The package's `examples\u002F` show the intended two-step pattern.\n\n## Code Quality\n\nAlign the project's Move style with OpenZeppelin's own conventions so integrator code stays consistent with the library. As with dependencies, don't restate the rules — point at the library's single sources of truth:\n\n- **[`STYLEGUIDE.md`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FSTYLEGUIDE.md)** — the codified rules (Naming, Module & Package, Section ordering, Imports, Structs, Functions, Idiomatic Move 2024, Collections & object size, Testing, Lint suppression, Documentation).\n- **[`ARCHITECTURE.md`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md)** — the design rationale those rules reference (capability-based access, owned vs. shared objects, PTB composability, bounded state, upgrade safety).\n- **[`.claude\u002Fcommands\u002Fcode-quality.md`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002F.claude\u002Fcommands\u002Fcode-quality.md)** — the review procedure: it reads `STYLEGUIDE.md` and checks each `.move` file against it, then reports or fixes violations. The procedure is plain markdown, so any agent can follow it even though the slash command is Claude-specific.\n\nRecord these under a **Code quality** heading in the generated `AGENTS.md` (see above) so downstream agents follow the same conventions on clone.\n\n### Formatting\n\ncontracts-sui formats Move with the [`@mysten\u002Fprettier-plugin-move`](https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui\u002Fblob\u002Fmain\u002Fexternal-crates\u002Fmove\u002Ftooling\u002Fprettier-move\u002FREADME.md) Prettier plugin — match it so integrator code lays out identically. Install it and add a `.prettierrc` matching the library's:\n\n```bash\nnpm i -D prettier @mysten\u002Fprettier-plugin-move\n```\n\n```json\n{\n  \"tabWidth\": 4,\n  \"printWidth\": 100,\n  \"useModuleLabel\": true,\n  \"autoGroupImports\": \"module\",\n  \"plugins\": [\"@mysten\u002Fprettier-plugin-move\"]\n}\n```\n\nThen format from the repo root (Prettier silently skips `.move` files if the plugin isn't resolvable, so keep it in `devDependencies`):\n\n```bash\nnpx prettier --write \"**\u002F*.move\"\n```\n\n> `autoGroupImports: \"module\"` normalizes `use` grouping, so run `--write` to let it format — don't hand-tune imports and expect `--check` to pass first.\n\nThe `code-quality.md` review procedure runs this same formatting pass after applying fixes.\n",{"data":37,"body":39},{"name":4,"description":6,"license":28,"metadata":38},{"author":9},{"type":40,"children":41},"root",[42,51,58,75,110,131,160,166,171,214,266,272,308,333,345,414,492,524,553,599,606,632,654,687,693,705,715,728,759,765,770,1068,1088,1094,1121,1159,1165,1214,1921,1933,2103,2109,2130,2187,2233,2246,2287,2293,2305,2471,2534,2540,2545,2619,2638,2644,2670,2705,2888,2908,2945,2982,2995],{"type":43,"tag":44,"props":45,"children":47},"element","h1",{"id":46},"sui-setup",[48],{"type":49,"value":50},"text","Sui Setup",{"type":43,"tag":52,"props":53,"children":55},"h2",{"id":54},"prerequisites",[56],{"type":49,"value":57},"Prerequisites",{"type":43,"tag":59,"props":60,"children":61},"p",{},[62,64,73],{"type":49,"value":63},"Install the Sui CLI by following the ",{"type":43,"tag":65,"props":66,"children":70},"a",{"href":67,"rel":68},"https:\u002F\u002Fdocs.sui.io\u002Fgetting-started\u002Fonboarding\u002Fsui-install",[69],"nofollow",[71],{"type":49,"value":72},"Sui installation guide",{"type":49,"value":74},". The CLI bundles the Move toolchain and the Move Registry (MVR) resolver, so no separate Move install is needed.",{"type":43,"tag":59,"props":76,"children":77},{},[78,80,92,94,100,102,108],{"type":49,"value":79},"Any time you need to investigate the library, start from its AI discovery entry point, ",{"type":43,"tag":65,"props":81,"children":84},{"href":82,"rel":83},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt",[69],[85],{"type":43,"tag":86,"props":87,"children":89},"code",{"className":88},[],[90],{"type":49,"value":91},"llms.txt",{"type":49,"value":93}," — it maps the library's content (the architecture doc, the ",{"type":43,"tag":86,"props":95,"children":97},{"className":96},[],[98],{"type":49,"value":99},"contracts\u002F",{"type":49,"value":101}," and ",{"type":43,"tag":86,"props":103,"children":105},{"className":104},[],[106],{"type":49,"value":107},"math\u002F",{"type":49,"value":109}," package catalogs, each package's README\u002Fexamples\u002FAPI reference, and audits). Follow its links rather than guessing paths.",{"type":43,"tag":59,"props":111,"children":112},{},[113,115,122,124,129],{"type":49,"value":114},"OpenZeppelin Contracts for Sui pins a specific Sui CLI version in its top-level ",{"type":43,"tag":65,"props":116,"children":119},{"href":117,"rel":118},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FREADME.md",[69],[120],{"type":49,"value":121},"README",{"type":49,"value":123}," (this is repo metadata, not linked from ",{"type":43,"tag":86,"props":125,"children":127},{"className":126},[],[128],{"type":49,"value":91},{"type":49,"value":130},") — read the required version there and check your local install against it. The pinned version is the tested one and safest to match; a newer patch\u002Fminor generally works too, so treat a small drift as a warning, not a blocker:",{"type":43,"tag":132,"props":133,"children":138},"pre",{"className":134,"code":135,"language":136,"meta":137,"style":137},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sui --version\n","bash","",[139],{"type":43,"tag":86,"props":140,"children":141},{"__ignoreMap":137},[142],{"type":43,"tag":143,"props":144,"children":147},"span",{"class":145,"line":146},"line",1,[148,154],{"type":43,"tag":143,"props":149,"children":151},{"style":150},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[152],{"type":49,"value":153},"sui",{"type":43,"tag":143,"props":155,"children":157},{"style":156},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[158],{"type":49,"value":159}," --version\n",{"type":43,"tag":52,"props":161,"children":163},{"id":162},"create-a-project",[164],{"type":49,"value":165},"Create a Project",{"type":43,"tag":59,"props":167,"children":168},{},[169],{"type":49,"value":170},"Initialize a new Move package (only if starting a new project):",{"type":43,"tag":132,"props":172,"children":174},{"className":134,"code":173,"language":136,"meta":137,"style":137},"sui move new my_project\ncd my_project\n",[175],{"type":43,"tag":86,"props":176,"children":177},{"__ignoreMap":137},[178,200],{"type":43,"tag":143,"props":179,"children":180},{"class":145,"line":146},[181,185,190,195],{"type":43,"tag":143,"props":182,"children":183},{"style":150},[184],{"type":49,"value":153},{"type":43,"tag":143,"props":186,"children":187},{"style":156},[188],{"type":49,"value":189}," move",{"type":43,"tag":143,"props":191,"children":192},{"style":156},[193],{"type":49,"value":194}," new",{"type":43,"tag":143,"props":196,"children":197},{"style":156},[198],{"type":49,"value":199}," my_project\n",{"type":43,"tag":143,"props":201,"children":203},{"class":145,"line":202},2,[204,210],{"type":43,"tag":143,"props":205,"children":207},{"style":206},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[208],{"type":49,"value":209},"cd",{"type":43,"tag":143,"props":211,"children":212},{"style":156},[213],{"type":49,"value":199},{"type":43,"tag":59,"props":215,"children":216},{},[217,219,225,227,233,235,241,242,248,250,256,258,264],{"type":49,"value":218},"This creates ",{"type":43,"tag":86,"props":220,"children":222},{"className":221},[],[223],{"type":49,"value":224},"Move.toml",{"type":49,"value":226},", a ",{"type":43,"tag":86,"props":228,"children":230},{"className":229},[],[231],{"type":49,"value":232},".gitignore",{"type":49,"value":234},", and commented-out stub modules ",{"type":43,"tag":86,"props":236,"children":238},{"className":237},[],[239],{"type":49,"value":240},"sources\u002Fmy_project.move",{"type":49,"value":101},{"type":43,"tag":86,"props":243,"children":245},{"className":244},[],[246],{"type":49,"value":247},"tests\u002Fmy_project_tests.move",{"type":49,"value":249},", using Move ",{"type":43,"tag":86,"props":251,"children":253},{"className":252},[],[254],{"type":49,"value":255},"edition = \"2024\"",{"type":49,"value":257},". The stubs are inert placeholders (fully wrapped in ",{"type":43,"tag":86,"props":259,"children":261},{"className":260},[],[262],{"type":49,"value":263},"\u002F* … *\u002F",{"type":49,"value":265},"); replace or delete them when you add your own modules.",{"type":43,"tag":52,"props":267,"children":269},{"id":268},"openzeppelin-dependencies",[270],{"type":49,"value":271},"OpenZeppelin Dependencies",{"type":43,"tag":59,"props":273,"children":274},{},[275,277,283,285,290,292,298,300,306],{"type":49,"value":276},"OpenZeppelin packages are published to the ",{"type":43,"tag":278,"props":279,"children":280},"strong",{},[281],{"type":49,"value":282},"Move Registry (MVR)",{"type":49,"value":284}," and added to ",{"type":43,"tag":86,"props":286,"children":288},{"className":287},[],[289],{"type":49,"value":224},{"type":49,"value":291}," under ",{"type":43,"tag":86,"props":293,"children":295},{"className":294},[],[296],{"type":49,"value":297},"[dependencies]",{"type":49,"value":299}," with the ",{"type":43,"tag":86,"props":301,"children":303},{"className":302},[],[304],{"type":49,"value":305},"r.mvr",{"type":49,"value":307}," format, mapping the Move package name to its MVR slug:",{"type":43,"tag":132,"props":309,"children":313},{"className":310,"code":311,"language":312,"meta":137,"style":137},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","[dependencies]\n\u003Cmove_package_name> = { r.mvr = \"@openzeppelin-move\u002F\u003Cslug>\" }\n","toml",[314],{"type":43,"tag":86,"props":315,"children":316},{"__ignoreMap":137},[317,325],{"type":43,"tag":143,"props":318,"children":319},{"class":145,"line":146},[320],{"type":43,"tag":143,"props":321,"children":322},{},[323],{"type":49,"value":324},"[dependencies]\n",{"type":43,"tag":143,"props":326,"children":327},{"class":145,"line":202},[328],{"type":43,"tag":143,"props":329,"children":330},{},[331],{"type":49,"value":332},"\u003Cmove_package_name> = { r.mvr = \"@openzeppelin-move\u002F\u003Cslug>\" }\n",{"type":43,"tag":59,"props":334,"children":335},{},[336,338,343],{"type":49,"value":337},"Do ",{"type":43,"tag":278,"props":339,"children":340},{},[341],{"type":49,"value":342},"not",{"type":49,"value":344}," rely on a memorized package list — it drifts as the library evolves. Discover what is available from the library's own metadata, which is the single source of truth:",{"type":43,"tag":346,"props":347,"children":348},"ol",{},[349,366,385],{"type":43,"tag":350,"props":351,"children":352},"li",{},[353,355,364],{"type":49,"value":354},"Start — as always — at the AI discovery entry point, ",{"type":43,"tag":65,"props":356,"children":358},{"href":82,"rel":357},[69],[359],{"type":43,"tag":86,"props":360,"children":362},{"className":361},[],[363],{"type":49,"value":91},{"type":49,"value":365},".",{"type":43,"tag":350,"props":367,"children":368},{},[369,371,376,378,383],{"type":49,"value":370},"Follow its links to ",{"type":43,"tag":278,"props":372,"children":373},{},[374],{"type":49,"value":375},"every package catalog it lists",{"type":49,"value":377}," — ",{"type":43,"tag":86,"props":379,"children":381},{"className":380},[],[382],{"type":49,"value":91},{"type":49,"value":384}," is the authority on which catalogs exist, so read the set from there rather than assuming a fixed one (new top-level catalogs get added over time). Each catalog table lists the MVR slug, the Move package name, docs, and highlights.",{"type":43,"tag":350,"props":386,"children":387},{},[388,390,396,398,403,405,412],{"type":49,"value":389},"Read the individual package's ",{"type":43,"tag":86,"props":391,"children":393},{"className":392},[],[394],{"type":49,"value":395},"README.md",{"type":49,"value":397}," for the exact ",{"type":43,"tag":86,"props":399,"children":401},{"className":400},[],[402],{"type":49,"value":305},{"type":49,"value":404}," install snippet and its module list. Confirm the slug resolves — either by looking it up on ",{"type":43,"tag":65,"props":406,"children":409},{"href":407,"rel":408},"https:\u002F\u002Fwww.moveregistry.com",[69],[410],{"type":49,"value":411},"moveregistry.com",{"type":49,"value":413}," or, definitively, by running the build (below), which resolves every slug against the MVR.",{"type":43,"tag":415,"props":416,"children":417},"blockquote",{},[418],{"type":43,"tag":59,"props":419,"children":420},{},[421,426,428,434,436,442,444,450,452,458,460,466,468,474,476,482,484,490],{"type":43,"tag":278,"props":422,"children":423},{},[424],{"type":49,"value":425},"Catalog paths are relative to the catalog file's own directory.",{"type":49,"value":427}," A catalog at ",{"type":43,"tag":86,"props":429,"children":431},{"className":430},[],[432],{"type":49,"value":433},"\u003Ccatalog-dir>\u002FREADME.md",{"type":49,"value":435}," lists each package by a ",{"type":43,"tag":86,"props":437,"children":439},{"className":438},[],[440],{"type":49,"value":441},"Path",{"type":49,"value":443}," relative to ",{"type":43,"tag":86,"props":445,"children":447},{"className":446},[],[448],{"type":49,"value":449},"\u003Ccatalog-dir>\u002F",{"type":49,"value":451},", so the package's raw README is ",{"type":43,"tag":86,"props":453,"children":455},{"className":454},[],[456],{"type":49,"value":457},"...\u002Fmain\u002F\u003Ccatalog-dir>\u002F\u003Cpath>\u002FREADME.md",{"type":49,"value":459}," — resolve ",{"type":43,"tag":86,"props":461,"children":463},{"className":462},[],[464],{"type":49,"value":465},"\u003Cpath>",{"type":49,"value":467}," against the directory of the catalog that links it, not the repo root (the bare ",{"type":43,"tag":86,"props":469,"children":471},{"className":470},[],[472],{"type":49,"value":473},"...\u002Fmain\u002F\u003Cpath>\u002FREADME.md",{"type":49,"value":475}," 404s). When in doubt, list the tree: ",{"type":43,"tag":86,"props":477,"children":479},{"className":478},[],[480],{"type":49,"value":481},"gh api 'repos\u002FOpenZeppelin\u002Fcontracts-sui\u002Fgit\u002Ftrees\u002Fmain?recursive=1'",{"type":49,"value":483}," (quote the endpoint — an unquoted ",{"type":43,"tag":86,"props":485,"children":487},{"className":486},[],[488],{"type":49,"value":489},"?",{"type":49,"value":491}," is a glob in some shells).",{"type":43,"tag":415,"props":493,"children":494},{},[495],{"type":43,"tag":59,"props":496,"children":497},{},[498,500,506,508,514,516,522],{"type":49,"value":499},"The Move package name (used in ",{"type":43,"tag":86,"props":501,"children":503},{"className":502},[],[504],{"type":49,"value":505},"use",{"type":49,"value":507}," statements) differs from the MVR slug — slug ",{"type":43,"tag":86,"props":509,"children":511},{"className":510},[],[512],{"type":49,"value":513},"@openzeppelin-move\u002Finteger-math",{"type":49,"value":515}," is Move package ",{"type":43,"tag":86,"props":517,"children":519},{"className":518},[],[520],{"type":49,"value":521},"openzeppelin_math",{"type":49,"value":523},". Only add the packages the project actually uses.",{"type":43,"tag":415,"props":525,"children":526},{},[527],{"type":43,"tag":59,"props":528,"children":529},{},[530,535,537,543,545,551],{"type":43,"tag":278,"props":531,"children":532},{},[533],{"type":49,"value":534},"A package usually contains several modules.",{"type":49,"value":536}," The catalog lists ",{"type":43,"tag":538,"props":539,"children":540},"em",{},[541],{"type":49,"value":542},"packages",{"type":49,"value":544},"; the building block you want is often one module among several inside a package. Read the package README's module list and its ",{"type":43,"tag":86,"props":546,"children":548},{"className":547},[],[549],{"type":49,"value":550},"examples\u002F",{"type":49,"value":552}," to see what a package actually exposes — don't assume one package equals one component, and don't rely on a fixed mental catalog: the set of packages and modules grows over time.",{"type":43,"tag":415,"props":554,"children":555},{},[556],{"type":43,"tag":59,"props":557,"children":558},{},[559,561,566,568,574,576,582,584,590,592,597],{"type":49,"value":560},"The OpenZeppelin ",{"type":43,"tag":278,"props":562,"children":563},{},[564],{"type":49,"value":565},"Sui MCP",{"type":49,"value":567}," exposes this same metadata as deterministic tool calls — ",{"type":43,"tag":86,"props":569,"children":571},{"className":570},[],[572],{"type":49,"value":573},"sui-list-recipes",{"type":49,"value":575}," (discover recipes), ",{"type":43,"tag":86,"props":577,"children":579},{"className":578},[],[580],{"type":49,"value":581},"sui-get-recipe",{"type":49,"value":583}," (a recipe's source plus the packages it uses, each with its install line), and ",{"type":43,"tag":86,"props":585,"children":587},{"className":586},[],[588],{"type":49,"value":589},"sui-get-package",{"type":49,"value":591}," (a package's install line + docs). When the MCP is available, query it instead of crawling the files by hand, then wire the returned install lines into ",{"type":43,"tag":86,"props":593,"children":595},{"className":594},[],[596],{"type":49,"value":224},{"type":49,"value":598}," and re-home the recipe source into your package. The MCP returns data, not a buildable package — that wiring and re-homing are what turn it into one.",{"type":43,"tag":600,"props":601,"children":603},"h3",{"id":602},"packages-not-on-the-move-registry",[604],{"type":49,"value":605},"Packages not on the Move Registry",{"type":43,"tag":59,"props":607,"children":608},{},[609,611,616,618,623,625,630],{"type":49,"value":610},"Not every package is on the Move Registry — some are not published there at all. When a package's ",{"type":43,"tag":86,"props":612,"children":614},{"className":613},[],[615],{"type":49,"value":395},{"type":49,"value":617}," has no ",{"type":43,"tag":86,"props":619,"children":621},{"className":620},[],[622],{"type":49,"value":305},{"type":49,"value":624}," install snippet, depend on it from a ",{"type":43,"tag":278,"props":626,"children":627},{},[628],{"type":49,"value":629},"GitHub release",{"type":49,"value":631}," instead — a git dependency pinned to a release tag, never a moving branch:",{"type":43,"tag":132,"props":633,"children":635},{"className":310,"code":634,"language":312,"meta":137,"style":137},"[dependencies]\n\u003Cmove_package_name> = { git = \"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui.git\", subdir = \"\u003Ccatalog-dir>\u002F\u003Cpath>\", rev = \"\u003Crelease-tag>\" }\n",[636],{"type":43,"tag":86,"props":637,"children":638},{"__ignoreMap":137},[639,646],{"type":43,"tag":143,"props":640,"children":641},{"class":145,"line":146},[642],{"type":43,"tag":143,"props":643,"children":644},{},[645],{"type":49,"value":324},{"type":43,"tag":143,"props":647,"children":648},{"class":145,"line":202},[649],{"type":43,"tag":143,"props":650,"children":651},{},[652],{"type":49,"value":653},"\u003Cmove_package_name> = { git = \"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui.git\", subdir = \"\u003Ccatalog-dir>\u002F\u003Cpath>\", rev = \"\u003Crelease-tag>\" }\n",{"type":43,"tag":59,"props":655,"children":656},{},[657,663,665,670,672,678,680,685],{"type":43,"tag":86,"props":658,"children":660},{"className":659},[],[661],{"type":49,"value":662},"\u003Ccatalog-dir>\u002F\u003Cpath>",{"type":49,"value":664}," is the package's directory in the repo (the same ",{"type":43,"tag":86,"props":666,"children":668},{"className":667},[],[669],{"type":49,"value":441},{"type":49,"value":671}," its catalog row lists); pin ",{"type":43,"tag":86,"props":673,"children":675},{"className":674},[],[676],{"type":49,"value":677},"rev",{"type":49,"value":679}," to a published GitHub ",{"type":43,"tag":278,"props":681,"children":682},{},[683],{"type":49,"value":684},"release",{"type":49,"value":686}," tag, not a branch. Keep every OpenZeppelin dependency on one consistent revision to avoid the diamond conflict below.",{"type":43,"tag":600,"props":688,"children":690},{"id":689},"resolving-version-conflicts-diamond-dependencies",[691],{"type":49,"value":692},"Resolving version conflicts (diamond dependencies)",{"type":43,"tag":59,"props":694,"children":695},{},[696,698,703],{"type":49,"value":697},"Two OZ packages can pull ",{"type":43,"tag":538,"props":699,"children":700},{},[701],{"type":49,"value":702},"different revisions",{"type":49,"value":704}," of a shared transitive dependency — for example, if one package embeds its own revision of a math package that you also depend on directly. When that happens the build aborts:",{"type":43,"tag":132,"props":706,"children":710},{"className":707,"code":709,"language":49},[708],"language-text","Package depends on multiple versions of the package with ID 0x…\n",[711],{"type":43,"tag":86,"props":712,"children":713},{"__ignoreMap":137},[714],{"type":49,"value":709},{"type":43,"tag":59,"props":716,"children":717},{},[718,720,726],{"type":49,"value":719},"Resolve it by adding ",{"type":43,"tag":86,"props":721,"children":723},{"className":722},[],[724],{"type":49,"value":725},"override = true",{"type":49,"value":727}," to the directly-declared dependency, which forces every consumer onto that revision:",{"type":43,"tag":132,"props":729,"children":731},{"className":310,"code":730,"language":312,"meta":137,"style":137},"[dependencies]\nopenzeppelin_math = { r.mvr = \"@openzeppelin-move\u002Finteger-math\", override = true }\nopenzeppelin_fp_math = { r.mvr = \"@openzeppelin-move\u002Ffixed-point-math\" }\n",[732],{"type":43,"tag":86,"props":733,"children":734},{"__ignoreMap":137},[735,742,750],{"type":43,"tag":143,"props":736,"children":737},{"class":145,"line":146},[738],{"type":43,"tag":143,"props":739,"children":740},{},[741],{"type":49,"value":324},{"type":43,"tag":143,"props":743,"children":744},{"class":145,"line":202},[745],{"type":43,"tag":143,"props":746,"children":747},{},[748],{"type":49,"value":749},"openzeppelin_math = { r.mvr = \"@openzeppelin-move\u002Finteger-math\", override = true }\n",{"type":43,"tag":143,"props":751,"children":753},{"class":145,"line":752},3,[754],{"type":43,"tag":143,"props":755,"children":756},{},[757],{"type":49,"value":758},"openzeppelin_fp_math = { r.mvr = \"@openzeppelin-move\u002Ffixed-point-math\" }\n",{"type":43,"tag":52,"props":760,"children":762},{"id":761},"study-the-examples-and-docs-before-implementing",[763],{"type":49,"value":764},"Study the Examples and Docs Before Implementing",{"type":43,"tag":59,"props":766,"children":767},{},[768],{"type":49,"value":769},"Do this before writing any integration code — most users don't know the full catalog, and it grows over time, so let the library show you what it provides and how it's meant to be composed. For each package you plan to use:",{"type":43,"tag":346,"props":771,"children":772},{},[773,983,1034],{"type":43,"tag":350,"props":774,"children":775},{},[776,787,789,795,797,887],{"type":43,"tag":278,"props":777,"children":778},{},[779,781,786],{"type":49,"value":780},"Study its ",{"type":43,"tag":86,"props":782,"children":784},{"className":783},[],[785],{"type":49,"value":550},{"type":49,"value":365},{"type":49,"value":788}," Every package ships compilable, CI-tested integration examples — these are the canonical composition recipes and the fastest way to see the real usage pattern (initialization, capability\u002Fwitness flow, object ownership, tests). Prefer copying and adapting an example into ",{"type":43,"tag":86,"props":790,"children":792},{"className":791},[],[793],{"type":49,"value":794},"sources\u002F",{"type":49,"value":796}," over writing from scratch.",{"type":43,"tag":415,"props":798,"children":799},{},[800],{"type":43,"tag":59,"props":801,"children":802},{},[803,816,818,823,825,831,833,838,840,850,852,857,859,864,866,870,872,878,880,885],{"type":43,"tag":278,"props":804,"children":805},{},[806,808,814],{"type":49,"value":807},"Read examples and metadata from ",{"type":43,"tag":86,"props":809,"children":811},{"className":810},[],[812],{"type":49,"value":813},"main",{"type":49,"value":815},"; pin dependencies to a release.",{"type":49,"value":817}," All AI metadata — ",{"type":43,"tag":86,"props":819,"children":821},{"className":820},[],[822],{"type":49,"value":91},{"type":49,"value":824},", the catalogs, package READMEs, ",{"type":43,"tag":86,"props":826,"children":828},{"className":827},[],[829],{"type":49,"value":830},"STYLEGUIDE.md",{"type":49,"value":832},", and the ",{"type":43,"tag":86,"props":834,"children":836},{"className":835},[],[837],{"type":49,"value":550},{"type":49,"value":839}," — should be read from the ",{"type":43,"tag":278,"props":841,"children":842},{},[843,848],{"type":43,"tag":86,"props":844,"children":846},{"className":845},[],[847],{"type":49,"value":813},{"type":49,"value":849}," branch",{"type":49,"value":851},", which carries the latest and most complete set (a package may have examples on ",{"type":43,"tag":86,"props":853,"children":855},{"className":854},[],[856],{"type":49,"value":813},{"type":49,"value":858}," that a tagged release does not). Your build ",{"type":43,"tag":538,"props":860,"children":861},{},[862],{"type":49,"value":863},"dependencies",{"type":49,"value":865},", by contrast, resolve to a pinned ",{"type":43,"tag":278,"props":867,"children":868},{},[869],{"type":49,"value":684},{"type":49,"value":871}," — an MVR slug or a git ",{"type":43,"tag":86,"props":873,"children":875},{"className":874},[],[876],{"type":49,"value":877},"rev = \"\u003Crelease-tag>\"",{"type":49,"value":879}," (above) — so builds stay reproducible. The two can differ: an example copied from ",{"type":43,"tag":86,"props":881,"children":883},{"className":882},[],[884],{"type":49,"value":813},{"type":49,"value":886}," may reference an API newer than your pinned release, in which case adapt it (or bump the pinned release) when you re-home.",{"type":43,"tag":415,"props":888,"children":889},{},[890],{"type":43,"tag":59,"props":891,"children":892},{},[893,898,900,905,907,913,915,920,922,928,930,936,938,943,945,951,953,959,961,966,968,974,976,981],{"type":43,"tag":278,"props":894,"children":895},{},[896],{"type":49,"value":897},"Re-home a copied example.",{"type":49,"value":899}," Example modules are declared under the ",{"type":43,"tag":538,"props":901,"children":902},{},[903],{"type":49,"value":904},"library's",{"type":49,"value":906}," own address (e.g. ",{"type":43,"tag":86,"props":908,"children":910},{"className":909},[],[911],{"type":49,"value":912},"module openzeppelin_access::example_reward_treasury;",{"type":49,"value":914},") — they are illustrations inside the library, not drop-in consumer code. When you copy one into ",{"type":43,"tag":86,"props":916,"children":918},{"className":917},[],[919],{"type":49,"value":794},{"type":49,"value":921},", rename its module to your package (",{"type":43,"tag":86,"props":923,"children":925},{"className":924},[],[926],{"type":49,"value":927},"module \u003Cyour_package>::\u003Cmodule>;",{"type":49,"value":929},", where ",{"type":43,"tag":86,"props":931,"children":933},{"className":932},[],[934],{"type":49,"value":935},"\u003Cyour_package>",{"type":49,"value":937}," is your ",{"type":43,"tag":86,"props":939,"children":941},{"className":940},[],[942],{"type":49,"value":224},{"type":49,"value":944}," ",{"type":43,"tag":86,"props":946,"children":948},{"className":947},[],[949],{"type":49,"value":950},"[package]",{"type":49,"value":952}," name). Keep the ",{"type":43,"tag":86,"props":954,"children":956},{"className":955},[],[957],{"type":49,"value":958},"use openzeppelin_*::…",{"type":49,"value":960}," lines as-is — those reference the dependencies. ",{"type":43,"tag":278,"props":962,"children":963},{},[964],{"type":49,"value":965},"If the example defines a one-time witness",{"type":49,"value":967}," — a struct whose name is the module name upper-cased, consumed by ",{"type":43,"tag":86,"props":969,"children":971},{"className":970},[],[972],{"type":49,"value":973},"init",{"type":49,"value":975}," — rename that struct to match your new module name too, or ",{"type":43,"tag":86,"props":977,"children":979},{"className":978},[],[980],{"type":49,"value":973},{"type":49,"value":982}," fails with \"Invalid parameter … Expected a one-time witness type\". You cannot define a module under a dependency's address, so a verbatim copy will not build until it is re-homed.",{"type":43,"tag":350,"props":984,"children":985},{},[986,991,993,1000,1002,1008,1010,1016,1018,1024,1026,1032],{"type":43,"tag":278,"props":987,"children":988},{},[989],{"type":49,"value":990},"Read the docs.",{"type":49,"value":992}," Start at the ",{"type":43,"tag":65,"props":994,"children":997},{"href":995,"rel":996},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui",[69],[998],{"type":49,"value":999},"documentation site",{"type":49,"value":1001}," for concepts and guides, then the generated API reference — reached via the ",{"type":43,"tag":86,"props":1003,"children":1005},{"className":1004},[],[1006],{"type":49,"value":1007},"Docs",{"type":49,"value":1009}," link in each catalog table (it points at the correct version), path ",{"type":43,"tag":86,"props":1011,"children":1013},{"className":1012},[],[1014],{"type":49,"value":1015},"...\u002Fcontracts-sui\u002F\u003Cmajor>.x\u002Fapi\u002F\u003Ccatalog_package>",{"type":49,"value":1017}," where ",{"type":43,"tag":86,"props":1019,"children":1021},{"className":1020},[],[1022],{"type":49,"value":1023},"\u003Cmajor>",{"type":49,"value":1025}," matches your contracts-sui release and ",{"type":43,"tag":86,"props":1027,"children":1029},{"className":1028},[],[1030],{"type":49,"value":1031},"\u003Ccatalog_package>",{"type":49,"value":1033}," is the short catalog name, not the Move package name — for exact signatures, parameters, and abort conditions.",{"type":43,"tag":350,"props":1035,"children":1036},{},[1037,1042,1044,1050,1052,1058,1060,1066],{"type":43,"tag":278,"props":1038,"children":1039},{},[1040],{"type":49,"value":1041},"Read the code docs.",{"type":49,"value":1043}," The API reference is generated from the modules' doc-comments, so the installed source is the ground truth. Generate the same docs locally with ",{"type":43,"tag":86,"props":1045,"children":1047},{"className":1046},[],[1048],{"type":49,"value":1049},"sui move build --doc --build-env testnet",{"type":49,"value":1051}," (the ",{"type":43,"tag":86,"props":1053,"children":1055},{"className":1054},[],[1056],{"type":49,"value":1057},"--build-env",{"type":49,"value":1059}," is required whenever there are MVR deps) — this also emits the docs for every OZ dependency under ",{"type":43,"tag":86,"props":1061,"children":1063},{"className":1062},[],[1064],{"type":49,"value":1065},"build\u002F\u003Cyour_package>\u002Fdocs\u002Fdependencies\u002F\u003Cmove_package_name>\u002F",{"type":49,"value":1067}," — or just read the doc-comments in the installed source.",{"type":43,"tag":59,"props":1069,"children":1070},{},[1071,1073,1078,1080,1087],{"type":49,"value":1072},"Discover the available examples from ",{"type":43,"tag":86,"props":1074,"children":1076},{"className":1075},[],[1077],{"type":49,"value":91},{"type":49,"value":1079}," and each package README, then browse them in the ",{"type":43,"tag":65,"props":1081,"children":1084},{"href":1082,"rel":1083},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui",[69],[1085],{"type":49,"value":1086},"contracts-sui repo",{"type":49,"value":365},{"type":43,"tag":52,"props":1089,"children":1091},{"id":1090},"import-conventions",[1092],{"type":49,"value":1093},"Import Conventions",{"type":43,"tag":59,"props":1095,"children":1096},{},[1097,1099,1104,1106,1112,1114,1119],{"type":49,"value":1098},"Import modules through the Move package name (the left side of the ",{"type":43,"tag":86,"props":1100,"children":1102},{"className":1101},[],[1103],{"type":49,"value":224},{"type":49,"value":1105}," entry) followed by the module name — ",{"type":43,"tag":86,"props":1107,"children":1109},{"className":1108},[],[1110],{"type":49,"value":1111},"use \u003Cmove_package_name>::\u003Cmodule>;",{"type":49,"value":1113}," — then follow the usage patterns from the package's ",{"type":43,"tag":86,"props":1115,"children":1117},{"className":1116},[],[1118],{"type":49,"value":550},{"type":49,"value":1120}," and API docs.",{"type":43,"tag":415,"props":1122,"children":1123},{},[1124],{"type":43,"tag":59,"props":1125,"children":1126},{},[1127,1129,1134,1136,1142,1144,1150,1152,1157],{"type":49,"value":1128},"Some operations are exposed as ",{"type":43,"tag":278,"props":1130,"children":1131},{},[1132],{"type":49,"value":1133},"method syntax",{"type":49,"value":1135}," (",{"type":43,"tag":86,"props":1137,"children":1139},{"className":1138},[],[1140],{"type":49,"value":1141},"value.op(...)",{"type":49,"value":1143},") via ",{"type":43,"tag":86,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":49,"value":1149},"public use fun",{"type":49,"value":1151}," re-exports, so the underlying function may live in a different module than the type. If a free function you expect isn't found, check the package source for the ",{"type":43,"tag":86,"props":1153,"children":1155},{"className":1154},[],[1156],{"type":49,"value":1149},{"type":49,"value":1158}," lines and call it as a method.",{"type":43,"tag":52,"props":1160,"children":1162},{"id":1161},"generate-agent-guidance",[1163],{"type":49,"value":1164},"Generate Agent Guidance",{"type":43,"tag":59,"props":1166,"children":1167},{},[1168,1170,1176,1178,1190,1192,1196,1198,1204,1206,1212],{"type":49,"value":1169},"Create an ",{"type":43,"tag":86,"props":1171,"children":1173},{"className":1172},[],[1174],{"type":49,"value":1175},"AGENTS.md",{"type":49,"value":1177}," at the project root so any agent that later opens this project knows it is built on OpenZeppelin Contracts for Sui and where the sources of truth live. Follow the same philosophy as the ",{"type":43,"tag":65,"props":1179,"children":1182},{"href":1180,"rel":1181},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FAGENTS.md",[69],[1183,1185],{"type":49,"value":1184},"contracts-sui ",{"type":43,"tag":86,"props":1186,"children":1188},{"className":1187},[],[1189],{"type":49,"value":1175},{"type":49,"value":1191},": a lean pointer file that does ",{"type":43,"tag":278,"props":1193,"children":1194},{},[1195],{"type":49,"value":342},{"type":49,"value":1197}," restate rules — it links to the authoritative sources. Also add a ",{"type":43,"tag":86,"props":1199,"children":1201},{"className":1200},[],[1202],{"type":49,"value":1203},"CLAUDE.md",{"type":49,"value":1205}," containing only ",{"type":43,"tag":86,"props":1207,"children":1209},{"className":1208},[],[1210],{"type":49,"value":1211},"@AGENTS.md",{"type":49,"value":1213}," so Claude Code picks it up (mirroring how contracts-sui itself is set up).",{"type":43,"tag":132,"props":1215,"children":1219},{"className":1216,"code":1217,"language":1218,"meta":137,"style":137},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# AGENTS.md\n\nThis is a Sui Move project built on **OpenZeppelin Contracts for Sui**.\n\n## Sources of truth — read these first\n- AI discovery entry point: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt\n  (points to the package catalogs, each package's `examples\u002F`, the generated API reference, and audits)\n- Docs: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\n- API reference: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\u002F\u003Cmajor>.x\u002Fapi\u002F\u003Ccatalog_package> (`\u003Cmajor>` matches your contracts-sui release and `\u003Ccatalog_package>` is the short catalog name; the catalog's `Docs` links carry the correct version)\n- Code docs (local): `sui move build --doc --build-env testnet` → `build\u002F\u003Cyour_package>\u002Fdocs\u002F` (named after your own package; includes OZ dependencies)\n\n## Conventions\n- Before implementing, study each package's `examples\u002F` (compilable, CI-tested composition recipes) and its API docs; prefer audited library components over custom logic.\n- Import modules via the Move package name (`use \u003Cmove_package_name>::\u003Cmodule>;`); a package typically exposes several modules — check its README and `examples\u002F`.\n- MVR-backed builds require a build env: `sui move build --build-env testnet`. If two OZ deps pull different revisions of a shared transitive package, add `override = true` to the directly-declared one.\n- For fungible-asset custody, consider Sui [Address Balances](https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fasset-custody\u002Faddress-balances\u002F) (SIP-58) over summing `Coin` objects where it fits.\n- Code style follows the OpenZeppelin Sui conventions — see Code Quality below.\n\n## Code quality\nThe library's conventions are the single source of truth for Move style:\n- Rules: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FSTYLEGUIDE.md\n- Design rationale: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md\n- Review procedure (reads STYLEGUIDE.md, reports\u002Ffixes violations): https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002F.claude\u002Fcommands\u002Fcode-quality.md\n\n## MCP\nThe OpenZeppelin Sui MCP (https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp) serves recipes and per-package install lines as deterministic tool calls (`sui-list-recipes`, `sui-get-recipe`, `sui-get-package`) — a queryable alternative to reading `llms.txt` + the catalogs by hand. This project ships it pre-wired in `.mcp.json`. It returns data, not a buildable package — wiring the install lines into `Move.toml` and re-homing the source into this package is what turns it into one.\n","markdown",[1220],{"type":43,"tag":86,"props":1221,"children":1222},{"__ignoreMap":137},[1223,1237,1246,1276,1284,1298,1312,1339,1352,1453,1501,1509,1522,1552,1598,1646,1708,1721,1729,1742,1751,1764,1777,1790,1798,1810],{"type":43,"tag":143,"props":1224,"children":1225},{"class":145,"line":146},[1226,1232],{"type":43,"tag":143,"props":1227,"children":1229},{"style":1228},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1230],{"type":49,"value":1231},"# ",{"type":43,"tag":143,"props":1233,"children":1234},{"style":150},[1235],{"type":49,"value":1236},"AGENTS.md\n",{"type":43,"tag":143,"props":1238,"children":1239},{"class":145,"line":202},[1240],{"type":43,"tag":143,"props":1241,"children":1243},{"emptyLinePlaceholder":1242},true,[1244],{"type":49,"value":1245},"\n",{"type":43,"tag":143,"props":1247,"children":1248},{"class":145,"line":752},[1249,1255,1261,1267,1271],{"type":43,"tag":143,"props":1250,"children":1252},{"style":1251},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1253],{"type":49,"value":1254},"This is a Sui Move project built on ",{"type":43,"tag":143,"props":1256,"children":1258},{"style":1257},"--shiki-light:#39ADB5;--shiki-light-font-weight:bold;--shiki-default:#89DDFF;--shiki-default-font-weight:bold;--shiki-dark:#89DDFF;--shiki-dark-font-weight:bold",[1259],{"type":49,"value":1260},"**",{"type":43,"tag":143,"props":1262,"children":1264},{"style":1263},"--shiki-light:#E53935;--shiki-light-font-weight:bold;--shiki-default:#F07178;--shiki-default-font-weight:bold;--shiki-dark:#F07178;--shiki-dark-font-weight:bold",[1265],{"type":49,"value":1266},"OpenZeppelin Contracts for Sui",{"type":43,"tag":143,"props":1268,"children":1269},{"style":1257},[1270],{"type":49,"value":1260},{"type":43,"tag":143,"props":1272,"children":1273},{"style":1251},[1274],{"type":49,"value":1275},".\n",{"type":43,"tag":143,"props":1277,"children":1279},{"class":145,"line":1278},4,[1280],{"type":43,"tag":143,"props":1281,"children":1282},{"emptyLinePlaceholder":1242},[1283],{"type":49,"value":1245},{"type":43,"tag":143,"props":1285,"children":1287},{"class":145,"line":1286},5,[1288,1293],{"type":43,"tag":143,"props":1289,"children":1290},{"style":1228},[1291],{"type":49,"value":1292},"## ",{"type":43,"tag":143,"props":1294,"children":1295},{"style":150},[1296],{"type":49,"value":1297},"Sources of truth — read these first\n",{"type":43,"tag":143,"props":1299,"children":1301},{"class":145,"line":1300},6,[1302,1307],{"type":43,"tag":143,"props":1303,"children":1304},{"style":1228},[1305],{"type":49,"value":1306},"-",{"type":43,"tag":143,"props":1308,"children":1309},{"style":1251},[1310],{"type":49,"value":1311}," AI discovery entry point: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt\n",{"type":43,"tag":143,"props":1313,"children":1315},{"class":145,"line":1314},7,[1316,1321,1326,1330,1334],{"type":43,"tag":143,"props":1317,"children":1318},{"style":1251},[1319],{"type":49,"value":1320},"  (points to the package catalogs, each package's ",{"type":43,"tag":143,"props":1322,"children":1323},{"style":1228},[1324],{"type":49,"value":1325},"`",{"type":43,"tag":143,"props":1327,"children":1328},{"style":156},[1329],{"type":49,"value":550},{"type":43,"tag":143,"props":1331,"children":1332},{"style":1228},[1333],{"type":49,"value":1325},{"type":43,"tag":143,"props":1335,"children":1336},{"style":1251},[1337],{"type":49,"value":1338},", the generated API reference, and audits)\n",{"type":43,"tag":143,"props":1340,"children":1342},{"class":145,"line":1341},8,[1343,1347],{"type":43,"tag":143,"props":1344,"children":1345},{"style":1228},[1346],{"type":49,"value":1306},{"type":43,"tag":143,"props":1348,"children":1349},{"style":1251},[1350],{"type":49,"value":1351}," Docs: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\n",{"type":43,"tag":143,"props":1353,"children":1355},{"class":145,"line":1354},9,[1356,1360,1365,1370,1376,1381,1386,1390,1395,1399,1403,1407,1411,1415,1419,1423,1427,1431,1436,1440,1444,1448],{"type":43,"tag":143,"props":1357,"children":1358},{"style":1228},[1359],{"type":49,"value":1306},{"type":43,"tag":143,"props":1361,"children":1362},{"style":1251},[1363],{"type":49,"value":1364}," API reference: https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui\u002F",{"type":43,"tag":143,"props":1366,"children":1367},{"style":1228},[1368],{"type":49,"value":1369},"\u003C",{"type":43,"tag":143,"props":1371,"children":1373},{"style":1372},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1374],{"type":49,"value":1375},"major",{"type":43,"tag":143,"props":1377,"children":1378},{"style":1228},[1379],{"type":49,"value":1380},">",{"type":43,"tag":143,"props":1382,"children":1383},{"style":1251},[1384],{"type":49,"value":1385},".x\u002Fapi\u002F",{"type":43,"tag":143,"props":1387,"children":1388},{"style":1228},[1389],{"type":49,"value":1369},{"type":43,"tag":143,"props":1391,"children":1392},{"style":1372},[1393],{"type":49,"value":1394},"catalog_package",{"type":43,"tag":143,"props":1396,"children":1397},{"style":1228},[1398],{"type":49,"value":1380},{"type":43,"tag":143,"props":1400,"children":1401},{"style":1251},[1402],{"type":49,"value":1135},{"type":43,"tag":143,"props":1404,"children":1405},{"style":1228},[1406],{"type":49,"value":1325},{"type":43,"tag":143,"props":1408,"children":1409},{"style":156},[1410],{"type":49,"value":1023},{"type":43,"tag":143,"props":1412,"children":1413},{"style":1228},[1414],{"type":49,"value":1325},{"type":43,"tag":143,"props":1416,"children":1417},{"style":1251},[1418],{"type":49,"value":1025},{"type":43,"tag":143,"props":1420,"children":1421},{"style":1228},[1422],{"type":49,"value":1325},{"type":43,"tag":143,"props":1424,"children":1425},{"style":156},[1426],{"type":49,"value":1031},{"type":43,"tag":143,"props":1428,"children":1429},{"style":1228},[1430],{"type":49,"value":1325},{"type":43,"tag":143,"props":1432,"children":1433},{"style":1251},[1434],{"type":49,"value":1435}," is the short catalog name; the catalog's ",{"type":43,"tag":143,"props":1437,"children":1438},{"style":1228},[1439],{"type":49,"value":1325},{"type":43,"tag":143,"props":1441,"children":1442},{"style":156},[1443],{"type":49,"value":1007},{"type":43,"tag":143,"props":1445,"children":1446},{"style":1228},[1447],{"type":49,"value":1325},{"type":43,"tag":143,"props":1449,"children":1450},{"style":1251},[1451],{"type":49,"value":1452}," links carry the correct version)\n",{"type":43,"tag":143,"props":1454,"children":1456},{"class":145,"line":1455},10,[1457,1461,1466,1470,1474,1478,1483,1487,1492,1496],{"type":43,"tag":143,"props":1458,"children":1459},{"style":1228},[1460],{"type":49,"value":1306},{"type":43,"tag":143,"props":1462,"children":1463},{"style":1251},[1464],{"type":49,"value":1465}," Code docs (local): ",{"type":43,"tag":143,"props":1467,"children":1468},{"style":1228},[1469],{"type":49,"value":1325},{"type":43,"tag":143,"props":1471,"children":1472},{"style":156},[1473],{"type":49,"value":1049},{"type":43,"tag":143,"props":1475,"children":1476},{"style":1228},[1477],{"type":49,"value":1325},{"type":43,"tag":143,"props":1479,"children":1480},{"style":1251},[1481],{"type":49,"value":1482}," → ",{"type":43,"tag":143,"props":1484,"children":1485},{"style":1228},[1486],{"type":49,"value":1325},{"type":43,"tag":143,"props":1488,"children":1489},{"style":156},[1490],{"type":49,"value":1491},"build\u002F\u003Cyour_package>\u002Fdocs\u002F",{"type":43,"tag":143,"props":1493,"children":1494},{"style":1228},[1495],{"type":49,"value":1325},{"type":43,"tag":143,"props":1497,"children":1498},{"style":1251},[1499],{"type":49,"value":1500}," (named after your own package; includes OZ dependencies)\n",{"type":43,"tag":143,"props":1502,"children":1504},{"class":145,"line":1503},11,[1505],{"type":43,"tag":143,"props":1506,"children":1507},{"emptyLinePlaceholder":1242},[1508],{"type":49,"value":1245},{"type":43,"tag":143,"props":1510,"children":1512},{"class":145,"line":1511},12,[1513,1517],{"type":43,"tag":143,"props":1514,"children":1515},{"style":1228},[1516],{"type":49,"value":1292},{"type":43,"tag":143,"props":1518,"children":1519},{"style":150},[1520],{"type":49,"value":1521},"Conventions\n",{"type":43,"tag":143,"props":1523,"children":1525},{"class":145,"line":1524},13,[1526,1530,1535,1539,1543,1547],{"type":43,"tag":143,"props":1527,"children":1528},{"style":1228},[1529],{"type":49,"value":1306},{"type":43,"tag":143,"props":1531,"children":1532},{"style":1251},[1533],{"type":49,"value":1534}," Before implementing, study each package's ",{"type":43,"tag":143,"props":1536,"children":1537},{"style":1228},[1538],{"type":49,"value":1325},{"type":43,"tag":143,"props":1540,"children":1541},{"style":156},[1542],{"type":49,"value":550},{"type":43,"tag":143,"props":1544,"children":1545},{"style":1228},[1546],{"type":49,"value":1325},{"type":43,"tag":143,"props":1548,"children":1549},{"style":1251},[1550],{"type":49,"value":1551}," (compilable, CI-tested composition recipes) and its API docs; prefer audited library components over custom logic.\n",{"type":43,"tag":143,"props":1553,"children":1555},{"class":145,"line":1554},14,[1556,1560,1565,1569,1573,1577,1582,1586,1590,1594],{"type":43,"tag":143,"props":1557,"children":1558},{"style":1228},[1559],{"type":49,"value":1306},{"type":43,"tag":143,"props":1561,"children":1562},{"style":1251},[1563],{"type":49,"value":1564}," Import modules via the Move package name (",{"type":43,"tag":143,"props":1566,"children":1567},{"style":1228},[1568],{"type":49,"value":1325},{"type":43,"tag":143,"props":1570,"children":1571},{"style":156},[1572],{"type":49,"value":1111},{"type":43,"tag":143,"props":1574,"children":1575},{"style":1228},[1576],{"type":49,"value":1325},{"type":43,"tag":143,"props":1578,"children":1579},{"style":1251},[1580],{"type":49,"value":1581},"); a package typically exposes several modules — check its README and ",{"type":43,"tag":143,"props":1583,"children":1584},{"style":1228},[1585],{"type":49,"value":1325},{"type":43,"tag":143,"props":1587,"children":1588},{"style":156},[1589],{"type":49,"value":550},{"type":43,"tag":143,"props":1591,"children":1592},{"style":1228},[1593],{"type":49,"value":1325},{"type":43,"tag":143,"props":1595,"children":1596},{"style":1251},[1597],{"type":49,"value":1275},{"type":43,"tag":143,"props":1599,"children":1601},{"class":145,"line":1600},15,[1602,1606,1611,1615,1620,1624,1629,1633,1637,1641],{"type":43,"tag":143,"props":1603,"children":1604},{"style":1228},[1605],{"type":49,"value":1306},{"type":43,"tag":143,"props":1607,"children":1608},{"style":1251},[1609],{"type":49,"value":1610}," MVR-backed builds require a build env: ",{"type":43,"tag":143,"props":1612,"children":1613},{"style":1228},[1614],{"type":49,"value":1325},{"type":43,"tag":143,"props":1616,"children":1617},{"style":156},[1618],{"type":49,"value":1619},"sui move build --build-env testnet",{"type":43,"tag":143,"props":1621,"children":1622},{"style":1228},[1623],{"type":49,"value":1325},{"type":43,"tag":143,"props":1625,"children":1626},{"style":1251},[1627],{"type":49,"value":1628},". If two OZ deps pull different revisions of a shared transitive package, add ",{"type":43,"tag":143,"props":1630,"children":1631},{"style":1228},[1632],{"type":49,"value":1325},{"type":43,"tag":143,"props":1634,"children":1635},{"style":156},[1636],{"type":49,"value":725},{"type":43,"tag":143,"props":1638,"children":1639},{"style":1228},[1640],{"type":49,"value":1325},{"type":43,"tag":143,"props":1642,"children":1643},{"style":1251},[1644],{"type":49,"value":1645}," to the directly-declared one.\n",{"type":43,"tag":143,"props":1647,"children":1649},{"class":145,"line":1648},16,[1650,1654,1659,1664,1669,1674,1680,1685,1690,1694,1699,1703],{"type":43,"tag":143,"props":1651,"children":1652},{"style":1228},[1653],{"type":49,"value":1306},{"type":43,"tag":143,"props":1655,"children":1656},{"style":1251},[1657],{"type":49,"value":1658}," For fungible-asset custody, consider Sui ",{"type":43,"tag":143,"props":1660,"children":1661},{"style":1228},[1662],{"type":49,"value":1663},"[",{"type":43,"tag":143,"props":1665,"children":1666},{"style":156},[1667],{"type":49,"value":1668},"Address Balances",{"type":43,"tag":143,"props":1670,"children":1671},{"style":1228},[1672],{"type":49,"value":1673},"](",{"type":43,"tag":143,"props":1675,"children":1677},{"style":1676},"--shiki-light:#E53935;--shiki-light-text-decoration:underline;--shiki-default:#F07178;--shiki-default-text-decoration:underline;--shiki-dark:#F07178;--shiki-dark-text-decoration:underline",[1678],{"type":49,"value":1679},"https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fasset-custody\u002Faddress-balances\u002F",{"type":43,"tag":143,"props":1681,"children":1682},{"style":1228},[1683],{"type":49,"value":1684},")",{"type":43,"tag":143,"props":1686,"children":1687},{"style":1251},[1688],{"type":49,"value":1689}," (SIP-58) over summing ",{"type":43,"tag":143,"props":1691,"children":1692},{"style":1228},[1693],{"type":49,"value":1325},{"type":43,"tag":143,"props":1695,"children":1696},{"style":156},[1697],{"type":49,"value":1698},"Coin",{"type":43,"tag":143,"props":1700,"children":1701},{"style":1228},[1702],{"type":49,"value":1325},{"type":43,"tag":143,"props":1704,"children":1705},{"style":1251},[1706],{"type":49,"value":1707}," objects where it fits.\n",{"type":43,"tag":143,"props":1709,"children":1711},{"class":145,"line":1710},17,[1712,1716],{"type":43,"tag":143,"props":1713,"children":1714},{"style":1228},[1715],{"type":49,"value":1306},{"type":43,"tag":143,"props":1717,"children":1718},{"style":1251},[1719],{"type":49,"value":1720}," Code style follows the OpenZeppelin Sui conventions — see Code Quality below.\n",{"type":43,"tag":143,"props":1722,"children":1724},{"class":145,"line":1723},18,[1725],{"type":43,"tag":143,"props":1726,"children":1727},{"emptyLinePlaceholder":1242},[1728],{"type":49,"value":1245},{"type":43,"tag":143,"props":1730,"children":1732},{"class":145,"line":1731},19,[1733,1737],{"type":43,"tag":143,"props":1734,"children":1735},{"style":1228},[1736],{"type":49,"value":1292},{"type":43,"tag":143,"props":1738,"children":1739},{"style":150},[1740],{"type":49,"value":1741},"Code quality\n",{"type":43,"tag":143,"props":1743,"children":1745},{"class":145,"line":1744},20,[1746],{"type":43,"tag":143,"props":1747,"children":1748},{"style":1251},[1749],{"type":49,"value":1750},"The library's conventions are the single source of truth for Move style:\n",{"type":43,"tag":143,"props":1752,"children":1754},{"class":145,"line":1753},21,[1755,1759],{"type":43,"tag":143,"props":1756,"children":1757},{"style":1228},[1758],{"type":49,"value":1306},{"type":43,"tag":143,"props":1760,"children":1761},{"style":1251},[1762],{"type":49,"value":1763}," Rules: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FSTYLEGUIDE.md\n",{"type":43,"tag":143,"props":1765,"children":1767},{"class":145,"line":1766},22,[1768,1772],{"type":43,"tag":143,"props":1769,"children":1770},{"style":1228},[1771],{"type":49,"value":1306},{"type":43,"tag":143,"props":1773,"children":1774},{"style":1251},[1775],{"type":49,"value":1776}," Design rationale: https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md\n",{"type":43,"tag":143,"props":1778,"children":1780},{"class":145,"line":1779},23,[1781,1785],{"type":43,"tag":143,"props":1782,"children":1783},{"style":1228},[1784],{"type":49,"value":1306},{"type":43,"tag":143,"props":1786,"children":1787},{"style":1251},[1788],{"type":49,"value":1789}," Review procedure (reads STYLEGUIDE.md, reports\u002Ffixes violations): https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002F.claude\u002Fcommands\u002Fcode-quality.md\n",{"type":43,"tag":143,"props":1791,"children":1793},{"class":145,"line":1792},24,[1794],{"type":43,"tag":143,"props":1795,"children":1796},{"emptyLinePlaceholder":1242},[1797],{"type":49,"value":1245},{"type":43,"tag":143,"props":1799,"children":1800},{"class":145,"line":29},[1801,1805],{"type":43,"tag":143,"props":1802,"children":1803},{"style":1228},[1804],{"type":49,"value":1292},{"type":43,"tag":143,"props":1806,"children":1807},{"style":150},[1808],{"type":49,"value":1809},"MCP\n",{"type":43,"tag":143,"props":1811,"children":1813},{"class":145,"line":1812},26,[1814,1819,1823,1827,1831,1836,1840,1844,1848,1852,1856,1860,1864,1869,1873,1877,1881,1886,1890,1895,1899,1904,1908,1912,1916],{"type":43,"tag":143,"props":1815,"children":1816},{"style":1251},[1817],{"type":49,"value":1818},"The OpenZeppelin Sui MCP (https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp) serves recipes and per-package install lines as deterministic tool calls (",{"type":43,"tag":143,"props":1820,"children":1821},{"style":1228},[1822],{"type":49,"value":1325},{"type":43,"tag":143,"props":1824,"children":1825},{"style":156},[1826],{"type":49,"value":573},{"type":43,"tag":143,"props":1828,"children":1829},{"style":1228},[1830],{"type":49,"value":1325},{"type":43,"tag":143,"props":1832,"children":1833},{"style":1251},[1834],{"type":49,"value":1835},", ",{"type":43,"tag":143,"props":1837,"children":1838},{"style":1228},[1839],{"type":49,"value":1325},{"type":43,"tag":143,"props":1841,"children":1842},{"style":156},[1843],{"type":49,"value":581},{"type":43,"tag":143,"props":1845,"children":1846},{"style":1228},[1847],{"type":49,"value":1325},{"type":43,"tag":143,"props":1849,"children":1850},{"style":1251},[1851],{"type":49,"value":1835},{"type":43,"tag":143,"props":1853,"children":1854},{"style":1228},[1855],{"type":49,"value":1325},{"type":43,"tag":143,"props":1857,"children":1858},{"style":156},[1859],{"type":49,"value":589},{"type":43,"tag":143,"props":1861,"children":1862},{"style":1228},[1863],{"type":49,"value":1325},{"type":43,"tag":143,"props":1865,"children":1866},{"style":1251},[1867],{"type":49,"value":1868},") — a queryable alternative to reading ",{"type":43,"tag":143,"props":1870,"children":1871},{"style":1228},[1872],{"type":49,"value":1325},{"type":43,"tag":143,"props":1874,"children":1875},{"style":156},[1876],{"type":49,"value":91},{"type":43,"tag":143,"props":1878,"children":1879},{"style":1228},[1880],{"type":49,"value":1325},{"type":43,"tag":143,"props":1882,"children":1883},{"style":1251},[1884],{"type":49,"value":1885}," + the catalogs by hand. This project ships it pre-wired in ",{"type":43,"tag":143,"props":1887,"children":1888},{"style":1228},[1889],{"type":49,"value":1325},{"type":43,"tag":143,"props":1891,"children":1892},{"style":156},[1893],{"type":49,"value":1894},".mcp.json",{"type":43,"tag":143,"props":1896,"children":1897},{"style":1228},[1898],{"type":49,"value":1325},{"type":43,"tag":143,"props":1900,"children":1901},{"style":1251},[1902],{"type":49,"value":1903},". It returns data, not a buildable package — wiring the install lines into ",{"type":43,"tag":143,"props":1905,"children":1906},{"style":1228},[1907],{"type":49,"value":1325},{"type":43,"tag":143,"props":1909,"children":1910},{"style":156},[1911],{"type":49,"value":224},{"type":43,"tag":143,"props":1913,"children":1914},{"style":1228},[1915],{"type":49,"value":1325},{"type":43,"tag":143,"props":1917,"children":1918},{"style":1251},[1919],{"type":49,"value":1920}," and re-homing the source into this package is what turns it into one.\n",{"type":43,"tag":59,"props":1922,"children":1923},{},[1924,1926,1931],{"type":49,"value":1925},"Also write a pre-wired MCP config at the project root so any agent understands the OpenZeppelin-on-Sui context on clone, without manual setup. Claude Code reads ",{"type":43,"tag":86,"props":1927,"children":1929},{"className":1928},[],[1930],{"type":49,"value":1894},{"type":49,"value":1932},"; other assistants (Cursor, Cline) take the same server URL in their own MCP config.",{"type":43,"tag":132,"props":1934,"children":1938},{"className":1935,"code":1936,"language":1937,"meta":137,"style":137},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"openzeppelin-sui\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp\"\n    }\n  }\n}\n","json",[1939],{"type":43,"tag":86,"props":1940,"children":1941},{"__ignoreMap":137},[1942,1950,1979,2004,2045,2079,2087,2095],{"type":43,"tag":143,"props":1943,"children":1944},{"class":145,"line":146},[1945],{"type":43,"tag":143,"props":1946,"children":1947},{"style":1228},[1948],{"type":49,"value":1949},"{\n",{"type":43,"tag":143,"props":1951,"children":1952},{"class":145,"line":202},[1953,1958,1964,1969,1974],{"type":43,"tag":143,"props":1954,"children":1955},{"style":1228},[1956],{"type":49,"value":1957},"  \"",{"type":43,"tag":143,"props":1959,"children":1961},{"style":1960},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1962],{"type":49,"value":1963},"mcpServers",{"type":43,"tag":143,"props":1965,"children":1966},{"style":1228},[1967],{"type":49,"value":1968},"\"",{"type":43,"tag":143,"props":1970,"children":1971},{"style":1228},[1972],{"type":49,"value":1973},":",{"type":43,"tag":143,"props":1975,"children":1976},{"style":1228},[1977],{"type":49,"value":1978}," {\n",{"type":43,"tag":143,"props":1980,"children":1981},{"class":145,"line":752},[1982,1987,1992,1996,2000],{"type":43,"tag":143,"props":1983,"children":1984},{"style":1228},[1985],{"type":49,"value":1986},"    \"",{"type":43,"tag":143,"props":1988,"children":1989},{"style":150},[1990],{"type":49,"value":1991},"openzeppelin-sui",{"type":43,"tag":143,"props":1993,"children":1994},{"style":1228},[1995],{"type":49,"value":1968},{"type":43,"tag":143,"props":1997,"children":1998},{"style":1228},[1999],{"type":49,"value":1973},{"type":43,"tag":143,"props":2001,"children":2002},{"style":1228},[2003],{"type":49,"value":1978},{"type":43,"tag":143,"props":2005,"children":2006},{"class":145,"line":1278},[2007,2012,2018,2022,2026,2031,2036,2040],{"type":43,"tag":143,"props":2008,"children":2009},{"style":1228},[2010],{"type":49,"value":2011},"      \"",{"type":43,"tag":143,"props":2013,"children":2015},{"style":2014},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[2016],{"type":49,"value":2017},"type",{"type":43,"tag":143,"props":2019,"children":2020},{"style":1228},[2021],{"type":49,"value":1968},{"type":43,"tag":143,"props":2023,"children":2024},{"style":1228},[2025],{"type":49,"value":1973},{"type":43,"tag":143,"props":2027,"children":2028},{"style":1228},[2029],{"type":49,"value":2030}," \"",{"type":43,"tag":143,"props":2032,"children":2033},{"style":156},[2034],{"type":49,"value":2035},"http",{"type":43,"tag":143,"props":2037,"children":2038},{"style":1228},[2039],{"type":49,"value":1968},{"type":43,"tag":143,"props":2041,"children":2042},{"style":1228},[2043],{"type":49,"value":2044},",\n",{"type":43,"tag":143,"props":2046,"children":2047},{"class":145,"line":1286},[2048,2052,2057,2061,2065,2069,2074],{"type":43,"tag":143,"props":2049,"children":2050},{"style":1228},[2051],{"type":49,"value":2011},{"type":43,"tag":143,"props":2053,"children":2054},{"style":2014},[2055],{"type":49,"value":2056},"url",{"type":43,"tag":143,"props":2058,"children":2059},{"style":1228},[2060],{"type":49,"value":1968},{"type":43,"tag":143,"props":2062,"children":2063},{"style":1228},[2064],{"type":49,"value":1973},{"type":43,"tag":143,"props":2066,"children":2067},{"style":1228},[2068],{"type":49,"value":2030},{"type":43,"tag":143,"props":2070,"children":2071},{"style":156},[2072],{"type":49,"value":2073},"https:\u002F\u002Fmcp.openzeppelin.com\u002Fcontracts\u002Fsui\u002Fmcp",{"type":43,"tag":143,"props":2075,"children":2076},{"style":1228},[2077],{"type":49,"value":2078},"\"\n",{"type":43,"tag":143,"props":2080,"children":2081},{"class":145,"line":1300},[2082],{"type":43,"tag":143,"props":2083,"children":2084},{"style":1228},[2085],{"type":49,"value":2086},"    }\n",{"type":43,"tag":143,"props":2088,"children":2089},{"class":145,"line":1314},[2090],{"type":43,"tag":143,"props":2091,"children":2092},{"style":1228},[2093],{"type":49,"value":2094},"  }\n",{"type":43,"tag":143,"props":2096,"children":2097},{"class":145,"line":1341},[2098],{"type":43,"tag":143,"props":2099,"children":2100},{"style":1228},[2101],{"type":49,"value":2102},"}\n",{"type":43,"tag":52,"props":2104,"children":2106},{"id":2105},"build-test",[2107],{"type":49,"value":2108},"Build & Test",{"type":43,"tag":59,"props":2110,"children":2111},{},[2112,2114,2120,2122,2128],{"type":49,"value":2113},"Because dependencies resolve through MVR, builds and tests must specify a build environment. Use ",{"type":43,"tag":86,"props":2115,"children":2117},{"className":2116},[],[2118],{"type":49,"value":2119},"testnet",{"type":49,"value":2121}," for development (",{"type":43,"tag":86,"props":2123,"children":2125},{"className":2124},[],[2126],{"type":49,"value":2127},"mainnet",{"type":49,"value":2129}," is also available for release builds):",{"type":43,"tag":132,"props":2131,"children":2133},{"className":134,"code":2132,"language":136,"meta":137,"style":137},"sui move build --build-env testnet\nsui move test --build-env testnet\n",[2134],{"type":43,"tag":86,"props":2135,"children":2136},{"__ignoreMap":137},[2137,2163],{"type":43,"tag":143,"props":2138,"children":2139},{"class":145,"line":146},[2140,2144,2148,2153,2158],{"type":43,"tag":143,"props":2141,"children":2142},{"style":150},[2143],{"type":49,"value":153},{"type":43,"tag":143,"props":2145,"children":2146},{"style":156},[2147],{"type":49,"value":189},{"type":43,"tag":143,"props":2149,"children":2150},{"style":156},[2151],{"type":49,"value":2152}," build",{"type":43,"tag":143,"props":2154,"children":2155},{"style":156},[2156],{"type":49,"value":2157}," --build-env",{"type":43,"tag":143,"props":2159,"children":2160},{"style":156},[2161],{"type":49,"value":2162}," testnet\n",{"type":43,"tag":143,"props":2164,"children":2165},{"class":145,"line":202},[2166,2170,2174,2179,2183],{"type":43,"tag":143,"props":2167,"children":2168},{"style":150},[2169],{"type":49,"value":153},{"type":43,"tag":143,"props":2171,"children":2172},{"style":156},[2173],{"type":49,"value":189},{"type":43,"tag":143,"props":2175,"children":2176},{"style":156},[2177],{"type":49,"value":2178}," test",{"type":43,"tag":143,"props":2180,"children":2181},{"style":156},[2182],{"type":49,"value":2157},{"type":43,"tag":143,"props":2184,"children":2185},{"style":156},[2186],{"type":49,"value":2162},{"type":43,"tag":415,"props":2188,"children":2189},{},[2190],{"type":43,"tag":59,"props":2191,"children":2192},{},[2193,2195,2200,2202,2207,2209,2215,2217,2223,2225,2231],{"type":49,"value":2194},"Without ",{"type":43,"tag":86,"props":2196,"children":2198},{"className":2197},[],[2199],{"type":49,"value":1057},{"type":49,"value":2201},", the CLI cannot resolve ",{"type":43,"tag":86,"props":2203,"children":2205},{"className":2204},[],[2206],{"type":49,"value":305},{"type":49,"value":2208}," dependencies and errors with \"Could not determine the correct dependencies to use for ",{"type":43,"tag":86,"props":2210,"children":2212},{"className":2211},[],[2213],{"type":49,"value":2214},"local",{"type":49,"value":2216},"\". A green ",{"type":43,"tag":86,"props":2218,"children":2220},{"className":2219},[],[2221],{"type":49,"value":2222},"build",{"type":49,"value":2224}," + ",{"type":43,"tag":86,"props":2226,"children":2228},{"className":2227},[],[2229],{"type":49,"value":2230},"test",{"type":49,"value":2232}," on a freshly scaffolded project is the acceptance bar.",{"type":43,"tag":59,"props":2234,"children":2235},{},[2236,2238,2244],{"type":49,"value":2237},"Add ",{"type":43,"tag":86,"props":2239,"children":2241},{"className":2240},[],[2242],{"type":49,"value":2243},"--lint --warnings-are-errors",{"type":49,"value":2245}," once the project has real code to catch style and dead-code issues early:",{"type":43,"tag":132,"props":2247,"children":2249},{"className":134,"code":2248,"language":136,"meta":137,"style":137},"sui move test --build-env testnet --lint --warnings-are-errors\n",[2250],{"type":43,"tag":86,"props":2251,"children":2252},{"__ignoreMap":137},[2253],{"type":43,"tag":143,"props":2254,"children":2255},{"class":145,"line":146},[2256,2260,2264,2268,2272,2277,2282],{"type":43,"tag":143,"props":2257,"children":2258},{"style":150},[2259],{"type":49,"value":153},{"type":43,"tag":143,"props":2261,"children":2262},{"style":156},[2263],{"type":49,"value":189},{"type":43,"tag":143,"props":2265,"children":2266},{"style":156},[2267],{"type":49,"value":2178},{"type":43,"tag":143,"props":2269,"children":2270},{"style":156},[2271],{"type":49,"value":2157},{"type":43,"tag":143,"props":2273,"children":2274},{"style":156},[2275],{"type":49,"value":2276}," testnet",{"type":43,"tag":143,"props":2278,"children":2279},{"style":156},[2280],{"type":49,"value":2281}," --lint",{"type":43,"tag":143,"props":2283,"children":2284},{"style":156},[2285],{"type":49,"value":2286}," --warnings-are-errors\n",{"type":43,"tag":600,"props":2288,"children":2290},{"id":2289},"testing-patterns-to-know",[2291],{"type":49,"value":2292},"Testing patterns to know",{"type":43,"tag":59,"props":2294,"children":2295},{},[2296,2298,2303],{"type":49,"value":2297},"A couple of Sui conventions recur when testing code built on these packages — the library's own ",{"type":43,"tag":86,"props":2299,"children":2301},{"className":2300},[],[2302],{"type":49,"value":550},{"type":49,"value":2304}," tests are the canonical reference:",{"type":43,"tag":2306,"props":2307,"children":2308},"ul",{},[2309,2373,2413],{"type":43,"tag":350,"props":2310,"children":2311},{},[2312,2317,2319,2324,2326,2332,2334,2339,2341,2346,2348],{"type":43,"tag":278,"props":2313,"children":2314},{},[2315],{"type":49,"value":2316},"One-Time Witness (OTW) in tests.",{"type":49,"value":2318}," Modules that take an OTW consume it in ",{"type":43,"tag":86,"props":2320,"children":2322},{"className":2321},[],[2323],{"type":49,"value":973},{"type":49,"value":2325},", and it can't be constructed at runtime. To exercise such a module in a unit test, expose a ",{"type":43,"tag":86,"props":2327,"children":2329},{"className":2328},[],[2330],{"type":49,"value":2331},"#[test_only]",{"type":49,"value":2333}," initializer that builds the OTW (its struct ",{"type":43,"tag":538,"props":2335,"children":2336},{},[2337],{"type":49,"value":2338},"is",{"type":49,"value":2340}," constructible inside a ",{"type":43,"tag":86,"props":2342,"children":2344},{"className":2343},[],[2345],{"type":49,"value":2331},{"type":49,"value":2347}," context):",{"type":43,"tag":132,"props":2349,"children":2353},{"className":2350,"code":2351,"language":2352,"meta":137,"style":137},"language-move shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","#[test_only]\npublic fun init_for_testing(ctx: &mut TxContext) { init(MY_OTW {}, ctx) }\n","move",[2354],{"type":43,"tag":86,"props":2355,"children":2356},{"__ignoreMap":137},[2357,2365],{"type":43,"tag":143,"props":2358,"children":2359},{"class":145,"line":146},[2360],{"type":43,"tag":143,"props":2361,"children":2362},{},[2363],{"type":49,"value":2364},"#[test_only]\n",{"type":43,"tag":143,"props":2366,"children":2367},{"class":145,"line":202},[2368],{"type":43,"tag":143,"props":2369,"children":2370},{},[2371],{"type":49,"value":2372},"public fun init_for_testing(ctx: &mut TxContext) { init(MY_OTW {}, ctx) }\n",{"type":43,"tag":350,"props":2374,"children":2375},{},[2376,2381,2383,2389,2391,2397,2398,2404,2406,2412],{"type":43,"tag":278,"props":2377,"children":2378},{},[2379],{"type":49,"value":2380},"Clock.",{"type":49,"value":2382}," Modules that depend on time take a ",{"type":43,"tag":86,"props":2384,"children":2386},{"className":2385},[],[2387],{"type":49,"value":2388},"sui::clock::Clock",{"type":49,"value":2390},". In tests use ",{"type":43,"tag":86,"props":2392,"children":2394},{"className":2393},[],[2395],{"type":49,"value":2396},"create_for_testing",{"type":49,"value":1835},{"type":43,"tag":86,"props":2399,"children":2401},{"className":2400},[],[2402],{"type":49,"value":2403},"increment_for_testing",{"type":49,"value":2405},", and ",{"type":43,"tag":86,"props":2407,"children":2409},{"className":2408},[],[2410],{"type":49,"value":2411},"destroy_for_testing",{"type":49,"value":365},{"type":43,"tag":350,"props":2414,"children":2415},{},[2416,2421,2423,2429,2431,2437,2439,2445,2447,2453,2455,2461,2463,2469],{"type":43,"tag":278,"props":2417,"children":2418},{},[2419],{"type":49,"value":2420},"Assertions.",{"type":49,"value":2422}," Under ",{"type":43,"tag":86,"props":2424,"children":2426},{"className":2425},[],[2427],{"type":49,"value":2428},"--warnings-are-errors",{"type":49,"value":2430},", a literal abort code (",{"type":43,"tag":86,"props":2432,"children":2434},{"className":2433},[],[2435],{"type":49,"value":2436},"assert!(cond, 0)",{"type":49,"value":2438},") trips the ",{"type":43,"tag":86,"props":2440,"children":2442},{"className":2441},[],[2443],{"type":49,"value":2444},"abort_without_constant",{"type":49,"value":2446}," lint. In tests, use ",{"type":43,"tag":86,"props":2448,"children":2450},{"className":2449},[],[2451],{"type":49,"value":2452},"assert_eq!",{"type":49,"value":2454}," (from ",{"type":43,"tag":86,"props":2456,"children":2458},{"className":2457},[],[2459],{"type":49,"value":2460},"std::unit_test",{"type":49,"value":2462},") or a bare ",{"type":43,"tag":86,"props":2464,"children":2466},{"className":2465},[],[2467],{"type":49,"value":2468},"assert!(cond)",{"type":49,"value":2470},"; in non-test code, assert against a named error constant rather than a literal.",{"type":43,"tag":415,"props":2472,"children":2473},{},[2474],{"type":43,"tag":59,"props":2475,"children":2476},{},[2477,2482,2484,2489,2491,2497,2499,2504,2506,2511,2513,2518,2520,2525,2527,2532],{"type":43,"tag":278,"props":2478,"children":2479},{},[2480],{"type":49,"value":2481},"Composition constraint:",{"type":49,"value":2483}," a Sui ",{"type":43,"tag":86,"props":2485,"children":2487},{"className":2486},[],[2488],{"type":49,"value":973},{"type":49,"value":2490}," function receives no ",{"type":43,"tag":86,"props":2492,"children":2494},{"className":2493},[],[2495],{"type":49,"value":2496},"Clock",{"type":49,"value":2498}," (nor other runtime arguments). A component whose constructor needs a ",{"type":43,"tag":86,"props":2500,"children":2502},{"className":2501},[],[2503],{"type":49,"value":2496},{"type":49,"value":2505}," therefore can't be fully built in ",{"type":43,"tag":86,"props":2507,"children":2509},{"className":2508},[],[2510],{"type":49,"value":973},{"type":49,"value":2512}," — create\u002Fshare the object in ",{"type":43,"tag":86,"props":2514,"children":2516},{"className":2515},[],[2517],{"type":49,"value":973},{"type":49,"value":2519},", then complete setup in a later entry function that takes the ",{"type":43,"tag":86,"props":2521,"children":2523},{"className":2522},[],[2524],{"type":49,"value":2496},{"type":49,"value":2526},". The package's ",{"type":43,"tag":86,"props":2528,"children":2530},{"className":2529},[],[2531],{"type":49,"value":550},{"type":49,"value":2533}," show the intended two-step pattern.",{"type":43,"tag":52,"props":2535,"children":2537},{"id":2536},"code-quality",[2538],{"type":49,"value":2539},"Code Quality",{"type":43,"tag":59,"props":2541,"children":2542},{},[2543],{"type":49,"value":2544},"Align the project's Move style with OpenZeppelin's own conventions so integrator code stays consistent with the library. As with dependencies, don't restate the rules — point at the library's single sources of truth:",{"type":43,"tag":2306,"props":2546,"children":2547},{},[2548,2566,2585],{"type":43,"tag":350,"props":2549,"children":2550},{},[2551,2564],{"type":43,"tag":278,"props":2552,"children":2553},{},[2554],{"type":43,"tag":65,"props":2555,"children":2558},{"href":2556,"rel":2557},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FSTYLEGUIDE.md",[69],[2559],{"type":43,"tag":86,"props":2560,"children":2562},{"className":2561},[],[2563],{"type":49,"value":830},{"type":49,"value":2565}," — the codified rules (Naming, Module & Package, Section ordering, Imports, Structs, Functions, Idiomatic Move 2024, Collections & object size, Testing, Lint suppression, Documentation).",{"type":43,"tag":350,"props":2567,"children":2568},{},[2569,2583],{"type":43,"tag":278,"props":2570,"children":2571},{},[2572],{"type":43,"tag":65,"props":2573,"children":2576},{"href":2574,"rel":2575},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md",[69],[2577],{"type":43,"tag":86,"props":2578,"children":2580},{"className":2579},[],[2581],{"type":49,"value":2582},"ARCHITECTURE.md",{"type":49,"value":2584}," — the design rationale those rules reference (capability-based access, owned vs. shared objects, PTB composability, bounded state, upgrade safety).",{"type":43,"tag":350,"props":2586,"children":2587},{},[2588,2602,2604,2609,2611,2617],{"type":43,"tag":278,"props":2589,"children":2590},{},[2591],{"type":43,"tag":65,"props":2592,"children":2595},{"href":2593,"rel":2594},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002F.claude\u002Fcommands\u002Fcode-quality.md",[69],[2596],{"type":43,"tag":86,"props":2597,"children":2599},{"className":2598},[],[2600],{"type":49,"value":2601},".claude\u002Fcommands\u002Fcode-quality.md",{"type":49,"value":2603}," — the review procedure: it reads ",{"type":43,"tag":86,"props":2605,"children":2607},{"className":2606},[],[2608],{"type":49,"value":830},{"type":49,"value":2610}," and checks each ",{"type":43,"tag":86,"props":2612,"children":2614},{"className":2613},[],[2615],{"type":49,"value":2616},".move",{"type":49,"value":2618}," file against it, then reports or fixes violations. The procedure is plain markdown, so any agent can follow it even though the slash command is Claude-specific.",{"type":43,"tag":59,"props":2620,"children":2621},{},[2622,2624,2629,2631,2636],{"type":49,"value":2623},"Record these under a ",{"type":43,"tag":278,"props":2625,"children":2626},{},[2627],{"type":49,"value":2628},"Code quality",{"type":49,"value":2630}," heading in the generated ",{"type":43,"tag":86,"props":2632,"children":2634},{"className":2633},[],[2635],{"type":49,"value":1175},{"type":49,"value":2637}," (see above) so downstream agents follow the same conventions on clone.",{"type":43,"tag":600,"props":2639,"children":2641},{"id":2640},"formatting",[2642],{"type":49,"value":2643},"Formatting",{"type":43,"tag":59,"props":2645,"children":2646},{},[2647,2649,2660,2662,2668],{"type":49,"value":2648},"contracts-sui formats Move with the ",{"type":43,"tag":65,"props":2650,"children":2653},{"href":2651,"rel":2652},"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui\u002Fblob\u002Fmain\u002Fexternal-crates\u002Fmove\u002Ftooling\u002Fprettier-move\u002FREADME.md",[69],[2654],{"type":43,"tag":86,"props":2655,"children":2657},{"className":2656},[],[2658],{"type":49,"value":2659},"@mysten\u002Fprettier-plugin-move",{"type":49,"value":2661}," Prettier plugin — match it so integrator code lays out identically. Install it and add a ",{"type":43,"tag":86,"props":2663,"children":2665},{"className":2664},[],[2666],{"type":49,"value":2667},".prettierrc",{"type":49,"value":2669}," matching the library's:",{"type":43,"tag":132,"props":2671,"children":2673},{"className":134,"code":2672,"language":136,"meta":137,"style":137},"npm i -D prettier @mysten\u002Fprettier-plugin-move\n",[2674],{"type":43,"tag":86,"props":2675,"children":2676},{"__ignoreMap":137},[2677],{"type":43,"tag":143,"props":2678,"children":2679},{"class":145,"line":146},[2680,2685,2690,2695,2700],{"type":43,"tag":143,"props":2681,"children":2682},{"style":150},[2683],{"type":49,"value":2684},"npm",{"type":43,"tag":143,"props":2686,"children":2687},{"style":156},[2688],{"type":49,"value":2689}," i",{"type":43,"tag":143,"props":2691,"children":2692},{"style":156},[2693],{"type":49,"value":2694}," -D",{"type":43,"tag":143,"props":2696,"children":2697},{"style":156},[2698],{"type":49,"value":2699}," prettier",{"type":43,"tag":143,"props":2701,"children":2702},{"style":156},[2703],{"type":49,"value":2704}," @mysten\u002Fprettier-plugin-move\n",{"type":43,"tag":132,"props":2706,"children":2708},{"className":1935,"code":2707,"language":1937,"meta":137,"style":137},"{\n  \"tabWidth\": 4,\n  \"printWidth\": 100,\n  \"useModuleLabel\": true,\n  \"autoGroupImports\": \"module\",\n  \"plugins\": [\"@mysten\u002Fprettier-plugin-move\"]\n}\n",[2709],{"type":43,"tag":86,"props":2710,"children":2711},{"__ignoreMap":137},[2712,2719,2748,2777,2802,2839,2881],{"type":43,"tag":143,"props":2713,"children":2714},{"class":145,"line":146},[2715],{"type":43,"tag":143,"props":2716,"children":2717},{"style":1228},[2718],{"type":49,"value":1949},{"type":43,"tag":143,"props":2720,"children":2721},{"class":145,"line":202},[2722,2726,2731,2735,2739,2744],{"type":43,"tag":143,"props":2723,"children":2724},{"style":1228},[2725],{"type":49,"value":1957},{"type":43,"tag":143,"props":2727,"children":2728},{"style":1960},[2729],{"type":49,"value":2730},"tabWidth",{"type":43,"tag":143,"props":2732,"children":2733},{"style":1228},[2734],{"type":49,"value":1968},{"type":43,"tag":143,"props":2736,"children":2737},{"style":1228},[2738],{"type":49,"value":1973},{"type":43,"tag":143,"props":2740,"children":2741},{"style":2014},[2742],{"type":49,"value":2743}," 4",{"type":43,"tag":143,"props":2745,"children":2746},{"style":1228},[2747],{"type":49,"value":2044},{"type":43,"tag":143,"props":2749,"children":2750},{"class":145,"line":752},[2751,2755,2760,2764,2768,2773],{"type":43,"tag":143,"props":2752,"children":2753},{"style":1228},[2754],{"type":49,"value":1957},{"type":43,"tag":143,"props":2756,"children":2757},{"style":1960},[2758],{"type":49,"value":2759},"printWidth",{"type":43,"tag":143,"props":2761,"children":2762},{"style":1228},[2763],{"type":49,"value":1968},{"type":43,"tag":143,"props":2765,"children":2766},{"style":1228},[2767],{"type":49,"value":1973},{"type":43,"tag":143,"props":2769,"children":2770},{"style":2014},[2771],{"type":49,"value":2772}," 100",{"type":43,"tag":143,"props":2774,"children":2775},{"style":1228},[2776],{"type":49,"value":2044},{"type":43,"tag":143,"props":2778,"children":2779},{"class":145,"line":1278},[2780,2784,2789,2793,2797],{"type":43,"tag":143,"props":2781,"children":2782},{"style":1228},[2783],{"type":49,"value":1957},{"type":43,"tag":143,"props":2785,"children":2786},{"style":1960},[2787],{"type":49,"value":2788},"useModuleLabel",{"type":43,"tag":143,"props":2790,"children":2791},{"style":1228},[2792],{"type":49,"value":1968},{"type":43,"tag":143,"props":2794,"children":2795},{"style":1228},[2796],{"type":49,"value":1973},{"type":43,"tag":143,"props":2798,"children":2799},{"style":1228},[2800],{"type":49,"value":2801}," true,\n",{"type":43,"tag":143,"props":2803,"children":2804},{"class":145,"line":1286},[2805,2809,2814,2818,2822,2826,2831,2835],{"type":43,"tag":143,"props":2806,"children":2807},{"style":1228},[2808],{"type":49,"value":1957},{"type":43,"tag":143,"props":2810,"children":2811},{"style":1960},[2812],{"type":49,"value":2813},"autoGroupImports",{"type":43,"tag":143,"props":2815,"children":2816},{"style":1228},[2817],{"type":49,"value":1968},{"type":43,"tag":143,"props":2819,"children":2820},{"style":1228},[2821],{"type":49,"value":1973},{"type":43,"tag":143,"props":2823,"children":2824},{"style":1228},[2825],{"type":49,"value":2030},{"type":43,"tag":143,"props":2827,"children":2828},{"style":156},[2829],{"type":49,"value":2830},"module",{"type":43,"tag":143,"props":2832,"children":2833},{"style":1228},[2834],{"type":49,"value":1968},{"type":43,"tag":143,"props":2836,"children":2837},{"style":1228},[2838],{"type":49,"value":2044},{"type":43,"tag":143,"props":2840,"children":2841},{"class":145,"line":1300},[2842,2846,2851,2855,2859,2864,2868,2872,2876],{"type":43,"tag":143,"props":2843,"children":2844},{"style":1228},[2845],{"type":49,"value":1957},{"type":43,"tag":143,"props":2847,"children":2848},{"style":1960},[2849],{"type":49,"value":2850},"plugins",{"type":43,"tag":143,"props":2852,"children":2853},{"style":1228},[2854],{"type":49,"value":1968},{"type":43,"tag":143,"props":2856,"children":2857},{"style":1228},[2858],{"type":49,"value":1973},{"type":43,"tag":143,"props":2860,"children":2861},{"style":1228},[2862],{"type":49,"value":2863}," [",{"type":43,"tag":143,"props":2865,"children":2866},{"style":1228},[2867],{"type":49,"value":1968},{"type":43,"tag":143,"props":2869,"children":2870},{"style":156},[2871],{"type":49,"value":2659},{"type":43,"tag":143,"props":2873,"children":2874},{"style":1228},[2875],{"type":49,"value":1968},{"type":43,"tag":143,"props":2877,"children":2878},{"style":1228},[2879],{"type":49,"value":2880},"]\n",{"type":43,"tag":143,"props":2882,"children":2883},{"class":145,"line":1314},[2884],{"type":43,"tag":143,"props":2885,"children":2886},{"style":1228},[2887],{"type":49,"value":2102},{"type":43,"tag":59,"props":2889,"children":2890},{},[2891,2893,2898,2900,2906],{"type":49,"value":2892},"Then format from the repo root (Prettier silently skips ",{"type":43,"tag":86,"props":2894,"children":2896},{"className":2895},[],[2897],{"type":49,"value":2616},{"type":49,"value":2899}," files if the plugin isn't resolvable, so keep it in ",{"type":43,"tag":86,"props":2901,"children":2903},{"className":2902},[],[2904],{"type":49,"value":2905},"devDependencies",{"type":49,"value":2907},"):",{"type":43,"tag":132,"props":2909,"children":2911},{"className":134,"code":2910,"language":136,"meta":137,"style":137},"npx prettier --write \"**\u002F*.move\"\n",[2912],{"type":43,"tag":86,"props":2913,"children":2914},{"__ignoreMap":137},[2915],{"type":43,"tag":143,"props":2916,"children":2917},{"class":145,"line":146},[2918,2923,2927,2932,2936,2941],{"type":43,"tag":143,"props":2919,"children":2920},{"style":150},[2921],{"type":49,"value":2922},"npx",{"type":43,"tag":143,"props":2924,"children":2925},{"style":156},[2926],{"type":49,"value":2699},{"type":43,"tag":143,"props":2928,"children":2929},{"style":156},[2930],{"type":49,"value":2931}," --write",{"type":43,"tag":143,"props":2933,"children":2934},{"style":1228},[2935],{"type":49,"value":2030},{"type":43,"tag":143,"props":2937,"children":2938},{"style":156},[2939],{"type":49,"value":2940},"**\u002F*.move",{"type":43,"tag":143,"props":2942,"children":2943},{"style":1228},[2944],{"type":49,"value":2078},{"type":43,"tag":415,"props":2946,"children":2947},{},[2948],{"type":43,"tag":59,"props":2949,"children":2950},{},[2951,2957,2959,2964,2966,2972,2974,2980],{"type":43,"tag":86,"props":2952,"children":2954},{"className":2953},[],[2955],{"type":49,"value":2956},"autoGroupImports: \"module\"",{"type":49,"value":2958}," normalizes ",{"type":43,"tag":86,"props":2960,"children":2962},{"className":2961},[],[2963],{"type":49,"value":505},{"type":49,"value":2965}," grouping, so run ",{"type":43,"tag":86,"props":2967,"children":2969},{"className":2968},[],[2970],{"type":49,"value":2971},"--write",{"type":49,"value":2973}," to let it format — don't hand-tune imports and expect ",{"type":43,"tag":86,"props":2975,"children":2977},{"className":2976},[],[2978],{"type":49,"value":2979},"--check",{"type":49,"value":2981}," to pass first.",{"type":43,"tag":59,"props":2983,"children":2984},{},[2985,2987,2993],{"type":49,"value":2986},"The ",{"type":43,"tag":86,"props":2988,"children":2990},{"className":2989},[],[2991],{"type":49,"value":2992},"code-quality.md",{"type":49,"value":2994}," review procedure runs this same formatting pass after applying fixes.",{"type":43,"tag":2996,"props":2997,"children":2998},"style",{},[2999],{"type":49,"value":3000},"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":3002,"total":1503},[3003,3020,3033,3047,3060,3070,3080,3087,3099,3110,3121],{"slug":3004,"name":3004,"fn":3005,"description":3006,"org":3007,"tags":3008,"stars":25,"repoUrl":26,"updatedAt":3019},"develop-secure-contracts","develop secure smart contracts with OpenZeppelin","Develop secure smart contracts using OpenZeppelin Contracts libraries. Use when users need to integrate OpenZeppelin library components — including token standards (ERC20, ERC721, ERC1155), access control (Ownable, AccessControl, AccessManager), security primitives (Pausable, ReentrancyGuard), governance (Governor, timelocks), or accounts (multisig, account abstraction) — into existing or new contracts. Covers pattern discovery from library source, CLI contract generators, and library-first integration. Supports Solidity, Cairo, Stylus, Stellar, and Sui Move.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3009,3012,3015,3016],{"name":3010,"slug":3011,"type":15},"Access Control","access-control",{"name":3013,"slug":3014,"type":15},"Security","security",{"name":23,"slug":24,"type":15},{"name":3017,"slug":3018,"type":15},"Solidity","solidity","2026-07-13T06:04:32.666273",{"slug":3021,"name":3021,"fn":3022,"description":3023,"org":3024,"tags":3025,"stars":25,"repoUrl":26,"updatedAt":3032},"review-sui-contracts","review Sui Move smart contracts","Review Sui Move code that integrates OpenZeppelin Contracts for Sui against the library's own patterns and conventions. Use this when a developer wants their integration checked before shipping. Triggers: \"review my Sui Move code\", \"am I using OpenZeppelin correctly\", \"check this integration\", \"is this idiomatic\", \"review before audit\". Checks correct use of OZ primitives, deviations from examples\u002Fdoc-comments, upheld invariants, test coverage, and code-quality\u002Fstyle. This is an AI code review, not a formal security audit.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3026,3027,3030,3031],{"name":13,"slug":14,"type":15},{"name":3028,"slug":3029,"type":15},"Code Review","code-review",{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},"2026-07-16T06:00:49.17387",{"slug":3034,"name":3034,"fn":3035,"description":3036,"org":3037,"tags":3038,"stars":25,"repoUrl":26,"updatedAt":3046},"setup-cairo-contracts","set up Cairo smart contract projects","Set up a Cairo smart contract project with OpenZeppelin Contracts for Cairo on Starknet. Use when users need to: (1) create a new Scarb\u002FStarknet project, (2) add OpenZeppelin Contracts for Cairo dependencies to Scarb.toml, (3) configure individual or umbrella OpenZeppelin packages, or (4) understand Cairo import conventions and component patterns for OpenZeppelin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3039,3042,3043],{"name":3040,"slug":3041,"type":15},"Engineering","engineering",{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},"Web3","web3","2026-07-13T06:04:17.186825",{"slug":3048,"name":3048,"fn":3049,"description":3050,"org":3051,"tags":3052,"stars":25,"repoUrl":26,"updatedAt":3059},"setup-solidity-contracts","set up Solidity smart contract projects","Set up a Solidity smart contract project with OpenZeppelin Contracts. Use when users need to: (1) create a new Hardhat or Foundry project, (2) install OpenZeppelin Contracts dependencies for Solidity, (3) configure remappings for Foundry, or (4) understand Solidity import conventions for OpenZeppelin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3053,3054,3057,3058],{"name":3040,"slug":3041,"type":15},{"name":3055,"slug":3056,"type":15},"Foundry","foundry",{"name":23,"slug":24,"type":15},{"name":3017,"slug":3018,"type":15},"2026-07-13T06:04:29.360325",{"slug":3061,"name":3061,"fn":3062,"description":3063,"org":3064,"tags":3065,"stars":25,"repoUrl":26,"updatedAt":3069},"setup-stellar-contracts","set up Stellar Soroban smart contract projects","Set up a Stellar\u002FSoroban smart contract project with OpenZeppelin Contracts for Stellar. Use when users need to: (1) install Stellar CLI and Rust toolchain for Soroban, (2) create a new Soroban project, (3) add OpenZeppelin Stellar dependencies to Cargo.toml, or (4) understand Soroban import conventions and contract patterns for OpenZeppelin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3066,3067,3068],{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},"2026-07-13T06:04:23.807685",{"slug":3071,"name":3071,"fn":3072,"description":3073,"org":3074,"tags":3075,"stars":25,"repoUrl":26,"updatedAt":3079},"setup-stylus-contracts","set up Stylus smart contract projects","Set up a Stylus smart contract project with OpenZeppelin Contracts for Stylus on Arbitrum. Use when users need to: (1) install Rust toolchain and WASM target for Stylus, (2) create a new Cargo Stylus project, (3) add OpenZeppelin Stylus dependencies to Cargo.toml, or (4) understand Stylus import conventions and storage patterns for OpenZeppelin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3076,3077,3078],{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},"2026-07-13T06:04:18.638516",{"slug":4,"name":4,"fn":5,"description":6,"org":3081,"tags":3082,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3083,3084,3085,3086],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"slug":3088,"name":3088,"fn":3089,"description":3090,"org":3091,"tags":3092,"stars":25,"repoUrl":26,"updatedAt":3098},"upgrade-cairo-contracts","upgrade Cairo smart contracts on Starknet","Upgrade Cairo smart contracts using OpenZeppelin's UpgradeableComponent on Starknet. Use when users need to: (1) make Cairo contracts upgradeable via replace_class_syscall, (2) integrate the OpenZeppelin UpgradeableComponent, (3) understand Starknet's class-based upgrade model vs EVM proxy patterns, (4) ensure storage compatibility across upgrades, (5) guard upgrade functions with access control, or (6) test upgrade paths for Cairo contracts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3093,3096,3097],{"name":3094,"slug":3095,"type":15},"Migration","migration",{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},"2026-07-13T06:04:25.126377",{"slug":3100,"name":3100,"fn":3101,"description":3102,"org":3103,"tags":3104,"stars":25,"repoUrl":26,"updatedAt":3109},"upgrade-solidity-contracts","upgrade Solidity smart contracts with proxies","Upgrade Solidity smart contracts using OpenZeppelin proxy patterns. Use when users need to: (1) make contracts upgradeable with UUPS, Transparent, or Beacon proxies, (2) write initializers instead of constructors, (3) use the Hardhat or Foundry upgrades plugins, (4) understand storage layout rules and ERC-7201 namespaced storage, (5) validate upgrade safety, (6) manage proxy deployments and upgrades, or (7) understand upgrade restrictions between OpenZeppelin Contracts major versions.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3105,3106,3107,3108],{"name":3094,"slug":3095,"type":15},{"name":3013,"slug":3014,"type":15},{"name":23,"slug":24,"type":15},{"name":3017,"slug":3018,"type":15},"2026-07-13T06:04:20.958319",{"slug":3111,"name":3111,"fn":3112,"description":3113,"org":3114,"tags":3115,"stars":25,"repoUrl":26,"updatedAt":3120},"upgrade-stellar-contracts","upgrade Stellar Soroban smart contracts","Upgrade Stellar\u002FSoroban smart contracts using OpenZeppelin's upgradeable module. Use when users need to: (1) make Soroban contracts upgradeable via native WASM replacement, (2) use Upgradeable or UpgradeableMigratable derive macros, (3) implement atomic upgrade-and-migrate patterns with an Upgrader contract, (4) ensure storage key compatibility across upgrades, or (5) test upgrade paths for Soroban contracts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3116,3117,3118,3119],{"name":13,"slug":14,"type":15},{"name":3094,"slug":3095,"type":15},{"name":3013,"slug":3014,"type":15},{"name":23,"slug":24,"type":15},"2026-07-13T06:04:31.398663",{"slug":3122,"name":3122,"fn":3123,"description":3124,"org":3125,"tags":3126,"stars":25,"repoUrl":26,"updatedAt":3131},"upgrade-stylus-contracts","upgrade Stylus smart contracts","Upgrade Stylus smart contracts using OpenZeppelin proxy patterns on Arbitrum. Use when users need to: (1) make Stylus Rust contracts upgradeable with UUPS or Beacon proxies, (2) understand Stylus-specific proxy mechanics (logic_flag, WASM reactivation), (3) integrate UUPSUpgradeable with access control, (4) ensure storage compatibility across upgrades, or (5) test upgrade paths for Stylus contracts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3127,3128,3129,3130],{"name":3094,"slug":3095,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},"2026-07-13T06:04:28.005287",{"items":3133,"total":1503},[3134,3141,3148,3154,3161,3167,3173],{"slug":3004,"name":3004,"fn":3005,"description":3006,"org":3135,"tags":3136,"stars":25,"repoUrl":26,"updatedAt":3019},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3137,3138,3139,3140],{"name":3010,"slug":3011,"type":15},{"name":3013,"slug":3014,"type":15},{"name":23,"slug":24,"type":15},{"name":3017,"slug":3018,"type":15},{"slug":3021,"name":3021,"fn":3022,"description":3023,"org":3142,"tags":3143,"stars":25,"repoUrl":26,"updatedAt":3032},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3144,3145,3146,3147],{"name":13,"slug":14,"type":15},{"name":3028,"slug":3029,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"slug":3034,"name":3034,"fn":3035,"description":3036,"org":3149,"tags":3150,"stars":25,"repoUrl":26,"updatedAt":3046},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3151,3152,3153],{"name":3040,"slug":3041,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},{"slug":3048,"name":3048,"fn":3049,"description":3050,"org":3155,"tags":3156,"stars":25,"repoUrl":26,"updatedAt":3059},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3157,3158,3159,3160],{"name":3040,"slug":3041,"type":15},{"name":3055,"slug":3056,"type":15},{"name":23,"slug":24,"type":15},{"name":3017,"slug":3018,"type":15},{"slug":3061,"name":3061,"fn":3062,"description":3063,"org":3162,"tags":3163,"stars":25,"repoUrl":26,"updatedAt":3069},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3164,3165,3166],{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},{"slug":3071,"name":3071,"fn":3072,"description":3073,"org":3168,"tags":3169,"stars":25,"repoUrl":26,"updatedAt":3079},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3170,3171,3172],{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"name":3044,"slug":3045,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":3174,"tags":3175,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3176,3177,3178,3179],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15}]