create-fhevm-example 1.1.5 → 1.2.0

package/README.md

@@ -48,19 +48,24 @@ npx create-fhevm-example --example fhe-counter --output ./my-project --install
 
 **Concepts**: `fhe-access-control`, `fhe-input-proof`, `fhe-handles`, `fhe-anti-patterns`
 
+**Gaming**: `rock-paper-scissors`, `encrypted-lottery`, `encrypted-poker`
+
 **OpenZeppelin**: `erc7984`, `erc7984-erc20-wrapper`, `swap-erc7984-to-erc20`, `swap-erc7984-to-erc7984`, `vesting-wallet`
 
-**Advanced**: `blind-auction`, `hidden-voting`
+**Advanced**: `blind-auction`, `hidden-voting`, `private-payroll`, `encrypted-escrow`, `private-kyc`
 
 ## Available Categories
 
 | Category | Description |
 |----------|-------------|
-| `basic` | Encryption, decryption, basic operations (9 contracts) |
-| `concepts` | Access control, proofs, handles (4 contracts) |
-| `operations` | Arithmetic, comparison operations (4 contracts) |
-| `openzeppelin` | ERC7984, wrappers, swaps (5 contracts) |
-| `advanced` | Blind auction, voting (2 contracts) |
+| `basic` | Basic encryption and counter examples (1 contract) |
+| `basicencryption` | Single and multiple value encryption (2 contracts) |
+| `basicdecryption` | Public and user decryption examples (4 contracts) |
+| `basicfheoperations` | FHE arithmetic and comparison (4 contracts) |
+| `concepts` | Access control, proofs, handles, anti-patterns (4 contracts) |
+| `gaming` | Rock-paper-scissors, lottery, poker (3 contracts) |
+| `openzeppelin` | ERC7984, wrappers, swaps, vesting (5 contracts) |
+| `advanced` | Blind auction, voting, payroll, escrow, KYC (5 contracts) |
 
 ## What Gets Created
 
@@ -89,6 +94,35 @@ npx create-fhevm-example --example fhe-counter --output ./my-project --install
 
 >This section is for contributors and maintainers of the package.
 
+### File Structure
+
+The package follows a modular structure similar to the main project's `scripts/` directory:
+
+```
+src/
+├── index.ts      # Main entry point + CLI modes (~320 lines)
+├── builders.ts   # createSingleExample, createCategoryProject (~250 lines)
+├── ui.ts         # Interactive prompts + install/test commands (~180 lines)
+├── utils.ts      # Utilities + constants + validation + logging (~350 lines)
+├── config.ts     # Auto-generated examples & categories (~440 lines)
+└── add-mode.ts   # Add FHEVM to existing projects (~370 lines)
+```
+
+**Key Components:**
+- `index.ts` - Main CLI entry point, handles interactive and direct modes
+- `builders.ts` - Project creation logic (single example, category project)
+- `ui.ts` - User interface (prompts + commands, replaces old prompts.ts + commands.ts)
+- `utils.ts` - File operations, constants, validation, logging utilities
+- `config.ts` - Auto-generated configuration from monorepo contracts
+- `add-mode.ts` - Add FHEVM to existing Hardhat projects
+
+**Design Principles:**
+- **Modular**: Each file has a single responsibility
+- **Aligned**: Mirrors main project's `scripts/` structure
+- **Maintainable**: Easy to understand and update
+- **Type-safe**: Full TypeScript coverage
+- **Consistent**: Standardized logging, error handling, validation
+
 ### Configuration
 
 The CLI uses a configuration file that defines all available examples and categories. This file is **auto-generated** by scanning the monorepo's contracts directory.
@@ -153,10 +187,10 @@ npm unlink -g create-fhevm-example
 
 ### Scripts
 
