Release v0.4.0 (rc)

[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 release-v0.4, this PR will be updated.

⚠️⚠️⚠️⚠️⚠️⚠️

release-v0.4 is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, run changeset pre exit on release-v0.4.

⚠️⚠️⚠️⚠️⚠️⚠️

Releases

openzeppelin-confidential-contracts@0.4.0-rc.0

openzeppelin-confidential-contracts

0.4.0-rc.0 (2026-03-12)

• Migrate @fhevm/solidity dependency to 0.11.1 (#311)
• Upgrade openzeppelin/contracts and openzeppelin/contracts-upgradeable to v5.6.1 (#314)

Token

• ERC7984ERC20Wrapper: use a bytes32 unwrap request identifier instead of identifying batches by the euint64 unwrap amount. (#326)
• ERC7984ERC20Wrapper: Support ERC-165 interface detection on ERC7984ERC20Wrapper. (#267)
• ERC7984ERC20Wrapper: return the amount of wrapped token sent on wrap calls. (#307)
• ERC7984ERC20Wrapper: return unwrapped amount on unwrap calls (#288)
• ERC7984Restricted, ERC7984Rwa: Rename isUserAllowed to canTransact (#291)
• ERC7984ERC20Wrapper: revert on wrap if there is a chance of total supply overflow. (#268)

Finance

• BatcherConfidential: A batching primitive that enables routing between two ERC7984ERC20Wrapper contracts via a non-confidential route. (#293)

Utils

• HandleAccessManager: change _validateHandleAllowance to return a boolean and validate it. (#303)

0.3.1 (2026-01-06)

Bug fixes

• ERC7984ERC20Wrapper: revert on wrap if there is a chance of total supply overflow. (#268)

0.3.0 (2025-11-28)

• Migrate @fhevm/solidity from v0.7.0 to 0.9.1 (#202, #248, #254)

Token

• Rename all ConfidentialFungibleToken files and contracts to use ERC7984 instead. (#158)
• ERC7984: Change tokenURI() to contractURI() following change in the ERC. (#209)
• ERC7984: Support ERC-165 interface detection on ERC-7984. (#246)
• IERC7984: Change tokenURI() to contractURI() following change in the ERC. (#209)
• IERC7984: Support ERC-165 interface detection on ERC-7984. (#246)
• ERC7984Omnibus: Add an extension of ERC7984 that exposes new functions for transferring between confidential subaccounts on omnibus wallets. (#186)
• ERC7984ObserverAccess: Add an extension for ERC7984, which allows each account to add an observer who is given access to their transfer and balance amounts. (#148)
• ERC7984Restricted: An extension of ERC7984 that implements user account transfer restrictions. (#182)
• ERC7984Freezable: Add an extension to ERC7984 that implements internal functions with the ability to freeze/unfreeze user tokens. (#151)
• ERC7984Rwa: An extension of ERC7984, that supports confidential Real World Assets (RWAs). (#160)

Utils

• FHESafeMath: Add tryAdd and trySub functions that return 0 upon failure. (#206)
• FHESafeMath: Support non-initialized inputs in tryIncrease(..)/tryDecrease(..). (#183)

0.2.0 (2025-08-14)

• Upgrade all contracts to use @fhevm/solidity 0.7.0. (#27)

Token

• IConfidentialFungibleToken: Prefix totalSupply and balanceOf functions with confidential. (#93)
• IConfidentialFungibleToken: Rename EncryptedAmountDisclosed event to AmountDisclosed. (#93)
• ConfidentialFungibleToken: Change the default decimals from 9 to 6. (#74)
• ConfidentialFungibleTokenERC20Wrapper: Add an internal function to allow overriding the max decimals used for wrapped tokens. (#89)
• ConfidentialFungibleTokenERC20Wrapper: Add an internal function to allow overriding the underlying decimals fallback value. (#133)

Governance

• VotesConfidential: Add votes governance utility for keeping track of FHE vote delegations. (#40)
• ConfidentialFungibleTokenVotes: Add an extension of ConfidentialFungibleToken that implements VotesConfidential. (#40)

Finance

• VestingWalletConfidential: A vesting wallet that releases confidential tokens owned by it according to a defined vesting schedule. (#91)
• VestingWalletCliffConfidential: A variant of VestingWalletConfidential which adds a cliff period to the vesting schedule. (#91)
• VestingWalletConfidentialFactory: A generalized factory that allows for batch funding of confidential vesting wallets. (#102)

Misc

• HandleAccessManager: Minimal contract that adds a function to give allowance to callers for a given ciphertext handle. (#143)
• ERC7821WithExecutor: Add an abstract contract that inherits from ERC7821 and adds an executor role. (#102)
• CheckpointsConfidential: Add a library for handling checkpoints with confidential value types. (#60)
• TFHESafeMath: Renamed to FHESafeMath. (#137)

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e5681310-b08a-46a7-90ba-a124c3a845b1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ 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/release-v0.4

📝 Coding Plan

• Generate coding plan for human review comments

---

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

Tip

CodeRabbit can use TruffleHog to scan for secrets in your code with verification capabilities.

Add a TruffleHog config file (e.g. trufflehog-config.yml, trufflehog.yml) to your project to customize detectors and scanning behavior. The tool runs only when a config file is present.