quantumcoin 7.0.2 → 7.0.4

package/examples/example-generator-sdk-js.js

@@ -1,95 +1,100 @@
-/**
- * SDK Generator example (JavaScript output)
- *
- * What this does:
- * - Compiles `SimpleIERC20.sol` with solc at `c:\solc\solc.exe`
- * - Writes `sdk-generator-erc20.inline.json` containing inline ABI+BIN
- * - Runs the repo's `generate-sdk.js` using `--artifacts-json --lang js`
- * - Generates a full typed package scaffold into `examples/example-generated-sdk-js`
- *
- * Usage (from repo root):
- *   node examples/example-generator-sdk-js.js
- */
-
-const fs = require("node:fs");
-const path = require("node:path");
-const { execFileSync, spawnSync } = require("node:child_process");
-
-function compileSimpleErc20({ solcPath, solPath }) {
-  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
-  const parsed = JSON.parse(out);
-
-  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
-  if (!key) {
-    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
-  }
-  const c = parsed.contracts[key];
-  const abi = JSON.parse(c.abi);
-  const bin = String(c.bin || "");
-  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
-  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
-
-  return { name: "SimpleERC20", abi, bin: bytecode };
-}
-
-function main() {
-  const repoRoot = path.resolve(__dirname, "..");
-  const solcPath = "c:\\solc\\solc.exe";
-
-  if (!fs.existsSync(solcPath)) {
-    throw new Error(`solc not found at ${solcPath}. Install solc there or update examples/example-generator-sdk-js.js.`);
-  }
-
-  const solPath = path.join(__dirname, "SimpleIERC20.sol");
-  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
-
-  // 1) Compile and write inline artifacts JSON (ABI array + BIN string).
-  const artifact = compileSimpleErc20({ solcPath, solPath });
-  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
-
-  // 2) Generate a new package into examples/example-generated-sdk-js (delete old one first).
-  const pkgDir = __dirname;
-  const pkgName = "example-generated-sdk-js";
-  const pkgRoot = path.join(pkgDir, pkgName);
-  if (fs.existsSync(pkgRoot)) {
-    fs.rmSync(pkgRoot, { recursive: true, force: true });
-  }
-
-  const generatorCli = path.join(repoRoot, "generate-sdk.js");
-  const res = spawnSync(
-    process.execPath,
-    [
-      generatorCli,
-      "--lang",
-      "js",
-      "--artifacts-json",
-      artifactsJsonPath,
-      "--create-package",
-      "--package-dir",
-      pkgDir,
-      "--package-name",
-      pkgName,
-      "--package-description",
-      "Example generated package (JS output) for quantumcoin-sdk-generator",
-      "--package-author",
-      "QuantumCoin Community",
-      "--package-license",
-      "MIT",
-      "--package-version",
-      "0.0.1",
-      "--non-interactive",
-    ],
-    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
-  );
-
-  if (res.error) throw res.error;
-  if (res.status !== 0) {
-    throw new Error(`Generator failed with exit code ${res.status}`);
-  }
-
-  // eslint-disable-next-line no-console
-  console.log(`\nGenerated JS package at: ${pkgRoot}\n`);
-}
-
-main();
-
+/**
+ * SDK Generator example (JavaScript output)
+ * Run with VERBOSE=1 for step-by-step logging.
+ *
+ * What this does:
+ * - Compiles `SimpleIERC20.sol` with solc (path from QC_SOLC_PATH or SOLC_PATH env, else c:\solc\solc.exe)
+ * - Writes `sdk-generator-erc20.inline.json` containing inline ABI+BIN
+ * - Runs the repo's `generate-sdk.js` using `--artifacts-json --lang js`
+ * - Generates a full typed package scaffold into `examples/example-generated-sdk-js`
+ *
+ * Usage (from repo root):
+ *   node examples/example-generator-sdk-js.js
+ */
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { execFileSync, spawnSync } = require("node:child_process");
+const { logExample } = require("../test/verbose-logger");
+
+function compileSimpleErc20({ solcPath, solPath }) {
+  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
+  const parsed = JSON.parse(out);
+
+  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
+  if (!key) {
+    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
+  }
+  const c = parsed.contracts[key];
+  const abi = JSON.parse(c.abi);
+  const bin = String(c.bin || "");
+  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
+  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
+
+  return { name: "SimpleERC20", abi, bin: bytecode };
+}
+
+function main() {
+  const solcPath = process.env.QC_SOLC_PATH || process.env.SOLC_PATH || "c:\\solc\\solc.exe";
+  logExample("example-generator-sdk-js.js", "starting", { solcPath });
+  const repoRoot = path.resolve(__dirname, "..");
+
+  if (!fs.existsSync(solcPath)) {
+    throw new Error(`solc not found at ${solcPath}. Set QC_SOLC_PATH or SOLC_PATH to your solc executable, or install solc at the default path.`);
+  }
+
+  const solPath = path.join(__dirname, "SimpleIERC20.sol");
+  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
+
+  // 1) Compile and write inline artifacts JSON (ABI array + BIN string).
+  const artifact = compileSimpleErc20({ solcPath, solPath });
+  logExample("example-generator-sdk-js.js", "compile SimpleERC20", { contractName: artifact.name });
+  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
+
+  // 2) Generate a new package into examples/example-generated-sdk-js (delete old one first).
+  const pkgDir = __dirname;
+  const pkgName = "example-generated-sdk-js";
+  const pkgRoot = path.join(pkgDir, pkgName);
+  if (fs.existsSync(pkgRoot)) {
+    fs.rmSync(pkgRoot, { recursive: true, force: true });
+  }
+  logExample("example-generator-sdk-js.js", "generate package", { pkgName, pkgRoot });
+
+  const generatorCli = path.join(repoRoot, "generate-sdk.js");
+  const res = spawnSync(
+    process.execPath,
+    [
+      generatorCli,
+      "--lang",
+      "js",
+      "--artifacts-json",
+      artifactsJsonPath,
+      "--create-package",
+      "--package-dir",
+      pkgDir,
+      "--package-name",
+      pkgName,
+      "--package-description",
+      "Example generated package (JS output) for sdkgen",
+      "--package-author",
+      "QuantumCoin Community",
+      "--package-license",
+      "MIT",
+      "--package-version",
+      "0.0.1",
+      "--non-interactive",
+    ],
+    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
+  );
+
+  if (res.error) throw res.error;
+  if (res.status !== 0) {
+    throw new Error(`Generator failed with exit code ${res.status}`);
+  }
+
+  // eslint-disable-next-line no-console
+  console.log(`\nGenerated JS package at: ${pkgRoot}\n`);
+}
+
+main();
+