-- `npm run build` - Compile TypeScript
-- `npm run dev` - Watch mode
-- `npm run update:config` - Update config from monorepo contracts
-- `npm run prepublishOnly` - Auto-runs update:config + build before publish
+- `npm run build` - Compile TypeScript to `dist/`
+- `npm run dev` - Watch mode for development
+- `npm run update:config` - Regenerate config from monorepo contracts
+- `npm run prepublishOnly` - Auto-runs before publish (update:config + build)
 
 ---
 

package/dist/builders.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Project Builders
+ *
+ * Creates single example and category projects from templates.
+ * Similar to main project's create-example.ts and create-category.ts
+ */
+/**
+ * Cleans up template-specific files after copying
+ * Similar to cleanupTemplate() in main project's shared/utils.ts
+ */
+export declare function cleanupTemplate(outputDir: string): void;
+/**
+ * Creates a single example project from the template
+ *
+ * Steps:
+ * 1. Copy template directory and clean up
+ * 2. Download contract and test files from GitHub
+ * 3. Update package.json and deploy scripts
+ */
+export declare function createSingleExample(exampleName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+/**
+ * Creates a category project with multiple examples
+ *
+ * Steps:
+ * 1. Copy template directory and clean up
+ * 2. Download all contracts and tests for the category
+ * 3. Update package.json
+ */
+export declare function createCategoryProject(categoryName: string, outputDir: string, tempRepoPath: string): Promise<void>;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmDvD;AAoED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAMD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/builders.js

@@ -0,0 +1,195 @@
+/**
+ * Project Builders
+ *
+ * Creates single example and category projects from templates.
+ * Similar to main project's create-example.ts and create-category.ts
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { EXAMPLES, CATEGORIES } from "./config.js";
+import { copyDirectoryRecursive, getContractName, downloadFileFromGitHub, runCommand, generateDeployScript, } from "./utils.js";
+import { TEST_TYPES_CONTENT } from "./utils.js";
+// =============================================================================
+// Template Cleanup
+// =============================================================================
+/**
+ * Cleans up template-specific files after copying
+ * Similar to cleanupTemplate() in main project's shared/utils.ts
+ */
+export function cleanupTemplate(outputDir) {
+    // Remove .git directory
+    const gitDir = path.join(outputDir, ".git");
+    if (fs.existsSync(gitDir)) {
+        fs.rmSync(gitDir, { recursive: true, force: true });
+    }
+    // Remove FHECounter.sol (template example)
+    const templateContract = path.join(outputDir, "contracts", "FHECounter.sol");
+    if (fs.existsSync(templateContract)) {
+        fs.unlinkSync(templateContract);
+    }
+    // Remove .gitkeep files
+    const contractsGitkeep = path.join(outputDir, "contracts", ".gitkeep");
+    if (fs.existsSync(contractsGitkeep)) {
+        fs.unlinkSync(contractsGitkeep);
+    }
+    // Clear test directory (remove template tests)
+    const testDir = path.join(outputDir, "test");
+    if (fs.existsSync(testDir)) {
+        fs.readdirSync(testDir).forEach((file) => {
+            if (file.endsWith(".ts") || file === ".gitkeep") {
+                fs.unlinkSync(path.join(testDir, file));
+            }
+        });
+    }
+    // Remove FHECounter task import from hardhat.config.ts
+    const configPath = path.join(outputDir, "hardhat.config.ts");
+    if (fs.existsSync(configPath)) {
+        let configContent = fs.readFileSync(configPath, "utf-8");
+        configContent = configContent.replace(/import "\.\/tasks\/FHECounter";\n?/g, "");
+        fs.writeFileSync(configPath, configContent);
+    }
+    // Remove FHECounter task file
+    const oldTaskFile = path.join(outputDir, "tasks", "FHECounter.ts");
+    if (fs.existsSync(oldTaskFile)) {
+        fs.unlinkSync(oldTaskFile);
+    }
+    // Create test/types.ts for type safety
+    fs.writeFileSync(path.join(outputDir, "test", "types.ts"), TEST_TYPES_CONTENT);
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Downloads contract dependencies to the output directory
+ */
+async function downloadDependencies(dependencies, outputDir) {
+    for (const depPath of dependencies) {
+        const relativePath = depPath.replace(/^contracts\//, "");
+        const depDestPath = path.join(outputDir, "contracts", relativePath);
+        const depDestDir = path.dirname(depDestPath);
+        if (!fs.existsSync(depDestDir)) {
+            fs.mkdirSync(depDestDir, { recursive: true });
+        }
+        await downloadFileFromGitHub(depPath, depDestPath);
+    }
+}
+/**
+ * Updates package.json with project name, description, and npm dependencies
+ */
+function updatePackageJson(outputDir, projectName, description, npmDependencies) {
+    const packageJsonPath = path.join(outputDir, "package.json");
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+    packageJson.name = projectName;
+    if (description) {
+        packageJson.description = description;
+    }
+    if (npmDependencies && Object.keys(npmDependencies).length > 0) {
+        if (!packageJson.dependencies) {
+            packageJson.dependencies = {};
+        }
+        Object.assign(packageJson.dependencies, npmDependencies);
+    }
+    fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+}
+/**
+ * Initializes git repository (optional, fails silently)
+ */
+async function initGitRepo(outputDir) {
+    try {
+        await runCommand("git", ["init"], outputDir);
+    }
+    catch (error) {
+        // Git init is optional
+    }
+}
+// =============================================================================
+// Single Example Builder
+// =============================================================================
+/**
+ * Creates a single example project from the template
+ *
+ * Steps:
+ * 1. Copy template directory and clean up
+ * 2. Download contract and test files from GitHub
+ * 3. Update package.json and deploy scripts
+ */
+export async function createSingleExample(exampleName, outputDir, tempRepoPath) {
+    const example = EXAMPLES[exampleName];
+    if (!example) {
+        throw new Error(`Unknown example: ${exampleName}`);
+    }
+    const templateDir = path.join(tempRepoPath, "fhevm-hardhat-template");
+    const contractName = getContractName(example.contract);
+    if (!contractName) {
+        throw new Error("Could not extract contract name");
+    }
+    // Step 1: Copy template and clean up
+    copyDirectoryRecursive(templateDir, outputDir);
+    cleanupTemplate(outputDir);
+    // Step 2: Download example contract
+    await downloadFileFromGitHub(example.contract, path.join(outputDir, "contracts", `${contractName}.sol`));
+    // Download contract dependencies if specified
+    if (example.dependencies) {
+        await downloadDependencies(example.dependencies, outputDir);
+    }
+    // Step 3: Download test file
+    await downloadFileFromGitHub(example.test, path.join(outputDir, "test", path.basename(example.test)));
+    // Step 4: Update deploy script and package.json
+    fs.writeFileSync(path.join(outputDir, "deploy", "deploy.ts"), generateDeployScript(contractName));
+    updatePackageJson(outputDir, `fhevm-example-${exampleName}`, example.description, example.npmDependencies);
+    // Initialize git repository
+    await initGitRepo(outputDir);
+}
+// =============================================================================
+// Category Project Builder
+// =============================================================================
+/**
+ * Creates a category project with multiple examples
+ *
+ * Steps:
+ * 1. Copy template directory and clean up
+ * 2. Download all contracts and tests for the category
+ * 3. Update package.json
+ */
+export async function createCategoryProject(categoryName, outputDir, tempRepoPath) {
+    const category = CATEGORIES[categoryName];
+    if (!category) {
+        throw new Error(`Unknown category: ${categoryName}`);
+    }
+    const templateDir = path.join(tempRepoPath, "fhevm-hardhat-template");
+    // Step 1: Copy template and clean up
+    copyDirectoryRecursive(templateDir, outputDir);
+    cleanupTemplate(outputDir);
+    // Step 2: Download all contracts and tests
+    for (const item of category.contracts) {
+        const contractName = getContractName(item.sol);
+        if (contractName) {
+            await downloadFileFromGitHub(item.sol, path.join(outputDir, "contracts", `${contractName}.sol`));
+        }
+        if (item.test) {
+            await downloadFileFromGitHub(item.test, path.join(outputDir, "test", path.basename(item.test)));
+        }
+    }
+    // Collect dependencies from all examples in this category
+    const allDependencies = new Set();
+    const allNpmDependencies = {};
+    for (const [exampleName, exampleConfig] of Object.entries(EXAMPLES)) {
+        if (exampleConfig.category === category.name.replace(" Examples", "")) {
+            if (exampleConfig.dependencies) {
+                exampleConfig.dependencies.forEach((dep) => allDependencies.add(dep));
+            }
+            if (exampleConfig.npmDependencies) {
+                Object.assign(allNpmDependencies, exampleConfig.npmDependencies);
+            }
+        }
+    }
+    // Download all collected dependencies
+    if (allDependencies.size > 0) {
+        await downloadDependencies(Array.from(allDependencies), outputDir);
+    }
+    // Step 3: Update package.json
+    updatePackageJson(outputDir, `fhevm-examples-${categoryName}`, undefined, allNpmDependencies);
+    // Initialize git repository
+    await initGitRepo(outputDir);
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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"}

package/dist/commands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Command Execution & Install/Test
+ *
+ * Runs npm install, compile, and test commands.
+ * Similar to main project's shared/commands.ts
+ */
+/**
+ * Runs npm install, compile, and test in the project directory
+ */
+export declare function runInstallAndTest(projectPath: string): Promise<void>;
+/**
+ * Shows quick start commands for the created project
+ */
+export declare function showQuickStart(relativePath: string): void;
+/**
+ * Asks user if they want to install and test, then runs or shows quick start
+ */
+export declare function askInstallAndTest(resolvedOutput: string, relativePath: string): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD1E;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/commands.js

@@ -0,0 +1,91 @@
+/**
+ * Command Execution & Install/Test
+ *
+ * Runs npm install, compile, and test commands.
+ * Similar to main project's shared/commands.ts
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { runCommand, extractTestResults } from "./utils.js";
+// =============================================================================
+// Install & Test
+// =============================================================================
+/**
+ * Runs npm install, compile, and test in the project directory
+ */
+export async function runInstallAndTest(projectPath) {
+    const steps = [
+        {
+            name: "Installing dependencies",
+            cmd: "npm",
+            args: ["install"],
+            showOutput: false,
+        },
+        {
+            name: "Compiling contracts",
+            cmd: "npm",
+            args: ["run", "compile"],
+            showOutput: false,
+        },
+        {
+            name: "Running tests",
+            cmd: "npm",
+            args: ["run", "test"],
+            showOutput: true,
+        },
+    ];
+    for (const step of steps) {
+        const s = p.spinner();
+        s.start(step.name + "...");
+        try {
+            const output = await runCommand(step.cmd, step.args, projectPath);
+            if (step.showOutput) {
+                const testResults = extractTestResults(output);
+                s.stop(testResults
+                    ? pc.green(`✓ ${step.name} - ${testResults}`)
+                    : pc.green(`✓ ${step.name} completed`));
+            }
+            else {
+                s.stop(pc.green(`✓ ${step.name} completed`));
+            }
+        }
+        catch (error) {
+            s.stop(pc.red(`✗ ${step.name} failed`));
+            if (error instanceof Error) {
+                p.log.error(error.message);
+            }
+            throw new Error(`${step.name} failed`);
+        }
+    }
+    p.log.success(pc.green("All steps completed successfully!"));
+}
+// =============================================================================
+// Quick Start Display
+// =============================================================================
+/**
+ * Shows quick start commands for the created project
+ */
+export function showQuickStart(relativePath) {
+    p.note(`${pc.dim("$")} cd ${relativePath}\n${pc.dim("$")} npm install\n${pc.dim("$")} npm run compile\n${pc.dim("$")} npm run test`, "🚀 Quick Start");
+}
+/**
+ * Asks user if they want to install and test, then runs or shows quick start
+ */
+export async function askInstallAndTest(resolvedOutput, relativePath) {
+    const shouldInstall = await p.confirm({
+        message: "Install dependencies and run tests?",
+        initialValue: false,
+    });
+    if (p.isCancel(shouldInstall)) {
+        showQuickStart(relativePath);
+        return;
+    }
+    if (shouldInstall) {
+        p.log.message("");
+        await runInstallAndTest(resolvedOutput);
+    }
+    else {
+        showQuickStart(relativePath);
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared constants for the CLI
+ */
+/**
+ * Simple folder icon for all categories
+ */
+export declare const CATEGORY_ICON = "\uD83D\uDCC1";
+/**
+ * Display order for example categories in the interactive prompt
+ */
+export declare const CATEGORY_ORDER: string[];
+/**
+ * Content for test/types.ts file
+ */
+export declare const TEST_TYPES_CONTENT = "import type { HardhatEthersSigner } from \"@nomicfoundation/hardhat-ethers/signers\";\n\n/**\n * Common signers interface used across test files\n */\nexport interface Signers {\n  owner: HardhatEthersSigner;\n  alice: HardhatEthersSigner;\n}\n";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,aAAa,iBAAO,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,cAAc,UAS1B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB,yPAS9B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Shared constants for the CLI
+ */
+// =============================================================================
+// Category Display
+// =============================================================================
+/**
+ * Simple folder icon for all categories
+ */
+export const CATEGORY_ICON = "📁";
+/**
+ * Display order for example categories in the interactive prompt
+ */
+export const CATEGORY_ORDER = [
+    "Basic",
+    "Basic - Encryption",
+    "Basic - Decryption",
+    "Basic - FHE Operations",
+    "Concepts",
+    "Gaming",
+    "Openzeppelin",
+    "Advanced",
+];
+// =============================================================================
+// Template Content
+// =============================================================================
+/**
+ * Content for test/types.ts file
+ */
+export const TEST_TYPES_CONTENT = `import type { HardhatEthersSigner } from "@nomicfoundation/hardhat-ethers/signers";
+
+/**
+ * Common signers interface used across test files
+ */
+export interface Signers {
+  owner: HardhatEthersSigner;
+  alice: HardhatEthersSigner;
+}
+`;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO;IACP,oBAAoB;IACpB,oBAAoB;IACpB,wBAAwB;IACxB,UAAU;IACV,QAAQ;IACR,cAAc;IACd,UAAU;CACX,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;CASjC,CAAC"}

package/dist/index.d.ts

@@ -6,17 +6,15 @@
  *   npx create-fhevm-example                    # Interactive mode
  *   npx create-fhevm-example --example <name>   # Create single example
  *   npx create-fhevm-example --category <name>  # Create category project
+ *   npx create-fhevm-example --add              # Add to existing project
  *
- * FILE STRUCTURE:
- * ================
- * 1. IMPORTS
- * 2. CONSTANTS - Category icons, order, etc.
- * 3. PROJECT BUILDERS - createSingleExample, createCategoryProject
- * 4. PROMPT HELPERS - Category/example selection prompts
- * 5. INSTALL & TEST - Build and test utilities
- * 6. INTERACTIVE MODE - Main interactive flow
- * 7. DIRECT MODE - CLI argument handling
- * 8. MAIN ENTRY POINT
+ * This is the main entry point - similar to scripts/create.ts in main project.
+ * Actual logic is split into:
+ *   - builders.ts   (createSingleExample, createCategoryProject)
+ *   - ui.ts         (prompts + commands)
+ *   - utils.ts      (file operations + constants + utilities)
+ *   - config.ts     (examples & categories)
+ *   - add-mode.ts   (add to existing project)
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}