create-mn-app 1.0.0

package/dist/utils/git-utils.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitUtils = void 0;
+const cross_spawn_1 = require("cross-spawn");
+class GitUtils {
+    static async init(projectPath) {
+        // Check if git is available
+        const gitAvailable = await this.isGitAvailable();
+        if (!gitAvailable) {
+            throw new Error("Git is not available");
+        }
+        // Initialize git repository
+        await this.runGitCommand(projectPath, ["init"]);
+        // Add all files
+        await this.runGitCommand(projectPath, ["add", "."]);
+        // Create initial commit
+        await this.runGitCommand(projectPath, [
+            "commit",
+            "-m",
+            "Initial commit from create-midnight-app",
+        ]);
+    }
+    static async isGitAvailable() {
+        try {
+            await this.runGitCommand(process.cwd(), ["--version"]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    static async runGitCommand(cwd, args) {
+        return new Promise((resolve, reject) => {
+            const child = (0, cross_spawn_1.spawn)("git", args, {
+                cwd,
+                stdio: "pipe",
+            });
+            child.on("close", (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Git command failed with code ${code}`));
+                }
+            });
+            child.on("error", reject);
+        });
+    }
+}
+exports.GitUtils = GitUtils;
+//# sourceMappingURL=git-utils.js.map

package/dist/utils/git-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/utils/git-utils.ts"],"names":[],"mappings":";;;AAAA,6CAAoC;AAIpC,MAAa,QAAQ;IACnB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAmB;QACnC,4BAA4B;QAC5B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QACjD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,4BAA4B;QAC5B,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAEhD,gBAAgB;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAEpD,wBAAwB;QACxB,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE;YACpC,QAAQ;YACR,IAAI;YACJ,yCAAyC;SAC1C,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,cAAc;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,aAAa,CAChC,GAAW,EACX,IAAc;QAEd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,IAAA,mBAAK,EAAC,KAAK,EAAE,IAAI,EAAE;gBAC/B,GAAG;gBACH,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AApDD,4BAoDC"}

package/dist/utils/template-manager.d.ts

@@ -0,0 +1,7 @@
+export declare class TemplateManager {
+    private templateName;
+    constructor(templateName: string);
+    scaffold(projectPath: string, projectName: string): Promise<void>;
+    private copyTemplate;
+}
+//# sourceMappingURL=template-manager.d.ts.map

package/dist/utils/template-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-manager.d.ts","sourceRoot":"","sources":["../../src/utils/template-manager.ts"],"names":[],"mappings":"AAIA,qBAAa,eAAe;IACd,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,MAAM;IAElC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBzD,YAAY;CAmC3B"}

package/dist/utils/template-manager.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateManager = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const mustache_1 = __importDefault(require("mustache"));
+class TemplateManager {
+    constructor(templateName) {
+        this.templateName = templateName;
+    }
+    async scaffold(projectPath, projectName) {
+        const templatePath = path_1.default.join(__dirname, "../../templates", this.templateName);
+        if (!fs_extra_1.default.existsSync(templatePath)) {
+            throw new Error(`Template "${this.templateName}" not found`);
+        }
+        const templateVars = {
+            projectName,
+            timestamp: new Date().toISOString(),
+            year: new Date().getFullYear(),
+            capitalizedName: projectName.charAt(0).toUpperCase() + projectName.slice(1),
+            kebabName: projectName.toLowerCase().replace(/\s+/g, "-"),
+        };
+        await this.copyTemplate(templatePath, projectPath, templateVars);
+    }
+    async copyTemplate(templatePath, projectPath, templateVars) {
+        const files = await fs_extra_1.default.readdir(templatePath, { withFileTypes: true });
+        for (const file of files) {
+            const sourcePath = path_1.default.join(templatePath, file.name);
+            let destPath = path_1.default.join(projectPath, file.name);
+            // Handle special file names
+            if (file.name === "_gitignore") {
+                destPath = path_1.default.join(projectPath, ".gitignore");
+            }
+            else if (file.name === "_env.template") {
+                destPath = path_1.default.join(projectPath, ".env.example");
+            }
+            if (file.isDirectory()) {
+                await fs_extra_1.default.ensureDir(destPath);
+                await this.copyTemplate(sourcePath, destPath, templateVars);
+            }
+            else {
+                if (file.name.endsWith(".template")) {
+                    // Render template file
+                    const content = await fs_extra_1.default.readFile(sourcePath, "utf8");
+                    const rendered = mustache_1.default.render(content, templateVars);
+                    const finalPath = destPath.replace(".template", "");
+                    await fs_extra_1.default.writeFile(finalPath, rendered);
+                }
+                else {
+                    // Copy binary file as-is
+                    await fs_extra_1.default.copy(sourcePath, destPath);
+                }
+            }
+        }
+    }
+}
+exports.TemplateManager = TemplateManager;
+//# sourceMappingURL=template-manager.js.map

package/dist/utils/template-manager.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationResult {
+    valid: boolean;
+    problems?: string[];
+}
+export declare function validateProjectName(name: string): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA8BlE"}

package/dist/utils/validation.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateProjectName = validateProjectName;
+const validate_npm_package_name_1 = __importDefault(require("validate-npm-package-name"));
+function validateProjectName(name) {
+    const validation = (0, validate_npm_package_name_1.default)(name);
+    if (validation.validForNewPackages) {
+        return { valid: true };
+    }
+    const problems = [];
+    if (validation.errors) {
+        problems.push(...validation.errors);
+    }
+    if (validation.warnings) {
+        problems.push(...validation.warnings);
+    }
+    // Additional checks
+    if (name.length === 0) {
+        problems.push("Project name cannot be empty");
+    }
+    if (name.match(/[A-Z]/)) {
+        problems.push("Project name cannot contain uppercase letters");
+    }
+    return {
+        valid: false,
+        problems: problems.length > 0 ? problems : ["Invalid project name"],
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":";;;;;AAOA,kDA8BC;AArCD,0FAA4D;AAO5D,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAG,IAAA,mCAAmB,EAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "create-mn-app",
+  "version": "1.0.0",
+  "description": "Create Midnight Network applications with zero configuration",
+  "main": "dist/index.js",
+  "bin": {
+    "create-mn-app": "./bin/create-midnight-app.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node dist/test.js",
+    "test-local": "npm run build && npm link && npx create-midnight-app test-app",
+    "clean": "rm -rf dist test-app"
+  },
+  "keywords": [
+    "midnight",
+    "blockchain",
+    "zero-knowledge",
+    "privacy",
+    "scaffold",
+    "cli",
+    "create-app"
+  ],
+  "author": "Midnight Network",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "cross-spawn": "^7.0.3",
+    "fs-extra": "^11.1.1",
+    "mustache": "^4.2.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2",
+    "semver": "^7.5.4",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.2",
+    "@types/fs-extra": "^11.0.1",
+    "@types/mustache": "^4.2.2",
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.4",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/midnightntwrk/create-midnight-app.git"
+  }
+}

package/templates/hello-world/README.md.template

@@ -0,0 +1,100 @@
+# {{projectName}}
+
+A Midnight Network application created with `create-midnight-app`.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+ installed
+- Docker installed (for proof server)
+
+### Quick Start
+
+1. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+2. **Start development**:
+
+   ```bash
+   npm run dev
+   ```
+
+   This will:
+
+   - Start the proof server
+   - Watch for contract changes
+   - Auto-compile and build
+   - Deploy when ready
+
+3. **Interact with your contract**:
+   ```bash
+   npm run cli
+   ```
+
+### Available Scripts
+
+- `npm run dev` - Start development server with hot reloading
+- `npm run setup` - Compile, build, and deploy contract
+- `npm run compile` - Compile Compact contract
+- `npm run build` - Build TypeScript
+- `npm run deploy` - Deploy contract to testnet
+- `npm run cli` - Interactive CLI for contract
+- `npm run reset` - Reset all compiled/built files
+- `npm run clean` - Clean build artifacts
+
+### Environment Variables
+
+Copy `.env.example` to `.env` and configure:
+
+- `WALLET_SEED` - Your 64-character wallet seed (auto-generated)
+- `MIDNIGHT_NETWORK` - Network to use (testnet)
+- `PROOF_SERVER_URL` - Proof server URL
+- `CONTRACT_NAME` - Contract name
+
+### Project Structure
+
+```
+{{projectName}}/
+├── contracts/
+│   ├── hello-world.compact    # Smart contract source
+│   └── managed/               # Compiled artifacts
+├── src/
+│   ├── deploy.ts             # Deployment script
+│   ├── cli.ts                # Interactive CLI
+│   ├── providers/            # Shared providers
+│   └── utils/                # Utility functions
+├── .env                      # Environment config (keep private!)
+├── deployment.json           # Deployment info
+└── package.json
+```
+
+### Getting Testnet Tokens
+
+1. Run `npm run deploy` to see your wallet address
+2. Visit [https://midnight.network/test-faucet](https://midnight.network/test-faucet)
+3. Enter your address to receive test tokens
+
+### Learn More
+
+- [Midnight Documentation](https://docs.midnight.network)
+- [Compact Language Guide](https://docs.midnight.network/compact)
+- [Tutorial Series](https://docs.midnight.network/tutorials)
+
+## Contract Overview
+
+This project includes a simple "Hello World" contract that:
+
+- Stores a message on the blockchain
+- Allows reading the current message
+- Demonstrates basic Midnight functionality
+
+The contract uses:
+
+- **Public ledger state** for the message
+- **Zero-knowledge proofs** for transactions
+- **Privacy-preserving** architecture
+
+Happy coding! 🌙

package/templates/hello-world/_gitignore

@@ -0,0 +1,52 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build output
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Contract artifacts
+contracts/managed/
+
+# Deployment info
+deployment.json
+
+# OS generated files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/settings.json
+.idea/
+*.swp
+*.swo
+
+# Logs
+logs/
+*.log
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory
+coverage/
+
+# Private state
+*-state/
+
+# Temporary files
+tmp/
+temp/

package/templates/hello-world/contracts/hello-world.compact.template

@@ -0,0 +1,12 @@
+pragma language_version >= 0.16 && <= 0.17;
+
+import CompactStandardLibrary;
+
+// Public ledger state - visible on blockchain
+export ledger message: Opaque<"string">;
+
+// Circuit to store a message on the blockchain
+// The message will be publicly visible
+export circuit storeMessage(customMessage: Opaque<"string">): [] {
+    message = disclose(customMessage);
+}

package/templates/hello-world/nodemon.json.template

@@ -0,0 +1,7 @@
+{
+  "watch": ["contracts/**/*.compact", "src/**/*.ts"],
+  "ext": "compact,ts",
+  "ignore": ["contracts/managed/**", "dist/**", "node_modules/**"],
+  "exec": "npm run compile && npm run build",
+  "delay": "1000"
+}

package/templates/hello-world/package.json.template

@@ -0,0 +1,49 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A Midnight Network application created with create-midnight-app",
+  "author": "{{author}}",
+  "license": "MIT",
+  "scripts": {
+    "dev": "concurrently \"npm run proof-server\" \"npm run watch\"",
+    "watch": "nodemon --config nodemon.json",
+    "setup": "npm run compile && npm run build && npm run deploy",
+    "compile": "compact compile contracts/hello-world.compact contracts/managed/hello-world",
+    "build": "tsc",
+    "deploy": "node dist/deploy.js",
+    "cli": "node dist/cli.js",
+    "reset": "rm -rf contracts/managed deployment.json dist && npm run compile",
+    "validate": "tsc --noEmit && npm run compile",
+    "clean": "rm -rf dist contracts/managed deployment.json",
+    "proof-server": "docker run -p 6300:6300 midnightnetwork/proof-server -- 'midnight-proof-server --network testnet'",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@midnight-ntwrk/compact-runtime": "^0.8.1",
+    "@midnight-ntwrk/ledger": "^4.0.0",
+    "@midnight-ntwrk/midnight-js-contracts": "2.0.2",
+    "@midnight-ntwrk/midnight-js-http-client-proof-provider": "2.0.2",
+    "@midnight-ntwrk/midnight-js-indexer-public-data-provider": "2.0.2",
+    "@midnight-ntwrk/midnight-js-level-private-state-provider": "2.0.2",
+    "@midnight-ntwrk/midnight-js-node-zk-config-provider": "2.0.2",
+    "@midnight-ntwrk/midnight-js-network-id": "2.0.2",
+    "@midnight-ntwrk/midnight-js-types": "2.0.2",
+    "@midnight-ntwrk/wallet": "5.0.0",
+    "@midnight-ntwrk/wallet-api": "5.0.0",
+    "@midnight-ntwrk/zswap": "^4.0.0",
+    "ws": "^8.18.3",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.4.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.9.2",
+    "nodemon": "^3.0.1",
+    "concurrently": "^8.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["midnight", "blockchain", "zero-knowledge", "privacy"]
+}

package/templates/hello-world/src/cli.ts.template

@@ -0,0 +1,194 @@
+import "dotenv/config";
+import * as readline from "readline/promises";
+import { WalletBuilder } from "@midnight-ntwrk/wallet";
+import { findDeployedContract } from "@midnight-ntwrk/midnight-js-contracts";
+import {
+  NetworkId,
+  setNetworkId,
+  getZswapNetworkId,
+  getLedgerNetworkId,
+} from "@midnight-ntwrk/midnight-js-network-id";
+import { createBalancedTx } from "@midnight-ntwrk/midnight-js-types";
+import { Transaction } from "@midnight-ntwrk/ledger";
+import { Transaction as ZswapTransaction } from "@midnight-ntwrk/zswap";
+import { WebSocket } from "ws";
+import * as path from "path";
+import * as fs from "fs";
+import * as Rx from "rxjs";
+import { MidnightProviders } from "./providers/midnight-providers";
+import { EnvironmentManager } from "./utils/environment";
+
+// Fix WebSocket for Node.js environment
+// @ts-ignore
+globalThis.WebSocket = WebSocket;
+
+// Configure for Midnight Testnet
+setNetworkId(NetworkId.TestNet);
+
+async function main() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log("🌙 {{projectName}} CLI\n");
+
+  try {
+    // Validate environment
+    EnvironmentManager.validateEnvironment();
+
+    // Check for deployment file
+    if (!fs.existsSync("deployment.json")) {
+      console.error("❌ No deployment.json found! Run npm run deploy first.");
+      process.exit(1);
+    }
+
+    const deployment = JSON.parse(fs.readFileSync("deployment.json", "utf-8"));
+    console.log(`Contract: ${deployment.contractAddress}\n`);
+
+    const networkConfig = EnvironmentManager.getNetworkConfig();
+    const contractName =
+      deployment.contractName || process.env.CONTRACT_NAME || "hello-world";
+    const walletSeed = process.env.WALLET_SEED!;
+
+    console.log("Connecting to Midnight network...");
+
+    // Build wallet
+    const wallet = await WalletBuilder.buildFromSeed(
+      networkConfig.indexer,
+      networkConfig.indexerWS,
+      networkConfig.proofServer,
+      networkConfig.node,
+      walletSeed,
+      getZswapNetworkId(),
+      "info"
+    );
+
+    wallet.start();
+
+    // Wait for sync
+    await Rx.firstValueFrom(
+      wallet.state().pipe(Rx.filter((s) => s.syncProgress?.synced === true))
+    );
+
+    // Load contract
+    const contractPath = path.join(process.cwd(), "contracts");
+    const contractModulePath = path.join(
+      contractPath,
+      "managed",
+      contractName,
+      "contract",
+      "index.cjs"
+    );
+    const HelloWorldModule = await import(contractModulePath);
+    const contractInstance = new HelloWorldModule.Contract({});
+
+    // Create wallet provider
+    const walletState = await Rx.firstValueFrom(wallet.state());
+
+    const walletProvider = {
+      coinPublicKey: walletState.coinPublicKey,
+      encryptionPublicKey: walletState.encryptionPublicKey,
+      balanceTx(tx: any, newCoins: any) {
+        return wallet
+          .balanceTransaction(
+            ZswapTransaction.deserialize(
+              tx.serialize(getLedgerNetworkId()),
+              getZswapNetworkId()
+            ),
+            newCoins
+          )
+          .then((tx) => wallet.proveTransaction(tx))
+          .then((zswapTx) =>
+            Transaction.deserialize(
+              zswapTx.serialize(getZswapNetworkId()),
+              getLedgerNetworkId()
+            )
+          )
+          .then(createBalancedTx);
+      },
+      submitTx(tx: any) {
+        return wallet.submitTransaction(tx);
+      },
+    };
+
+    // Configure providers
+    const providers = MidnightProviders.create({
+      contractName,
+      walletProvider,
+      networkConfig,
+    });
+
+    // Connect to contract
+    const deployed: any = await findDeployedContract(providers, {
+      contractAddress: deployment.contractAddress,
+      contract: contractInstance,
+      privateStateId: "helloWorldState",
+      initialPrivateState: {},
+    });
+
+    console.log("✅ Connected to contract\n");
+
+    // Main menu loop
+    let running = true;
+    while (running) {
+      console.log("--- Menu ---");
+      console.log("1. Store message");
+      console.log("2. Read current message");
+      console.log("3. Exit");
+
+      const choice = await rl.question("\nYour choice: ");
+
+      switch (choice) {
+        case "1":
+          console.log("\nStoring custom message...");
+          const customMessage = await rl.question("Enter your message: ");
+          try {
+            const tx = await deployed.callTx.storeMessage(customMessage);
+            console.log("✅ Success!");
+            console.log(`Message: "${customMessage}"`);
+            console.log(`Transaction ID: ${tx.public.txId}`);
+            console.log(`Block height: ${tx.public.blockHeight}\n`);
+          } catch (error) {
+            console.error("❌ Failed to store message:", error);
+          }
+          break;
+
+        case "2":
+          console.log("\nReading message from blockchain...");
+          try {
+            const state = await providers.publicDataProvider.queryContractState(
+              deployment.contractAddress
+            );
+            if (state) {
+              const ledger = HelloWorldModule.ledger(state.data);
+              const message = Buffer.from(ledger.message).toString();
+              console.log(`📋 Current message: "${message}"\n`);
+            } else {
+              console.log("📋 No message found\n");
+            }
+          } catch (error) {
+            console.error("❌ Failed to read message:", error);
+          }
+          break;
+
+        case "3":
+          running = false;
+          console.log("\n👋 Goodbye!");
+          break;
+
+        default:
+          console.log("❌ Invalid choice. Please enter 1, 2, or 3.\n");
+      }
+    }
+
+    // Clean up
+    await wallet.close();
+  } catch (error) {
+    console.error("\n❌ Error:", error);
+  } finally {
+    rl.close();
+  }
+}
+
+main().catch(console.error);