Compatibility

Essential version information and network compatibility for all CoFHE ecosystem components

Overview

This document provides detailed compatibility information for all components in the CoFHE ecosystem. Following these version requirements is crucial for maintaining a stable and secure development environment.

Using incompatible versions of CoFHE components can lead to unexpected behavior, security vulnerabilities, or complete failure of your application. Always verify version compatibility before deployment.

Core Components

The following table lists all core CoFHE components with their current and minimum compatible versions:

Component	Current Version	Minimum Compatible Version	Notes
@fhenixprotocol/cofhe-contracts	0.1.3	0.1.3	Solidity libraries and smart contracts for FHE operations
@cofhe/sdk	0.5.1	0.5.1	JavaScript library for interacting with FHE contracts and the CoFHE coprocessor
@cofhe/hardhat-plugin	0.5.1	0.5.1	Hardhat plugin that deploys mock contracts and exposes utilities
@cofhe/hardhat-3-plugin	0.5.1	0.5.1	Hardhat 3 plugin that deploys mock contracts and exposes utilities
@cofhe/foundry-plugin	0.5.1	0.5.1	Foundry plugin that deploys mock contracts and exposes utilities
@cofhe/mock-contracts	0.5.1	0.5.1	Mock contracts for local development and testing

Additional Packages

These packages provide shared utilities and higher-level abstractions used across the ecosystem:

Component	Current Version	Minimum Compatible Version	Notes
@fhenixprotocol/cofhe-errors	1.0.2	1.0.2	Shared error definitions for CoFHE contracts
@fhenixprotocol/fhenix-confidential-contracts	0.2.1	0.2.1	Pre-built confidential contract primitives (FHERC20, etc.)

Version Compatibility Guidelines

When working with CoFHE components:

• Always use the latest stable versions: Check GitHub releases for the most recent versions
• Verify compatibility: Ensure all components are within their compatible version ranges
• Test thoroughly: After updating versions, test your application in both mock and testnet environments
• Check release notes: Review breaking changes and migration guides when upgrading

For the best development experince, use the latest versions of all components. They are designed to work together seamlessly and include the latest features and security improvements.

Network Compatibility

CoFHE currently supports the following networks:

Network	Compatible	API Version	Notes	Plugin Name
Sepolia	✅	v1	Full support	eth-sepolia
Arbitrum Sepolia	✅	v1	Full support	arb-sepolia
Base Sepolia	✅	v1	Full support	base-sepolia

All supported networks use API version v1. The plugin names correspond to the network identifiers used in Hardhat configuration files.

Troubleshooting Compatibility Issues

If you encounter compatibility issues:

1. Verify all versions: Ensure all CoFHE components are using compatible versions
2. Check network support: Confirm your target network is supported
3. Review error messages: Look for version mismatch errors in your console
4. Update dependencies: Run npm update or yarn upgrade to get the latest compatible versions
5. Check documentation: Review the component-specific documentation for version requirements

If you’re experiencing issues after updating versions, check the release notes for breaking changes and migration guides. Some updates may require code changes in your contracts or client applications.

Next Steps

• Review the Quick Start guide to set up your development environment
• Learn about best practices for developing with CoFHE
• Explore the API reference for detailed component documentation

e