Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cofhe-docs.fhenix.zone/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
ComponentCurrent VersionMinimum Compatible VersionNotes
@fhenixprotocol/cofhe-contracts0.1.30.1.3Solidity libraries and smart contracts for FHE operations
@cofhe/sdk0.5.10.5.1JavaScript library for interacting with FHE contracts and the CoFHE coprocessor
@cofhe/hardhat-plugin0.5.10.5.1Hardhat plugin that deploys mock contracts and exposes utilities
@cofhe/hardhat-3-plugin0.5.10.5.1Hardhat 3 plugin that deploys mock contracts and exposes utilities
@cofhe/foundry-plugin0.5.10.5.1Foundry plugin that deploys mock contracts and exposes utilities
@cofhe/mock-contracts0.5.10.5.1Mock contracts for local development and testing

​
Additional Packages

These packages provide shared utilities and higher-level abstractions used across the ecosystem:
ComponentCurrent VersionMinimum Compatible VersionNotes
@fhenixprotocol/cofhe-errors1.0.21.0.2Shared error definitions for CoFHE contracts
@fhenixprotocol/fhenix-confidential-contracts0.2.10.2.1Pre-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:
NetworkCompatibleAPI VersionNotesPlugin Name
Sepolia✅v1Full supporteth-sepolia
Arbitrum Sepolia✅v1Full supportarb-sepolia
Base Sepolia✅v1Full supportbase-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

e