quantum-coin-js-sdk 1.0.36 → 1.0.39

package/example/node_modules/quantumcoin/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Package entrypoint for `require("quantumcoin")`.
+ *
+ * This exports the ethers.js v6 compatible API surface implemented in `src/`,
+ * plus the initialization utilities from `config.js`.
+ */
+
+module.exports = {
+  ...require("./src"),
+  ...require("./config"),
+};
+

package/example/node_modules/quantumcoin/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "quantumcoin",
+  "version": "7.0.14",
+  "description": "QuantumCoin.js - a post quantum cryptography SDK for QuantumCoin",
+  "main": "index.js",
+  "types": "src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "types": [
+        "src/types/index.d.ts"
+      ],
+      "config": [
+        "config.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./index.js"
+    },
+    "./config": {
+      "types": "./config.d.ts",
+      "default": "./config.js"
+    },
+    "./types": {
+      "types": "./src/types/index.d.ts",
+      "default": "./src/types/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "test": "node --test \"test/unit/**/*.test.js\" \"test/integration/**/*.test.js\" \"test/security/**/*.test.js\" \"test/e2e/*.test.js\"",
+    "test:unit": "node --test \"test/unit/**/*.test.js\"",
+    "test:integration": "node --test \"test/integration/**/*.test.js\"",
+    "test:security": "node --test \"test/security/**/*.test.js\"",
+    "test:non-transactional": "node --test \"test/unit/**/*.test.js\" \"test/integration/**/*.test.js\" \"test/security/**/*.test.js\"",
+    "test:e2e": "node --test --test-concurrency=1 \"test/e2e/*.test.js\"",
+    "test:generator-sdk": "node --test \"test/unit/generate-contract-cli.test.js\" \"test/unit/generator.test.js\" \"test/unit/generate-sdk-artifacts-json.test.js\" && node --test --test-concurrency=1 \"test/e2e/typed-generator.e2e.test.js\" \"test/e2e/simple-erc20.generated-sdks.e2e.test.js\" \"test/e2e/all-solidity-types.generated-sdks.e2e.test.js\"",
+    "test:ts:generator-sdk": "npx tsx --test \"test/unit/generate-contract-cli.test.ts\" \"test/unit/generator.test.ts\" \"test/unit/generate-sdk-artifacts-json.test.ts\" && npx tsx --test --test-concurrency=1 \"test/e2e/typed-generator.e2e.test.ts\" \"test/e2e/simple-erc20.generated-sdks.e2e.test.ts\" \"test/e2e/all-solidity-types.generated-sdks.e2e.test.ts\"",
+    "test:ts": "npx tsx --test \"test/unit/**/*.test.ts\" \"test/integration/**/*.test.ts\" \"test/security/**/*.test.ts\"",
+    "test:ts:unit": "npx tsx --test \"test/unit/**/*.test.ts\"",
+    "test:ts:integration": "npx tsx --test \"test/integration/**/*.test.ts\"",
+    "test:ts:security": "npx tsx --test \"test/security/**/*.test.ts\"",
+    "test:ts:e2e": "npx tsx --test --test-concurrency=1 \"test/e2e/*.test.ts\" \"test/e2e/*.e2e.test.ts\" \"test/e2e/*.dynamic.test.ts\"",
+    "example": "node examples/example.js",
+    "example:ts": "npx tsx examples/example.ts",
+    "example:provider": "node examples/example.js",
+    "example:wallet": "node examples/wallet-offline.js",
+    "example:wallet:ts": "npx tsx examples/wallet-offline.ts",
+    "example:contract:read": "node examples/read-operations.js",
+    "example:contract:read:ts": "npx tsx examples/read-operations.ts",
+    "example:events": "node examples/events.js",
+    "example:events:ts": "npx tsx examples/events.ts",
+    "example:offline-signing": "node examples/offline-signing.js",
+    "example:offline-signing:ts": "npx tsx examples/offline-signing.ts",
+    "example:generator-js": "node examples/example-generator-sdk-js.js",
+    "example:generator-js:ts": "npx tsx examples/example-generator-sdk-js.ts",
+    "example:generator-ts": "node examples/example-generator-sdk-ts.js",
+    "example:generator-ts:ts": "npx tsx examples/example-generator-sdk-ts.ts",
+    "examples": "node examples/example.js && node examples/wallet-offline.js && node examples/read-operations.js && node examples/events.js && node examples/example-generator-sdk-js.js && node examples/example-generator-sdk-ts.js",
+    "examples:ts": "npx tsx examples/example.ts && npx tsx examples/wallet-offline.ts && npx tsx examples/read-operations.ts && npx tsx examples/events.ts && npx tsx examples/example-generator-sdk-js.ts && npx tsx examples/example-generator-sdk-ts.ts",
+    "build": "npx -p typescript tsc -p tsconfig.build.json && node scripts/copy-declarations.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quantumcoinproject/quantumcoin.js.git"
+  },
+  "files": [
+    "**"
+  ],
+  "keywords": [
+    "cryptography",
+    "quantum coins",
+    "quantum coin",
+    "quantumcoin",
+    "blockchain"
+  ],
+  "author": "QuantumCoin Community",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/quantumcoinproject/quantumcoin.js/issues"
+  },
+  "homepage": "https://github.com/quantumcoinproject/quantumcoin.js#readme",
+  "bin": {
+    "sdkgen": "./generate-sdk.js"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0"
+  },
+  "dependencies": {
+    "seed-words": "^1.0.2",
+    "quantum-coin-js-sdk": "1.0.36"
+  }
+}

