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 offchain FHE engine.

What the mocks simulate

Contract	Role
`MockTaskManager`	Manages FHE operations; stores plaintext values onchain for testing
`MockACL`	Access control for encrypted handles
`MockZkVerifier`	Simulates ZK proof verification for encrypted inputs
`MockThresholdNetwork`	Handles decryption requests
`TestBed`	Helper contract for testing. Exposes trivial value setters and a `numberHash` getter

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

Mock contracts are deployed automatically before every npx hardhat test and npx hardhat node run. To skip auto-deployment:

COFHE_SKIP_MOCKS_DEPLOY=1 npx hardhat test

You only need COFHE_SKIP_MOCKS_DEPLOY=1 if your tests exclusively target an external RPC and don’t use the in-process Hardhat network at all.

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

npx hardhat task:cofhe-mocks:deploy
npx hardhat task:cofhe-mocks:deploy --deployTestBed false  # skip TestBed
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 each mock contract:

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 testBed = await hre.cofhe.mocks.getTestBed();

Reading plaintext values

Because MockTaskManager stores plaintext values onchain, you can read the underlying plaintext of any encrypted handle directly in tests, no ACP needed.

`getPlaintext(ctHash)`

Returns the plaintext bigint for a given ciphertext hash:

import hre from 'hardhat';
import { expect } from 'chai';

const testBed = await hre.cofhe.mocks.getTestBed();
await testBed.setNumberTrivial(7);
const ctHash = await testBed.numberHash();

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 testBed = await hre.cofhe.mocks.getTestBed();
await testBed.setNumberTrivial(7);
const ctHash = await testBed.numberHash();

await hre.cofhe.mocks.expectPlaintext(ctHash, 7n);

getPlaintext and expectPlaintext only work on the Hardhat network (where MockTaskManager stores plaintexts). They will throw on localcofhe or any real network.

Introduction

Quick Start

Guides

Hardhat Plugin

Foundry Plugin

Examples

Reference

What the mocks simulate

Auto-deployment

Accessing mock contracts

Reading plaintext values

`getPlaintext(ctHash)`

`expectPlaintext(ctHash, expectedValue)`

​What the mocks simulate

​Auto-deployment

​Accessing mock contracts

​Reading plaintext values

​getPlaintext(ctHash)

​expectPlaintext(ctHash, expectedValue)

What the mocks simulate

Auto-deployment

Accessing mock contracts

Reading plaintext values

`getPlaintext(ctHash)`

`expectPlaintext(ctHash, expectedValue)`