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.

The mock contracts log every FHE operation to the console. This makes it easy to inspect what your contracts are doing under the hood during tests.

​
What gets logged

Each FHE operation emits a formatted log entry showing the operation name, the input and output operand hashes (truncated), and the security zone: 
┌──────────────────┬──────────────────────────────────────────────────
│ [COFHE-MOCKS]    │ "counter.increment()" logs:
├──────────────────┴──────────────────────────────────────────────────
├ FHE.add          | euint32(4473..3424)[0] + euint32(1157..3648)[1]  =>  euint32(1106..1872)[1]
├ FHE.allowThis    | euint32(1106..1872)[1] -> 0x663f..6602
├ FHE.allow        | euint32(1106..1872)[1] -> 0x3c44..93bc
└─────────────────────────────────────────────────────────────────────
Wraps a block of code with logging enabled and prints a labeled box around the output. The name appears as the header so you can identify which call produced which operations. 
import hre from 'hardhat';

await hre.cofhe.mocks.withLogs('counter.increment()', async () => {
  await counter.increment();
});
withLogs enables logging before the closure runs and disables it after, so only operations from within that block appear in the output.

​
enableLogs() / disableLogs() — manual

For finer-grained control, you can enable and disable logging manually: 
import hre from 'hardhat';

await hre.cofhe.mocks.enableLogs('counter.increment()');

await counter.increment();

await hre.cofhe.mocks.disableLogs();
enableLogs accepts an optional label string. If provided, it prints a labeled header immediately — useful when you want to mark a section of output at a known point.

​
Default logging behavior

Logging is enabled by default. You can turn it off globally in your Hardhat config:
hardhat.config.ts
import '@cofhe/hardhat-plugin';

export default {
  solidity: '0.8.28',
  cofhe: {
    logMocks: false, // disable FHE op logs globally
  },
};
You can also toggle logging for a specific test run using the Hardhat task: 
npx hardhat task:cofhe-mocks:setlogops --enable true
npx hardhat task:cofhe-mocks:setlogops --enable false