package/example/node_modules/quantumcoin/scripts/copy-declarations.js

@@ -0,0 +1,31 @@
+/**
+ * Copy generated .d.ts from dist/ into src/ so that package types stay in sync
+ * with the declarations emitted by `tsc` from JSDoc in the .js sources.
+ * Run after `npm run build`.
+ */
+const fs = require("fs");
+const path = require("path");
+
+const distDir = path.join(__dirname, "..", "dist");
+const srcDir = path.join(__dirname, "..", "src");
+
+if (!fs.existsSync(distDir)) {
+  console.warn("scripts/copy-declarations.js: dist/ not found, run build first.");
+  process.exit(0);
+}
+
+function copyRecursive(from, to) {
+  for (const name of fs.readdirSync(from)) {
+    const fromPath = path.join(from, name);
+    const toPath = path.join(to, name);
+    if (fs.statSync(fromPath).isDirectory()) {
+      if (!fs.existsSync(toPath)) fs.mkdirSync(toPath, { recursive: true });
+      copyRecursive(fromPath, toPath);
+    } else {
+      fs.copyFileSync(fromPath, toPath);
+    }
+  }
+}
+
+copyRecursive(distDir, srcDir);
+console.log("Declarations copied from dist/ to src/.");

package/example/node_modules/quantumcoin/scripts/run-all-one-by-one.js

