quantumcoin 7.0.2 → 7.0.4

package/test/unit/utils.test.js

@@ -1,54 +1,57 @@
-/**
- * @testCategory unit
- * @blockchainRequired false
- * @transactional false
- * @description Utility helpers (units, encoding, hashing, rlp, abi coder)
- */
-
-const { describe, it } = require("node:test");
-const assert = require("node:assert/strict");
-
-const { Initialize } = require("../../config");
-const qc = require("../../index");
-
-describe("Utils", () => {
-  it("parseEther/formatEther roundtrip", () => {
-    const wei = qc.parseEther("1.5");
-    assert.equal(wei, 1500000000000000000n);
-    assert.equal(qc.formatEther(wei), "1.5");
-  });
-
-  it("encodeBytes32String/decodeBytes32String roundtrip", () => {
-    const hex = qc.encodeBytes32String("hello");
-    assert.equal(hex.length, 66);
-    assert.equal(qc.decodeBytes32String(hex), "hello");
-  });
-
-  it("base58 encode/decode roundtrip", () => {
-    const bytes = qc.toUtf8Bytes("hello world");
-    const b58 = qc.encodeBase58(bytes);
-    const out = qc.decodeBase58(b58);
-    assert.equal(qc.toUtf8String(out), "hello world");
-  });
-
-  it("RLP encode/decode roundtrip (hex bytes)", () => {
-    const value = ["0x68656c6c6f", "0x7b", "0x01"];
-    const encoded = qc.encodeRlp(value);
-    assert.ok(typeof encoded === "string" && encoded.startsWith("0x"));
-    const decoded = qc.decodeRlp(encoded);
-    assert.deepEqual(decoded, value);
-  });
-
-  it("AbiCoder encode/decode roundtrip", async () => {
-    await Initialize(null);
-    const coder = new qc.AbiCoder();
-    const data = coder.encode(["uint256", "bool", "string"], [123n, true, "hello"]);
-    assert.ok(typeof data === "string" && data.startsWith("0x"));
-    const decoded = coder.decode(["uint256", "bool", "string"], data);
-    // qcsdk returns JSON array, so we accept array-like output
-    assert.equal(decoded[0].toString(), "123");
-    assert.equal(Boolean(decoded[1]), true);
-    assert.equal(decoded[2], "hello");
-  });
-});
-
+/**
+ * @testCategory unit
+ * @blockchainRequired false
+ * @transactional false
+ * @description Utility helpers (units, encoding, hashing, rlp, abi coder)
+ */
+
+const { describe, it } = require("node:test");
+const assert = require("node:assert/strict");
+
+const { Initialize } = require("../../config");
+const qc = require("../../index");
+const { logSuite, logTest } = require("../verbose-logger");
+
+describe("Utils", () => {
+  logSuite("Utils");
+  it("parseEther/formatEther roundtrip", () => {
+    logTest("parseEther/formatEther roundtrip", {});
+    const wei = qc.parseEther("1.5");
+    assert.equal(wei, 1500000000000000000n);
+    assert.equal(qc.formatEther(wei), "1.5");
+  });
+
+  it("encodeBytes32String/decodeBytes32String roundtrip", () => {
+    const hex = qc.encodeBytes32String("hello");
+    assert.equal(hex.length, 66);
+    assert.equal(qc.decodeBytes32String(hex), "hello");
+  });
+
+  it("base58 encode/decode roundtrip", () => {
+    const bytes = qc.toUtf8Bytes("hello world");
+    const b58 = qc.encodeBase58(bytes);
+    const out = qc.decodeBase58(b58);
+    assert.equal(qc.toUtf8String(out), "hello world");
+  });
+
+  it("RLP encode/decode roundtrip (hex bytes)", () => {
+    const value = ["0x68656c6c6f", "0x7b", "0x01"];
+    const encoded = qc.encodeRlp(value);
+    assert.ok(typeof encoded === "string" && encoded.startsWith("0x"));
+    const decoded = qc.decodeRlp(encoded);
+    assert.deepEqual(decoded, value);
+  });
+
+  it("AbiCoder encode/decode roundtrip", async () => {
+    await Initialize(null);
+    const coder = new qc.AbiCoder();
+    const data = coder.encode(["uint256", "bool", "string"], [123n, true, "hello"]);
+    assert.ok(typeof data === "string" && data.startsWith("0x"));
+    const decoded = coder.decode(["uint256", "bool", "string"], data);
+    // qcsdk returns JSON array, so we accept array-like output
+    assert.equal(decoded[0].toString(), "123");
+    assert.equal(Boolean(decoded[1]), true);
+    assert.equal(decoded[2], "hello");
+  });
+});
+

package/test/unit/utils.test.ts