package/examples/example-generator-sdk-js.ts

@@ -0,0 +1,77 @@
+/**
+ * SDK Generator example (JavaScript output) - TypeScript.
+ * Run: npx tsx examples/example-generator-sdk-js.ts
+ * Compiles SimpleIERC20.sol, writes sdk-generator-erc20.inline.json, runs generate-sdk.js --lang js.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync, spawnSync } from "node:child_process";
+import { logExample } from "../test/verbose-logger";
+
+function compileSimpleErc20({ solcPath, solPath }: { solcPath: string; solPath: string }) {
+  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
+  const parsed = JSON.parse(out);
+  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
+  if (!key) {
+    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
+  }
+  const c = parsed.contracts[key];
+  const abi = JSON.parse(c.abi);
+  const bin = String(c.bin || "");
+  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
+  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
+  return { name: "SimpleERC20", abi, bin: bytecode };
+}
+
+function main(): void {
+  const solcPath = process.env.QC_SOLC_PATH || process.env.SOLC_PATH || "c:\\solc\\solc.exe";
+  logExample("example-generator-sdk-js.ts", "starting", { solcPath });
+  const repoRoot = path.resolve(__dirname, "..");
+
+  if (!fs.existsSync(solcPath)) {
+    throw new Error(`solc not found at ${solcPath}. Set QC_SOLC_PATH or SOLC_PATH.`);
+  }
+
+  const solPath = path.join(__dirname, "SimpleIERC20.sol");
+  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
+
+  const artifact = compileSimpleErc20({ solcPath, solPath });
+  logExample("example-generator-sdk-js.ts", "compile SimpleERC20", { contractName: artifact.name });
+  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
+
+  const pkgDir = __dirname;
+  const pkgName = "example-generated-sdk-js";
+  const pkgRoot = path.join(pkgDir, pkgName);
+  if (fs.existsSync(pkgRoot)) {
+    fs.rmSync(pkgRoot, { recursive: true, force: true });
+  }
+  logExample("example-generator-sdk-js.ts", "generate package", { pkgName, pkgRoot });
+
+  const generatorCli = path.join(repoRoot, "generate-sdk.js");
+  const res = spawnSync(
+    process.execPath,
+    [
+      generatorCli,
+      "--lang", "js",
+      "--artifacts-json", artifactsJsonPath,
+      "--create-package",
+      "--package-dir", pkgDir,
+      "--package-name", pkgName,
+      "--package-description", "Example generated package (JS output) for sdkgen",
+      "--package-author", "QuantumCoin Community",
+      "--package-license", "MIT",
+      "--package-version", "0.0.1",
+      "--non-interactive",
+    ],
+    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
+  );
+
+  if (res.error) throw res.error;
+  if (res.status !== 0) {
+    throw new Error(`Generator failed with exit code ${res.status}`);
+  }
+  console.log(`\nGenerated JS package at: ${pkgRoot}\n`);
+}
+
+main();

package/examples/example-generator-sdk-ts.js

@@ -1,95 +1,100 @@
-/**
- * SDK Generator example (TypeScript output)
- *
- * What this does:
- * - Compiles `SimpleIERC20.sol` with solc at `c:\solc\solc.exe`
- * - Writes `sdk-generator-erc20.inline.json` containing inline ABI+BIN
- * - Runs the repo's `generate-sdk.js` using `--artifacts-json --lang ts`
- * - Generates a full typed package scaffold into `examples/example-generated-sdk-ts`
- *
- * Usage (from repo root):
- *   node examples/example-generator-sdk-ts.js
- */
-
-const fs = require("node:fs");
-const path = require("node:path");
-const { execFileSync, spawnSync } = require("node:child_process");
-
-function compileSimpleErc20({ solcPath, solPath }) {
-  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
-  const parsed = JSON.parse(out);
-
-  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
-  if (!key) {
-    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
-  }
-  const c = parsed.contracts[key];
-  const abi = JSON.parse(c.abi);
-  const bin = String(c.bin || "");
-  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
-  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
-
-  return { name: "SimpleERC20", abi, bin: bytecode };
-}
-
-function main() {
-  const repoRoot = path.resolve(__dirname, "..");
-  const solcPath = "c:\\solc\\solc.exe";
-
-  if (!fs.existsSync(solcPath)) {
-    throw new Error(`solc not found at ${solcPath}. Install solc there or update examples/example-generator-sdk-ts.js.`);
-  }
-
-  const solPath = path.join(__dirname, "SimpleIERC20.sol");
-  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
-
-  // 1) Compile and write inline artifacts JSON (ABI array + BIN string).
-  const artifact = compileSimpleErc20({ solcPath, solPath });
-  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
-
-  // 2) Generate a new package into examples/example-generated-sdk-ts (delete old one first).
-  const pkgDir = __dirname;
-  const pkgName = "example-generated-sdk-ts";
-  const pkgRoot = path.join(pkgDir, pkgName);
-  if (fs.existsSync(pkgRoot)) {
-    fs.rmSync(pkgRoot, { recursive: true, force: true });
-  }
-
-  const generatorCli = path.join(repoRoot, "generate-sdk.js");
-  const res = spawnSync(
-    process.execPath,
-    [
-      generatorCli,
-      "--lang",
-      "ts",
-      "--artifacts-json",
-      artifactsJsonPath,
-      "--create-package",
-      "--package-dir",
-      pkgDir,
-      "--package-name",
-      pkgName,
-      "--package-description",
-      "Example generated package (TS output) for quantumcoin-sdk-generator",
-      "--package-author",
-      "QuantumCoin Community",
-      "--package-license",
-      "MIT",
-      "--package-version",
-      "0.0.1",
-      "--non-interactive",
-    ],
-    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
-  );
-
-  if (res.error) throw res.error;
-  if (res.status !== 0) {
-    throw new Error(`Generator failed with exit code ${res.status}`);
-  }
-
-  // eslint-disable-next-line no-console
-  console.log(`\nGenerated TS package at: ${pkgRoot}\n`);
-}
-
-main();
-
+/**
+ * SDK Generator example (TypeScript output)
+ * Run with VERBOSE=1 for step-by-step logging.
+ *
+ * What this does:
+ * - Compiles `SimpleIERC20.sol` with solc (path from QC_SOLC_PATH or SOLC_PATH env, else c:\solc\solc.exe)
+ * - Writes `sdk-generator-erc20.inline.json` containing inline ABI+BIN
+ * - Runs the repo's `generate-sdk.js` using `--artifacts-json --lang ts`
+ * - Generates a full typed package scaffold into `examples/example-generated-sdk-ts`
+ *
+ * Usage (from repo root):
+ *   node examples/example-generator-sdk-ts.js
+ */
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { execFileSync, spawnSync } = require("node:child_process");
+const { logExample } = require("../test/verbose-logger");
+
+function compileSimpleErc20({ solcPath, solPath }) {
+  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
+  const parsed = JSON.parse(out);
+
+  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
+  if (!key) {
+    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
+  }
+  const c = parsed.contracts[key];
+  const abi = JSON.parse(c.abi);
+  const bin = String(c.bin || "");
+  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
+  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
+
+  return { name: "SimpleERC20", abi, bin: bytecode };
+}
+
+function main() {
+  const solcPath = process.env.QC_SOLC_PATH || process.env.SOLC_PATH || "c:\\solc\\solc.exe";
+  logExample("example-generator-sdk-ts.js", "starting", { solcPath });
+  const repoRoot = path.resolve(__dirname, "..");
+
+  if (!fs.existsSync(solcPath)) {
+    throw new Error(`solc not found at ${solcPath}. Set QC_SOLC_PATH or SOLC_PATH to your solc executable, or install solc at the default path.`);
+  }
+
+  const solPath = path.join(__dirname, "SimpleIERC20.sol");
+  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
+
+  // 1) Compile and write inline artifacts JSON (ABI array + BIN string).
+  const artifact = compileSimpleErc20({ solcPath, solPath });
+  logExample("example-generator-sdk-ts.js", "compile SimpleERC20", { contractName: artifact.name });
+  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
+
+  // 2) Generate a new package into examples/example-generated-sdk-ts (delete old one first).
+  const pkgDir = __dirname;
+  const pkgName = "example-generated-sdk-ts";
+  const pkgRoot = path.join(pkgDir, pkgName);
+  if (fs.existsSync(pkgRoot)) {
+    fs.rmSync(pkgRoot, { recursive: true, force: true });
+  }
+  logExample("example-generator-sdk-ts.js", "generate package", { pkgName, pkgRoot });
+
+  const generatorCli = path.join(repoRoot, "generate-sdk.js");
+  const res = spawnSync(
+    process.execPath,
+    [
+      generatorCli,
+      "--lang",
+      "ts",
+      "--artifacts-json",
+      artifactsJsonPath,
+      "--create-package",
+      "--package-dir",
+      pkgDir,
+      "--package-name",
+      pkgName,
+      "--package-description",
+      "Example generated package (TS output) for sdkgen",
+      "--package-author",
+      "QuantumCoin Community",
+      "--package-license",
+      "MIT",
+      "--package-version",
+      "0.0.1",
+      "--non-interactive",
+    ],
+    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
+  );
+
+  if (res.error) throw res.error;
+  if (res.status !== 0) {
+    throw new Error(`Generator failed with exit code ${res.status}`);
+  }
+
+  // eslint-disable-next-line no-console
+  console.log(`\nGenerated TS package at: ${pkgRoot}\n`);
+}
+
+main();
+

