Prepare Release

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and publish to npm yourself or setup this action to publish automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to master, this PR will be updated.

Releases

@openzeppelin/wizard-common@0.3.0

Changelog

0.3.0 (2025-11-11)

• Breaking changes: Solidity Stablecoin and RWA: Change custodian option to freezable. Replace ERC20Custodian with ERC20Freezable. (#719)
• Add macros descriptions for Cairo (#703)

0.2.0 (2025-11-03)

• Breaking changes: Solidity Stablecoin and RWA: Change limitations option to restrictions. Replace ERC20Allowlist and ERC20Blocklist with ERC20Restricted. (#715)
• Update @openzeppelin/contracts and @openzeppelin/contracts-upgradeable dependencies to 5.5.0 (#681)
  • Breaking changes:
    • Solidity account signer: ERC7702 option is renamed as EIP7702. Imported contract SignerERC7702 is renamed as SignerEIP7702.
    • Solidity upgradeable contracts: Initializable and UUPSUpgradeable are imported from @openzeppelin/contracts instead of @openzeppelin/contracts-upgradeable.

0.1.2 (2025-10-29)

• Add AI descriptions for AccessControl in Cairo-alpha (#698)

0.1.1 (2025-09-16)

• Update Solidity Account prompt (#609)
• Support decimals customization for ERC20 Cairo contracts (#654)

0.1.0 (2025-08-15)

• Bump minor version for semantic versioning stability (#631)

0.0.3 (2025-08-12)

• Breaking change: Use ERC20Bridgeable from OpenZeppelin Contracts 5.4.0 instead of Community Contracts (#619)

0.0.2 (2025-07-03)

• Stellar: Add Stablecoin with Limitations and Access Control (ownable and roles). (#575)

0.0.1 (2025-06-20)

• Add support for Wizard MCP server. (#569)

@openzeppelin/wizard@0.10.1

Changelog

0.10.1 (2025-11-11)

• Fixed bug with incorrect names in generated comment for Multisig account. (#720)
• Add API function to get versioned remappings. (#724)
• Breaking changes: Solidity Stablecoin and RWA: Change custodian option to freezable. Replace ERC20Custodian with ERC20Freezable. (#719)
• Solidity account signer: Fix grammar in comment (#711)

0.10.0 (2025-11-03)

• Update @openzeppelin/contracts and @openzeppelin/contracts-upgradeable dependencies to 5.5.0 (#681)

  • Breaking changes:
    • Solidity account signer: ERC7702 option is renamed as EIP7702. Imported contract SignerERC7702 is renamed as SignerEIP7702.
    • Solidity upgradeable contracts: Initializable and UUPSUpgradeable are imported from @openzeppelin/contracts instead of @openzeppelin/contracts-upgradeable.

• Breaking changes: Solidity Stablecoin and RWA: Change limitations option to restrictions. Replace ERC20Allowlist and ERC20Blocklist with ERC20Restricted. (#715)

0.9.0 (2025-10-29)

• Breaking changes: Use namespaced storage instead of state variables when upgradeability is enabled. (#704)
  • For ERC-20, use namespaced storage for tokenBridge when cross-chain bridging is set to 'custom' and upgradeability is enabled.
  • For ERC-721, use namespaced storage for _nextTokenId when mintable, auto increment IDs, and upgradeability are enabled.

0.8.1 (2025-10-14)

• Updated community-contracts digest version (#659)
• Updated community-contracts digest version (#677)

0.8.0 (2025-09-16)

• Add constructors for SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913, MultiSignerERC7913 and MultiSignerERC7913Weighted (#609)
• Enable upgradeability for AccountERC7579, AccountERC7579Hooked, SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913 and MultiSignerERC7913 (#609)
• Breaking change: Use Account, AccountERC7579, AccountERC7579Hooked, ERC7812, ERC7739Utils, ERC7913Utils, AbstractSigner, SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913, MultiSignerERC7913, and MultiSignerERC7913Weighted from OpenZeppelin Contracts 5.4.0 instead of Community Contracts (#609)
• Remove all initializers from non-upgradeable accounts. (#658)

0.7.1 (2025-08-15)

• Add compatible git commit in comments when importing OpenZeppelin Community Contracts (#627)

0.7.0 (2025-08-12)

• Breaking change: Use ERC20Bridgeable from OpenZeppelin Contracts 5.4.0 instead of Community Contracts (#619)

0.6.0 (2025-06-20)

• Add support for Wizard MCP server. (#569)

  • Possibly breaking changes:
    • Governor: Remove usage of access option. This option now has no effect.

• Accounts: Add _disableInitializers() to account implementations (#568)

0.5.6 (2025-05-21)

• MultisigERC7913: Add onlyEntryPointOrSelf modifier to public configuration functions. (#554)
• Use onlyGovernance to restrict upgrades for Governor with UUPS (#544)
  • Potentially breaking changes:
    • Governor with UUPS: _authorizeUpgrade function is restricted by onlyGovernance instead of onlyOwner

0.5.5 (2025-05-13)

• Add account contract types for ERC-4337. (#486, #523, #527)
• Use unicode syntax for strings with non-ASCII characters (#476)
• Remove redundant overrides in Governor. (#522)
• Simplify Community Contracts imports. (#537)
• Potentially breaking changes:
  • Update pragma versions to 0.8.27. (#486)
  • Changes import path format for @openzeppelin/community-contracts. (#537)

0.5.4 (2025-04-01)

• Add validation for ERC20 premint field. (#488)
• Add callback in ERC20 features. (#500)

0.5.3 (2025-03-13)

• Add ERC20 Cross-Chain Bridging, SuperchainERC20. (#436)
  Note: Cross-Chain Bridging is experimental and may be subject to change.

• Potentially breaking changes:

  • Change order of constructor argument recipient when using premint.

0.5.2 (2025-02-21)

• Fix modifiers order to follow Solidity style guides. (#450)
• ERC721: Return tokenId on safeMint with incremental id. (#455)

0.5.1 (2025-02-05)

• Potentially breaking changes:
  • Add constructor argument recipient when using premint in erc20, stablecoin, and realWorldAsset. (#435)

0.5.0 (2025-01-23)

• Update to use TypeScript v5. (#231)

• Remove unused dependencies. (#430)

• Breaking changes:

  • Update Contracts Wizard license to AGPLv3. (#424)

0.4.6 (2024-11-20)

• Use named imports. (#411)

0.4.5 (2024-11-18)

• Add stablecoin and realWorldAsset contract types. (#404)
  Note: stablecoin and realWorldAsset are experimental and may be subject to change.

0.4.4 (2024-10-23)

Potentially breaking changes

• Update pragma versions to 0.8.22. (#401)

0.4.3 (2024-04-08)

• Add timestamp based Governor and Votes clock options. (#347)

0.4.2 (2024-02-22)

• Add code comments for compatible OpenZeppelin Contracts versions. (#331)

0.4.1 (2023-10-18)

• Add managed access control option for use with AccessManager. (#298)

0.4.0 (2023-10-05)

Breaking changes

• Update to OpenZeppelin Contracts 5.0. (#284)
• Require constructor or initializer arguments for initial owner or role assignments if using access control.
• Use token-specific pausable extensions.
• Enable ERC20Permit by default.

0.3.0 (2023-05-25)

• Breaking change: Update to OpenZeppelin Contracts 4.9. (#252)
• Change default voting delay to 1 day in governor. (#258)

0.2.3 (2023-03-23)

• Fix module not found error. (#235)

0.2.2 (2023-03-17)

• Fix missing file. (#234)

0.2.1 (2023-03-17)

• Remove unspecified dependency on @openzeppelin/contracts. (#233)

0.2.0 (2022-11-08)

• Reduce default block time to 12 seconds in governor. (fdcf912)
• Breaking change: Update to OpenZeppelin Contracts 4.8 and Solidity ^0.8.9. (#199)

0.1.1 (2022-06-30)

• Support custom contract type, optional access control. (#112)

0.1.0 (2022-06-15)

• Initial API for Solidity. (#136)

@openzeppelin/contracts-mcp@0.4.1

Changelog

0.4.1 (2025-11-11)

• Breaking changes: Solidity Stablecoin and RWA: Change custodian option to freezable. Replace ERC20Custodian with ERC20Freezable. (#719)
• Updated dependencies [6b8f8f5, c14be02, bec86b5, ce8fbba, 5c1fa0f]:
  • @openzeppelin/wizard@0.10.1
  • @openzeppelin/wizard-common@0.3.0

0.4.0 (2025-11-03)

• Update @openzeppelin/contracts and @openzeppelin/contracts-upgradeable dependencies to 5.5.0 (#681)

  • Breaking changes:
    • Solidity account signer: ERC7702 option is renamed as EIP7702. Imported contract SignerERC7702 is renamed as SignerEIP7702.
    • Solidity upgradeable contracts: Initializable and UUPSUpgradeable are imported from @openzeppelin/contracts instead of @openzeppelin/contracts-upgradeable.

• Breaking changes: Solidity Stablecoin and RWA: Change limitations option to restrictions. Replace ERC20Allowlist and ERC20Blocklist with ERC20Restricted. (#715)

• Updated dependencies [880b9b8, b49e056]:

  • @openzeppelin/wizard-common@0.2.0
  • @openzeppelin/wizard@0.10.0

0.3.0 (2025-10-29)

• Breaking changes: Solidity: Use namespaced storage instead of state variables when upgradeability is enabled. (#704)
  • For ERC-20, use namespaced storage for tokenBridge when cross-chain bridging is set to 'custom' and upgradeability is enabled.
  • For ERC-721, use namespaced storage for _nextTokenId when mintable, auto increment IDs, and upgradeability are enabled.
• Updated dependencies [38da80c, 0f0509d]:
  • @openzeppelin/wizard@0.9.0
  • @openzeppelin/wizard-common@0.1.2

0.2.0 (2025-09-16)

• Add constructors for SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913, MultiSignerERC7913 and MultiSignerERC7913Weighted (#609)
• Enable upgradeability for AccountERC7579, AccountERC7579Hooked, SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913 and MultiSignerERC7913 (#609)
• Breaking change: Use Account, AccountERC7579, AccountERC7579Hooked, ERC7812, ERC7739Utils, ERC7913Utils, AbstractSigner, SignerECDSA, SignerP256, SignerRSA, SignerERC7702, SignerERC7913, MultiSignerERC7913, and MultiSignerERC7913Weighted from OpenZeppelin Contracts 5.4.0 instead of Community Contracts (#609)
• Support decimals customization for ERC20 Cairo contracts (#654)
• Updated dependencies [41d5c74, b9d58dc, 41d5c74, 41d5c74, 41d5c74, 029790c]:
  • @openzeppelin/wizard-common@0.1.1
  • @openzeppelin/wizard@0.8.0
  • @openzeppelin/wizard-cairo@2.1.0

0.1.1 (2025-09-02)

• Cairo: Support decimals value added to ERC-20 scheme (#654)

0.1.0 (2025-08-15)

• Export functions to register MCP tools (#631)
• Updated dependencies [2bb2a16, c65acb7]:
  • @openzeppelin/wizard@0.7.1
  • @openzeppelin/wizard-common@0.1.0

0.0.7 (2025-08-12)

• Updated dependencies [f39adfd]:
  • @openzeppelin/wizard@0.7.0
  • @openzeppelin/wizard-common@0.0.3

0.0.6 (2025-07-29)

• Update Wizard API dependencies (#612)

0.0.5 (2025-07-25)

• Breaking changes: Renamed package from @openzeppelin/wizard-mcp to @openzeppelin/contracts-mcp (#607)

0.0.4 (2025-07-22)

• Updated dependencies [9e61c0f]:
  • @openzeppelin/wizard-stellar@0.4.1

0.0.3 (2025-07-03)

• Stellar: Add Stablecoin with Limitations and Access Control (ownable and roles). (#575)
  • Potentially breaking changes:
    • Use OpenZeppelin Stellar Soroban Contracts v0.3.0
• Updated dependencies [4b86b07, 4b86b07]:
  • @openzeppelin/wizard-stellar@0.3.0
  • @openzeppelin/wizard-common@0.0.2

0.0.2 (2025-06-27)

• Add security contact for stellar (#585)
• Updated dependencies [8997a89]:
  • @openzeppelin/wizard-stellar@0.2.3

0.0.1 (2025-06-20)

• Add support for Wizard MCP server. (#569)

[coderabbitai]

Walkthrough

The pull request consolidates multiple changesets and finalizes release documentation across three packages. It removes five changeset entries, bumps versions for @openzeppelin/wizard-common (0.2.0→0.3.0), @openzeppelin/wizard (0.10.0→0.10.1), and @openzeppelin/contracts-mcp (0.4.0→0.4.1), and updates corresponding CHANGELOG entries with breaking changes and fixes.

Changes

Cohort / File(s)	Summary
Changeset deletions .changeset/huge-ties-find.md, .changeset/long-trams-tease.md, .changeset/mean-shoes-cheer.md, .changeset/smart-fans-build.md, .changeset/twenty-hornets-clap.md	Removed five changeset entries documenting pending patch/version bumps for wizard, wizard-common, and contracts-mcp packages
Package version bumps packages/common/package.json, packages/core/solidity/package.json, packages/mcp/package.json	Updated version numbers: common (0.2.0→0.3.0), solidity (0.10.0→0.10.1), mcp (0.4.0→0.4.1) and aligned dependency versions in mcp
Changelog documentation packages/common/CHANGELOG.md, packages/core/solidity/CHANGELOG.md, packages/mcp/CHANGELOG.md	Added new version entries (0.3.0, 0.10.1, 0.4.1) documenting breaking changes, dependency updates, and bug fixes

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Verify version numbers are consistent across all package.json files and CHANGELOG entries
• Confirm changelog entries accurately reflect the removed changeset descriptions
• Ensure dependency version constraints in packages/mcp/package.json align with bumped versions

Possibly related PRs

• Add Solidity Wizard API function to get versioned remappings #724: Contains the same Solidity Wizard API addition (getVersionedRemappings) and matching version bumps for @openzeppelin/wizard and @openzeppelin/wizard-common
• Prepare Release #717: Related release update modifying the same package manifests and CHANGELOGs across @openzeppelin/wizard, @openzeppelin/wizard-common, and @openzeppelin/contracts-mcp

Suggested labels

ignore-changeset

Suggested reviewers

• CoveMB
• ericnordelo

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Prepare Release' is generic and directly aligned with the PR's primary objective of preparing package releases as generated by the Changesets action.
Description check	✅ Passed	The description is a standard Changesets release template that clearly explains the PR's purpose and includes detailed changelogs for all released packages.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch changeset-release/master

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c14be02 and 20b25d3.

📒 Files selected for processing (11)

• .changeset/huge-ties-find.md (0 hunks)
• .changeset/long-trams-tease.md (0 hunks)
• .changeset/mean-shoes-cheer.md (0 hunks)
• .changeset/smart-fans-build.md (0 hunks)
• .changeset/twenty-hornets-clap.md (0 hunks)
• packages/common/CHANGELOG.md (1 hunks)
• packages/common/package.json (1 hunks)
• packages/core/solidity/CHANGELOG.md (1 hunks)
• packages/core/solidity/package.json (1 hunks)
• packages/mcp/CHANGELOG.md (1 hunks)
• packages/mcp/package.json (2 hunks)

💤 Files with no reviewable changes (5)

• .changeset/mean-shoes-cheer.md
• .changeset/twenty-hornets-clap.md
• .changeset/smart-fans-build.md
• .changeset/long-trams-tease.md
• .changeset/huge-ties-find.md

🧰 Additional context used

🧠 Learnings (6)

📓 Common learnings

Learnt from: ericglau
Repo: OpenZeppelin/contracts-wizard PR: 663
File: packages/core/cairo_alpha/src/custom.test.ts.md:12-12
Timestamp: 2025-09-12T15:07:08.673Z
Learning: In the OpenZeppelin contracts-wizard cairo_alpha package changelog (packages/core/cairo_alpha/CHANGELOG.md), each alpha version gets its own separate entry under the "Unreleased" section rather than updating a single entry. This allows tracking of changes across different alpha releases (e.g., v3.0.0-alpha.0, v3.0.0-alpha.1, v3.0.0-alpha.2 all have separate entries).

Learnt from: ernestognw
Repo: OpenZeppelin/contracts-wizard PR: 609
File: .changeset/sour-hats-grow.md:2-6
Timestamp: 2025-08-15T22:49:25.653Z
Learning: In OpenZeppelin contracts-wizard, breaking changes that have concrete migration paths (like dependency migrations from Community Contracts to OpenZeppelin Contracts) can be handled as minor version bumps instead of major bumps, per maintainer ernestognw's versioning policy.

📚 Learning: 2025-08-15T22:49:25.653Z

Learnt from: ernestognw
Repo: OpenZeppelin/contracts-wizard PR: 609
File: .changeset/sour-hats-grow.md:2-6
Timestamp: 2025-08-15T22:49:25.653Z
Learning: In OpenZeppelin contracts-wizard, breaking changes that have concrete migration paths (like dependency migrations from Community Contracts to OpenZeppelin Contracts) can be handled as minor version bumps instead of major bumps, per maintainer ernestognw's versioning policy.

Applied to files:

• packages/common/package.json
• packages/mcp/CHANGELOG.md
• packages/core/solidity/package.json
• packages/common/CHANGELOG.md
• packages/mcp/package.json
• packages/core/solidity/CHANGELOG.md

📚 Learning: 2025-09-12T15:07:08.673Z

Learnt from: ericglau
Repo: OpenZeppelin/contracts-wizard PR: 663
File: packages/core/cairo_alpha/src/custom.test.ts.md:12-12
Timestamp: 2025-09-12T15:07:08.673Z
Learning: In the OpenZeppelin contracts-wizard cairo_alpha package changelog (packages/core/cairo_alpha/CHANGELOG.md), each alpha version gets its own separate entry under the "Unreleased" section rather than updating a single entry. This allows tracking of changes across different alpha releases (e.g., v3.0.0-alpha.0, v3.0.0-alpha.1, v3.0.0-alpha.2 all have separate entries).

Applied to files:

• packages/common/package.json
• packages/mcp/CHANGELOG.md
• packages/common/CHANGELOG.md
• packages/core/solidity/CHANGELOG.md

📚 Learning: 2025-08-19T15:21:06.991Z

Learnt from: ericglau
Repo: OpenZeppelin/contracts-wizard PR: 638
File: packages/core/cairo_alpha/src/account.test.ts.md:18-18
Timestamp: 2025-08-19T15:21:06.991Z
Learning: In the OpenZeppelin contracts-wizard repository, the cairo_alpha package (packages/core/cairo_alpha) and the stable cairo package (packages/core/cairo) are separate implementations that do not need to have the same code or matching dependency versions. The cairo_alpha package targets dependencies that are either newer than or the same as the stable cairo package, allowing it to test and support newer Cairo/Scarb/OpenZeppelin versions while the stable version maintains compatibility with stable releases.

Applied to files:

• packages/common/package.json
• packages/common/CHANGELOG.md
• packages/mcp/package.json

📚 Learning: 2025-08-19T15:31:24.984Z

Learnt from: ericglau
Repo: OpenZeppelin/contracts-wizard PR: 0
File: :0-0
Timestamp: 2025-08-19T15:31:24.984Z
Learning: Changes within packages/core/cairo_alpha should have a corresponding changelog entry in packages/core/cairo_alpha/CHANGELOG.md under the Unreleased section to track these changes. When cairo_alpha is eventually promoted to cairo (stable), these entries will be moved into a changeset for cairo (stable).

Applied to files:

• packages/common/CHANGELOG.md
• packages/core/solidity/CHANGELOG.md

📚 Learning: 2025-09-18T20:18:23.799Z

Learnt from: ericglau
Repo: OpenZeppelin/contracts-wizard PR: 652
File: packages/ui/api/ai-assistant/function-definitions/confidential.ts:32-38
Timestamp: 2025-09-18T20:18:23.799Z
Learning: In OpenZeppelin Wizard, the AI Assistant defines its own function definitions separately and does not use the MCP tools. This means the AI Assistant function definitions and MCP schemas can have different shapes without causing validation conflicts.

Applied to files:

• packages/mcp/package.json

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (6)

• GitHub Check: Redirect rules - openzeppelin-contracts-wizard
• GitHub Check: Header rules - openzeppelin-contracts-wizard
• GitHub Check: Pages changed - openzeppelin-contracts-wizard
• GitHub Check: boostsecurity - boostsecurityio/semgrep-pro
• GitHub Check: build (solidity, default)
• GitHub Check: semgrep-cloud-platform/scan

🔇 Additional comments (6)

packages/common/package.json (1)

3-3: Version bump correctly aligned with changelog.

The minor version bump (0.2.0 → 0.3.0) matches the new changelog entry and appropriately reflects the breaking changes (custodian → freezable, ERC20Custodian → ERC20Freezable) with concrete migration paths. Based on learnings, this follows established maintainer policy.

packages/core/solidity/package.json (1)

3-3: Patch version bump aligned with changelog.

The patch version bump (0.10.0 → 0.10.1) matches the new changelog entry, which includes both a bug fix and a breaking change (custodian → freezable). Since this is a Changesets-generated release, the versioning strategy was pre-determined by merged changeset files.

packages/common/CHANGELOG.md (1)

4-8: Changelog entry is well-formatted and accurate.

The 0.3.0 entry (2025-11-11) correctly documents the breaking change and new feature, with proper formatting, PR references, and positioning. The entry aligns with the version bump in package.json.

packages/core/solidity/CHANGELOG.md (1)

4-10: Changelog entry is well-documented and properly formatted.

The 0.10.1 entry (2025-11-11) correctly captures four distinct changes (bug fixes, feature addition, and breaking change) with proper PR references and formatting. The breaking change is clearly marked and aligns with the patch version bump.

packages/mcp/package.json (1)

3-3: Version bump and dependency updates are correctly aligned.

The patch version bump (0.4.0 → 0.4.1) is accompanied by precise dependency updates to @openzeppelin/wizard-common@^0.3.0 and @openzeppelin/wizard@^0.10.1, matching the versions being released in this same PR. The caret ranges allow appropriate patch and minor updates.

Also applies to: 29-30

packages/mcp/CHANGELOG.md (1)

4-10: Changelog entry correctly documents breaking change and dependency updates.

The 0.4.1 entry (2025-11-11) properly documents the breaking change (custodian → freezable) with PR reference and lists updated dependencies (@openzeppelin/wizard@0.10.1 and @openzeppelin/wizard-common@0.3.0) with commit hashes. The versions match package.json dependencies exactly.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}