[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openzeppelin-develop-secure-contracts":3,"mdc--fe3fjr-key":36,"related-org-openzeppelin-develop-secure-contracts":1882,"related-repo-openzeppelin-develop-secure-contracts":2013},{"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},"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},"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},"Security","security","tag",{"name":17,"slug":18,"type":15},"Smart Contracts","smart-contracts",{"name":20,"slug":21,"type":15},"Access Control","access-control",{"name":23,"slug":24,"type":15},"Solidity","solidity",193,"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-skills","2026-07-13T06:04:32.666273","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\u002Fdevelop-secure-contracts","---\nname: develop-secure-contracts\ndescription: \"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.\"\nlicense: AGPL-3.0-only\nmetadata:\n  author: OpenZeppelin\n---\n\n# Develop Secure Smart Contracts with OpenZeppelin\n\n## Core Workflow\n\n### Understand the Request Before Responding\n\nFor conceptual questions (\"How does Ownable work?\"), explain without generating code. For implementation requests, proceed with the workflow below.\n\n### CRITICAL: Always Read the Project First\n\nBefore generating code or suggesting changes:\n\n1. **Search the user's project** for existing contracts (`Glob` for `**\u002F*.sol`, `**\u002F*.cairo`, `**\u002F*.rs`, `**\u002F*.move`, etc.)\n2. **Read the relevant contract files** to understand what already exists\n3. **Default to integration, not replacement** — when users say \"add pausability\" or \"make it upgradeable\", they mean modify their existing code, not generate something new. Only replace if explicitly requested (\"start fresh\", \"replace this\").\n\nIf a file cannot be read, surface the failure explicitly — report the path attempted and the reason. Ask whether the path is correct. Never silently fall back to a generic response as if the file does not exist.\n\n### Fundamental Rule: Prefer Library Components Over Custom Code\n\nBefore writing ANY logic, search the OpenZeppelin library for an existing component:\n\n1. **Exact match exists?** Import and use it directly — inherit, implement its trait, compose with it. Done.\n2. **Close match exists?** Import and extend it — override only functions the library marks as overridable (virtual, hooks, configurable parameters).\n3. **No match exists?** Only then write custom logic. Confirm by browsing the library's directory structure first.\n\n**NEVER copy or embed library source code into the user's contract.** Always import from the dependency so the project receives security updates. Never hand-write what the library already provides:\n- Never write a custom `paused` modifier when `Pausable` or `ERC20Pausable` exists\n- Never write `require(msg.sender == owner)` when `Ownable` exists\n- Never implement ERC165 logic when the library's base contracts already handle it\n\n### Methodology\n\nThe primary workflow is **pattern discovery from library source code**:\n\n1. Inspect what the user's project already imports\n2. Read the dependency source and docs in the project's installed packages\n3. Identify what functions, modifiers, hooks, and storage the dependency requires\n4. Apply those requirements to the user's contract\n\nSee [Pattern Discovery and Integration](#pattern-discovery-and-integration) below for the full step-by-step procedure.\n\n### CLI Generators as Reference\n\nUse `npx @openzeppelin\u002Fcontracts-cli` to generate reference implementations for pattern discovery:\ngenerate a baseline to a file, generate with a feature enabled to another file, diff them, and apply the changes to the user's code. The CLI output is the canonical correct integration — use it as the source of truth for what imports, inheritance, storage, and overrides a feature requires.\n\nSee [CLI Generators](#cli-generators) for details on the generate-compare-apply workflow.\n\nIf no CLI command exists for what's needed, use the generic pattern discovery methodology from [Pattern Discovery and Integration](#pattern-discovery-and-integration). The absence of a CLI command does not mean the library lacks support — it only means there is no generator.\n\n## Pattern Discovery and Integration\n\nProcedural guide for discovering and applying OpenZeppelin contract integration patterns\nby reading dependency source code. Works for any ecosystem and any library version.\n\n**Prerequisite:** Always follow the library-first decision tree above\n(prefer library components over custom code, never copy\u002Fembed source).\n\n### Step 1: Identify Dependencies and Search the Library\n\n1. Search the project for contract files: `Glob` for `**\u002F*.sol`, `**\u002F*.cairo`, `**\u002F*.rs`,\n   `**\u002F*.move`, or the relevant extension from the lookup table below.\n2. Read import\u002Fuse statements in existing contracts to identify which OpenZeppelin components\n   are already in use.\n3. Locate the installed dependency in the project's dependency tree:\n   - Solidity: `node_modules\u002F@openzeppelin\u002Fcontracts\u002F` (Hardhat\u002Fnpm) or\n     `lib\u002Fopenzeppelin-contracts\u002F` (Foundry\u002Fforge)\n   - Cairo: resolve from `Scarb.toml` dependencies — source cached by Scarb\n   - Stylus: resolve from `Cargo.toml` — source in `target\u002F` or the cargo registry cache\n     (`~\u002F.cargo\u002Fregistry\u002Fsrc\u002F`)\n   - Stellar: resolve from `Cargo.toml` — same cargo cache locations as Stylus\n   - Sui Move: resolve from `Move.toml` — after a build, the MVR source is cached under `~\u002F.move\u002F`\n     and mirrored per-dependency in `build\u002F\u003Cproject_package>\u002Fsources\u002Fdependencies\u002F\u003Cmove_package_name>\u002F`\n4. Browse the dependency's directory listing to discover available components. Use `Glob`\n   patterns against the installed source (e.g., `node_modules\u002F@openzeppelin\u002Fcontracts\u002F**\u002F*.sol`).\n   Do not assume knowledge of the library's contents — always verify by listing directories.\n5. If the dependency is not installed locally, clone or browse the canonical repository\n   (see lookup table below).\n\n### Step 2: Read the Dependency Source and Documentation\n\n1. Read the source file of the component relevant to the user's request.\n2. Look for documentation within the source: NatSpec comments (`\u002F\u002F\u002F`, `\u002F** *\u002F`) in Solidity,\n   doc comments (`\u002F\u002F\u002F`) in Rust and Cairo, and README files in the component's directory.\n3. Determine the integration strategy using the decision tree from the Critical Principle:\n   - If the component satisfies the need directly → import and use as-is.\n   - If customization is needed → identify extension points the library provides (virtual\n     functions, hook functions, configurable constructor parameters). Import and extend.\n   - Only if no component covers the need → write custom logic.\n4. Identify the **public API**: functions\u002Fmethods exposed, events emitted, errors defined.\n5. Identify **integration requirements** — this is the critical step:\n   - Functions the integrator MUST implement (abstract functions, trait methods, hooks)\n   - Modifiers, decorators, or guards that must be applied to the integrator's functions\n   - Constructor or initializer parameters that must be passed\n   - Storage variables or state that must be declared\n   - Inheritance or trait implementations required (always via import, never via copy)\n6. Search for example contracts or tests in the same repository that demonstrate correct\n   usage. Look in `test\u002F`, `tests\u002F`, `examples\u002F`, or `mocks\u002F` directories.\n\n### Step 3: Extract the Minimal Integration Pattern\n\nFrom Step 2, construct the minimal set of changes needed:\n\n- **Imports \u002F use statements** to add\n- **Inheritance \u002F trait implementations** to add (always via import from the dependency)\n- **Storage** to declare\n- **Constructor \u002F initializer** changes (new parameters, initialization calls)\n- **New functions** to add (required overrides, hooks, public API)\n- **Existing functions to modify** (add modifiers, call hooks, emit events)\n\nIf the contract is upgradeable, any of the above may affect storage compatibility. Consult the relevant upgrade skill before applying.\n\nDo not include anything beyond what the dependency requires. This is the minimal diff\nbetween \"contract without the feature\" and \"contract with the feature.\"\n\n### Step 4: Apply Patterns to the User's Contract\n\n1. Read the user's existing contract file.\n2. Apply the changes from Step 3 using the `Edit` tool. Do not replace the entire file —\n   integrate into existing code.\n3. Check for conflicts: duplicate access control systems, conflicting function overrides,\n   incompatible inheritance. Resolve before finishing.\n4. Do not ask the user to make changes themselves — apply directly.\n\n### Repository and Documentation Lookup Table\n\n| Ecosystem | Repository | Documentation | File Extension | Dependency Location |\n|-----------|-----------|---------------|----------------|-------------------|\n| Solidity | [openzeppelin-contracts](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-contracts) | [docs.openzeppelin.com\u002Fcontracts](https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts) | `.sol` | `node_modules\u002F@openzeppelin\u002Fcontracts\u002F` or `lib\u002Fopenzeppelin-contracts\u002F` |\n| Cairo | [cairo-contracts](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcairo-contracts) | [docs.openzeppelin.com\u002Fcontracts-cairo](https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-cairo) | `.cairo` | Scarb cache (resolve from `Scarb.toml`) |\n| Stylus | [rust-contracts-stylus](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Frust-contracts-stylus) | [docs.openzeppelin.com\u002Fcontracts-stylus](https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-stylus) | `.rs` | Cargo cache (`~\u002F.cargo\u002Fregistry\u002Fsrc\u002F`) |\n| Stellar | [stellar-contracts](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts) ([Architecture](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts\u002Fblob\u002Fmain\u002FArchitecture.md)) | [docs.openzeppelin.com\u002Fstellar-contracts](https:\u002F\u002Fdocs.openzeppelin.com\u002Fstellar-contracts) | `.rs` | Cargo cache (`~\u002F.cargo\u002Fregistry\u002Fsrc\u002F`) |\n| Sui Move | [contracts-sui](https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui) ([llms.txt](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt) · [ARCHITECTURE](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md)) | [docs.openzeppelin.com\u002Fcontracts-sui](https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui) | `.move` | Move Registry cache (`~\u002F.move\u002F`, resolve from `Move.toml`) |\n\n### Directory Structure Conventions\n\nWhere to find components within each repository:\n\n| Category | Solidity | Cairo | Stylus | Stellar |\n|----------|---------|-------|--------|---------|\n| Tokens | `contracts\u002Ftoken\u002F{ERC20,ERC721,ERC1155}\u002F` | `packages\u002Ftoken\u002F` | `contracts\u002Fsrc\u002Ftoken\u002F` | `packages\u002Ftokens\u002F` |\n| Access control | `contracts\u002Faccess\u002F` | `packages\u002Faccess\u002F` | `contracts\u002Fsrc\u002Faccess\u002F` | `packages\u002Faccess\u002F` |\n| Governance | `contracts\u002Fgovernance\u002F` | `packages\u002Fgovernance\u002F` | — | `packages\u002Fgovernance\u002F` |\n| Proxies \u002F Upgrades | `contracts\u002Fproxy\u002F` | `packages\u002Fupgrades\u002F` | `contracts\u002Fsrc\u002Fproxy\u002F` | `packages\u002Fcontract-utils\u002F` |\n| Utilities \u002F Security | `contracts\u002Futils\u002F` | `packages\u002Futils\u002F`, `packages\u002Fsecurity\u002F` | `contracts\u002Fsrc\u002Futils\u002F` | `packages\u002Fcontract-utils\u002F` |\n| Accounts | `contracts\u002Faccount\u002F` | `packages\u002Faccount\u002F` | — | `packages\u002Faccounts\u002F` |\n\nBrowse these paths first when searching for a component.\n\n**Sui Move** isn't in this fixed grid and has no `@openzeppelin\u002Fcontracts-cli` generator, so always use the pattern-discovery methodology above — adapt a package's `examples\u002F` as the canonical integration recipe and import via MVR rather than copying source. Discover everything else (the package set, composition and style conventions, exact APIs, and the toolchain) from the library's own metadata, starting at [`llms.txt`](https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt); the `setup-sui-contracts` skill covers the full setup, dependency, `--build-env` build, and quality-gate flow.\n\n### Known Version-Specific Considerations\n\nDo not assume override points from prior knowledge — always verify by reading the installed source. Functions that were `virtual` in an older version may no longer be in the current one, making them non-overridable. The source NatSpec will indicate the correct override point (e.g., `NOTE: This function is not virtual, {X} should be overridden instead`).\n\nA known example: the Solidity ERC-20 transfer hook changed between v4 and v5. Read the installed `ERC20.sol` to confirm which function is `virtual` before recommending an override.\n\n## CLI Generators\n\nThe `@openzeppelin\u002Fcontracts-cli` package generates reference OpenZeppelin contract implementations from the command line. Use it as the reference source in the generate-compare-apply workflow whenever a command exists for the contract type.\n\n### Discovering Commands and Options\n\nRun `npx @openzeppelin\u002Fcontracts-cli --help` to list available commands. Each command corresponds to a contract type (e.g., `solidity-erc20`, `cairo-erc721`, `stellar-fungible`). Run `npx @openzeppelin\u002Fcontracts-cli \u003Ccommand> --help` to see the available options. Do not rely on prior knowledge of what options exist; check `--help` at the start of a conversation since the CLI may have been updated.\n\n### Generate-Compare-Apply Shortcut\n\nWhen a CLI command exists for the contract type, pipe generated output to temporary files and diff them to keep generated contract code out of the conversation context:\n\n1. **Generate baseline** — run with only required options, all features disabled, pipe to a file:\n   ```bash\n   npx @openzeppelin\u002Fcontracts-cli solidity-erc20 --name MyToken --symbol MTK > \u002Ftmp\u002Foz-baseline.sol\n   ```\n2. **Generate with feature** — run again with the feature enabled, pipe to a second file:\n   ```bash\n   npx @openzeppelin\u002Fcontracts-cli solidity-erc20 --name MyToken --symbol MTK --pausable > \u002Ftmp\u002Foz-variant.sol\n   ```\n3. **Compare** — diff the two files to identify exactly what changed (imports, inheritance, state, constructor, functions, modifiers):\n   ```bash\n   diff \u002Ftmp\u002Foz-baseline.sol \u002Ftmp\u002Foz-variant.sol\n   ```\n4. **Apply** — edit the user's existing contract to add the discovered changes\n\nFor interacting features (e.g., access control + upgradeability), generate a combined variant as well.\n\n### When No CLI Command Exists or a Feature Is Not Covered\n\nThe absence of a CLI command does NOT mean the library lacks support. It only means there is no generator for that contract type. Always fall back to the generic pattern discovery methodology in [Pattern Discovery and Integration](#pattern-discovery-and-integration).\n\nSimilarly, when a CLI command exists but does not expose an option for a specific feature, do not stop there. Fall back to pattern discovery for that feature: read the installed library source to find the relevant component, extract the integration requirements, and apply them to the user's contract.\n",{"data":37,"body":39},{"name":4,"description":6,"license":28,"metadata":38},{"author":9},{"type":40,"children":41},"root",[42,51,58,65,71,77,82,157,162,168,173,206,216,274,280,292,315,329,335,348,360,371,376,381,391,397,577,583,728,734,739,802,807,812,818,849,855,1174,1180,1185,1477,1482,1533,1539,1560,1580,1585,1597,1603,1654,1660,1665,1849,1854,1860,1871,1876],{"type":43,"tag":44,"props":45,"children":47},"element","h1",{"id":46},"develop-secure-smart-contracts-with-openzeppelin",[48],{"type":49,"value":50},"text","Develop Secure Smart Contracts with OpenZeppelin",{"type":43,"tag":52,"props":53,"children":55},"h2",{"id":54},"core-workflow",[56],{"type":49,"value":57},"Core Workflow",{"type":43,"tag":59,"props":60,"children":62},"h3",{"id":61},"understand-the-request-before-responding",[63],{"type":49,"value":64},"Understand the Request Before Responding",{"type":43,"tag":66,"props":67,"children":68},"p",{},[69],{"type":49,"value":70},"For conceptual questions (\"How does Ownable work?\"), explain without generating code. For implementation requests, proceed with the workflow below.",{"type":43,"tag":59,"props":72,"children":74},{"id":73},"critical-always-read-the-project-first",[75],{"type":49,"value":76},"CRITICAL: Always Read the Project First",{"type":43,"tag":66,"props":78,"children":79},{},[80],{"type":49,"value":81},"Before generating code or suggesting changes:",{"type":43,"tag":83,"props":84,"children":85},"ol",{},[86,137,147],{"type":43,"tag":87,"props":88,"children":89},"li",{},[90,96,98,105,107,113,115,121,122,128,129,135],{"type":43,"tag":91,"props":92,"children":93},"strong",{},[94],{"type":49,"value":95},"Search the user's project",{"type":49,"value":97}," for existing contracts (",{"type":43,"tag":99,"props":100,"children":102},"code",{"className":101},[],[103],{"type":49,"value":104},"Glob",{"type":49,"value":106}," for ",{"type":43,"tag":99,"props":108,"children":110},{"className":109},[],[111],{"type":49,"value":112},"**\u002F*.sol",{"type":49,"value":114},", ",{"type":43,"tag":99,"props":116,"children":118},{"className":117},[],[119],{"type":49,"value":120},"**\u002F*.cairo",{"type":49,"value":114},{"type":43,"tag":99,"props":123,"children":125},{"className":124},[],[126],{"type":49,"value":127},"**\u002F*.rs",{"type":49,"value":114},{"type":43,"tag":99,"props":130,"children":132},{"className":131},[],[133],{"type":49,"value":134},"**\u002F*.move",{"type":49,"value":136},", etc.)",{"type":43,"tag":87,"props":138,"children":139},{},[140,145],{"type":43,"tag":91,"props":141,"children":142},{},[143],{"type":49,"value":144},"Read the relevant contract files",{"type":49,"value":146}," to understand what already exists",{"type":43,"tag":87,"props":148,"children":149},{},[150,155],{"type":43,"tag":91,"props":151,"children":152},{},[153],{"type":49,"value":154},"Default to integration, not replacement",{"type":49,"value":156}," — when users say \"add pausability\" or \"make it upgradeable\", they mean modify their existing code, not generate something new. Only replace if explicitly requested (\"start fresh\", \"replace this\").",{"type":43,"tag":66,"props":158,"children":159},{},[160],{"type":49,"value":161},"If a file cannot be read, surface the failure explicitly — report the path attempted and the reason. Ask whether the path is correct. Never silently fall back to a generic response as if the file does not exist.",{"type":43,"tag":59,"props":163,"children":165},{"id":164},"fundamental-rule-prefer-library-components-over-custom-code",[166],{"type":49,"value":167},"Fundamental Rule: Prefer Library Components Over Custom Code",{"type":43,"tag":66,"props":169,"children":170},{},[171],{"type":49,"value":172},"Before writing ANY logic, search the OpenZeppelin library for an existing component:",{"type":43,"tag":83,"props":174,"children":175},{},[176,186,196],{"type":43,"tag":87,"props":177,"children":178},{},[179,184],{"type":43,"tag":91,"props":180,"children":181},{},[182],{"type":49,"value":183},"Exact match exists?",{"type":49,"value":185}," Import and use it directly — inherit, implement its trait, compose with it. Done.",{"type":43,"tag":87,"props":187,"children":188},{},[189,194],{"type":43,"tag":91,"props":190,"children":191},{},[192],{"type":49,"value":193},"Close match exists?",{"type":49,"value":195}," Import and extend it — override only functions the library marks as overridable (virtual, hooks, configurable parameters).",{"type":43,"tag":87,"props":197,"children":198},{},[199,204],{"type":43,"tag":91,"props":200,"children":201},{},[202],{"type":49,"value":203},"No match exists?",{"type":49,"value":205}," Only then write custom logic. Confirm by browsing the library's directory structure first.",{"type":43,"tag":66,"props":207,"children":208},{},[209,214],{"type":43,"tag":91,"props":210,"children":211},{},[212],{"type":49,"value":213},"NEVER copy or embed library source code into the user's contract.",{"type":49,"value":215}," Always import from the dependency so the project receives security updates. Never hand-write what the library already provides:",{"type":43,"tag":217,"props":218,"children":219},"ul",{},[220,249,269],{"type":43,"tag":87,"props":221,"children":222},{},[223,225,231,233,239,241,247],{"type":49,"value":224},"Never write a custom ",{"type":43,"tag":99,"props":226,"children":228},{"className":227},[],[229],{"type":49,"value":230},"paused",{"type":49,"value":232}," modifier when ",{"type":43,"tag":99,"props":234,"children":236},{"className":235},[],[237],{"type":49,"value":238},"Pausable",{"type":49,"value":240}," or ",{"type":43,"tag":99,"props":242,"children":244},{"className":243},[],[245],{"type":49,"value":246},"ERC20Pausable",{"type":49,"value":248}," exists",{"type":43,"tag":87,"props":250,"children":251},{},[252,254,260,262,268],{"type":49,"value":253},"Never write ",{"type":43,"tag":99,"props":255,"children":257},{"className":256},[],[258],{"type":49,"value":259},"require(msg.sender == owner)",{"type":49,"value":261}," when ",{"type":43,"tag":99,"props":263,"children":265},{"className":264},[],[266],{"type":49,"value":267},"Ownable",{"type":49,"value":248},{"type":43,"tag":87,"props":270,"children":271},{},[272],{"type":49,"value":273},"Never implement ERC165 logic when the library's base contracts already handle it",{"type":43,"tag":59,"props":275,"children":277},{"id":276},"methodology",[278],{"type":49,"value":279},"Methodology",{"type":43,"tag":66,"props":281,"children":282},{},[283,285,290],{"type":49,"value":284},"The primary workflow is ",{"type":43,"tag":91,"props":286,"children":287},{},[288],{"type":49,"value":289},"pattern discovery from library source code",{"type":49,"value":291},":",{"type":43,"tag":83,"props":293,"children":294},{},[295,300,305,310],{"type":43,"tag":87,"props":296,"children":297},{},[298],{"type":49,"value":299},"Inspect what the user's project already imports",{"type":43,"tag":87,"props":301,"children":302},{},[303],{"type":49,"value":304},"Read the dependency source and docs in the project's installed packages",{"type":43,"tag":87,"props":306,"children":307},{},[308],{"type":49,"value":309},"Identify what functions, modifiers, hooks, and storage the dependency requires",{"type":43,"tag":87,"props":311,"children":312},{},[313],{"type":49,"value":314},"Apply those requirements to the user's contract",{"type":43,"tag":66,"props":316,"children":317},{},[318,320,327],{"type":49,"value":319},"See ",{"type":43,"tag":321,"props":322,"children":324},"a",{"href":323},"#pattern-discovery-and-integration",[325],{"type":49,"value":326},"Pattern Discovery and Integration",{"type":49,"value":328}," below for the full step-by-step procedure.",{"type":43,"tag":59,"props":330,"children":332},{"id":331},"cli-generators-as-reference",[333],{"type":49,"value":334},"CLI Generators as Reference",{"type":43,"tag":66,"props":336,"children":337},{},[338,340,346],{"type":49,"value":339},"Use ",{"type":43,"tag":99,"props":341,"children":343},{"className":342},[],[344],{"type":49,"value":345},"npx @openzeppelin\u002Fcontracts-cli",{"type":49,"value":347}," to generate reference implementations for pattern discovery:\ngenerate a baseline to a file, generate with a feature enabled to another file, diff them, and apply the changes to the user's code. The CLI output is the canonical correct integration — use it as the source of truth for what imports, inheritance, storage, and overrides a feature requires.",{"type":43,"tag":66,"props":349,"children":350},{},[351,352,358],{"type":49,"value":319},{"type":43,"tag":321,"props":353,"children":355},{"href":354},"#cli-generators",[356],{"type":49,"value":357},"CLI Generators",{"type":49,"value":359}," for details on the generate-compare-apply workflow.",{"type":43,"tag":66,"props":361,"children":362},{},[363,365,369],{"type":49,"value":364},"If no CLI command exists for what's needed, use the generic pattern discovery methodology from ",{"type":43,"tag":321,"props":366,"children":367},{"href":323},[368],{"type":49,"value":326},{"type":49,"value":370},". The absence of a CLI command does not mean the library lacks support — it only means there is no generator.",{"type":43,"tag":52,"props":372,"children":374},{"id":373},"pattern-discovery-and-integration",[375],{"type":49,"value":326},{"type":43,"tag":66,"props":377,"children":378},{},[379],{"type":49,"value":380},"Procedural guide for discovering and applying OpenZeppelin contract integration patterns\nby reading dependency source code. Works for any ecosystem and any library version.",{"type":43,"tag":66,"props":382,"children":383},{},[384,389],{"type":43,"tag":91,"props":385,"children":386},{},[387],{"type":49,"value":388},"Prerequisite:",{"type":49,"value":390}," Always follow the library-first decision tree above\n(prefer library components over custom code, never copy\u002Fembed source).",{"type":43,"tag":59,"props":392,"children":394},{"id":393},"step-1-identify-dependencies-and-search-the-library",[395],{"type":49,"value":396},"Step 1: Identify Dependencies and Search the Library",{"type":43,"tag":83,"props":398,"children":399},{},[400,437,442,552,572],{"type":43,"tag":87,"props":401,"children":402},{},[403,405,410,411,416,417,422,423,428,430,435],{"type":49,"value":404},"Search the project for contract files: ",{"type":43,"tag":99,"props":406,"children":408},{"className":407},[],[409],{"type":49,"value":104},{"type":49,"value":106},{"type":43,"tag":99,"props":412,"children":414},{"className":413},[],[415],{"type":49,"value":112},{"type":49,"value":114},{"type":43,"tag":99,"props":418,"children":420},{"className":419},[],[421],{"type":49,"value":120},{"type":49,"value":114},{"type":43,"tag":99,"props":424,"children":426},{"className":425},[],[427],{"type":49,"value":127},{"type":49,"value":429},",\n",{"type":43,"tag":99,"props":431,"children":433},{"className":432},[],[434],{"type":49,"value":134},{"type":49,"value":436},", or the relevant extension from the lookup table below.",{"type":43,"tag":87,"props":438,"children":439},{},[440],{"type":49,"value":441},"Read import\u002Fuse statements in existing contracts to identify which OpenZeppelin components\nare already in use.",{"type":43,"tag":87,"props":443,"children":444},{},[445,447],{"type":49,"value":446},"Locate the installed dependency in the project's dependency tree:\n",{"type":43,"tag":217,"props":448,"children":449},{},[450,471,484,513,525],{"type":43,"tag":87,"props":451,"children":452},{},[453,455,461,463,469],{"type":49,"value":454},"Solidity: ",{"type":43,"tag":99,"props":456,"children":458},{"className":457},[],[459],{"type":49,"value":460},"node_modules\u002F@openzeppelin\u002Fcontracts\u002F",{"type":49,"value":462}," (Hardhat\u002Fnpm) or\n",{"type":43,"tag":99,"props":464,"children":466},{"className":465},[],[467],{"type":49,"value":468},"lib\u002Fopenzeppelin-contracts\u002F",{"type":49,"value":470}," (Foundry\u002Fforge)",{"type":43,"tag":87,"props":472,"children":473},{},[474,476,482],{"type":49,"value":475},"Cairo: resolve from ",{"type":43,"tag":99,"props":477,"children":479},{"className":478},[],[480],{"type":49,"value":481},"Scarb.toml",{"type":49,"value":483}," dependencies — source cached by Scarb",{"type":43,"tag":87,"props":485,"children":486},{},[487,489,495,497,503,505,511],{"type":49,"value":488},"Stylus: resolve from ",{"type":43,"tag":99,"props":490,"children":492},{"className":491},[],[493],{"type":49,"value":494},"Cargo.toml",{"type":49,"value":496}," — source in ",{"type":43,"tag":99,"props":498,"children":500},{"className":499},[],[501],{"type":49,"value":502},"target\u002F",{"type":49,"value":504}," or the cargo registry cache\n(",{"type":43,"tag":99,"props":506,"children":508},{"className":507},[],[509],{"type":49,"value":510},"~\u002F.cargo\u002Fregistry\u002Fsrc\u002F",{"type":49,"value":512},")",{"type":43,"tag":87,"props":514,"children":515},{},[516,518,523],{"type":49,"value":517},"Stellar: resolve from ",{"type":43,"tag":99,"props":519,"children":521},{"className":520},[],[522],{"type":49,"value":494},{"type":49,"value":524}," — same cargo cache locations as Stylus",{"type":43,"tag":87,"props":526,"children":527},{},[528,530,536,538,544,546],{"type":49,"value":529},"Sui Move: resolve from ",{"type":43,"tag":99,"props":531,"children":533},{"className":532},[],[534],{"type":49,"value":535},"Move.toml",{"type":49,"value":537}," — after a build, the MVR source is cached under ",{"type":43,"tag":99,"props":539,"children":541},{"className":540},[],[542],{"type":49,"value":543},"~\u002F.move\u002F",{"type":49,"value":545},"\nand mirrored per-dependency in ",{"type":43,"tag":99,"props":547,"children":549},{"className":548},[],[550],{"type":49,"value":551},"build\u002F\u003Cproject_package>\u002Fsources\u002Fdependencies\u002F\u003Cmove_package_name>\u002F",{"type":43,"tag":87,"props":553,"children":554},{},[555,557,562,564,570],{"type":49,"value":556},"Browse the dependency's directory listing to discover available components. Use ",{"type":43,"tag":99,"props":558,"children":560},{"className":559},[],[561],{"type":49,"value":104},{"type":49,"value":563},"\npatterns against the installed source (e.g., ",{"type":43,"tag":99,"props":565,"children":567},{"className":566},[],[568],{"type":49,"value":569},"node_modules\u002F@openzeppelin\u002Fcontracts\u002F**\u002F*.sol",{"type":49,"value":571},").\nDo not assume knowledge of the library's contents — always verify by listing directories.",{"type":43,"tag":87,"props":573,"children":574},{},[575],{"type":49,"value":576},"If the dependency is not installed locally, clone or browse the canonical repository\n(see lookup table below).",{"type":43,"tag":59,"props":578,"children":580},{"id":579},"step-2-read-the-dependency-source-and-documentation",[581],{"type":49,"value":582},"Step 2: Read the Dependency Source and Documentation",{"type":43,"tag":83,"props":584,"children":585},{},[586,591,618,641,653,693],{"type":43,"tag":87,"props":587,"children":588},{},[589],{"type":49,"value":590},"Read the source file of the component relevant to the user's request.",{"type":43,"tag":87,"props":592,"children":593},{},[594,596,602,603,609,611,616],{"type":49,"value":595},"Look for documentation within the source: NatSpec comments (",{"type":43,"tag":99,"props":597,"children":599},{"className":598},[],[600],{"type":49,"value":601},"\u002F\u002F\u002F",{"type":49,"value":114},{"type":43,"tag":99,"props":604,"children":606},{"className":605},[],[607],{"type":49,"value":608},"\u002F** *\u002F",{"type":49,"value":610},") in Solidity,\ndoc comments (",{"type":43,"tag":99,"props":612,"children":614},{"className":613},[],[615],{"type":49,"value":601},{"type":49,"value":617},") in Rust and Cairo, and README files in the component's directory.",{"type":43,"tag":87,"props":619,"children":620},{},[621,623],{"type":49,"value":622},"Determine the integration strategy using the decision tree from the Critical Principle:\n",{"type":43,"tag":217,"props":624,"children":625},{},[626,631,636],{"type":43,"tag":87,"props":627,"children":628},{},[629],{"type":49,"value":630},"If the component satisfies the need directly → import and use as-is.",{"type":43,"tag":87,"props":632,"children":633},{},[634],{"type":49,"value":635},"If customization is needed → identify extension points the library provides (virtual\nfunctions, hook functions, configurable constructor parameters). Import and extend.",{"type":43,"tag":87,"props":637,"children":638},{},[639],{"type":49,"value":640},"Only if no component covers the need → write custom logic.",{"type":43,"tag":87,"props":642,"children":643},{},[644,646,651],{"type":49,"value":645},"Identify the ",{"type":43,"tag":91,"props":647,"children":648},{},[649],{"type":49,"value":650},"public API",{"type":49,"value":652},": functions\u002Fmethods exposed, events emitted, errors defined.",{"type":43,"tag":87,"props":654,"children":655},{},[656,658,663,665],{"type":49,"value":657},"Identify ",{"type":43,"tag":91,"props":659,"children":660},{},[661],{"type":49,"value":662},"integration requirements",{"type":49,"value":664}," — this is the critical step:\n",{"type":43,"tag":217,"props":666,"children":667},{},[668,673,678,683,688],{"type":43,"tag":87,"props":669,"children":670},{},[671],{"type":49,"value":672},"Functions the integrator MUST implement (abstract functions, trait methods, hooks)",{"type":43,"tag":87,"props":674,"children":675},{},[676],{"type":49,"value":677},"Modifiers, decorators, or guards that must be applied to the integrator's functions",{"type":43,"tag":87,"props":679,"children":680},{},[681],{"type":49,"value":682},"Constructor or initializer parameters that must be passed",{"type":43,"tag":87,"props":684,"children":685},{},[686],{"type":49,"value":687},"Storage variables or state that must be declared",{"type":43,"tag":87,"props":689,"children":690},{},[691],{"type":49,"value":692},"Inheritance or trait implementations required (always via import, never via copy)",{"type":43,"tag":87,"props":694,"children":695},{},[696,698,704,705,711,712,718,720,726],{"type":49,"value":697},"Search for example contracts or tests in the same repository that demonstrate correct\nusage. Look in ",{"type":43,"tag":99,"props":699,"children":701},{"className":700},[],[702],{"type":49,"value":703},"test\u002F",{"type":49,"value":114},{"type":43,"tag":99,"props":706,"children":708},{"className":707},[],[709],{"type":49,"value":710},"tests\u002F",{"type":49,"value":114},{"type":43,"tag":99,"props":713,"children":715},{"className":714},[],[716],{"type":49,"value":717},"examples\u002F",{"type":49,"value":719},", or ",{"type":43,"tag":99,"props":721,"children":723},{"className":722},[],[724],{"type":49,"value":725},"mocks\u002F",{"type":49,"value":727}," directories.",{"type":43,"tag":59,"props":729,"children":731},{"id":730},"step-3-extract-the-minimal-integration-pattern",[732],{"type":49,"value":733},"Step 3: Extract the Minimal Integration Pattern",{"type":43,"tag":66,"props":735,"children":736},{},[737],{"type":49,"value":738},"From Step 2, construct the minimal set of changes needed:",{"type":43,"tag":217,"props":740,"children":741},{},[742,752,762,772,782,792],{"type":43,"tag":87,"props":743,"children":744},{},[745,750],{"type":43,"tag":91,"props":746,"children":747},{},[748],{"type":49,"value":749},"Imports \u002F use statements",{"type":49,"value":751}," to add",{"type":43,"tag":87,"props":753,"children":754},{},[755,760],{"type":43,"tag":91,"props":756,"children":757},{},[758],{"type":49,"value":759},"Inheritance \u002F trait implementations",{"type":49,"value":761}," to add (always via import from the dependency)",{"type":43,"tag":87,"props":763,"children":764},{},[765,770],{"type":43,"tag":91,"props":766,"children":767},{},[768],{"type":49,"value":769},"Storage",{"type":49,"value":771}," to declare",{"type":43,"tag":87,"props":773,"children":774},{},[775,780],{"type":43,"tag":91,"props":776,"children":777},{},[778],{"type":49,"value":779},"Constructor \u002F initializer",{"type":49,"value":781}," changes (new parameters, initialization calls)",{"type":43,"tag":87,"props":783,"children":784},{},[785,790],{"type":43,"tag":91,"props":786,"children":787},{},[788],{"type":49,"value":789},"New functions",{"type":49,"value":791}," to add (required overrides, hooks, public API)",{"type":43,"tag":87,"props":793,"children":794},{},[795,800],{"type":43,"tag":91,"props":796,"children":797},{},[798],{"type":49,"value":799},"Existing functions to modify",{"type":49,"value":801}," (add modifiers, call hooks, emit events)",{"type":43,"tag":66,"props":803,"children":804},{},[805],{"type":49,"value":806},"If the contract is upgradeable, any of the above may affect storage compatibility. Consult the relevant upgrade skill before applying.",{"type":43,"tag":66,"props":808,"children":809},{},[810],{"type":49,"value":811},"Do not include anything beyond what the dependency requires. This is the minimal diff\nbetween \"contract without the feature\" and \"contract with the feature.\"",{"type":43,"tag":59,"props":813,"children":815},{"id":814},"step-4-apply-patterns-to-the-users-contract",[816],{"type":49,"value":817},"Step 4: Apply Patterns to the User's Contract",{"type":43,"tag":83,"props":819,"children":820},{},[821,826,839,844],{"type":43,"tag":87,"props":822,"children":823},{},[824],{"type":49,"value":825},"Read the user's existing contract file.",{"type":43,"tag":87,"props":827,"children":828},{},[829,831,837],{"type":49,"value":830},"Apply the changes from Step 3 using the ",{"type":43,"tag":99,"props":832,"children":834},{"className":833},[],[835],{"type":49,"value":836},"Edit",{"type":49,"value":838}," tool. Do not replace the entire file —\nintegrate into existing code.",{"type":43,"tag":87,"props":840,"children":841},{},[842],{"type":49,"value":843},"Check for conflicts: duplicate access control systems, conflicting function overrides,\nincompatible inheritance. Resolve before finishing.",{"type":43,"tag":87,"props":845,"children":846},{},[847],{"type":49,"value":848},"Do not ask the user to make changes themselves — apply directly.",{"type":43,"tag":59,"props":850,"children":852},{"id":851},"repository-and-documentation-lookup-table",[853],{"type":49,"value":854},"Repository and Documentation Lookup Table",{"type":43,"tag":856,"props":857,"children":858},"table",{},[859,893],{"type":43,"tag":860,"props":861,"children":862},"thead",{},[863],{"type":43,"tag":864,"props":865,"children":866},"tr",{},[867,873,878,883,888],{"type":43,"tag":868,"props":869,"children":870},"th",{},[871],{"type":49,"value":872},"Ecosystem",{"type":43,"tag":868,"props":874,"children":875},{},[876],{"type":49,"value":877},"Repository",{"type":43,"tag":868,"props":879,"children":880},{},[881],{"type":49,"value":882},"Documentation",{"type":43,"tag":868,"props":884,"children":885},{},[886],{"type":49,"value":887},"File Extension",{"type":43,"tag":868,"props":889,"children":890},{},[891],{"type":49,"value":892},"Dependency Location",{"type":43,"tag":894,"props":895,"children":896},"tbody",{},[897,949,997,1045,1101],{"type":43,"tag":864,"props":898,"children":899},{},[900,905,916,926,935],{"type":43,"tag":901,"props":902,"children":903},"td",{},[904],{"type":49,"value":23},{"type":43,"tag":901,"props":906,"children":907},{},[908],{"type":43,"tag":321,"props":909,"children":913},{"href":910,"rel":911},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fopenzeppelin-contracts",[912],"nofollow",[914],{"type":49,"value":915},"openzeppelin-contracts",{"type":43,"tag":901,"props":917,"children":918},{},[919],{"type":43,"tag":321,"props":920,"children":923},{"href":921,"rel":922},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts",[912],[924],{"type":49,"value":925},"docs.openzeppelin.com\u002Fcontracts",{"type":43,"tag":901,"props":927,"children":928},{},[929],{"type":43,"tag":99,"props":930,"children":932},{"className":931},[],[933],{"type":49,"value":934},".sol",{"type":43,"tag":901,"props":936,"children":937},{},[938,943,944],{"type":43,"tag":99,"props":939,"children":941},{"className":940},[],[942],{"type":49,"value":460},{"type":49,"value":240},{"type":43,"tag":99,"props":945,"children":947},{"className":946},[],[948],{"type":49,"value":468},{"type":43,"tag":864,"props":950,"children":951},{},[952,957,967,977,986],{"type":43,"tag":901,"props":953,"children":954},{},[955],{"type":49,"value":956},"Cairo",{"type":43,"tag":901,"props":958,"children":959},{},[960],{"type":43,"tag":321,"props":961,"children":964},{"href":962,"rel":963},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcairo-contracts",[912],[965],{"type":49,"value":966},"cairo-contracts",{"type":43,"tag":901,"props":968,"children":969},{},[970],{"type":43,"tag":321,"props":971,"children":974},{"href":972,"rel":973},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-cairo",[912],[975],{"type":49,"value":976},"docs.openzeppelin.com\u002Fcontracts-cairo",{"type":43,"tag":901,"props":978,"children":979},{},[980],{"type":43,"tag":99,"props":981,"children":983},{"className":982},[],[984],{"type":49,"value":985},".cairo",{"type":43,"tag":901,"props":987,"children":988},{},[989,991,996],{"type":49,"value":990},"Scarb cache (resolve from ",{"type":43,"tag":99,"props":992,"children":994},{"className":993},[],[995],{"type":49,"value":481},{"type":49,"value":512},{"type":43,"tag":864,"props":998,"children":999},{},[1000,1005,1015,1025,1034],{"type":43,"tag":901,"props":1001,"children":1002},{},[1003],{"type":49,"value":1004},"Stylus",{"type":43,"tag":901,"props":1006,"children":1007},{},[1008],{"type":43,"tag":321,"props":1009,"children":1012},{"href":1010,"rel":1011},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Frust-contracts-stylus",[912],[1013],{"type":49,"value":1014},"rust-contracts-stylus",{"type":43,"tag":901,"props":1016,"children":1017},{},[1018],{"type":43,"tag":321,"props":1019,"children":1022},{"href":1020,"rel":1021},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-stylus",[912],[1023],{"type":49,"value":1024},"docs.openzeppelin.com\u002Fcontracts-stylus",{"type":43,"tag":901,"props":1026,"children":1027},{},[1028],{"type":43,"tag":99,"props":1029,"children":1031},{"className":1030},[],[1032],{"type":49,"value":1033},".rs",{"type":43,"tag":901,"props":1035,"children":1036},{},[1037,1039,1044],{"type":49,"value":1038},"Cargo cache (",{"type":43,"tag":99,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":49,"value":510},{"type":49,"value":512},{"type":43,"tag":864,"props":1046,"children":1047},{},[1048,1053,1073,1083,1091],{"type":43,"tag":901,"props":1049,"children":1050},{},[1051],{"type":49,"value":1052},"Stellar",{"type":43,"tag":901,"props":1054,"children":1055},{},[1056,1063,1065,1072],{"type":43,"tag":321,"props":1057,"children":1060},{"href":1058,"rel":1059},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts",[912],[1061],{"type":49,"value":1062},"stellar-contracts",{"type":49,"value":1064}," (",{"type":43,"tag":321,"props":1066,"children":1069},{"href":1067,"rel":1068},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fstellar-contracts\u002Fblob\u002Fmain\u002FArchitecture.md",[912],[1070],{"type":49,"value":1071},"Architecture",{"type":49,"value":512},{"type":43,"tag":901,"props":1074,"children":1075},{},[1076],{"type":43,"tag":321,"props":1077,"children":1080},{"href":1078,"rel":1079},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fstellar-contracts",[912],[1081],{"type":49,"value":1082},"docs.openzeppelin.com\u002Fstellar-contracts",{"type":43,"tag":901,"props":1084,"children":1085},{},[1086],{"type":43,"tag":99,"props":1087,"children":1089},{"className":1088},[],[1090],{"type":49,"value":1033},{"type":43,"tag":901,"props":1092,"children":1093},{},[1094,1095,1100],{"type":49,"value":1038},{"type":43,"tag":99,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":49,"value":510},{"type":49,"value":512},{"type":43,"tag":864,"props":1102,"children":1103},{},[1104,1109,1137,1147,1156],{"type":43,"tag":901,"props":1105,"children":1106},{},[1107],{"type":49,"value":1108},"Sui Move",{"type":43,"tag":901,"props":1110,"children":1111},{},[1112,1119,1120,1127,1129,1136],{"type":43,"tag":321,"props":1113,"children":1116},{"href":1114,"rel":1115},"https:\u002F\u002Fgithub.com\u002FOpenZeppelin\u002Fcontracts-sui",[912],[1117],{"type":49,"value":1118},"contracts-sui",{"type":49,"value":1064},{"type":43,"tag":321,"props":1121,"children":1124},{"href":1122,"rel":1123},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002Fllms.txt",[912],[1125],{"type":49,"value":1126},"llms.txt",{"type":49,"value":1128}," · ",{"type":43,"tag":321,"props":1130,"children":1133},{"href":1131,"rel":1132},"https:\u002F\u002Fraw.githubusercontent.com\u002FOpenZeppelin\u002Fcontracts-sui\u002Fmain\u002FARCHITECTURE.md",[912],[1134],{"type":49,"value":1135},"ARCHITECTURE",{"type":49,"value":512},{"type":43,"tag":901,"props":1138,"children":1139},{},[1140],{"type":43,"tag":321,"props":1141,"children":1144},{"href":1142,"rel":1143},"https:\u002F\u002Fdocs.openzeppelin.com\u002Fcontracts-sui",[912],[1145],{"type":49,"value":1146},"docs.openzeppelin.com\u002Fcontracts-sui",{"type":43,"tag":901,"props":1148,"children":1149},{},[1150],{"type":43,"tag":99,"props":1151,"children":1153},{"className":1152},[],[1154],{"type":49,"value":1155},".move",{"type":43,"tag":901,"props":1157,"children":1158},{},[1159,1161,1166,1168,1173],{"type":49,"value":1160},"Move Registry cache (",{"type":43,"tag":99,"props":1162,"children":1164},{"className":1163},[],[1165],{"type":49,"value":543},{"type":49,"value":1167},", resolve from ",{"type":43,"tag":99,"props":1169,"children":1171},{"className":1170},[],[1172],{"type":49,"value":535},{"type":49,"value":512},{"type":43,"tag":59,"props":1175,"children":1177},{"id":1176},"directory-structure-conventions",[1178],{"type":49,"value":1179},"Directory Structure Conventions",{"type":43,"tag":66,"props":1181,"children":1182},{},[1183],{"type":49,"value":1184},"Where to find components within each repository:",{"type":43,"tag":856,"props":1186,"children":1187},{},[1188,1215],{"type":43,"tag":860,"props":1189,"children":1190},{},[1191],{"type":43,"tag":864,"props":1192,"children":1193},{},[1194,1199,1203,1207,1211],{"type":43,"tag":868,"props":1195,"children":1196},{},[1197],{"type":49,"value":1198},"Category",{"type":43,"tag":868,"props":1200,"children":1201},{},[1202],{"type":49,"value":23},{"type":43,"tag":868,"props":1204,"children":1205},{},[1206],{"type":49,"value":956},{"type":43,"tag":868,"props":1208,"children":1209},{},[1210],{"type":49,"value":1004},{"type":43,"tag":868,"props":1212,"children":1213},{},[1214],{"type":49,"value":1052},{"type":43,"tag":894,"props":1216,"children":1217},{},[1218,1262,1305,1344,1388,1438],{"type":43,"tag":864,"props":1219,"children":1220},{},[1221,1226,1235,1244,1253],{"type":43,"tag":901,"props":1222,"children":1223},{},[1224],{"type":49,"value":1225},"Tokens",{"type":43,"tag":901,"props":1227,"children":1228},{},[1229],{"type":43,"tag":99,"props":1230,"children":1232},{"className":1231},[],[1233],{"type":49,"value":1234},"contracts\u002Ftoken\u002F{ERC20,ERC721,ERC1155}\u002F",{"type":43,"tag":901,"props":1236,"children":1237},{},[1238],{"type":43,"tag":99,"props":1239,"children":1241},{"className":1240},[],[1242],{"type":49,"value":1243},"packages\u002Ftoken\u002F",{"type":43,"tag":901,"props":1245,"children":1246},{},[1247],{"type":43,"tag":99,"props":1248,"children":1250},{"className":1249},[],[1251],{"type":49,"value":1252},"contracts\u002Fsrc\u002Ftoken\u002F",{"type":43,"tag":901,"props":1254,"children":1255},{},[1256],{"type":43,"tag":99,"props":1257,"children":1259},{"className":1258},[],[1260],{"type":49,"value":1261},"packages\u002Ftokens\u002F",{"type":43,"tag":864,"props":1263,"children":1264},{},[1265,1270,1279,1288,1297],{"type":43,"tag":901,"props":1266,"children":1267},{},[1268],{"type":49,"value":1269},"Access control",{"type":43,"tag":901,"props":1271,"children":1272},{},[1273],{"type":43,"tag":99,"props":1274,"children":1276},{"className":1275},[],[1277],{"type":49,"value":1278},"contracts\u002Faccess\u002F",{"type":43,"tag":901,"props":1280,"children":1281},{},[1282],{"type":43,"tag":99,"props":1283,"children":1285},{"className":1284},[],[1286],{"type":49,"value":1287},"packages\u002Faccess\u002F",{"type":43,"tag":901,"props":1289,"children":1290},{},[1291],{"type":43,"tag":99,"props":1292,"children":1294},{"className":1293},[],[1295],{"type":49,"value":1296},"contracts\u002Fsrc\u002Faccess\u002F",{"type":43,"tag":901,"props":1298,"children":1299},{},[1300],{"type":43,"tag":99,"props":1301,"children":1303},{"className":1302},[],[1304],{"type":49,"value":1287},{"type":43,"tag":864,"props":1306,"children":1307},{},[1308,1313,1322,1331,1336],{"type":43,"tag":901,"props":1309,"children":1310},{},[1311],{"type":49,"value":1312},"Governance",{"type":43,"tag":901,"props":1314,"children":1315},{},[1316],{"type":43,"tag":99,"props":1317,"children":1319},{"className":1318},[],[1320],{"type":49,"value":1321},"contracts\u002Fgovernance\u002F",{"type":43,"tag":901,"props":1323,"children":1324},{},[1325],{"type":43,"tag":99,"props":1326,"children":1328},{"className":1327},[],[1329],{"type":49,"value":1330},"packages\u002Fgovernance\u002F",{"type":43,"tag":901,"props":1332,"children":1333},{},[1334],{"type":49,"value":1335},"—",{"type":43,"tag":901,"props":1337,"children":1338},{},[1339],{"type":43,"tag":99,"props":1340,"children":1342},{"className":1341},[],[1343],{"type":49,"value":1330},{"type":43,"tag":864,"props":1345,"children":1346},{},[1347,1352,1361,1370,1379],{"type":43,"tag":901,"props":1348,"children":1349},{},[1350],{"type":49,"value":1351},"Proxies \u002F Upgrades",{"type":43,"tag":901,"props":1353,"children":1354},{},[1355],{"type":43,"tag":99,"props":1356,"children":1358},{"className":1357},[],[1359],{"type":49,"value":1360},"contracts\u002Fproxy\u002F",{"type":43,"tag":901,"props":1362,"children":1363},{},[1364],{"type":43,"tag":99,"props":1365,"children":1367},{"className":1366},[],[1368],{"type":49,"value":1369},"packages\u002Fupgrades\u002F",{"type":43,"tag":901,"props":1371,"children":1372},{},[1373],{"type":43,"tag":99,"props":1374,"children":1376},{"className":1375},[],[1377],{"type":49,"value":1378},"contracts\u002Fsrc\u002Fproxy\u002F",{"type":43,"tag":901,"props":1380,"children":1381},{},[1382],{"type":43,"tag":99,"props":1383,"children":1385},{"className":1384},[],[1386],{"type":49,"value":1387},"packages\u002Fcontract-utils\u002F",{"type":43,"tag":864,"props":1389,"children":1390},{},[1391,1396,1405,1421,1430],{"type":43,"tag":901,"props":1392,"children":1393},{},[1394],{"type":49,"value":1395},"Utilities \u002F Security",{"type":43,"tag":901,"props":1397,"children":1398},{},[1399],{"type":43,"tag":99,"props":1400,"children":1402},{"className":1401},[],[1403],{"type":49,"value":1404},"contracts\u002Futils\u002F",{"type":43,"tag":901,"props":1406,"children":1407},{},[1408,1414,1415],{"type":43,"tag":99,"props":1409,"children":1411},{"className":1410},[],[1412],{"type":49,"value":1413},"packages\u002Futils\u002F",{"type":49,"value":114},{"type":43,"tag":99,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":49,"value":1420},"packages\u002Fsecurity\u002F",{"type":43,"tag":901,"props":1422,"children":1423},{},[1424],{"type":43,"tag":99,"props":1425,"children":1427},{"className":1426},[],[1428],{"type":49,"value":1429},"contracts\u002Fsrc\u002Futils\u002F",{"type":43,"tag":901,"props":1431,"children":1432},{},[1433],{"type":43,"tag":99,"props":1434,"children":1436},{"className":1435},[],[1437],{"type":49,"value":1387},{"type":43,"tag":864,"props":1439,"children":1440},{},[1441,1446,1455,1464,1468],{"type":43,"tag":901,"props":1442,"children":1443},{},[1444],{"type":49,"value":1445},"Accounts",{"type":43,"tag":901,"props":1447,"children":1448},{},[1449],{"type":43,"tag":99,"props":1450,"children":1452},{"className":1451},[],[1453],{"type":49,"value":1454},"contracts\u002Faccount\u002F",{"type":43,"tag":901,"props":1456,"children":1457},{},[1458],{"type":43,"tag":99,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":49,"value":1463},"packages\u002Faccount\u002F",{"type":43,"tag":901,"props":1465,"children":1466},{},[1467],{"type":49,"value":1335},{"type":43,"tag":901,"props":1469,"children":1470},{},[1471],{"type":43,"tag":99,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":49,"value":1476},"packages\u002Faccounts\u002F",{"type":43,"tag":66,"props":1478,"children":1479},{},[1480],{"type":49,"value":1481},"Browse these paths first when searching for a component.",{"type":43,"tag":66,"props":1483,"children":1484},{},[1485,1489,1491,1497,1499,1504,1506,1515,1517,1523,1525,1531],{"type":43,"tag":91,"props":1486,"children":1487},{},[1488],{"type":49,"value":1108},{"type":49,"value":1490}," isn't in this fixed grid and has no ",{"type":43,"tag":99,"props":1492,"children":1494},{"className":1493},[],[1495],{"type":49,"value":1496},"@openzeppelin\u002Fcontracts-cli",{"type":49,"value":1498}," generator, so always use the pattern-discovery methodology above — adapt a package's ",{"type":43,"tag":99,"props":1500,"children":1502},{"className":1501},[],[1503],{"type":49,"value":717},{"type":49,"value":1505}," as the canonical integration recipe and import via MVR rather than copying source. Discover everything else (the package set, composition and style conventions, exact APIs, and the toolchain) from the library's own metadata, starting at ",{"type":43,"tag":321,"props":1507,"children":1509},{"href":1122,"rel":1508},[912],[1510],{"type":43,"tag":99,"props":1511,"children":1513},{"className":1512},[],[1514],{"type":49,"value":1126},{"type":49,"value":1516},"; the ",{"type":43,"tag":99,"props":1518,"children":1520},{"className":1519},[],[1521],{"type":49,"value":1522},"setup-sui-contracts",{"type":49,"value":1524}," skill covers the full setup, dependency, ",{"type":43,"tag":99,"props":1526,"children":1528},{"className":1527},[],[1529],{"type":49,"value":1530},"--build-env",{"type":49,"value":1532}," build, and quality-gate flow.",{"type":43,"tag":59,"props":1534,"children":1536},{"id":1535},"known-version-specific-considerations",[1537],{"type":49,"value":1538},"Known Version-Specific Considerations",{"type":43,"tag":66,"props":1540,"children":1541},{},[1542,1544,1550,1552,1558],{"type":49,"value":1543},"Do not assume override points from prior knowledge — always verify by reading the installed source. Functions that were ",{"type":43,"tag":99,"props":1545,"children":1547},{"className":1546},[],[1548],{"type":49,"value":1549},"virtual",{"type":49,"value":1551}," in an older version may no longer be in the current one, making them non-overridable. The source NatSpec will indicate the correct override point (e.g., ",{"type":43,"tag":99,"props":1553,"children":1555},{"className":1554},[],[1556],{"type":49,"value":1557},"NOTE: This function is not virtual, {X} should be overridden instead",{"type":49,"value":1559},").",{"type":43,"tag":66,"props":1561,"children":1562},{},[1563,1565,1571,1573,1578],{"type":49,"value":1564},"A known example: the Solidity ERC-20 transfer hook changed between v4 and v5. Read the installed ",{"type":43,"tag":99,"props":1566,"children":1568},{"className":1567},[],[1569],{"type":49,"value":1570},"ERC20.sol",{"type":49,"value":1572}," to confirm which function is ",{"type":43,"tag":99,"props":1574,"children":1576},{"className":1575},[],[1577],{"type":49,"value":1549},{"type":49,"value":1579}," before recommending an override.",{"type":43,"tag":52,"props":1581,"children":1583},{"id":1582},"cli-generators",[1584],{"type":49,"value":357},{"type":43,"tag":66,"props":1586,"children":1587},{},[1588,1590,1595],{"type":49,"value":1589},"The ",{"type":43,"tag":99,"props":1591,"children":1593},{"className":1592},[],[1594],{"type":49,"value":1496},{"type":49,"value":1596}," package generates reference OpenZeppelin contract implementations from the command line. Use it as the reference source in the generate-compare-apply workflow whenever a command exists for the contract type.",{"type":43,"tag":59,"props":1598,"children":1600},{"id":1599},"discovering-commands-and-options",[1601],{"type":49,"value":1602},"Discovering Commands and Options",{"type":43,"tag":66,"props":1604,"children":1605},{},[1606,1608,1614,1616,1622,1623,1629,1630,1636,1638,1644,1646,1652],{"type":49,"value":1607},"Run ",{"type":43,"tag":99,"props":1609,"children":1611},{"className":1610},[],[1612],{"type":49,"value":1613},"npx @openzeppelin\u002Fcontracts-cli --help",{"type":49,"value":1615}," to list available commands. Each command corresponds to a contract type (e.g., ",{"type":43,"tag":99,"props":1617,"children":1619},{"className":1618},[],[1620],{"type":49,"value":1621},"solidity-erc20",{"type":49,"value":114},{"type":43,"tag":99,"props":1624,"children":1626},{"className":1625},[],[1627],{"type":49,"value":1628},"cairo-erc721",{"type":49,"value":114},{"type":43,"tag":99,"props":1631,"children":1633},{"className":1632},[],[1634],{"type":49,"value":1635},"stellar-fungible",{"type":49,"value":1637},"). Run ",{"type":43,"tag":99,"props":1639,"children":1641},{"className":1640},[],[1642],{"type":49,"value":1643},"npx @openzeppelin\u002Fcontracts-cli \u003Ccommand> --help",{"type":49,"value":1645}," to see the available options. Do not rely on prior knowledge of what options exist; check ",{"type":43,"tag":99,"props":1647,"children":1649},{"className":1648},[],[1650],{"type":49,"value":1651},"--help",{"type":49,"value":1653}," at the start of a conversation since the CLI may have been updated.",{"type":43,"tag":59,"props":1655,"children":1657},{"id":1656},"generate-compare-apply-shortcut",[1658],{"type":49,"value":1659},"Generate-Compare-Apply Shortcut",{"type":43,"tag":66,"props":1661,"children":1662},{},[1663],{"type":49,"value":1664},"When a CLI command exists for the contract type, pipe generated output to temporary files and diff them to keep generated contract code out of the conversation context:",{"type":43,"tag":83,"props":1666,"children":1667},{},[1668,1743,1805,1839],{"type":43,"tag":87,"props":1669,"children":1670},{},[1671,1676,1678],{"type":43,"tag":91,"props":1672,"children":1673},{},[1674],{"type":49,"value":1675},"Generate baseline",{"type":49,"value":1677}," — run with only required options, all features disabled, pipe to a file:\n",{"type":43,"tag":1679,"props":1680,"children":1685},"pre",{"className":1681,"code":1682,"language":1683,"meta":1684,"style":1684},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx @openzeppelin\u002Fcontracts-cli solidity-erc20 --name MyToken --symbol MTK > \u002Ftmp\u002Foz-baseline.sol\n","bash","",[1686],{"type":43,"tag":99,"props":1687,"children":1688},{"__ignoreMap":1684},[1689],{"type":43,"tag":1690,"props":1691,"children":1694},"span",{"class":1692,"line":1693},"line",1,[1695,1701,1707,1712,1717,1722,1727,1732,1738],{"type":43,"tag":1690,"props":1696,"children":1698},{"style":1697},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[1699],{"type":49,"value":1700},"npx",{"type":43,"tag":1690,"props":1702,"children":1704},{"style":1703},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[1705],{"type":49,"value":1706}," @openzeppelin\u002Fcontracts-cli",{"type":43,"tag":1690,"props":1708,"children":1709},{"style":1703},[1710],{"type":49,"value":1711}," solidity-erc20",{"type":43,"tag":1690,"props":1713,"children":1714},{"style":1703},[1715],{"type":49,"value":1716}," --name",{"type":43,"tag":1690,"props":1718,"children":1719},{"style":1703},[1720],{"type":49,"value":1721}," MyToken",{"type":43,"tag":1690,"props":1723,"children":1724},{"style":1703},[1725],{"type":49,"value":1726}," --symbol",{"type":43,"tag":1690,"props":1728,"children":1729},{"style":1703},[1730],{"type":49,"value":1731}," MTK",{"type":43,"tag":1690,"props":1733,"children":1735},{"style":1734},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1736],{"type":49,"value":1737}," >",{"type":43,"tag":1690,"props":1739,"children":1740},{"style":1703},[1741],{"type":49,"value":1742}," \u002Ftmp\u002Foz-baseline.sol\n",{"type":43,"tag":87,"props":1744,"children":1745},{},[1746,1751,1753],{"type":43,"tag":91,"props":1747,"children":1748},{},[1749],{"type":49,"value":1750},"Generate with feature",{"type":49,"value":1752}," — run again with the feature enabled, pipe to a second file:\n",{"type":43,"tag":1679,"props":1754,"children":1756},{"className":1681,"code":1755,"language":1683,"meta":1684,"style":1684},"npx @openzeppelin\u002Fcontracts-cli solidity-erc20 --name MyToken --symbol MTK --pausable > \u002Ftmp\u002Foz-variant.sol\n",[1757],{"type":43,"tag":99,"props":1758,"children":1759},{"__ignoreMap":1684},[1760],{"type":43,"tag":1690,"props":1761,"children":1762},{"class":1692,"line":1693},[1763,1767,1771,1775,1779,1783,1787,1791,1796,1800],{"type":43,"tag":1690,"props":1764,"children":1765},{"style":1697},[1766],{"type":49,"value":1700},{"type":43,"tag":1690,"props":1768,"children":1769},{"style":1703},[1770],{"type":49,"value":1706},{"type":43,"tag":1690,"props":1772,"children":1773},{"style":1703},[1774],{"type":49,"value":1711},{"type":43,"tag":1690,"props":1776,"children":1777},{"style":1703},[1778],{"type":49,"value":1716},{"type":43,"tag":1690,"props":1780,"children":1781},{"style":1703},[1782],{"type":49,"value":1721},{"type":43,"tag":1690,"props":1784,"children":1785},{"style":1703},[1786],{"type":49,"value":1726},{"type":43,"tag":1690,"props":1788,"children":1789},{"style":1703},[1790],{"type":49,"value":1731},{"type":43,"tag":1690,"props":1792,"children":1793},{"style":1703},[1794],{"type":49,"value":1795}," --pausable",{"type":43,"tag":1690,"props":1797,"children":1798},{"style":1734},[1799],{"type":49,"value":1737},{"type":43,"tag":1690,"props":1801,"children":1802},{"style":1703},[1803],{"type":49,"value":1804}," \u002Ftmp\u002Foz-variant.sol\n",{"type":43,"tag":87,"props":1806,"children":1807},{},[1808,1813,1815],{"type":43,"tag":91,"props":1809,"children":1810},{},[1811],{"type":49,"value":1812},"Compare",{"type":49,"value":1814}," — diff the two files to identify exactly what changed (imports, inheritance, state, constructor, functions, modifiers):\n",{"type":43,"tag":1679,"props":1816,"children":1818},{"className":1681,"code":1817,"language":1683,"meta":1684,"style":1684},"diff \u002Ftmp\u002Foz-baseline.sol \u002Ftmp\u002Foz-variant.sol\n",[1819],{"type":43,"tag":99,"props":1820,"children":1821},{"__ignoreMap":1684},[1822],{"type":43,"tag":1690,"props":1823,"children":1824},{"class":1692,"line":1693},[1825,1830,1835],{"type":43,"tag":1690,"props":1826,"children":1827},{"style":1697},[1828],{"type":49,"value":1829},"diff",{"type":43,"tag":1690,"props":1831,"children":1832},{"style":1703},[1833],{"type":49,"value":1834}," \u002Ftmp\u002Foz-baseline.sol",{"type":43,"tag":1690,"props":1836,"children":1837},{"style":1703},[1838],{"type":49,"value":1804},{"type":43,"tag":87,"props":1840,"children":1841},{},[1842,1847],{"type":43,"tag":91,"props":1843,"children":1844},{},[1845],{"type":49,"value":1846},"Apply",{"type":49,"value":1848}," — edit the user's existing contract to add the discovered changes",{"type":43,"tag":66,"props":1850,"children":1851},{},[1852],{"type":49,"value":1853},"For interacting features (e.g., access control + upgradeability), generate a combined variant as well.",{"type":43,"tag":59,"props":1855,"children":1857},{"id":1856},"when-no-cli-command-exists-or-a-feature-is-not-covered",[1858],{"type":49,"value":1859},"When No CLI Command Exists or a Feature Is Not Covered",{"type":43,"tag":66,"props":1861,"children":1862},{},[1863,1865,1869],{"type":49,"value":1864},"The absence of a CLI command does NOT mean the library lacks support. It only means there is no generator for that contract type. Always fall back to the generic pattern discovery methodology in ",{"type":43,"tag":321,"props":1866,"children":1867},{"href":323},[1868],{"type":49,"value":326},{"type":49,"value":1870},".",{"type":43,"tag":66,"props":1872,"children":1873},{},[1874],{"type":49,"value":1875},"Similarly, when a CLI command exists but does not expose an option for a specific feature, do not stop there. Fall back to pattern discovery for that feature: read the installed library source to find the relevant component, extract the integration requirements, and apply them to the user's contract.",{"type":43,"tag":1877,"props":1878,"children":1879},"style",{},[1880],{"type":49,"value":1881},"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":1883,"total":2012},[1884,1891,1908,1922,1935,1945,1955,1967,1979,1990,2001],{"slug":4,"name":4,"fn":5,"description":6,"org":1885,"tags":1886,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1887,1888,1889,1890],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"slug":1892,"name":1892,"fn":1893,"description":1894,"org":1895,"tags":1896,"stars":25,"repoUrl":26,"updatedAt":1907},"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},[1897,1900,1903,1906],{"name":1898,"slug":1899,"type":15},"Blockchain","blockchain",{"name":1901,"slug":1902,"type":15},"Code Review","code-review",{"name":1904,"slug":1905,"type":15},"Rust","rust",{"name":17,"slug":18,"type":15},"2026-07-16T06:00:49.17387",{"slug":1909,"name":1909,"fn":1910,"description":1911,"org":1912,"tags":1913,"stars":25,"repoUrl":26,"updatedAt":1921},"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},[1914,1917,1918],{"name":1915,"slug":1916,"type":15},"Engineering","engineering",{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},"Web3","web3","2026-07-13T06:04:17.186825",{"slug":1923,"name":1923,"fn":1924,"description":1925,"org":1926,"tags":1927,"stars":25,"repoUrl":26,"updatedAt":1934},"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},[1928,1929,1932,1933],{"name":1915,"slug":1916,"type":15},{"name":1930,"slug":1931,"type":15},"Foundry","foundry",{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},"2026-07-13T06:04:29.360325",{"slug":1936,"name":1936,"fn":1937,"description":1938,"org":1939,"tags":1940,"stars":25,"repoUrl":26,"updatedAt":1944},"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},[1941,1942,1943],{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},"2026-07-13T06:04:23.807685",{"slug":1946,"name":1946,"fn":1947,"description":1948,"org":1949,"tags":1950,"stars":25,"repoUrl":26,"updatedAt":1954},"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},[1951,1952,1953],{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},"2026-07-13T06:04:18.638516",{"slug":1522,"name":1522,"fn":1956,"description":1957,"org":1958,"tags":1959,"stars":25,"repoUrl":26,"updatedAt":1966},"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},[1960,1961,1964,1965],{"name":1898,"slug":1899,"type":15},{"name":1962,"slug":1963,"type":15},"CLI","cli",{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},"2026-07-16T05:59:21.671811",{"slug":1968,"name":1968,"fn":1969,"description":1970,"org":1971,"tags":1972,"stars":25,"repoUrl":26,"updatedAt":1978},"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},[1973,1976,1977],{"name":1974,"slug":1975,"type":15},"Migration","migration",{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},"2026-07-13T06:04:25.126377",{"slug":1980,"name":1980,"fn":1981,"description":1982,"org":1983,"tags":1984,"stars":25,"repoUrl":26,"updatedAt":1989},"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},[1985,1986,1987,1988],{"name":1974,"slug":1975,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},"2026-07-13T06:04:20.958319",{"slug":1991,"name":1991,"fn":1992,"description":1993,"org":1994,"tags":1995,"stars":25,"repoUrl":26,"updatedAt":2000},"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},[1996,1997,1998,1999],{"name":1898,"slug":1899,"type":15},{"name":1974,"slug":1975,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},"2026-07-13T06:04:31.398663",{"slug":2002,"name":2002,"fn":2003,"description":2004,"org":2005,"tags":2006,"stars":25,"repoUrl":26,"updatedAt":2011},"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},[2007,2008,2009,2010],{"name":1974,"slug":1975,"type":15},{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},"2026-07-13T06:04:28.005287",11,{"items":2014,"total":2012},[2015,2022,2029,2035,2042,2048,2054],{"slug":4,"name":4,"fn":5,"description":6,"org":2016,"tags":2017,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2018,2019,2020,2021],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"slug":1892,"name":1892,"fn":1893,"description":1894,"org":2023,"tags":2024,"stars":25,"repoUrl":26,"updatedAt":1907},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2025,2026,2027,2028],{"name":1898,"slug":1899,"type":15},{"name":1901,"slug":1902,"type":15},{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"slug":1909,"name":1909,"fn":1910,"description":1911,"org":2030,"tags":2031,"stars":25,"repoUrl":26,"updatedAt":1921},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2032,2033,2034],{"name":1915,"slug":1916,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},{"slug":1923,"name":1923,"fn":1924,"description":1925,"org":2036,"tags":2037,"stars":25,"repoUrl":26,"updatedAt":1934},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2038,2039,2040,2041],{"name":1915,"slug":1916,"type":15},{"name":1930,"slug":1931,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"slug":1936,"name":1936,"fn":1937,"description":1938,"org":2043,"tags":2044,"stars":25,"repoUrl":26,"updatedAt":1944},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2045,2046,2047],{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},{"slug":1946,"name":1946,"fn":1947,"description":1948,"org":2049,"tags":2050,"stars":25,"repoUrl":26,"updatedAt":1954},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2051,2052,2053],{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15},{"name":1919,"slug":1920,"type":15},{"slug":1522,"name":1522,"fn":1956,"description":1957,"org":2055,"tags":2056,"stars":25,"repoUrl":26,"updatedAt":1966},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2057,2058,2059,2060],{"name":1898,"slug":1899,"type":15},{"name":1962,"slug":1963,"type":15},{"name":1904,"slug":1905,"type":15},{"name":17,"slug":18,"type":15}]