package/examples/example-generator-sdk-ts.ts

@@ -0,0 +1,77 @@
+/**
+ * SDK Generator example (TypeScript output) - TypeScript.
+ * Run: npx tsx examples/example-generator-sdk-ts.ts
+ * Compiles SimpleIERC20.sol, writes sdk-generator-erc20.inline.json, runs generate-sdk.js --lang ts.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync, spawnSync } from "node:child_process";
+import { logExample } from "../test/verbose-logger";
+
+function compileSimpleErc20({ solcPath, solPath }: { solcPath: string; solPath: string }) {
+  const out = execFileSync(solcPath, ["--optimize", "--combined-json", "abi,bin", solPath], { encoding: "utf8" });
+  const parsed = JSON.parse(out);
+  const key = Object.keys(parsed.contracts || {}).find((k) => k.endsWith(":SimpleERC20"));
+  if (!key) {
+    throw new Error(`SimpleERC20 not found in solc output. Contracts: ${Object.keys(parsed.contracts || {}).join(", ")}`);
+  }
+  const c = parsed.contracts[key];
+  const abi = JSON.parse(c.abi);
+  const bin = String(c.bin || "");
+  if (!bin) throw new Error("solc produced empty bytecode for SimpleERC20");
+  const bytecode = bin.startsWith("0x") ? bin : `0x${bin}`;
+  return { name: "SimpleERC20", abi, bin: bytecode };
+}
+
+function main(): void {
+  const solcPath = process.env.QC_SOLC_PATH || process.env.SOLC_PATH || "c:\\solc\\solc.exe";
+  logExample("example-generator-sdk-ts.ts", "starting", { solcPath });
+  const repoRoot = path.resolve(__dirname, "..");
+
+  if (!fs.existsSync(solcPath)) {
+    throw new Error(`solc not found at ${solcPath}. Set QC_SOLC_PATH or SOLC_PATH.`);
+  }
+
+  const solPath = path.join(__dirname, "SimpleIERC20.sol");
+  const artifactsJsonPath = path.join(__dirname, "sdk-generator-erc20.inline.json");
+
+  const artifact = compileSimpleErc20({ solcPath, solPath });
+  logExample("example-generator-sdk-ts.ts", "compile SimpleERC20", { contractName: artifact.name });
+  fs.writeFileSync(artifactsJsonPath, JSON.stringify([artifact], null, 2) + "\n", "utf8");
+
+  const pkgDir = __dirname;
+  const pkgName = "example-generated-sdk-ts";
+  const pkgRoot = path.join(pkgDir, pkgName);
+  if (fs.existsSync(pkgRoot)) {
+    fs.rmSync(pkgRoot, { recursive: true, force: true });
+  }
+  logExample("example-generator-sdk-ts.ts", "generate package", { pkgName, pkgRoot });
+
+  const generatorCli = path.join(repoRoot, "generate-sdk.js");
+  const res = spawnSync(
+    process.execPath,
+    [
+      generatorCli,
+      "--lang", "ts",
+      "--artifacts-json", artifactsJsonPath,
+      "--create-package",
+      "--package-dir", pkgDir,
+      "--package-name", pkgName,
+      "--package-description", "Example generated package (TS output) for sdkgen",
+      "--package-author", "QuantumCoin Community",
+      "--package-license", "MIT",
+      "--package-version", "0.0.1",
+      "--non-interactive",
+    ],
+    { cwd: repoRoot, stdio: "inherit", shell: false, windowsHide: true },
+  );
+
+  if (res.error) throw res.error;
+  if (res.status !== 0) {
+    throw new Error(`Generator failed with exit code ${res.status}`);
+  }
+  console.log(`\nGenerated TS package at: ${pkgRoot}\n`);
+}
+
+main();