Mock Contracts

The plugin deploys a suite of mock contracts that simulate the full CoFHE coprocessor stack on the Hardhat network. This lets you develop and test FHE contracts without running the off-chain FHE engine.

What the mocks simulate

Contract	Role
`MockTaskManager`	Manages FHE operations; stores plaintext values on-chain for testing
`MockACL`	Access control for encrypted handles
`MockZkVerifier`	Simulates ZK proof verification for encrypted inputs
`MockThresholdNetwork`	Handles decryption requests
`SimpleTest`	Optional helper contract for tests — exposes trivial value setters plus `getValueHash()`

The SDK automatically detects when it's running against the mock environment (by checking bytecode at the MockZkVerifier fixed address) and adapts its behavior accordingly — ZK proof generation is skipped and verification is handled by the mock contracts.

Auto-deployment

The core mock contracts are deployed automatically before every npx hardhat test and npx hardhat node run. SimpleTest is not auto-deployed.

To skip auto-deployment:

COFHE_SKIP_MOCKS_DEPLOY=1 npx hardhat test

You can also deploy mock contracts manually via the Hardhat task:

npx hardhat task:cofhe-mocks:deploy
npx hardhat task:cofhe-mocks:deploy --silent true          # suppress output

Or programmatically from a test or script:

import hre from 'hardhat';
 
await hre.cofhe.mocks.deployMocks();

Accessing mock contracts

hre.cofhe.mocks exposes typed accessors for the core mock contracts. Each method returns a fully typed Typechain contract instance:

import hre from 'hardhat';
 
const taskManager = await hre.cofhe.mocks.getMockTaskManager();
const acl = await hre.cofhe.mocks.getMockACL();
const thresholdNetwork = await hre.cofhe.mocks.getMockThresholdNetwork();
const zkVerifier = await hre.cofhe.mocks.getMockZkVerifier();
 
const simpleTestFactory = await hre.ethers.getContractFactory('SimpleTest');
const simpleTest = await simpleTestFactory.deploy();
await simpleTest.waitForDeployment();

Reading plaintext values

Because MockTaskManager stores plaintext values on-chain, you can read the underlying plaintext of any encrypted handle directly in tests — no permit needed.

`getPlaintext(ctHash)`

Returns the plaintext bigint for a given handle (ctHash in code):

import hre from 'hardhat';
import { expect } from 'chai';
 
const simpleTestFactory = await hre.ethers.getContractFactory('SimpleTest');
const simpleTest = await simpleTestFactory.deploy();
await simpleTest.waitForDeployment();
await simpleTest.setValueTrivial(7);
const ctHash = await simpleTest.getValueHash();
 
const plaintext = await hre.cofhe.mocks.getPlaintext(ctHash); 
 
expect(plaintext).to.equal(7n);

`expectPlaintext(ctHash, expectedValue)`

Assertion shorthand — wraps getPlaintext with a Chai expect:

import hre from 'hardhat';
 
const simpleTestFactory = await hre.ethers.getContractFactory('SimpleTest');
const simpleTest = await simpleTestFactory.deploy();
await simpleTest.waitForDeployment();
await simpleTest.setValueTrivial(7);
const ctHash = await simpleTest.getValueHash();
 
await hre.cofhe.mocks.expectPlaintext(ctHash, 7n);