Skip to main content
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