@awarizon/cli 1.0.0

package/dist/index.mjs

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/generate.ts
+import fs from "fs-extra";
+import path from "path";
+
+// src/codegen.ts
+import { parseABI, generateAllMethodSignatures } from "@awarizon/abi-engine";
+function generateContractClient(contractName, address, abi) {
+  const parsed = parseABI(abi);
+  const methods = generateAllMethodSignatures(parsed);
+  const readMethods = methods.filter((m) => m.kind === "read");
+  const writeMethods = methods.filter((m) => m.kind !== "read");
+  const methodDocs = methods.map((m) => {
+    const tag = m.kind === "read" ? "@read" : m.kind === "payable" ? "@write @payable" : "@write";
+    return `  /**
+   * ${tag}
+   * @signature ${m.signature}
+   */
+  ${m.signature};`;
+  }).join("\n\n");
+  const methodImpls = methods.map((m) => {
+    const params = m.params.map((p) => p.name).join(", ");
+    const args = params ? `[${params}]` : "[]";
+    if (m.kind === "read") {
+      return `  async ${m.name}(${m.params.map((p) => `${p.name}: ${p.type}`).join(", ")}) {
+    return this._contract.${m.name}(${params});
+  }`;
+    }
+    return `  async ${m.name}(${m.params.map((p) => `${p.name}: ${p.type}`).join(", ")}) {
+    return this._contract.${m.name}(${params});
+  }`;
+  }).join("\n\n");
+  return `// Auto-generated by @awarizon/cli \u2014 do not edit manually
+// Contract: ${contractName}
+// Address:  ${address}
+// Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+import { AwarizonWeb3 } from "@awarizon/web3";
+import type { ContractInstance, TransactionResult } from "@awarizon/web3";
+
+const CONTRACT_ADDRESS = "${address}" as const;
+
+const ABI = ${JSON.stringify(abi, null, 2)} as const;
+
+// \u2500\u2500\u2500 Typed interface \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export interface ${contractName}Contract {
+${methodDocs}
+
+  on(event: string, callback: (log: unknown) => void): () => void;
+  estimateGas(method: string, ...args: unknown[]): Promise<bigint>;
+}
+
+// \u2500\u2500\u2500 Client class \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export class ${contractName}Client {
+  private _contract!: ContractInstance;
+
+  private constructor() {}
+
+  static async create(sdk: AwarizonWeb3): Promise<${contractName}Client> {
+    const client = new ${contractName}Client();
+    client._contract = await sdk.contract({ address: CONTRACT_ADDRESS, abi: ABI });
+    return client;
+  }
+
+${methodImpls}
+
+  on(event: string, callback: (log: unknown) => void) {
+    return this._contract.on(event, callback);
+  }
+
+  async estimateGas(method: string, ...args: unknown[]) {
+    return this._contract.estimateGas(method, ...args);
+  }
+}
+`;
+}
+function generateReactHooks(contractName, address, abi) {
+  const parsed = parseABI(abi);
+  const methods = generateAllMethodSignatures(parsed);
+  const readHooks = parsed.readFunctions.map((fn) => {
+    const meta = methods.find((m) => m.name === fn.name);
+    const paramList = meta.params.map((p) => `${p.name}: ${p.type}`).join(", ");
+    const paramNames = meta.params.map((p) => p.name).join(", ");
+    const argsExpr = paramNames ? `[${paramNames}]` : "[]";
+    return `/**
+ * Hook to read \`${fn.name}\` from ${contractName}.
+ * @example
+ * const { data } = useRead${capitalize(fn.name)}(${paramNames})
+ */
+export function useRead${capitalize(fn.name)}(${paramList}) {
+  return useReadContract({
+    address: "${address}",
+    abi: ${contractName.toUpperCase()}_ABI as any,
+    method: "${fn.name}",
+    args: ${argsExpr},
+  });
+}`;
+  }).join("\n\n");
+  const writeHooks = parsed.writeFunctions.map((fn) => {
+    return `/**
+ * Hook to call \`${fn.name}\` on ${contractName}.
+ * @example
+ * const { write } = useWrite${capitalize(fn.name)}()
+ * await write(${parsed.writeFunctions.find((f) => f.name === fn.name)?.inputs.map((i) => i.name).join(", ")})
+ */
+export function useWrite${capitalize(fn.name)}() {
+  return useWriteContract({
+    address: "${address}",
+    abi: ${contractName.toUpperCase()}_ABI as any,
+    method: "${fn.name}",
+  });
+}`;
+  }).join("\n\n");
+  const eventSubscriptions = parsed.events.map((ev) => {
+    return `/**
+ * Hook to subscribe to the \`${ev.name}\` event on ${contractName}.
+ */
+export function use${contractName}${capitalize(ev.name)}Event(
+  callback: (log: unknown) => void,
+  enabled = true,
+) {
+  const { contract } = useContract({ address: "${address}", abi: ${contractName.toUpperCase()}_ABI as any });
+
+  useEffect(() => {
+    if (!enabled || !contract) return;
+    const unsubscribe = contract.on("${ev.name}", callback);
+    return unsubscribe;
+  }, [contract, enabled, callback]);
+}`;
+  }).join("\n\n");
+  return `// Auto-generated by @awarizon/cli \u2014 do not edit manually
+// React hooks for: ${contractName}
+// Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+import { useEffect } from "react";
+import {
+  useContract,
+  useReadContract,
+  useWriteContract,
+} from "@awarizon/react";
+
+const ${contractName.toUpperCase()}_ABI = ${JSON.stringify(abi, null, 2)} as const;
+
+// \u2500\u2500\u2500 Read hooks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+${readHooks}
+
+// \u2500\u2500\u2500 Write hooks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+${writeHooks}
+
+// \u2500\u2500\u2500 Event hooks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+${eventSubscriptions}
+`;
+}
+function capitalize(s) {
+  return s.charAt(0).toUpperCase() + s.slice(1);
+}
+
+// src/commands/generate.ts
+function registerGenerateCommand(program2) {
+  program2.command("generate").alias("gen").description("Generate a typed contract client and React hooks from an ABI file").requiredOption("-a, --abi <path>", "Path to ABI JSON file").requiredOption("-n, --name <name>", "Contract name in PascalCase (e.g. StakingPool)").requiredOption("--address <address>", "Deployed contract address (0x...)").option("-o, --out <dir>", "Output directory", "./src/contracts").option("--no-react", "Skip React hooks generation").action(async (opts) => {
+    const chalk = (await import("chalk")).default;
+    const ora = (await import("ora")).default;
+    const spinner = ora("Reading ABI\u2026").start();
+    try {
+      const abiPath = path.resolve(process.cwd(), opts.abi);
+      if (!fs.existsSync(abiPath)) {
+        spinner.fail(chalk.red(`ABI file not found: ${abiPath}`));
+        process.exit(1);
+      }
+      const raw = await fs.readJson(abiPath);
+      const abi = Array.isArray(raw) ? raw : raw.abi;
+      if (!Array.isArray(abi)) {
+        spinner.fail(chalk.red('Invalid ABI: expected an array or an object with an "abi" field.'));
+        process.exit(1);
+      }
+      const outDir = path.resolve(process.cwd(), opts.out);
+      await fs.ensureDir(outDir);
+      spinner.text = `Generating ${opts.name}Client\u2026`;
+      const clientCode = generateContractClient(opts.name, opts.address, abi);
+      const clientFile = path.join(outDir, `${opts.name}Client.ts`);
+      await fs.writeFile(clientFile, clientCode, "utf-8");
+      let hooksFile = null;
+      if (opts.react !== false) {
+        spinner.text = `Generating React hooks for ${opts.name}\u2026`;
+        const hooksCode = generateReactHooks(opts.name, opts.address, abi);
+        hooksFile = path.join(outDir, `use${opts.name}.ts`);
+        await fs.writeFile(hooksFile, hooksCode, "utf-8");
+      }
+      spinner.succeed(chalk.green(`Generated ${opts.name} contract client`));
+      console.log("");
+      console.log(chalk.bold("  Output files:"));
+      console.log(`  ${chalk.cyan("\u2192")} ${clientFile}`);
+      if (hooksFile) console.log(`  ${chalk.cyan("\u2192")} ${hooksFile}`);
+      console.log("");
+      console.log(chalk.bold("  Usage:"));
+      console.log(`  ${chalk.gray("// Instantiate")}`);
+      console.log(`  ${chalk.white(`const client = await ${opts.name}Client.create(sdk)`)}`);
+      console.log("");
+    } catch (err) {
+      spinner.fail(chalk.red(`Generation failed: ${err.message}`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/index.ts
+var program = new Command();
+program.name("awarizon").description(
+  "Awarizon Web3 CLI \u2014 generate typed contract clients and React hooks from ABI files"
+).version("1.0.0");
+registerGenerateCommand(program);
+program.command("info").description("Print SDK version and supported chains").action(async () => {
+  const chalk = (await import("chalk")).default;
+  console.log("");
+  console.log(chalk.bold.cyan("  @awarizon/web3 \u2014 EVM Blockchain SDK"));
+  console.log(`  ${"\u2500".repeat(40)}`);
+  console.log(`  ${chalk.bold("Version:")}   1.0.0`);
+  console.log(`  ${chalk.bold("Engine:")}    viem`);
+  console.log("");
+  console.log(`  ${chalk.bold("Supported chains:")}`);
+  const chains = [
+    "mainnet / ethereum",
+    "base",
+    "base-sepolia",
+    "polygon",
+    "arbitrum",
+    "optimism",
+    "bsc",
+    "avalanche",
+    "sepolia",
+    "linea",
+    "scroll",
+    "zora",
+    "mantle",
+    "celo"
+  ];
+  for (const c of chains) {
+    console.log(`    ${chalk.cyan("\u2022")} ${c}`);
+  }
+  console.log("");
+  console.log(`  ${chalk.dim("https://github.com/awarizon/web3")}`);
+  console.log("");
+});
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@awarizon/cli",
+  "version": "1.0.0",
+  "description": "CLI for Awarizon Web3 SDK — generate typed contract clients and React hooks",
+  "bin": { "awarizon": "./dist/index.js" },
+  "main": "./dist/index.js",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@awarizon/abi-engine": "workspace:*",
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "tsup": "^8.2.0",
+    "vitest": "^2.0.0",
+    "@types/fs-extra": "^11.0.0",
+    "viem": "^2.21.0",
+    "rimraf": "^5.0.0"
+  }
+}