@cofhe/hardhat-3-plugin 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @cofhe/hardhat-3-plugin
 
+## 0.6.0
+
+### Minor Changes
+
+- 566f126: Remove the legacy `TestBed` mock surface and stop auto-deploying `SimpleTest` through the Hardhat plugins. Core mock contracts still deploy automatically, while tests that need `SimpleTest` should deploy it explicitly from their own artifacts.
+
+  This also removes `TEST_BED_ADDRESS` and cleans up duplicate `SimpleTest` exports from `@cofhe/mock-contracts`.
+
+### Patch Changes
+
+- Updated dependencies [bf23270]
+- Updated dependencies [2711f9b]
+- Updated dependencies [566f126]
+  - @cofhe/sdk@0.6.0
+  - @cofhe/mock-contracts@0.6.0
+
+## 0.5.2
+
+### Patch Changes
+
+- Updated dependencies [2fbb918]
+  - @cofhe/sdk@0.5.2
+  - @cofhe/mock-contracts@0.5.2
+
 ## 0.5.1
 
 ### Patch Changes

package/README.md

@@ -1,10 +1,10 @@
 # @cofhe/hardhat-3-plugin
 
-A [Hardhat 3](https://hardhat.org) plugin for [CoFHE](https://docs.fhenix.io) development. It deploys the CoFHE mock contracts to an in-process Hardhat network on every `network.connect()` call and exposes a `cofhe` namespace on the connection object — ready to use immediately, no boilerplate required.
+A [Hardhat 3](https://hardhat.org) plugin for [CoFHE](https://docs.fhenix.io) development. It deploys the core CoFHE mock contracts to an in-process Hardhat network on every `network.connect()` call and exposes a `cofhe` namespace on the connection object — ready to use immediately, no boilerplate required.
 
 ## Features
 
-- Automatically deploys all CoFHE mock contracts (`MockTaskManager`, `MockACL`, `MockZkVerifier`, `MockThresholdNetwork`, `TestBed`) on every `network.connect()`
+- Automatically deploys the core CoFHE mock contracts (`MockTaskManager`, `MockACL`, `MockZkVerifier`, `MockThresholdNetwork`) on every `network.connect()`
 - Exposes `conn.cofhe` on the Hardhat 3 connection object (compatible with `@nomicfoundation/hardhat-viem`'s `conn.viem`)
 - Provides a batteries-included `cofhe.createClientWithBatteries()` for quick SDK client setup
 - Mock-specific helpers: plaintext inspection, logging control, and Viem contract descriptors for every mock
@@ -57,7 +57,7 @@ export default defineConfig({
 
 Every call to `network.connect()` automatically:
 
-1. Deploys all CoFHE mock contracts to the fresh in-process EVM
+1. Deploys the core CoFHE mock contracts to the fresh in-process EVM
 2. Attaches a `cofhe` namespace to the returned connection object
 
 Because `network.connect()` is awaitable at the top level of an `async describe`, you can set everything up without lifecycle hooks:
@@ -131,25 +131,21 @@ const client = await cofhe.createClientWithBatteries(walletClient);
 
 #### Contract descriptors
 
-Each mock contract is exposed as an `{ address, abi }` object that can be spread directly into Viem's `readContract` / `writeContract`:
+The core mock contracts are exposed as an `{ address, abi }` object that can be spread directly into Viem's `readContract` / `writeContract`:
 
 ```typescript
-// All mock contracts are synchronous { address, abi } descriptors:
+// Core mock contracts are synchronous { address, abi } descriptors:
 cofhe.mocks.MockTaskManager; // { address: `0x...`, abi: [...] }
 cofhe.mocks.MockACL; // { address: `0x...`, abi: [...] }
 cofhe.mocks.MockZkVerifier; // { address: `0x...`, abi: [...] }
 cofhe.mocks.MockThresholdNetwork; // { address: `0x...`, abi: [...] }
-cofhe.mocks.TestBed; // { address: `0x...`, abi: [...] }
 ```
 
+`SimpleTest` is not injected onto `cofhe.mocks`. If a test needs it, deploy it explicitly and bind it locally using its fixed address and ABI.
+
 Example — calling a mock directly with Viem:
 
 ```typescript
-const value = await publicClient.readContract({
-  ...cofhe.mocks.TestBed,
-  functionName: 'numberHash',
-});
-
 await walletClient.writeContract({
   ...cofhe.mocks.MockTaskManager,
   functionName: 'setSecurityZones',
@@ -190,34 +186,34 @@ await cofhe.mocks.withLogs('my test', async () => {
 
 #### `cofhe.mocks.deployMocks(options?)`
 
-Re-deploys all mock contracts. Normally you don't need to call this directly — mocks are deployed automatically on every `network.connect()`. This is available for advanced scenarios where you need to reset mock state mid-test.
+Re-deploys the core mock contracts. They are deployed automatically on every `network.connect()`.
 
 ```typescript
-await cofhe.mocks.deployMocks({ deployTestBed: true, silent: true });
+await cofhe.mocks.deployMocks({ gasWarning: false, mocksDeployVerbosity: '' });
 ```
 
-| Option          | Type      | Default         | Description                                      |
-| --------------- | --------- | --------------- | ------------------------------------------------ |
-| `deployTestBed` | `boolean` | `true`          | Whether to deploy the `TestBed` utility contract |
-| `gasWarning`    | `boolean` | inherits config | Print gas warning after deployment               |
-| `silent`        | `boolean` | `false`         | Suppress all deployment output                   |
+| Option                 | Type                | Default         | Description                          |
+| ---------------------- | ------------------- | --------------- | ------------------------------------ |
+| `gasWarning`           | `boolean`           | inherits config | Print gas warning after deployment   |
+| `mocksDeployVerbosity` | `'' \| 'v' \| 'vv'` | inherits config | Controls deployment output verbosity |
 
 ---
 
 ## Mock contracts
 
-The plugin deploys these contracts automatically on every `network.connect()`:
+The plugin deploys these core contracts automatically on every `network.connect()`:
 
-| Contract               | Address                                      | Description                                                           |
-| ---------------------- | -------------------------------------------- | --------------------------------------------------------------------- |
-| `MockTaskManager`      | `0xeA30c4B8b44078Bbf8a6ef5b9f1eC1626C7848D9` | Coordinates FHE operations and ACL                                    |
-| `MockACL`              | dynamic                                      | Access Control List — address resolved from TaskManager               |
-| `MockZkVerifier`       | `0x0000000000000000000000000000000000005001` | Verifies ZK proofs for encrypted inputs                               |
-| `MockThresholdNetwork` | `0x0000000000000000000000000000000000005002` | Simulates the threshold decryption network                            |
-| `TestBed`              | `0x0000000000000000000000000000000000005003` | Utility contract for storing and retrieving encrypted values in tests |
+| Contract               | Address                                      | Description                                             |
+| ---------------------- | -------------------------------------------- | ------------------------------------------------------- |
+| `MockTaskManager`      | `0xeA30c4B8b44078Bbf8a6ef5b9f1eC1626C7848D9` | Coordinates FHE operations and ACL                      |
+| `MockACL`              | dynamic                                      | Access Control List — address resolved from TaskManager |
+| `MockZkVerifier`       | `0x0000000000000000000000000000000000005001` | Verifies ZK proofs for encrypted inputs                 |
+| `MockThresholdNetwork` | `0x0000000000000000000000000000000000005002` | Simulates the threshold decryption network              |
 
 Fixed-address contracts are deployed via `hardhat_setCode`, ensuring they are always at the same address regardless of deployment order. `MockACL` is deployed as a normal contract (so its EIP-712 domain constructor runs correctly) and its address is registered in `MockTaskManager`.
 
+If a test needs `SimpleTest`, deploy it directly from its artifact rather than through `cofhe.mocks`.
+
 ---
 
 ## Complete test example
@@ -232,6 +228,15 @@ describe('Encrypted counter', async () => {
   const { viem, cofhe } = await network.connect();
   const publicClient = await viem.getPublicClient();
   const [walletClient] = await viem.getWalletClients();
+  const simpleTestArtifact = /* your compiled SimpleTest artifact */;
+  const deployHash = await walletClient.deployContract({
+    abi: simpleTestArtifact.abi,
+    bytecode: simpleTestArtifact.bytecode.object as `0x${string}`,
+  });
+  const deployReceipt = await publicClient.waitForTransactionReceipt({ hash: deployHash });
+  if (!deployReceipt.contractAddress) throw new Error('SimpleTest deployment failed');
+
+  const simpleTest = { address: deployReceipt.contractAddress, abi: simpleTestArtifact.abi } as const;
 
   it('encrypts, stores, and decrypts a uint32', async () => {
     const client = await cofhe.createClientWithBatteries(walletClient);
@@ -239,16 +244,16 @@ describe('Encrypted counter', async () => {
     // Encrypt
     const [enc] = await client.encryptInputs([Encryptable.uint32(42n)]).execute();
 
-    // Store on-chain via TestBed
+    // Store on-chain via SimpleTest
     await walletClient.writeContract({
-      ...cofhe.mocks.TestBed,
-      functionName: 'setNumber',
-      args: [{ ctHash: enc.ctHash, securityZone: enc.securityZone, utype: enc.utype, signature: enc.signature }],
+      ...simpleTest,
+      functionName: 'setValue',
+      args: [enc],
     });
 
     const ctHash = (await publicClient.readContract({
-      ...cofhe.mocks.TestBed,
-      functionName: 'numberHash',
+      ...simpleTest,
+      functionName: 'getValueHash',
     })) as `0x${string}`;
 
     // Decrypt via view (off-chain, instant)

package/dist/{chunk-WZRVFS4U.js → chunk-AAZRPK26.js}

@@ -2,15 +2,14 @@
 import { createTestClient, custom } from "viem";
 import chalk from "chalk";
 import { privateKeyToAccount } from "viem/accounts";
-import { MockTaskManagerArtifact, MockThresholdNetworkArtifact, TestBedArtifact } from "@cofhe/mock-contracts";
+import { MockTaskManagerArtifact, MockThresholdNetworkArtifact } from "@cofhe/mock-contracts";
 import {
   TASK_MANAGER_ADDRESS,
   MOCKS_ZK_VERIFIER_ADDRESS,
   MOCKS_ZK_VERIFIER_SIGNER_ADDRESS,
   MOCKS_ZK_VERIFIER_SIGNER_PRIVATE_KEY,
   MOCKS_DECRYPT_RESULT_SIGNER_PRIVATE_KEY,
-  MOCKS_THRESHOLD_NETWORK_ADDRESS,
-  TEST_BED_ADDRESS
+  MOCKS_THRESHOLD_NETWORK_ADDRESS
 } from "@cofhe/sdk";
 var verbosity = "v";
 async function isLocalHardhatNetwork(publicClient) {
@@ -22,7 +21,7 @@ async function isLocalHardhatNetwork(publicClient) {
   }
 }
 async function deployMocks(ctx, options = {}) {
-  const { deployTestBed = true, gasWarning = true } = options;
+  const { gasWarning = true } = options;
   verbosity = options.mocksDeployVerbosity ?? "v";
   if (!await isLocalHardhatNetwork(ctx.publicClient)) {
     log("v", `cofhe-hardhat-3-plugin - deploy mocks - skipped on non-hardhat network`, 0);
@@ -103,10 +102,6 @@ async function deployMocks(ctx, options = {}) {
     account,
     chain: null
   });
-  if (deployTestBed) {
-    await deployFixed(ctx.publicClient, "TestBed", TestBedArtifact.fixedAddress, ctx.artifacts);
-    logDeployment("TestBed", TestBedArtifact.fixedAddress);
-  }
   log("v", chalk.bold("cofhe-hardhat-3-plugin :: mocks deployed"), 0);
   if (gasWarning) {
     logEmpty("v");
@@ -120,8 +115,7 @@ async function deployMocks(ctx, options = {}) {
     MockTaskManager: TASK_MANAGER_ADDRESS,
     MockACL: aclAddress,
     MockZkVerifier: MOCKS_ZK_VERIFIER_ADDRESS,
-    MockThresholdNetwork: MOCKS_THRESHOLD_NETWORK_ADDRESS,
-    TestBed: deployTestBed ? TEST_BED_ADDRESS : void 0
+    MockThresholdNetwork: MOCKS_THRESHOLD_NETWORK_ADDRESS
   };
 }
 async function deployFixed(publicClient, contractName, fixedAddress, artifactManager) {

package/dist/{hre-44O4XM4I.js → hre-PG4EAJES.js}

@@ -3,7 +3,7 @@ import {
   getMockContractsNpmPaths,
   mock_expectPlaintext,
   mock_getPlaintext
-} from "./chunk-WZRVFS4U.js";
+} from "./chunk-AAZRPK26.js";
 import {
   mock_setLoggingEnabled,
   mock_withLogs
@@ -17,8 +17,7 @@ import {
   MockTaskManagerArtifact,
   MockACLArtifact,
   MockZkVerifierArtifact,
-  MockThresholdNetworkArtifact,
-  TestBedArtifact
+  MockThresholdNetworkArtifact
 } from "@cofhe/mock-contracts";
 import { MOCKS_ZK_VERIFIER_SIGNER_PRIVATE_KEY } from "@cofhe/sdk";
 import { createCofheConfig, createCofheClient } from "@cofhe/sdk/node";
@@ -92,8 +91,7 @@ function createCofheConnection(publicClient, walletClient, transport, artifacts,
       MockThresholdNetwork: {
         address: deployedMockContracts.MockThresholdNetwork,
         abi: MockThresholdNetworkArtifact.abi
-      },
-      TestBed: { address: deployedMockContracts.TestBed, abi: TestBedArtifact.abi }
+      }
     }
   };
 }
@@ -134,7 +132,6 @@ var hreHooks = {
         const deployedMockContracts = await deployMocks(
           { publicClient, walletClient, artifacts: hre.artifacts },
           {
-            deployTestBed: true,
             gasWarning: hre.config.cofhe.gasWarning,
             mocksDeployVerbosity: hre.config.cofhe.mocksDeployVerbosity
           }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { HardhatPlugin } from 'hardhat/types/plugins';
 import { PublicClient, WalletClient } from 'viem';
 import { CofheInputConfig, CofheConfig, CofheClient } from '@cofhe/sdk';
 import { ArtifactManager } from 'hardhat/types/artifacts';
-import { MockTaskManagerArtifact, MockACLArtifact, MockZkVerifierArtifact, MockThresholdNetworkArtifact, TestBedArtifact } from '@cofhe/mock-contracts';
+import { MockTaskManagerArtifact, MockACLArtifact, MockZkVerifierArtifact, MockThresholdNetworkArtifact } from '@cofhe/mock-contracts';
 
 /**
  * Controls deploy-mocks console output.
@@ -17,10 +17,8 @@ type DeployedMockContracts = {
     MockACL: `0x${string}`;
     MockZkVerifier: `0x${string}`;
     MockThresholdNetwork: `0x${string}`;
-    TestBed: `0x${string}` | undefined;
 };
 type DeployMocksArgs = {
-    deployTestBed?: boolean;
     gasWarning?: boolean;
     mocksDeployVerbosity?: LogMocksDeploy;
 };
@@ -78,11 +76,6 @@ interface CofheConnection {
             address: `0x${string}`;
             abi: typeof MockThresholdNetworkArtifact.abi;
         };
-        /** TestBed contract descriptor */
-        TestBed: {
-            address: `0x${string}`;
-            abi: typeof TestBedArtifact.abi;
-        };
     };
 }
 declare module 'hardhat/types/config' {
@@ -113,7 +106,8 @@ declare module 'hardhat/types/network' {
     interface NetworkConnection {
         /**
          * CoFHE mock environment — ready to use immediately after network.connect().
-         * Mock contracts are deployed automatically on every connect().
+         * Core mock contracts are deployed automatically on every connect().
+         * Contracts like SimpleTest should be deployed explicitly when a test needs them.
          */
         cofhe: CofheConnection;
     }

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   getMockContractsNpmPaths,
   mock_expectPlaintext,
   mock_getPlaintext
-} from "./chunk-WZRVFS4U.js";
+} from "./chunk-AAZRPK26.js";
 import {
   localcofheFundAccount,
   localcofheFundWalletIfNeeded
@@ -26,7 +26,7 @@ var plugin = {
   id: "@cofhe/hardhat-3-plugin",
   hookHandlers: {
     config: async () => import("./config-YK3LB5IH.js"),
-    hre: async () => import("./hre-44O4XM4I.js")
+    hre: async () => import("./hre-PG4EAJES.js")
   },
   tasks: [
     task(TASK_COFHE_USE_FAUCET, "Fund an account via the localcofhe faucet").addOption({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cofhe/hardhat-3-plugin",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Hardhat 3 plugin for CoFHE — deploys mock contracts and wires up the hre.cofhe interface",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,8 @@
   "dependencies": {
     "chalk": "4.1.2",
     "viem": "2.38.6",
-    "@cofhe/mock-contracts": "0.5.1",
-    "@cofhe/sdk": "0.5.1"
+    "@cofhe/mock-contracts": "0.6.0",
+    "@cofhe/sdk": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "20.19.15",

package/src/deploy.ts

@@ -4,7 +4,7 @@ import { createTestClient, custom } from 'viem';
 import chalk from 'chalk';
 import { privateKeyToAccount } from 'viem/accounts';
 
-import { MockTaskManagerArtifact, MockThresholdNetworkArtifact, TestBedArtifact } from '@cofhe/mock-contracts';
+import { MockTaskManagerArtifact, MockThresholdNetworkArtifact } from '@cofhe/mock-contracts';
 import {
   TASK_MANAGER_ADDRESS,
   MOCKS_ZK_VERIFIER_ADDRESS,
@@ -12,7 +12,6 @@ import {
   MOCKS_ZK_VERIFIER_SIGNER_PRIVATE_KEY,
   MOCKS_DECRYPT_RESULT_SIGNER_PRIVATE_KEY,
   MOCKS_THRESHOLD_NETWORK_ADDRESS,
-  TEST_BED_ADDRESS,
 } from '@cofhe/sdk';
 
 /**
@@ -29,11 +28,9 @@ export type DeployedMockContracts = {
   MockACL: `0x${string}`;
   MockZkVerifier: `0x${string}`;
   MockThresholdNetwork: `0x${string}`;
-  TestBed: `0x${string}` | undefined;
 };
 
 export type DeployMocksArgs = {
-  deployTestBed?: boolean;
   gasWarning?: boolean;
   mocksDeployVerbosity?: LogMocksDeploy;
 };
@@ -62,7 +59,7 @@ async function isLocalHardhatNetwork(publicClient: PublicClient): Promise<boolea
 }
 
 export async function deployMocks(ctx: DeployContext, options: DeployMocksArgs = {}): Promise<DeployedMockContracts> {
-  const { deployTestBed = true, gasWarning = true } = options;
+  const { gasWarning = true } = options;
   verbosity = options.mocksDeployVerbosity ?? 'v';
 
   if (!(await isLocalHardhatNetwork(ctx.publicClient))) {
@@ -167,12 +164,6 @@ export async function deployMocks(ctx: DeployContext, options: DeployMocksArgs =
     chain: null,
   });
 
-  // 11. Optionally deploy TestBed
-  if (deployTestBed) {
-    await deployFixed(ctx.publicClient, 'TestBed', TestBedArtifact.fixedAddress, ctx.artifacts);
-    logDeployment('TestBed', TestBedArtifact.fixedAddress);
-  }
-
   log('v', chalk.bold('cofhe-hardhat-3-plugin :: mocks deployed'), 0);
 
   if (gasWarning) {
@@ -192,7 +183,6 @@ export async function deployMocks(ctx: DeployContext, options: DeployMocksArgs =
     MockACL: aclAddress,
     MockZkVerifier: MOCKS_ZK_VERIFIER_ADDRESS,
     MockThresholdNetwork: MOCKS_THRESHOLD_NETWORK_ADDRESS,
-    TestBed: deployTestBed ? TEST_BED_ADDRESS : undefined,
   };
 }
 

package/src/hooks/hre.ts

@@ -11,7 +11,6 @@ import {
   MockACLArtifact,
   MockZkVerifierArtifact,
   MockThresholdNetworkArtifact,
-  TestBedArtifact,
 } from '@cofhe/mock-contracts';
 import { MOCKS_ZK_VERIFIER_SIGNER_PRIVATE_KEY, type CofheInputConfig } from '@cofhe/sdk';
 import { createCofheConfig, createCofheClient } from '@cofhe/sdk/node';
@@ -113,7 +112,6 @@ function createCofheConnection(
         address: deployedMockContracts.MockThresholdNetwork,
         abi: MockThresholdNetworkArtifact.abi,
       },
-      TestBed: { address: deployedMockContracts.TestBed!, abi: TestBedArtifact.abi },
     },
   };
 }
@@ -173,7 +171,6 @@ const hreHooks: Partial<HardhatRuntimeEnvironmentHooks> = {
         const deployedMockContracts = await deployMocks(
           { publicClient, walletClient, artifacts: hre.artifacts },
           {
-            deployTestBed: true,
             gasWarning: hre.config.cofhe.gasWarning,
             mocksDeployVerbosity: hre.config.cofhe.mocksDeployVerbosity,
           }

package/src/type-extensions.ts

@@ -6,7 +6,6 @@ import type {
   MockACLArtifact,
   MockZkVerifierArtifact,
   MockThresholdNetworkArtifact,
-  TestBedArtifact,
 } from '@cofhe/mock-contracts';
 
 import 'hardhat/types/network';
@@ -60,9 +59,6 @@ export interface CofheConnection {
 
     /** MockThresholdNetwork contract descriptor */
     MockThresholdNetwork: { address: `0x${string}`; abi: typeof MockThresholdNetworkArtifact.abi };
-
-    /** TestBed contract descriptor */
-    TestBed: { address: `0x${string}`; abi: typeof TestBedArtifact.abi };
   };
 }
 
@@ -100,7 +96,8 @@ declare module 'hardhat/types/network' {
   interface NetworkConnection {
     /**
      * CoFHE mock environment — ready to use immediately after network.connect().
-     * Mock contracts are deployed automatically on every connect().
+     * Core mock contracts are deployed automatically on every connect().
+     * Contracts like SimpleTest should be deployed explicitly when a test needs them.
      */
     cofhe: CofheConnection;
   }