Release v0.3.1

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

Releases

openzeppelin-confidential-contracts@0.3.1

openzeppelin-confidential-contracts

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, which allows accounts granted the "freezer" role to freeze and unfreeze 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.

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

✨ 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.3

---

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