@@ -0,0 +1,151 @@
+/**
+ * Run all tests and examples one by one with process.env (set QC_RPC_URL, QC_SOLC_PATH).
+ * Prints a status table at the end.
+ * Usage: node scripts/run-all-one-by-one.js
+ */
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+
+const repoRoot = path.resolve(__dirname, "..");
+const isWin = process.platform === "win32";
+
+function run(cmd, args, opts = {}) {
+  const cwd = opts.cwd || repoRoot;
+  const env = { ...process.env, ...opts.env };
+  const res = spawnSync(cmd, args, {
+    cwd,
+    env,
+    encoding: "utf8",
+    stdio: "pipe",
+    shell: false,
+    windowsHide: true,
+    timeout: opts.timeout ?? 120000,
+  });
+  return { ...res, status: res.status ?? (res.signal ? 1 : 0) };
+}
+
+function runShell(cmdLine, opts = {}) {
+  const cwd = opts.cwd || repoRoot;
+  const env = { ...process.env, ...opts.env };
+  if (isWin) {
+    return spawnSync("cmd.exe", ["/d", "/s", "/c", cmdLine], {
+      cwd,
+      env,
+      encoding: "utf8",
+      stdio: "pipe",
+      windowsHide: true,
+      timeout: opts.timeout ?? 120000,
+    });
+  }
+  return spawnSync("sh", ["-c", cmdLine], {
+    cwd,
+    env,
+    encoding: "utf8",
+    stdio: "pipe",
+    timeout: opts.timeout ?? 120000,
+  });
+}
+
+const results = [];
+
+function add(name, ok, errMsg = "") {
+  results.push({ name, status: ok ? "PASS" : "FAIL", err: errMsg });
+  process.stdout.write(ok ? "." : "F");
+}
+
+// Unit tests (node --test single file)
+const unitDir = path.join(repoRoot, "test", "unit");
+const unitFiles = fs.readdirSync(unitDir)
+  .filter((f) => f.endsWith(".test.js"))
+  .sort();
+for (const f of unitFiles) {
+  const name = `unit / ${f}`;
+  const r = run(process.execPath, ["--test", path.join(unitDir, f)], { timeout: 60000 });
+  add(name, r.status === 0, r.stderr || r.stdout);
+}
+
+// Integration
+const intDir = path.join(repoRoot, "test", "integration");
+const intFiles = fs.readdirSync(intDir)
+  .filter((f) => f.endsWith(".test.js"))
+  .sort();
+for (const f of intFiles) {
+  const name = `integration / ${f}`;
+  const r = run(process.execPath, ["--test", path.join(intDir, f)], { timeout: 60000 });
+  add(name, r.status === 0, r.stderr || r.stdout);
+}
+
+// Security
+const secDir = path.join(repoRoot, "test", "security");
+const secFiles = fs.readdirSync(secDir)
+  .filter((f) => f.endsWith(".test.js"))
+  .sort();
+for (const f of secFiles) {
+  const name = `security / ${f}`;
+  const r = run(process.execPath, ["--test", path.join(secDir, f)], { timeout: 60000 });
+  add(name, r.status === 0, r.stderr || r.stdout);
+}
+
+// E2E (one by one, longer timeout)
+const e2eDir = path.join(repoRoot, "test", "e2e");
+const e2eFiles = fs.readdirSync(e2eDir)
+  .filter((f) => f.endsWith(".test.js"))
+  .sort();
+for (const f of e2eFiles) {
+  const name = `e2e / ${f}`;
+  const r = run(process.execPath, ["--test", "--test-concurrency=1", path.join(e2eDir, f)], { timeout: 180000 });
+  add(name, r.status === 0, r.stderr || r.stdout);
+}
+
+// Examples (JS)
+const examples = [
+  ["example.js", [process.execPath, "examples/example.js"]],
+  ["wallet-offline.js", [process.execPath, "examples/wallet-offline.js"]],
+  ["read-operations.js", [process.execPath, "examples/read-operations.js"]],
+  ["events.js", [process.execPath, "examples/events.js"]],
+  ["offline-signing.js", [process.execPath, "examples/offline-signing.js"]],
+  ["example-generator-sdk-js.js", [process.execPath, "examples/example-generator-sdk-js.js"]],
+  ["example-generator-sdk-ts.js", [process.execPath, "examples/example-generator-sdk-ts.js"]],
+];
+for (const [label, [cmd, ...args]] of examples) {
+  const r = run(cmd, args, { timeout: 90000 });
+  add(`example / ${label}`, r.status === 0, r.stderr || r.stdout);
+}
+
+// Examples (TS via npx tsx)
+const examplesTs = [
+  "example.ts",
+  "wallet-offline.ts",
+  "read-operations.ts",
+  "events.ts",
+  "offline-signing.ts",
+  "example-generator-sdk-js.ts",
+  "example-generator-sdk-ts.ts",
+];
+for (const f of examplesTs) {
+  const name = `example / ${f}`;
+  const r = runShell(`npx tsx examples/${f}`, { timeout: 90000 });
+  const status = r.status ?? (r.signal ? 1 : 0);
+  add(name, status === 0, r.stderr || r.stdout);
+}
+
+// Print table
+console.log("\n\n| Category   | Item | Status |");
+console.log("|------------|------|--------|");
+let lastCat = "";
+for (const { name, status } of results) {
+  const [cat, item] = name.split(" / ");
+  const catDisplay = cat !== lastCat ? cat : "";
+  lastCat = cat;
+  console.log(`| ${catDisplay.padEnd(10)} | ${item} | ${status} |`);
+}
+const passed = results.filter((r) => r.status === "PASS").length;
+const failed = results.filter((r) => r.status === "FAIL").length;
+console.log("\nTotal:", passed, "passed,", failed, "failed.");
+if (failed > 0) {
+  console.log("\nFailed:");
+  results.filter((r) => r.status === "FAIL").forEach((r) => console.log(" -", r.name, "\n", r.err.slice(0, 500)));
+  process.exit(1);
+}
+process.exit(0);

