quantumcoin 7.0.14 → 8.0.0

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

@@ -1,77 +0,0 @@
-/**
- * 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,100 +0,0 @@
-/**
- * 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

@@ -1,77 +0,0 @@
-/**
- * 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();

package/examples/example.js

@@ -1,67 +0,0 @@
-/**
- * QuantumCoin.js Examples (non-transactional).
- *
- * Run:
- * - `node examples/example.js`
- * - `VERBOSE=1 node examples/example.js` for verbose logging (addresses, block hashes, etc.)
- *
- * These examples only perform:
- * - SDK initialization
- * - Read-only JSON-RPC queries
- * - Offline wallet operations (sign/encrypt)
- * - Read-only contract call against the system staking contract
- */
-
-const { Initialize } = require("../config");
-const qc = require("..");
-const { logExample, logAddress } = require("../test/verbose-logger");
-
-const RPC = "https://public.rpc.quantumcoinapi.com";
-const CHAIN_ID = 123123;
-const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00"; // 0x...1000
-
-async function main() {
-  logExample("example.js", "starting", { rpc: RPC, chainId: CHAIN_ID });
-
-  const ok = await Initialize(null);
-  if (!ok) throw new Error("Initialize failed");
-
-  console.log("SDK initialized:", qc.isInitialized());
-
-  // Provider: basic read-only calls (getProvider detects http/ws/ipc from endpoint)
-  const provider = qc.getProvider(RPC, CHAIN_ID);
-  const blockNumber = await provider.getBlockNumber();
-  console.log("Latest block:", blockNumber);
-  logExample("example.js", "getBlockNumber", { blockNumber });
-
-  const block = await provider.getBlock("latest");
-  console.log("Latest block hash:", block.hash);
-  logExample("example.js", "getBlock(latest)", { blockNumber: block.number, blockHash: block.hash });
-
-  const balance = await provider.getBalance(STAKING_CONTRACT);
-  console.log("Staking contract balance (wei):", balance.toString());
-  logAddress("staking_contract", STAKING_CONTRACT);
-  logExample("example.js", "getBalance", { balance: balance.toString() });
-
-  // Wallet: offline operations
-  const wallet = qc.Wallet.createRandom();
-  console.log("Random wallet address:", wallet.address);
-  logAddress("random_wallet", wallet.address);
-
-  const encrypted = wallet.encryptSync("mySecurePassword123");
-  console.log("Encrypted wallet JSON length:", encrypted.length);
-
-  // Contract: read-only call
-  const abi = require("../test/fixtures/StakingContract.abi.json");
-  const staking = new qc.Contract(STAKING_CONTRACT, abi, provider);
-  const depositorCount = await staking.getDepositorCount();
-  console.log("typeof depositorCount:", typeof depositorCount);
-  console.log("Depositor count:", depositorCount.toString());
-  logExample("example.js", "getDepositorCount", { depositorCount: depositorCount.toString() });
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exitCode = 1;
-});
-

package/examples/example.ts

@@ -1,56 +0,0 @@
-/**
- * QuantumCoin.js Examples (non-transactional) - TypeScript.
- *
- * Run: npx tsx examples/example.ts
- * VERBOSE=1 npx tsx examples/example.ts for verbose logging.
- */
-
-import { Initialize } from "../config";
-import qc from "..";
-import { logExample, logAddress } from "../test/verbose-logger";
-
-const RPC = "https://public.rpc.quantumcoinapi.com";
-const CHAIN_ID = 123123;
-const STAKING_CONTRACT = "0x" + "00".repeat(30) + "10" + "00";
-
-async function main(): Promise<void> {
-  logExample("example.ts", "starting", { rpc: RPC, chainId: CHAIN_ID });
-
-  const ok = await Initialize(null);
-  if (!ok) throw new Error("Initialize failed");
-
-  console.log("SDK initialized:", qc.isInitialized());
-
-  const provider = qc.getProvider(RPC, CHAIN_ID);
-  const blockNumber = await provider.getBlockNumber();
-  console.log("Latest block:", blockNumber);
-  logExample("example.ts", "getBlockNumber", { blockNumber });
-
-  const block = await provider.getBlock("latest");
-  console.log("Latest block hash:", block.hash);
-  logExample("example.ts", "getBlock(latest)", { blockNumber: block.number, blockHash: block.hash });
-
-  const balance = await provider.getBalance(STAKING_CONTRACT);
-  console.log("Staking contract balance (wei):", balance.toString());
-  logAddress("staking_contract", STAKING_CONTRACT);
-  logExample("example.ts", "getBalance", { balance: balance.toString() });
-
-  const wallet = qc.Wallet.createRandom();
-  console.log("Random wallet address:", wallet.address);
-  logAddress("random_wallet", wallet.address);
-
-  const encrypted = wallet.encryptSync("mySecurePassword123");
-  console.log("Encrypted wallet JSON length:", encrypted.length);
-
-  const abi = require("../test/fixtures/StakingContract.abi.json");
-  const staking = new qc.Contract(STAKING_CONTRACT, abi, provider);
-  const depositorCount = await staking.getDepositorCount();
-  console.log("typeof depositorCount:", typeof depositorCount);
-  console.log("Depositor count:", depositorCount.toString());
-  logExample("example.ts", "getDepositorCount", { depositorCount: depositorCount.toString() });
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exitCode = 1;
-});

package/examples/node_modules/.bin/esbuild

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../esbuild/bin/esbuild" "$@"
-else 
-  exec node  "$basedir/../esbuild/bin/esbuild" "$@"
-fi

package/examples/node_modules/.bin/esbuild.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\esbuild\bin\esbuild" %*

package/examples/node_modules/.bin/esbuild.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/examples/node_modules/.bin/sdkgen

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../quantumcoin/generate-sdk.js" "$@"
-else 
-  exec node  "$basedir/../quantumcoin/generate-sdk.js" "$@"
-fi

package/examples/node_modules/.bin/sdkgen.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\quantumcoin\generate-sdk.js" %*

package/examples/node_modules/.bin/sdkgen.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
-  } else {
-    & "node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/examples/node_modules/.bin/tsx

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
-else 
-  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
-fi

package/examples/node_modules/.bin/tsx.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\tsx\dist\cli.mjs" %*

package/examples/node_modules/.bin/tsx.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
-  } else {
-    & "node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret