@paimaexample/evm-contracts 0.3.104 → 0.3.106

package/README.md

@@ -5,3 +5,265 @@ NPM package for EVM contracts for EffectStream and related utilities.
 See
 [the Paima documentation](https://docs.paimastudios.com/home/libraries/evm-contracts/introduction)
 for full documentation.
+
+# Hardhat Config Builder
+
+This package also provides a unified Hardhat configuration builder that consolidates common Hardhat setup logic used across e2e tests and templates.
+
+## Overview
+
+The unified config builder provides three main functions:
+
+1. **`createHardhatConfig()`** - Creates a complete Hardhat configuration with automatic default networks
+2. **`createNodeTasks()`** - Creates custom Hardhat tasks for running local blockchain nodes
+3. **`initTelemetry()`** - Initializes OpenTelemetry for Hardhat
+
+**Key Features:**
+- **Automatic Default Networks**: Default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`) are included when `networks` is not specified.
+- **Centralized Configuration**: All common Hardhat setup logic in one place
+- **Type Safe**: Full TypeScript support with proper types
+- **Flexible**: Supports both `@effectstream` and `@paimaexample` package namespaces
+
+**Additional Utilities:**
+- **`createDefaultNetworks()`** - Helper function to create default network configurations
+
+## Usage
+
+### Basic Example
+
+```typescript
+import type { HardhatUserConfig } from "hardhat/config";
+import {
+  createHardhatConfig,
+  createNodeTasks,
+  initTelemetry,
+} from "@effectstream/evm-hardhat/hardhat-config-builder";
+// or for templates:
+// } from "@paimaexample/evm-hardhat/hardhat-config-builder";
+
+import {
+  JsonRpcServerImplementation,
+} from "@effectstream/evm-hardhat/json-rpc-server";
+// or for templates:
+// } from "@paimaexample/evm-hardhat/json-rpc-server";
+
+import fs from "node:fs";
+import waitOn from "wait-on";
+import {
+  ComponentNames,
+  log,
+  SeverityNumber,
+} from "@effectstream/log";
+// or for templates:
+// } from "@paimaexample/log";
+
+const __dirname = import.meta.dirname;
+
+// Initialize telemetry (optional)
+// Note: logPackage parameter is kept for backward compatibility but ignored
+initTelemetry("@effectstream/log", "./deno.json");
+// or for templates:
+// initTelemetry("@paimaexample/log", "./deno.json");
+
+// Create node tasks (optional, only if you need local node functionality)
+const nodeTasks = createNodeTasks({
+  JsonRpcServer: {} as unknown as never, // Type placeholder, optional and not used
+  JsonRpcServerImplementation,
+  ComponentNames,
+  log,
+  SeverityNumber,
+  waitOn,
+  fs,
+});
+
+// Create unified config with default networks
+const config: HardhatUserConfig = createHardhatConfig({
+  sourcesDir: `${__dirname}/src/contracts`,
+  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
+  cacheDir: `${__dirname}/build/cache/hardhat`,
+  // Default networks (evmMain, evmMainHttp, evmParallel, evmParallelHttp) are used automatically
+  tasks: nodeTasks, // Optional: only include if you created node tasks
+  solidityVersion: "0.8.30", // Optional: defaults to "0.8.30"
+});
+
+export default config;
+```
+
+## API Reference
+
+### `createDefaultNetworks(options?: DefaultNetworkOptions): Record<string, NetworkConfig>`
+
+Creates default network configurations commonly used in e2e tests and templates. This function is used by `createHardhatConfig()` when default networks are enabled, but can also be called directly if you need to create networks separately or customize them.
+
+#### When to Use
+
+- **Directly**: When you want to create default networks and pass them explicitly to `createHardhatConfig()`
+- **Internally**: Automatically called by `createHardhatConfig()` when `networks` is not provided (default behavior)
+- **Customization**: Use with `defaultNetworkOptions` in `createHardhatConfig()` to customize default network parameters
+
+#### Parameters
+
+- `options.evmMainPort` (optional): Base port for evmMain (defaults to `8545`)
+- `options.evmParallelPort` (optional): Base port for evmParallel (defaults to `8546`)
+- `options.evmMainChainId` (optional): Chain ID for evmMain (defaults to `31337`)
+- `options.evmParallelChainId` (optional): Chain ID for evmParallel (defaults to `31338`)
+- `options.evmMainInterval` (optional): Mining interval for evmMain in ms (defaults to `250`)
+- `options.evmParallelInterval` (optional): Mining interval for evmParallel in ms (defaults to `1000`)
+
+#### Returns
+
+A network configuration object with:
+- `evmMain`: Fast network (250ms block interval) on chainId 31337, port 8545
+- `evmMainHttp`: HTTP wrapper for evmMain (used by Hardhat Ignition for deployments)
+- `evmParallel`: Slower network (1s block interval) on chainId 31338, port 8546
+- `evmParallelHttp`: HTTP wrapper for evmParallel (used by Hardhat Ignition for deployments)
+
+#### Example
+
+```typescript
+import { createDefaultNetworks } from "@effectstream/evm-contracts";
+
+// Create default networks with custom ports
+const networks = createDefaultNetworks({
+  evmMainPort: 8545,
+  evmParallelPort: 8546,
+  evmMainInterval: 500, // Slower than default
+});
+
+// Use in createHardhatConfig
+const config = createHardhatConfig({
+  sourcesDir: `${__dirname}/src/contracts`,
+  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
+  cacheDir: `${__dirname}/build/cache/hardhat`,
+  networks, // Explicitly pass networks
+  useDefaultNetworks: false, // Disable auto-creation since we're passing networks
+});
+```
+
+### `createHardhatConfig(options: HardhatConfigOptions): HardhatUserConfig`
+
+Creates a unified Hardhat configuration.
+
+#### Parameters
+
+- `options.sourcesDir` (required): Directory containing contract sources
+- `options.artifactsDir` (required): Directory for compiled artifacts
+- `options.cacheDir` (required): Directory for Hardhat cache
+- `options.networks` (optional): Networks configuration object. **If not provided, default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`) will be automatically used**
+- `options.useDefaultNetworks` (optional): Whether to use default networks (defaults to `true` if `networks` is not provided)
+- `options.defaultNetworkOptions` (optional): Options for customizing default networks (only used if `useDefaultNetworks` is `true`)
+- `options.tasks` (optional): Custom Hardhat tasks (e.g., from `createNodeTasks()`)
+- `options.solidityVersion` (optional): Solidity compiler version (defaults to `"0.8.30"`)
+
+#### Returns
+
+A complete `HardhatUserConfig` object ready to export.
+**Note:** The config will automatically include the default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`) when `networks` is not provided.
+
+### `createNodeTasks(deps: NodeTaskDependencies): HardhatUserConfig["tasks"]`
+
+Creates custom Hardhat tasks for running local blockchain nodes. These tasks enable:
+- Starting JSON-RPC servers for configured networks (`hardhat node`)
+- Waiting for servers to be ready (`hardhat node:wait`)
+
+#### Parameters
+
+- `deps.JsonRpcServer` (optional): Type placeholder, not actually used (kept for type compatibility). Can be omitted or set to `{} as unknown as never`
+- `deps.JsonRpcServerImplementation` (required): The JsonRpcServerImplementation class from `@effectstream/evm-hardhat/json-rpc-server` or `@paimaexample/evm-hardhat/json-rpc-server`
+- `deps.ComponentNames` (required): Component names from the log package
+- `deps.log` (required): Log utilities from the log package
+- `deps.SeverityNumber` (required): Severity number constants from the log package
+- `deps.waitOn` (required): The `wait-on` module for waiting on ports
+- `deps.fs` (required): Node.js `fs` module for checking Docker environment
+
+#### Returns
+
+An array of Hardhat tasks that can be passed to `createHardhatConfig()`.
+
+### `initTelemetry(logPackage: string, denoJsonPath?: string): void`
+
+Initializes OpenTelemetry for Hardhat. This should be called at the top level of your `hardhat.config.ts` file.
+
+#### Parameters
+
+- `logPackage` (required but ignored): Package name for log utilities - kept for backward compatibility but no longer used (uses static import instead)
+- `denoJsonPath` (optional): Path to `deno.json` file for version detection (defaults to `"./deno.json"`)
+
+## Package Names
+
+The unified config builder supports both package naming conventions:
+
+- **E2E tests**: Use `@effectstream/evm-hardhat/hardhat-config-builder`, `@effectstream/evm-hardhat/json-rpc-server`, `@effectstream/log`
+- **Templates**: Use `@paimaexample/evm-hardhat/hardhat-config-builder`, `@paimaexample/evm-hardhat/json-rpc-server`, `@paimaexample/log`
+
+Note: The functions are now exported from `evm-hardhat` package. The `evm-contracts` package re-exports them for backward compatibility, but new code should import directly from `evm-hardhat`.
+
+## Benefits
+
+1. **Centralized Configuration**: All common Hardhat setup logic in one place
+2. **Easier Maintenance**: Updates to Hardhat setup only need to be made once
+3. **Consistency**: All e2e tests and templates use the same configuration logic
+4. **Flexibility**: Still allows customization through parameters
+5. **Type Safety**: Full TypeScript support with proper types
+
+### Customizing Default Networks
+
+You can customize the default networks by passing `defaultNetworkOptions`:
+
+```typescript
+const config: HardhatUserConfig = createHardhatConfig({
+  sourcesDir: `${__dirname}/src/contracts`,
+  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
+  cacheDir: `${__dirname}/build/cache/hardhat`,
+  defaultNetworkOptions: {
+    evmMainInterval: 500, // Customize main network interval
+    evmMainPort: 8545, // Customize port (defaults to 8545)
+    evmParallelPort: 8546, // Customize port (defaults to 8546)
+  },
+  tasks: nodeTasks,
+  solidityVersion: "0.8.30",
+});
+```
+
+### Using Custom Networks
+
+If you want to provide completely custom networks instead of using defaults:
+
+```typescript
+const customNetworks = {
+  myCustomNetwork: {
+    type: "edr-simulated",
+    chainType: "l1",
+    chainId: 1337,
+    // ... custom config
+  },
+};
+
+const config: HardhatUserConfig = createHardhatConfig({
+  sourcesDir: `${__dirname}/src/contracts`,
+  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
+  cacheDir: `${__dirname}/build/cache/hardhat`,
+  networks: customNetworks,
+  useDefaultNetworks: false, // Disable default networks
+  tasks: nodeTasks,
+  solidityVersion: "0.8.30",
+});
+```
+
+## Migration Guide
+
+If you have an existing `hardhat.config.ts` file, follow these steps:
+
+1. Import the unified builder functions
+2. Replace your custom `initTelemetry()` function with `initTelemetry()` from the builder
+3. Replace your custom node tasks with `createNodeTasks()`
+4. Remove the network definitions (they're now provided by default)
+5. Replace your config object with `createHardhatConfig()` (without the `networks` parameter)
+6. Remove duplicate code (network list helpers, task definitions, etc.)
+
+See the examples in `e2e/shared/contracts/evm/hardhat.config.ts` and the template configs for reference implementations.
+
+## See Also
+
+- [Hardhat Documentation](https://hardhat.org/docs)
+- [Paima Engine Documentation](https://docs.paimastudios.com)

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@paimaexample/evm-contracts",
-  "version": "0.3.104",
+  "version": "0.3.106",
   "license": "MIT",
   "exports": {
     ".": "./mod.ts"

package/mod.ts

@@ -6,7 +6,7 @@ export {
   type HardhatConfigOptions,
   type DefaultNetworkOptions,
   type NodeTaskDependencies,
-} from "./src/hardhatConfigBuilder.ts";
+} from "@paimaexample/evm-hardhat/hardhat-config-builder";
 
 export { defaultHardhatConfig } from "./src/recommendedHardhat.ts";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paimaexample/evm-contracts",
-  "version": "0.3.104",
+  "version": "0.3.106",
   "description": "Effectstream EVM default contracts.",
   "main": "index.js",
   "author": "Paima Studios",

package/HARDHAT_CONFIG_BUILDER.md

@@ -1,262 +0,0 @@
-# Hardhat Config Builder
-
-This package provides a unified Hardhat configuration builder that consolidates common Hardhat setup logic used across e2e tests and templates. This eliminates code duplication and centralizes maintenance.
-
-## Overview
-
-The unified config builder provides three main functions:
-
-1. **`createHardhatConfig()`** - Creates a complete Hardhat configuration with automatic default networks
-2. **`createNodeTasks()`** - Creates custom Hardhat tasks for running local blockchain nodes
-3. **`initTelemetry()`** - Initializes OpenTelemetry for Hardhat
-
-**Key Features:**
-- **Automatic Default Networks**: If you don't specify `networks`, default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`) are automatically included
-- **Centralized Configuration**: All common Hardhat setup logic in one place
-- **Type Safe**: Full TypeScript support with proper types
-- **Flexible**: Supports both `@effectstream` and `@paimaexample` package namespaces
-
-**Additional Utilities:**
-- **`createDefaultNetworks()`** - Helper function to create default network configurations (used internally by `createHardhatConfig()`)
-
-## Usage
-
-### Basic Example
-
-```typescript
-import type { HardhatUserConfig } from "hardhat/config";
-import {
-  createHardhatConfig,
-  createNodeTasks,
-  initTelemetry,
-} from "@effectstream/evm-contracts";
-// or for templates:
-// } from "@paimaexample/evm-contracts";
-
-import {
-  JsonRpcServerImplementation,
-} from "@effectstream/evm-hardhat/json-rpc-server";
-// or for templates:
-// } from "@paimaexample/evm-hardhat/json-rpc-server";
-
-import fs from "node:fs";
-import waitOn from "wait-on";
-import {
-  ComponentNames,
-  log,
-  SeverityNumber,
-} from "@effectstream/log";
-// or for templates:
-// } from "@paimaexample/log";
-
-const __dirname = import.meta.dirname;
-
-// Initialize telemetry (optional)
-initTelemetry("@effectstream/log", "./deno.json");
-// or for templates:
-// initTelemetry("@paimaexample/log", "./deno.json");
-
-// Create node tasks (optional, only if you need local node functionality)
-const nodeTasks = createNodeTasks({
-  JsonRpcServer: {} as unknown as never, // Type placeholder, optional and not used
-  JsonRpcServerImplementation,
-  ComponentNames,
-  log,
-  SeverityNumber,
-  waitOn,
-  fs,
-});
-
-// Create unified config with default networks
-const config: HardhatUserConfig = createHardhatConfig({
-  sourcesDir: `${__dirname}/src/contracts`,
-  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
-  cacheDir: `${__dirname}/build/cache/hardhat`,
-  // Default networks (evmMain, evmMainHttp, evmParallel, evmParallelHttp) are used automatically
-  tasks: nodeTasks, // Optional: only include if you created node tasks
-  solidityVersion: "0.8.30", // Optional: defaults to "0.8.30"
-});
-
-export default config;
-```
-
-## API Reference
-
-### `createDefaultNetworks(options?: DefaultNetworkOptions): Record<string, NetworkConfig>`
-
-Creates default network configurations commonly used in e2e tests and templates. This function is used internally by `createHardhatConfig()` when default networks are enabled, but can also be called directly if you need to create networks separately or customize them.
-
-#### When to Use
-
-- **Directly**: When you want to create default networks and pass them explicitly to `createHardhatConfig()`
-- **Internally**: Automatically called by `createHardhatConfig()` when `networks` is not provided (default behavior)
-- **Customization**: Use with `defaultNetworkOptions` in `createHardhatConfig()` to customize default network parameters
-
-#### Parameters
-
-- `options.evmMainPort` (optional): Base port for evmMain (defaults to `8545`)
-- `options.evmParallelPort` (optional): Base port for evmParallel (defaults to `8546`)
-- `options.evmMainChainId` (optional): Chain ID for evmMain (defaults to `31337`)
-- `options.evmParallelChainId` (optional): Chain ID for evmParallel (defaults to `31338`)
-- `options.evmMainInterval` (optional): Mining interval for evmMain in ms (defaults to `250`)
-- `options.evmParallelInterval` (optional): Mining interval for evmParallel in ms (defaults to `1000`)
-
-#### Returns
-
-A network configuration object with:
-- `evmMain`: Fast network (250ms block interval) on chainId 31337, port 8545
-- `evmMainHttp`: HTTP wrapper for evmMain (used by Hardhat Ignition for deployments)
-- `evmParallel`: Slower network (1s block interval) on chainId 31338, port 8546
-- `evmParallelHttp`: HTTP wrapper for evmParallel (used by Hardhat Ignition for deployments)
-
-#### Example
-
-```typescript
-import { createDefaultNetworks } from "@effectstream/evm-contracts";
-
-// Create default networks with custom ports
-const networks = createDefaultNetworks({
-  evmMainPort: 8545,
-  evmParallelPort: 8546,
-  evmMainInterval: 500, // Slower than default
-});
-
-// Use in createHardhatConfig
-const config = createHardhatConfig({
-  sourcesDir: `${__dirname}/src/contracts`,
-  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
-  cacheDir: `${__dirname}/build/cache/hardhat`,
-  networks, // Explicitly pass networks
-  useDefaultNetworks: false, // Disable auto-creation since we're passing networks
-});
-```
-
-### `createHardhatConfig(options: HardhatConfigOptions): HardhatUserConfig`
-
-Creates a unified Hardhat configuration.
-
-#### Parameters
-
-- `options.sourcesDir` (required): Directory containing contract sources
-- `options.artifactsDir` (required): Directory for compiled artifacts
-- `options.cacheDir` (required): Directory for Hardhat cache
-- `options.networks` (optional): Networks configuration object. **If not provided, default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`) will be automatically used**
-- `options.useDefaultNetworks` (optional): Whether to use default networks (defaults to `true` if `networks` is not provided)
-- `options.defaultNetworkOptions` (optional): Options for customizing default networks (only used if `useDefaultNetworks` is `true`)
-- `options.tasks` (optional): Custom Hardhat tasks (e.g., from `createNodeTasks()`)
-- `options.solidityVersion` (optional): Solidity compiler version (defaults to `"0.8.30"`)
-
-#### Returns
-
-A complete `HardhatUserConfig` object ready to export.
-
-**Note:** By default, if you don't provide `networks`, the config will automatically include the default networks (`evmMain`, `evmMainHttp`, `evmParallel`, `evmParallelHttp`). This eliminates the need to define networks manually in most cases.
-
-### `createNodeTasks(deps: NodeTaskDependencies): HardhatUserConfig["tasks"]`
-
-Creates custom Hardhat tasks for running local blockchain nodes. These tasks enable:
-- Starting JSON-RPC servers for configured networks (`hardhat node`)
-- Waiting for servers to be ready (`hardhat node:wait`)
-
-#### Parameters
-
-- `deps.JsonRpcServer` (optional): Type placeholder, not actually used (kept for type compatibility). Can be omitted or set to `{} as unknown as never`
-- `deps.JsonRpcServerImplementation` (required): The JsonRpcServerImplementation class from `@effectstream/evm-hardhat/json-rpc-server` or `@paimaexample/evm-hardhat/json-rpc-server`
-- `deps.ComponentNames` (required): Component names from the log package
-- `deps.log` (required): Log utilities from the log package
-- `deps.SeverityNumber` (required): Severity number constants from the log package
-- `deps.waitOn` (required): The `wait-on` module for waiting on ports
-- `deps.fs` (required): Node.js `fs` module for checking Docker environment
-
-#### Returns
-
-An array of Hardhat tasks that can be passed to `createHardhatConfig()`.
-
-### `initTelemetry(logPackage: string, denoJsonPath?: string): void`
-
-Initializes OpenTelemetry for Hardhat. This should be called at the top level of your `hardhat.config.ts` file.
-
-#### Parameters
-
-- `logPackage` (required): Package name for log utilities (e.g., `"@effectstream/log"` or `"@paimaexample/log"`)
-- `denoJsonPath` (optional): Path to `deno.json` file for version detection (defaults to `"./deno.json"`)
-
-## Package Names
-
-The unified config builder supports both package naming conventions:
-
-- **E2E tests**: Use `@effectstream/evm-contracts`, `@effectstream/evm-hardhat`, `@effectstream/log`
-- **Templates**: Use `@paimaexample/evm-contracts`, `@paimaexample/evm-hardhat`, `@paimaexample/log`
-
-The functions work identically regardless of which package namespace you use.
-
-## Benefits
-
-1. **Eliminates Duplication**: Common Hardhat configuration logic is centralized in one place
-2. **Easier Maintenance**: Updates to Hardhat setup only need to be made once
-3. **Consistency**: All e2e tests and templates use the same configuration logic
-4. **Flexibility**: Still allows customization through parameters
-5. **Type Safety**: Full TypeScript support with proper types
-
-### Customizing Default Networks
-
-You can customize the default networks by passing `defaultNetworkOptions`:
-
-```typescript
-const config: HardhatUserConfig = createHardhatConfig({
-  sourcesDir: `${__dirname}/src/contracts`,
-  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
-  cacheDir: `${__dirname}/build/cache/hardhat`,
-  defaultNetworkOptions: {
-    evmMainInterval: 500, // Customize main network interval
-    evmMainPort: 8545, // Customize port (defaults to 8545)
-    evmParallelPort: 8546, // Customize port (defaults to 8546)
-  },
-  tasks: nodeTasks,
-  solidityVersion: "0.8.30",
-});
-```
-
-### Using Custom Networks
-
-If you want to provide completely custom networks instead of using defaults:
-
-```typescript
-const customNetworks = {
-  myCustomNetwork: {
-    type: "edr-simulated",
-    chainType: "l1",
-    chainId: 1337,
-    // ... custom config
-  },
-};
-
-const config: HardhatUserConfig = createHardhatConfig({
-  sourcesDir: `${__dirname}/src/contracts`,
-  artifactsDir: `${__dirname}/build/artifacts/hardhat`,
-  cacheDir: `${__dirname}/build/cache/hardhat`,
-  networks: customNetworks,
-  useDefaultNetworks: false, // Disable default networks
-  tasks: nodeTasks,
-  solidityVersion: "0.8.30",
-});
-```
-
-## Migration Guide
-
-If you have an existing `hardhat.config.ts` file, follow these steps:
-
-1. Import the unified builder functions
-2. Replace your custom `initTelemetry()` function with `initTelemetry()` from the builder
-3. Replace your custom node tasks with `createNodeTasks()`
-4. Remove the network definitions (they're now provided by default)
-5. Replace your config object with `createHardhatConfig()` (without the `networks` parameter)
-6. Remove duplicate code (network list helpers, task definitions, etc.)
-
-See the examples in `e2e/shared/contracts/evm/hardhat.config.ts` and the template configs for reference implementations.
-
-## See Also
-
-- [Hardhat Documentation](https://hardhat.org/docs)
-- [Paima Engine Documentation](https://docs.paimastudios.com)
-

package/src/hardhatConfigBuilder.ts

@@ -1,398 +0,0 @@
-import type { HardhatUserConfig } from "hardhat/config";
-import type { NetworkConfig, TaskArguments } from "hardhat/types";
-import type { HardhatRuntimeEnvironment } from "hardhat/types";
-import HardhatViem from "@nomicfoundation/hardhat-viem";
-import { overrideTask, task } from "hardhat/config";
-import { ArgumentType } from "hardhat/types/arguments";
-import HardhatIgnitionViem from "@nomicfoundation/hardhat-ignition-viem";
-
-/**
- * Dependencies required for creating node tasks.
- * These should be imported in the calling code and passed to createNodeTasks.
- */
-export interface NodeTaskDependencies {
-  /** JsonRpcServer type placeholder (not actually used, kept for type compatibility) */
-  JsonRpcServer?: unknown;
-  /** JsonRpcServerImplementation from evm-hardhat package */
-  JsonRpcServerImplementation: new (
-    options: { hostname: string; port: number; provider: any },
-    logCallback: (msg: string) => void,
-  ) => any;
-  /** Log utilities from log package */
-  ComponentNames: { HARDHAT: string };
-  log: {
-    remote: (
-      component: string,
-      tags: string[],
-      severity: number,
-      fn: (log: (...args: unknown[]) => void) => void,
-    ) => void;
-  };
-  SeverityNumber: { INFO: number };
-  /** wait-on module for waiting on ports */
-  waitOn: (options: { resources: string[] }) => Promise<void>;
-  /** fs module for checking Docker environment */
-  fs: { existsSync: (path: string) => boolean };
-}
-
-/**
- * Options for creating default networks
- */
-export interface DefaultNetworkOptions {
-  /** Base port for evmMain (defaults to 8545) */
-  evmMainPort?: number;
-  /** Base port for evmParallel (defaults to 8546) */
-  evmParallelPort?: number;
-  /** Chain ID for evmMain (defaults to 31337) */
-  evmMainChainId?: number;
-  /** Chain ID for evmParallel (defaults to 31338) */
-  evmParallelChainId?: number;
-  /** Mining interval for evmMain in ms (defaults to 250) */
-  evmMainInterval?: number;
-  /** Mining interval for evmParallel in ms (defaults to 1000) */
-  evmParallelInterval?: number;
-}
-
-/**
- * Configuration options for creating a Hardhat config
- */
-export interface HardhatConfigOptions {
-  /** Directory containing contract sources */
-  sourcesDir: string;
-  /** Directory for compiled artifacts */
-  artifactsDir: string;
-  /** Directory for Hardhat cache */
-  cacheDir: string;
-  /** Networks configuration - if not provided, default networks will be used */
-  networks?: Record<string, NetworkConfig>;
-  /** Whether to use default networks (defaults to true if networks is not provided) */
-  useDefaultNetworks?: boolean;
-  /** Options for default networks (only used if useDefaultNetworks is true) */
-  defaultNetworkOptions?: DefaultNetworkOptions;
-  /** Custom Hardhat tasks (e.g., from createNodeTasks) */
-  tasks?: HardhatUserConfig["tasks"];
-  /** Solidity compiler version */
-  solidityVersion?: string;
-}
-
-/**
- * Creates node tasks for running local blockchain nodes.
- * These tasks allow starting JSON-RPC servers for configured networks.
- * 
- * @param deps Dependencies required for the tasks (imported in calling code)
- * @returns Array of Hardhat tasks (node and node:wait)
- */
-export function createNodeTasks(
-  deps: NodeTaskDependencies,
-): HardhatUserConfig["tasks"] {
-  const {
-    JsonRpcServerImplementation,
-    ComponentNames,
-    log,
-    SeverityNumber,
-    waitOn,
-    fs,
-  } = deps;
-
-  function logNetwork(networkName: string, ...msg: unknown[]) {
-    log.remote(
-      ComponentNames.HARDHAT,
-      [networkName],
-      SeverityNumber.INFO,
-      (logFn) => logFn(...msg),
-    );
-  }
-
-  function getNetworkList(networks: Record<string, NetworkConfig>) {
-    const networkEntries = Object.entries(networks);
-    // ensure we always run the `hardhat` network first
-    networkEntries.sort((a, b) => {
-      if (a[0] === "hardhat") return -1;
-      if (b[0] === "hardhat") return 1;
-      return 0;
-    });
-
-    return networkEntries.filter(([name, network]) =>
-      // skip the builtin localhost network, since hardhat node is meant to explicitly not use it
-      name !== "localhost" &&
-      // hardhat network seems broken and the block number never advances on it
-      name !== "hardhat" &&
-      // if http type, then it already has a JSON-RPC server
-      network.type !== "http"
-    );
-  }
-
-  const nodeTask = overrideTask("node")
-    .setAction(async () => ({
-      default: async (
-        args: TaskArguments,
-        hre: HardhatRuntimeEnvironment,
-      ): Promise<void> => {
-        const hostname = (() => {
-          if (args.hostname !== "127.0.0.1" && args.hostname !== "") {
-            return args.hostname as string;
-          }
-          const insideDocker = fs.existsSync("/.dockerenv");
-          return insideDocker ? "0.0.0.0" : "127.0.0.1";
-        })();
-        let port = args.port as number;
-
-        const connections: any[] = [];
-        const networkEntries = getNetworkList(hre.config.networks);
-        for (const [name, network] of networkEntries) {
-          // skip the builtin localhost network, since hardhat node is meant to explicitly not use it
-          if (name === "localhost") {
-            continue;
-          }
-          // hardhat network seems broken and the block number never advances on it
-          if (name === "hardhat") {
-            continue;
-          }
-          // if http type, then it already has a JSON-RPC server
-          if (network.type === "http") {
-            continue;
-          }
-
-          const connection = await hre.network.connect(name);
-
-          const server = new JsonRpcServerImplementation(
-            {
-              hostname,
-              port,
-              provider: connection.provider,
-            },
-            (msg: string) => logNetwork(name, msg),
-          );
-          port++; // increase port so next network has a unique port number
-          const publicClient = await connection.viem.getPublicClient();
-          publicClient.watchBlocks(
-            {
-              onBlock: (block: any) => {
-                // there seems to be a bug on block 0 where it triggers watchBlock in an infinite loop
-                if (block.number === 0n) return;
-
-                const txsMessage = block.transactions.length === 0
-                  ? ""
-                  : `\nTransactions:\n${
-                    block.transactions.map((tx: any) => tx.hash).join("\n\t")
-                  }`;
-                logNetwork(
-                  name,
-                  `block ${block.number} (${block.hash})`,
-                  txsMessage,
-                );
-              },
-              includeTransactions: true,
-            },
-          );
-
-          const { port: actualPort, address } = await server.listen();
-          logNetwork(
-            name,
-            `Started HTTP and WebSocket JSON-RPC server at ${address}:${actualPort}\n`,
-          );
-
-          connections.push(server);
-
-          logNetwork(name, "Accounts for", name);
-          logNetwork(name, "========");
-          // we use this over network.genesisAccounts
-          // since we don't have access to some of the hardhat v3 util functions otherwise
-          const wallets = await connection.viem.getWalletClients();
-          for (let i = 0; i < wallets.length; i++) {
-            const weiBalance = await publicClient.getBalance({
-              address: wallets[i].account.address,
-            });
-            const balance = (weiBalance / 10n ** 18n).toString(10);
-            logNetwork(
-              name,
-              `Account #${i}: ${wallets[i].account.address} (${balance} ETH)`,
-            );
-          }
-        }
-        await Promise.all(
-          connections.map((connection) => connection.waitUntilClosed()),
-        );
-      },
-    }))
-    .build();
-
-  const nodeWaitTask = task(["node", "wait"])
-    .addOption({
-      name: "port",
-      type: ArgumentType.INT,
-      defaultValue: 8545,
-    }).setAction(async () => ({
-      default: async (
-        args: TaskArguments,
-        hre: HardhatRuntimeEnvironment,
-      ): Promise<void> => {
-        const networkEntries = getNetworkList(hre.config.networks);
-        for (
-          let port = args.port as number;
-          port < (args.port as number) + networkEntries.length;
-          port++
-        ) {
-          await waitOn({
-            resources: [`tcp:${port}`],
-          });
-          port++;
-        }
-      },
-    }))
-    .build();
-
-  return [nodeTask, nodeWaitTask];
-}
-
-/**
- * Creates default network configurations commonly used in e2e tests and templates.
- * 
- * Returns networks:
- * - evmMain: Fast network (250ms block interval) on chainId 31337, port 8545
- * - evmMainHttp: HTTP wrapper for evmMain
- * - evmParallel: Slower network (1s block interval) on chainId 31338, port 8546
- * - evmParallelHttp: HTTP wrapper for evmParallel
- * 
- * @param options Optional configuration to override defaults
- * @returns Network configuration object
- */
-export function createDefaultNetworks(
-  options?: DefaultNetworkOptions,
-): Record<string, NetworkConfig> {
-  const {
-    evmMainPort = 8545,
-    evmParallelPort = 8546,
-    evmMainChainId = 31337,
-    evmParallelChainId = 31338,
-    evmMainInterval = 250,
-    evmParallelInterval = 1000,
-  } = options || {};
-
-  return {
-    evmMain: {
-      type: "edr-simulated",
-      chainType: "l1",
-      chainId: evmMainChainId,
-      mining: {
-        auto: true,
-        interval: evmMainInterval, // Arbitrum (250ms)
-      },
-      allowBlocksWithSameTimestamp: true,
-    },
-    // This is a helper network to allow to hardhat/ignition to connect to the network.
-    evmMainHttp: {
-      type: "http",
-      chainType: "l1",
-      url: `http://0.0.0.0:${evmMainPort}`,
-    },
-    evmParallel: {
-      type: "edr-simulated",
-      chainType: "l1",
-      chainId: evmParallelChainId,
-      mining: {
-        auto: true,
-        interval: evmParallelInterval, // 1s
-      },
-    },
-    // This is a helper network to allow to hardhat/ignition to connect to the network.
-    evmParallelHttp: {
-      type: "http",
-      chainType: "l1",
-      url: `http://0.0.0.0:${evmParallelPort}`,
-    },
-  };
-}
-
-/**
- * Initializes OpenTelemetry for Hardhat.
- * This should be called at the top level of your hardhat.config.ts file.
- * 
- * Note: This function uses dynamic imports and executes asynchronously.
- * Errors are caught and logged as warnings to avoid breaking Hardhat initialization.
- * 
- * @param logPackage Package name for log utilities (e.g., "@paimaexample/log" or "@paimaexample/log")
- * @param denoJsonPath Path to deno.json file for version detection
- */
-export function initTelemetry(
-  logPackage: string,
-  denoJsonPath: string = "./deno.json",
-): void {
-  // Dynamic import to support both @effectstream and @paimaexample packages
-  // Execute asynchronously - errors won't break Hardhat initialization
-  (async () => {
-    try {
-      const fs = await import("node:fs");
-      const { parse } = await import("jsonc-parser");
-      const { NodeSDK } = await import("@opentelemetry/sdk-node");
-      const { defaultOtelSetup } = await import(logPackage);
-
-      const DenoConfig = parse(fs.readFileSync(denoJsonPath, "utf8"));
-      const sdk = new NodeSDK({
-        ...defaultOtelSetup("hardhat", DenoConfig.version),
-      });
-      sdk.start();
-    } catch (error) {
-      console.warn("Failed to initialize telemetry:", error);
-    }
-  })();
-}
-
-/**
- * Creates a unified Hardhat configuration that can be used across e2e tests and templates.
- * 
- * This function consolidates the common Hardhat setup including:
- * - Network configuration
- * - Path configuration
- * - Plugin setup
- * - Solidity compiler configuration
- * 
- * For node tasks, use createNodeTasks() separately and pass the result in the tasks option.
- * 
- * @param options Configuration options
- * @returns HardhatUserConfig object
- */
-export function createHardhatConfig(
-  options: HardhatConfigOptions,
-): HardhatUserConfig {
-  const {
-    sourcesDir,
-    artifactsDir,
-    cacheDir,
-    networks,
-    useDefaultNetworks = networks === undefined,
-    defaultNetworkOptions,
-    tasks,
-    solidityVersion = "0.8.30",
-  } = options;
-
-  // Use default networks if none provided and useDefaultNetworks is true
-  const finalNetworks = networks ||
-    (useDefaultNetworks
-      ? createDefaultNetworks(defaultNetworkOptions)
-      : {});
-
-  const config: HardhatUserConfig = {
-    networks: finalNetworks,
-    paths: {
-      sources: [sourcesDir],
-      artifacts: artifactsDir,
-      cache: cacheDir,
-    },
-    tasks,
-    plugins: [
-      HardhatViem,
-      HardhatIgnitionViem,
-    ],
-    solidity: {
-      profiles: {
-        default: {
-          version: solidityVersion,
-        },
-      },
-    },
-  };
-
-  return config;
-}
-