package/example/node_modules/quantumcoin/src/abi/fragments.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Minimal ABI fragment classes (ethers.js v6 compatible surface).
+ *
+ * This SDK keeps fragment handling lightweight and delegates ABI encoding/decoding
+ * to `quantum-coin-js-sdk` (WASM).
+ */
+export class Fragment {
+    /**
+     * @param {any} fragment
+     */
+    constructor(fragment: any);
+    type: any;
+    name: any;
+    inputs: any;
+    outputs: any;
+    stateMutability: any;
+    anonymous: any;
+    /**
+     * Formats the fragment.
+     * @param {string=} format
+     * @returns {string}
+     */
+    format(format?: string | undefined): string;
+    /**
+     * @returns {any}
+     */
+    toJSON(): any;
+}
+export class NamedFragment extends Fragment {
+}
+export class FunctionFragment extends NamedFragment {
+}
+export class EventFragment extends NamedFragment {
+}
+export class ErrorFragment extends NamedFragment {
+}
+export class ConstructorFragment extends Fragment {
+}
+export class StructFragment extends Fragment {
+}
+export class FallbackFragment extends Fragment {
+}

package/example/node_modules/quantumcoin/src/abi/fragments.js

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Minimal ABI fragment classes (ethers.js v6 compatible surface).
+ *
+ * This SDK keeps fragment handling lightweight and delegates ABI encoding/decoding
+ * to `quantum-coin-js-sdk` (WASM).
+ */
+
+class Fragment {
+  /**
+   * @param {any} fragment
+   */
+  constructor(fragment) {
+    this.type = fragment?.type;
+    this.name = fragment?.name;
+    this.inputs = fragment?.inputs || [];
+    this.outputs = fragment?.outputs || [];
+    this.stateMutability = fragment?.stateMutability;
+    this.anonymous = fragment?.anonymous;
+  }
+
+  /**
+   * Formats the fragment.
+   * @param {string=} format
+   * @returns {string}
+   */
+  format(format) {
+    // For now, return JSON-ish format (compatible enough for tooling).
+    // ethers supports "sighash", "full", etc.
+    void format;
+    return JSON.stringify(this.toJSON());
+  }
+
+  /**
+   * @returns {any}
+   */
+  toJSON() {
+    const out = {};
+    for (const k of ["type", "name", "inputs", "outputs", "stateMutability", "anonymous"]) {
+      if (this[k] != null) out[k] = this[k];
+    }
+    return out;
+  }
+}
+
+class NamedFragment extends Fragment {}
+class FunctionFragment extends NamedFragment {}
+class EventFragment extends NamedFragment {}
+class ErrorFragment extends NamedFragment {}
+class ConstructorFragment extends Fragment {}
+class StructFragment extends Fragment {}
+class FallbackFragment extends Fragment {}
+
+module.exports = {
+  Fragment,
+  NamedFragment,
+  FunctionFragment,
+  EventFragment,
+  ErrorFragment,
+  ConstructorFragment,
+  StructFragment,
+  FallbackFragment,
+};
+

package/example/node_modules/quantumcoin/src/abi/index.d.ts

@@ -0,0 +1,13 @@
+declare const _exports: {
+    Interface: typeof import("./interface").Interface;
+    AbiCoder: typeof import("./interface").AbiCoder;
+    Fragment: typeof import("./fragments").Fragment;
+    NamedFragment: typeof import("./fragments").NamedFragment;
+    FunctionFragment: typeof import("./fragments").FunctionFragment;
+    EventFragment: typeof import("./fragments").EventFragment;
+    ErrorFragment: typeof import("./fragments").ErrorFragment;
+    ConstructorFragment: typeof import("./fragments").ConstructorFragment;
+    StructFragment: typeof import("./fragments").StructFragment;
+    FallbackFragment: typeof import("./fragments").FallbackFragment;
+};
+export = _exports;

package/example/node_modules/quantumcoin/src/abi/index.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview ABI exports.
+ */
+
+module.exports = {
+  ...require("./fragments"),
+  ...require("./interface"),
+};
+

