chore(release): v0.3.0-alpha

[0xisk]

Types of changes

What types of changes does your code introduce to OpenZeppelin Midnight Contracts?
Put an x in the boxes that apply

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation Update (if none of the other choices apply)

Fixes #???

Release PR for v0.3.0-alpha, targeting main per RELEASING.md.

Pushing the release-v0.3.0-alpha branch triggers the prepare-release.yml workflow, which bumps the version in contracts/package.json and the // OpenZeppelin Compact Contracts vX.Y.Z headers throughout contracts/src/ (0.2.0 → 0.3.0-alpha) and commits it to this branch. This PR is the review gate for those changes before the tag is cut.

This pre-release bundles everything merged since v0.2.0. Changelog summary:

Added

• Native shielded token standard implementing MIP-0011, with opt-in supply and derived-nonce extensions (feat(token): add native shielded token standard MIP-0011 #621)
• Blocklist module (Add blocklist #626)
• Allowlist module (Add allowlist #625)
• ElGamal module (Add elgamal #617)
• Multisig contract suite (signature verification stubbed pending ECDSA + Keccak primitives) (Multisig contracts #378, Add multisig signer #424, feat(multisig): add Forwarder + ForwarderPrivate modules #526)

Changed

• Upgrade the Compact toolchain and Midnight dependencies (compiler 0.29.0 → 0.31.0, pragma language_version >= 0.21.0 → >= 0.23.0, runtime / ledger / simulator bumps)
• Migrate the unit suites to the async, backend-aware simulator (dry-run + live) (test: migrate unit suites to async backend-aware simulator (dry + live) #620, test: apply PR #620 simulator-migration review feedback #631)

Fixed

• Resolve zero-value revert audit findings L-01 and L-02 in the token modules (fix(token): resolve zero-value revert audit findings (L-01, L-02) #616)

The toolchain/pragma bump is the breaking element: consumers building against compiler < 0.31.0 are affected.

PR Checklist

• I have read the Contributing Guide
• I have added tests that prove my fix is effective or that my feature works. See GUIDELINES.md#testing for more information.
• I have added documentation for new methods or changes to existing method behavior. See GUIDELINES.md#documentation for more information.
• CI Workflows Are Passing

Further comments

The CHANGELOG was updated manually (move Unreleased → dated 0.3.0-alpha) ahead of the automated version bump, mirroring the v0.2.0 release. Once this merges, follow the remaining RELEASING.md steps: pull main, tag v0.3.0-alpha, push the tag, then publish the GitHub release.

Summary by CodeRabbit

• New Features
  • Documented support for shielded token functionality and multisig-related capabilities in the latest release notes.
• Changed
  • Updated the project version to 0.3.0-alpha and refreshed package metadata to match.
  • Aligned documentation and module references with the new release version.
• Bug Fixes
  • Noted fixes for zero-value revert issues in token-related behavior.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e1d50af4-f61f-4374-975e-b210daa6b0cd

📥 Commits

Reviewing files that changed from the base of the PR and between a0835be and 759c32a.

📒 Files selected for processing (41)

• CHANGELOG.md
• contracts/package.json
• contracts/src/access/AccessControl.compact
• contracts/src/access/Ownable.compact
• contracts/src/access/ShieldedAccessControl.compact
• contracts/src/access/ZOwnablePK.compact
• contracts/src/archive/ShieldedToken.compact
• contracts/src/crypto/ElGamal.compact
• contracts/src/multisig/ForwarderPrivate.compact
• contracts/src/multisig/ForwarderShielded.compact
• contracts/src/multisig/ForwarderUnshielded.compact
• contracts/src/multisig/ProposalManager.compact
• contracts/src/multisig/ShieldedTreasury.compact
• contracts/src/multisig/ShieldedTreasuryStateless.compact
• contracts/src/multisig/Signer.compact
• contracts/src/multisig/SignerManager.compact
• contracts/src/multisig/UnshieldedTreasury.compact
• contracts/src/multisig/presets/ShieldedMultiSig.compact
• contracts/src/multisig/presets/ShieldedMultiSigV2.compact
• contracts/src/multisig/presets/forwarder/ForwarderPrivate.compact
• contracts/src/multisig/presets/forwarder/ForwarderShielded.compact
• contracts/src/multisig/presets/forwarder/ForwarderUnshielded.compact
• contracts/src/multisig/test/EmptyWitnesses.ts
• contracts/src/multisig/test/witnesses/ProposalManagerWitnesses.ts
• contracts/src/multisig/test/witnesses/ShieldedMultiSigV2Witnesses.ts
• contracts/src/multisig/test/witnesses/ShieldedMultiSigWitnesses.ts
• contracts/src/multisig/test/witnesses/ShieldedTreasuryWitnesses.ts
• contracts/src/multisig/test/witnesses/SignerManagerWitnesses.ts
• contracts/src/multisig/test/witnesses/SignerWitnesses.ts
• contracts/src/multisig/test/witnesses/UnshieldedTreasuryWitnesses.ts
• contracts/src/security/Allowlist.compact
• contracts/src/security/Blocklist.compact
• contracts/src/security/Initializable.compact
• contracts/src/security/Pausable.compact
• contracts/src/token/FungibleToken.compact
• contracts/src/token/MultiToken.compact
• contracts/src/token/NativeShieldedToken.compact
• contracts/src/token/NativeShieldedTokenCore.compact
• contracts/src/token/NativeShieldedTokenFamily.compact
• contracts/src/token/NonFungibleToken.compact
• contracts/src/utils/Utils.compact

---

Walkthrough

Bumps the package version from 0.2.0 to 0.3.0-alpha in contracts/package.json, populates the CHANGELOG.md 0.3.0-alpha entry with Added/Changed/Fixed sections, and updates the header comment in every .compact and .ts source file from v0.2.0 to v0.3.0-alpha.

Changes

v0.3.0-alpha Release Bump

Layer / File(s)	Summary
CHANGELOG and package version CHANGELOG.md, contracts/package.json	Populates the 0.3.0-alpha (2026-06-30) changelog with Added (native shielded token MIP-0011, blocklist/allowList, ElGamal, multisig), Changed (toolchain/dependency upgrades including @openzeppelin/compact-simulator ^0.1.0→^0.2.0, async simulator API migration), and Fixed (zero-value revert audit findings L-01/L-02) entries; bumps the package version field.
Header comment version bump contracts/src/access/*, contracts/src/archive/*, contracts/src/crypto/*, contracts/src/multisig/..., contracts/src/security/*, contracts/src/token/*, contracts/src/utils/*	Updates the OpenZeppelin Compact Contracts version string from v0.2.0 to v0.3.0-alpha in the top-of-file header comment of all 39 .compact and .ts source files.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related issues

• Merge all Dependabot PRs before 0.3.0-alpha release #587: The @openzeppelin/compact-simulator dependency bump documented in the CHANGELOG aligns with the dependency/version upgrade work tracked in this issue.

Possibly related PRs

• OpenZeppelin/compact-contracts#541: Performs the same pattern of version-only bumps across contracts/package.json and all contracts/src/** module header comments with no functional changes.
• OpenZeppelin/compact-contracts#615: Touches the same multisig contract files (e.g., contracts/src/multisig/Forwarder*) with the identical header-comment version bump pattern.
• OpenZeppelin/compact-contracts#597: Relates to the Compact/Midnight toolchain and @openzeppelin/compact-simulator upgrade path documented in this PR's CHANGELOG.

Poem

🐇 Hop, hop, the version's new,
From 0.2 to alpha-three-point-oh!
Every header gets a fresh debut,
The changelog filled from top to toe.
Zero-value bugs? Fixed long ago.
A rabbit stamps the release—let's go! 🎉

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the release/version bump to v0.3.0-alpha, which matches the main purpose of the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release-v0.3.0-alpha

---

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