quantumcoin 7.0.2 → 7.0.4

package/index.js

@@ -1,12 +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"),
-};
-
+/**
+ * @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/package.json

@@ -1,75 +1,95 @@
-{
-  "name": "quantumcoin",
-  "version": "7.0.2",
-  "description": "QuantumCoin SDK - a complete SDK for dapps",
-  "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/**/*.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\"",
-    "example": "node examples/example.js",
-    "example:provider": "node examples/example.js",
-    "example:wallet": "node examples/wallet-offline.js",
-    "example:contract:read": "node examples/read-operations.js",
-    "example:events": "node examples/events.js",
-    "build": "npx -p typescript tsc src/index.js --declaration --allowJs --emitDeclarationOnly"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/quantumcoinproject/quantumcoin.js.git"
-  },
-  "files": [
-    "**"
-  ],
-  "keywords": [
-    "pqc",
-    "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": {
-    "quantumcoin-sdk-generator": "./generate-sdk.js"
-  },
-  "dependencies": {
-    "quantum-coin-pqc-js-sdk": "^1.0.5",
-    "seed-words": "^1.0.2",
-    "quantum-coin-js-sdk": "^1.0.28"
-  }
-}
+{
+  "name": "quantumcoin",
+  "version": "7.0.4",
+  "description": "QuantumCoin SDK - a complete SDK for dapps",
+  "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.31"
+  }
+}

package/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/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/src/abi/fragments.d.ts

@@ -1,42 +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 {
-}
+/**
+ * @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/src/abi/fragments.js

@@ -1,63 +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,
-};
-
+/**
+ * @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/src/abi/index.d.ts

@@ -1,13 +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;
+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/src/abi/index.js

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