@@ -0,0 +1,56 @@
+/**
+ * @testCategory unit
+ * @blockchainRequired false
+ * @transactional false
+ * @description Utility helpers (units, encoding, hashing, rlp, abi coder)
+ */
+
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import { Initialize } from "../../config";
+import qc from "../../index";
+import { logSuite, logTest } from "../verbose-logger";
+
+describe("Utils", () => {
+  logSuite("Utils");
+  it("parseEther/formatEther roundtrip", () => {
+    logTest("parseEther/formatEther roundtrip", {});
+    const wei = qc.parseEther("1.5");
+    assert.equal(wei, 1500000000000000000n);
+    assert.equal(qc.formatEther(wei), "1.5");
+  });
+
+  it("encodeBytes32String/decodeBytes32String roundtrip", () => {
+    const hex = qc.encodeBytes32String("hello");
+    assert.equal(hex.length, 66);
+    assert.equal(qc.decodeBytes32String(hex), "hello");
+  });
+
+  it("base58 encode/decode roundtrip", () => {
+    const bytes = qc.toUtf8Bytes("hello world");
+    const b58 = qc.encodeBase58(bytes);
+    const out = qc.decodeBase58(b58);
+    assert.equal(qc.toUtf8String(out), "hello world");
+  });
+
+  it("RLP encode/decode roundtrip (hex bytes)", () => {
+    const value = ["0x68656c6c6f", "0x7b", "0x01"];
+    const encoded = qc.encodeRlp(value);
+    assert.ok(typeof encoded === "string" && encoded.startsWith("0x"));
+    const decoded = qc.decodeRlp(encoded);
+    assert.deepEqual(decoded, value);
+  });
+
+  it("AbiCoder encode/decode roundtrip", async () => {
+    await Initialize(null);
+    const coder = new qc.AbiCoder();
+    const data = coder.encode(["uint256", "bool", "string"], [123n, true, "hello"]);
+    assert.ok(typeof data === "string" && data.startsWith("0x"));
+    const decoded = coder.decode(["uint256", "bool", "string"], data);
+    // qcsdk returns JSON array, so we accept array-like output
+    assert.equal(decoded[0].toString(), "123");
+    assert.equal(Boolean(decoded[1]), true);
+    assert.equal(decoded[2], "hello");
+  });
+});

package/test/verbose-logger.js

@@ -0,0 +1,74 @@
+/**
+ * Verbose logging for tests and examples.
+ * Enable with: VERBOSE=1 or QC_VERBOSE=1 (e.g. VERBOSE=1 npm test, VERBOSE=1 node examples/example.js)
+ */
+
+function isVerbose() {
+  const v = process.env.QC_VERBOSE || process.env.VERBOSE;
+  return v === "1" || v === "true" || v === "yes";
+}
+
+function ts() {
+  return new Date().toISOString();
+}
+
+function log(section, message, data) {
+  if (!isVerbose()) return;
+  const prefix = `[${ts()}] [${section}]`;
+  if (data !== undefined && data !== null && typeof data === "object" && Object.keys(data).length > 0) {
+    try {
+      console.log(prefix, message, JSON.stringify(data));
+    } catch {
+      console.log(prefix, message, String(data));
+    }
+  } else {
+    console.log(prefix, message);
+  }
+}
+
+function logSuite(suiteName) {
+  if (!isVerbose()) return;
+  console.log(`[${ts()}] [suite] ${suiteName}`);
+}
+
+function logTest(testName, data) {
+  if (!isVerbose()) return;
+  const payload = { test: testName, ...data };
+  console.log(`[${ts()}] [test] ${testName}`, JSON.stringify(payload));
+}
+
+function logTxn(txHash, data) {
+  if (!isVerbose()) return;
+  const hash = typeof txHash === "string" ? txHash : (txHash && txHash.hash) || String(txHash);
+  console.log(`[${ts()}] [txn] hash=${hash}`, data ? JSON.stringify(data) : "");
+}
+
+function logAddress(label, address) {
+  if (!isVerbose()) return;
+  const addr = typeof address === "string" ? address : (address && address.address) || String(address);
+  console.log(`[${ts()}] [address] ${label}=${addr}`);
+}
+
+function logExample(exampleName, message, data) {
+  if (!isVerbose()) return;
+  const prefix = `[${ts()}] [example:${exampleName}]`;
+  if (data !== undefined && data !== null && typeof data === "object" && Object.keys(data).length > 0) {
+    try {
+      console.log(prefix, message, JSON.stringify(data));
+    } catch {
+      console.log(prefix, message, String(data));
+    }
+  } else {
+    console.log(prefix, message);
+  }
+}
+
+module.exports = {
+  isVerbose,
+  log,
+  logSuite,
+  logTest,
+  logTxn,
+  logAddress,
+  logExample,
+};

package/tsconfig.build.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "allowJs": true,
+    "lib": ["ES2015"],
+    "skipLibCheck": true,
+    "noEmit": false,
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.js"],
+  "exclude": ["node_modules"]
+}