package/example/node_modules/quantumcoin/src/abi/interface.d.ts

@@ -0,0 +1,128 @@
+export class Interface {
+    /**
+     * @param {any[]|Interface} abi
+     */
+    constructor(abi: any[] | Interface);
+    abi: any;
+    _abiJson: string;
+    _qcsdkAbi: any[];
+    _qcsdkAbiJson: string;
+    /**
+     * Returns JSON format of ABI.
+     * @returns {string}
+     */
+    formatJson(): string;
+    /**
+     * Internal: normalized ABI JSON for qcsdk.
+     * @returns {string}
+     */
+    _qcsdkFormatJson(): string;
+    /**
+     * Internal: normalize argument values for qcsdk based on original ABI params.
+     * @param {Array<any>} params
+     * @param {Array<any>} values
+     * @returns {Array<any>}
+     */
+    _qcsdkNormalizeValues(params: Array<any>, values: Array<any>): Array<any>;
+    /**
+     * Basic formatter (ethers supports multiple formats).
+     * @param {string=} format
+     * @returns {string}
+     */
+    format(format?: string | undefined): string;
+    /**
+     * Get a function fragment by name (first match).
+     * @param {string} nameOrSignature
+     * @returns {FunctionFragment}
+     */
+    getFunction(nameOrSignature: string): FunctionFragment;
+    /**
+     * Get an event fragment by name (first match).
+     * @param {string} nameOrSignature
+     * @returns {EventFragment}
+     */
+    getEvent(nameOrSignature: string): EventFragment;
+    /**
+     * Get an error fragment by name (first match).
+     * @param {string} nameOrSignature
+     * @returns {ErrorFragment}
+     */
+    getError(nameOrSignature: string): ErrorFragment;
+    /**
+     * Returns the constructor fragment if present.
+     * @returns {ConstructorFragment|null}
+     */
+    getConstructor(): ConstructorFragment | null;
+    /**
+     * Encode function data using quantum-coin-js-sdk.
+     * @param {FunctionFragment|string} functionFragment
+     * @param {any[]} values
+     * @returns {string}
+     */
+    encodeFunctionData(functionFragment: FunctionFragment | string, values: any[]): string;
+    /**
+     * Decode function result using quantum-coin-js-sdk.
+     * @param {FunctionFragment|string} functionFragment
+     * @param {string} data
+     * @returns {any}
+     */
+    decodeFunctionResult(functionFragment: FunctionFragment | string, data: string): any;
+    /**
+     * Encode an event log from values.
+     * @param {EventFragment|any} eventFragment
+     * @param {any[]} values
+     * @returns {{ topics: string[], data: string }}
+     */
+    encodeEventLog(eventFragment: EventFragment | any, values: any[]): {
+        topics: string[];
+        data: string;
+    };
+    /**
+     * Decode an event log.
+     * @param {EventFragment|any} eventFragment
+     * @param {string[]} topics
+     * @param {string} data
+     * @returns {any}
+     */
+    decodeEventLog(eventFragment: EventFragment | any, topics: string[], data: string): any;
+    parseTransaction(): void;
+    parseLog(...args: any[]): {
+        fragment: EventFragment;
+        name: any;
+        signature: any;
+        topic: string;
+        args: Result;
+    };
+    parseError(): void;
+    getSighash(): void;
+    getEventTopic(): void;
+    getFallback(): any;
+    getReceive(): any;
+}
+export class AbiCoder {
+    /**
+     * Encode values by types into ABI data.
+     * @param {(string|any)[]} types
+     * @param {any[]} values
+     * @returns {string}
+     */
+    encode(types: (string | any)[], values: any[]): string;
+    /**
+     * Decode ABI data by output types.
+     * @param {(string|any)[]} types
+     * @param {string} data
+     * @returns {any}
+     */
+    decode(types: (string | any)[], data: string): any;
+    /**
+     * Return a default value for types.
+     * @param {(string|any)[]} types
+     * @returns {any}
+     */
+    getDefaultValue(types: (string | any)[]): any;
+}
+import { FunctionFragment } from "./fragments";
+import { EventFragment } from "./fragments";
+import { ErrorFragment } from "./fragments";
+import { ConstructorFragment } from "./fragments";
+import { Result } from "../utils/result";