quantumcoin 7.0.12 → 7.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantumcoin",
-  "version": "7.0.12",
+  "version": "7.0.13",
   "description": "QuantumCoin.js - a post quantum cryptography SDK for QuantumCoin",
   "main": "index.js",
   "types": "src/index.d.ts",

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/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/contract/index.d.ts

@@ -1,9 +1,9 @@
-declare const _exports: {
-    ContractFactory: typeof import("./contract-factory").ContractFactory;
-    BaseContract: typeof import("./contract").BaseContract;
-    Contract: typeof import("./contract").Contract;
-    ContractTransactionResponse: typeof import("./contract").ContractTransactionResponse;
-    ContractTransactionReceipt: typeof import("./contract").ContractTransactionReceipt;
-    EventLog: typeof import("./contract").EventLog;
-};
-export = _exports;
+declare const _exports: {
+    ContractFactory: typeof import("./contract-factory").ContractFactory;
+    BaseContract: typeof import("./contract").BaseContract;
+    Contract: typeof import("./contract").Contract;
+    ContractTransactionResponse: typeof import("./contract").ContractTransactionResponse;
+    ContractTransactionReceipt: typeof import("./contract").ContractTransactionReceipt;
+    EventLog: typeof import("./contract").EventLog;
+};
+export = _exports;

package/src/errors/index.d.ts

@@ -1,92 +1,92 @@
-export type ErrorCode = "INVALID_ARGUMENT" | "NUMERIC_FAULT" | "BUFFER_OVERRUN" | "CALL_EXCEPTION" | "UNKNOWN_ERROR" | "NOT_IMPLEMENTED";
-/**
- * @fileoverview Error helpers and error classes.
- *
- * The QuantumCoin.js SDK follows ethers.js v6 error patterns:
- * - errors include a machine-readable `code`
- * - errors include `shortMessage`
- * - errors may include extra fields depending on the failure
- */
-/**
- * @typedef {"INVALID_ARGUMENT"|"NUMERIC_FAULT"|"BUFFER_OVERRUN"|"CALL_EXCEPTION"|"UNKNOWN_ERROR"|"NOT_IMPLEMENTED"} ErrorCode
- */
-/**
- * Returns true if the error matches the given code.
- * @param {any} error
- * @param {string} code
- * @returns {boolean}
- */
-export function isError(error: any, code: string): boolean;
-/**
- * Returns true if the error is a CALL_EXCEPTION.
- * @param {any} error
- * @returns {boolean}
- */
-export function isCallException(error: any): boolean;
-/**
- * Create an Error configured like ethers emits errors.
- *
- * @param {string} message
- * @param {ErrorCode} code
- * @param {Record<string, any>=} info
- * @returns {Error & { code: ErrorCode, shortMessage: string }}
- */
-export function makeError(message: string, code: ErrorCode, info?: Record<string, any> | undefined): Error & {
-    code: ErrorCode;
-    shortMessage: string;
-};
-/**
- * Assert a condition, throwing an ethers-style error otherwise.
- * @param {any} check
- * @param {string} message
- * @param {ErrorCode} code
- * @param {Record<string, any>=} info
- */
-export function assert(check: any, message: string, code: ErrorCode, info?: Record<string, any> | undefined): void;
-/**
- * Assert an argument constraint.
- * @param {any} check
- * @param {string} message
- * @param {string} name
- * @param {any} value
- */
-export function assertArgument(check: any, message: string, name: string, value: any): void;
-/**
- * Provider error.
- */
-export class ProviderError extends Error {
-    /**
-     * @param {string} message
-     * @param {Record<string, any>=} info
-     */
-    constructor(message: string, info?: Record<string, any> | undefined);
-    /** @type {ErrorCode} */
-    code: ErrorCode;
-    shortMessage: string;
-}
-/**
- * Transaction error.
- */
-export class TransactionError extends Error {
-    /**
-     * @param {string} message
-     * @param {Record<string, any>=} info
-     */
-    constructor(message: string, info?: Record<string, any> | undefined);
-    /** @type {ErrorCode} */
-    code: ErrorCode;
-    shortMessage: string;
-}
-/**
- * Contract error.
- */
-export class ContractError extends Error {
-    /**
-     * @param {string} message
-     * @param {Record<string, any>=} info
-     */
-    constructor(message: string, info?: Record<string, any> | undefined);
-    /** @type {ErrorCode} */
-    code: ErrorCode;
-    shortMessage: string;
-}
+export type ErrorCode = "INVALID_ARGUMENT" | "NUMERIC_FAULT" | "BUFFER_OVERRUN" | "CALL_EXCEPTION" | "UNKNOWN_ERROR" | "NOT_IMPLEMENTED";
+/**
+ * @fileoverview Error helpers and error classes.
+ *
+ * The QuantumCoin.js SDK follows ethers.js v6 error patterns:
+ * - errors include a machine-readable `code`
+ * - errors include `shortMessage`
+ * - errors may include extra fields depending on the failure
+ */
+/**
+ * @typedef {"INVALID_ARGUMENT"|"NUMERIC_FAULT"|"BUFFER_OVERRUN"|"CALL_EXCEPTION"|"UNKNOWN_ERROR"|"NOT_IMPLEMENTED"} ErrorCode
+ */
+/**
+ * Returns true if the error matches the given code.
+ * @param {any} error
+ * @param {string} code
+ * @returns {boolean}
+ */
+export function isError(error: any, code: string): boolean;
+/**
+ * Returns true if the error is a CALL_EXCEPTION.
+ * @param {any} error
+ * @returns {boolean}
+ */
+export function isCallException(error: any): boolean;
+/**
+ * Create an Error configured like ethers emits errors.
+ *
+ * @param {string} message
+ * @param {ErrorCode} code
+ * @param {Record<string, any>=} info
+ * @returns {Error & { code: ErrorCode, shortMessage: string }}
+ */
+export function makeError(message: string, code: ErrorCode, info?: Record<string, any> | undefined): Error & {
+    code: ErrorCode;
+    shortMessage: string;
+};
+/**
+ * Assert a condition, throwing an ethers-style error otherwise.
+ * @param {any} check
+ * @param {string} message
+ * @param {ErrorCode} code
+ * @param {Record<string, any>=} info
+ */
+export function assert(check: any, message: string, code: ErrorCode, info?: Record<string, any> | undefined): void;
+/**
+ * Assert an argument constraint.
+ * @param {any} check
+ * @param {string} message
+ * @param {string} name
+ * @param {any} value
+ */
+export function assertArgument(check: any, message: string, name: string, value: any): void;
+/**
+ * Provider error.
+ */
+export class ProviderError extends Error {
+    /**
+     * @param {string} message
+     * @param {Record<string, any>=} info
+     */
+    constructor(message: string, info?: Record<string, any> | undefined);
+    /** @type {ErrorCode} */
+    code: ErrorCode;
+    shortMessage: string;
+}
+/**
+ * Transaction error.
+ */
+export class TransactionError extends Error {
+    /**
+     * @param {string} message
+     * @param {Record<string, any>=} info
+     */
+    constructor(message: string, info?: Record<string, any> | undefined);
+    /** @type {ErrorCode} */
+    code: ErrorCode;
+    shortMessage: string;
+}
+/**
+ * Contract error.
+ */
+export class ContractError extends Error {
+    /**
+     * @param {string} message
+     * @param {Record<string, any>=} info
+     */
+    constructor(message: string, info?: Record<string, any> | undefined);
+    /** @type {ErrorCode} */
+    code: ErrorCode;
+    shortMessage: string;
+}

package/src/generator/index.d.ts

@@ -52,23 +52,30 @@ export function generateFromArtifacts(opts: {
  * Generate a transactional e2e test file (JavaScript) for the typed contract package.
  * The test deploys the contract with constructor args (if any) and invokes one write method.
  *
- * @param {{ contractName: string, abi: any[] }} opts
- * @returns {string}
+ * When `bytecode` is omitted, empty, or `"0x"` the contract is treated as an interface
+ * and the post-deploy `provider.getCode(...)` bytecode assertion is omitted from the
+ * generated test (interfaces deploy with no runtime code by design).
+ *
+ * @param opts
  */
 export function generateTransactionalTestJs(opts: {
     contractName: string;
     abi: any[];
+    bytecode?: string;
 }): string;
 /**
  * Generate a single transactional e2e test that deploys and invokes methods on ALL contracts.
  * Used when the package has multiple contracts so one test exercises every contract.
  *
- * @param {{ artifacts: Array<{ contractName: string, abi: any[] }> }} opts
- * @returns {string}
+ * Accepts `bytecode` per artifact for forward-compatibility; the multi-contract template
+ * currently emits no `getCode` assertion (so the value is not yet consumed).
+ *
+ * @param opts
  */
 export function generateAllContractsTransactionalTestJs(opts: {
     artifacts: Array<{
         contractName: string;
         abi: any[];
+        bytecode?: string;
     }>;
 }): string;

package/src/generator/index.js

@@ -381,6 +381,23 @@ function _findConstructor(abi) {
   return ctor || { type: "constructor", inputs: [] };
 }
 
+/**
+ * Return true if the given bytecode artifact represents an interface
+ * (or otherwise non-deployable contract with no runtime code).
+ *
+ * `solc` writes an empty `.bin` for `interface` declarations and fully
+ * abstract `contract` declarations. We treat `null`, `undefined`, empty
+ * string, and the bare `"0x"` / `"0X"` prefix as interface bytecode.
+ *
+ * @param {string|null|undefined} bytecode
+ * @returns {boolean}
+ */
+function _isInterfaceBytecode(bytecode) {
+  if (bytecode == null) return true;
+  const s = String(bytecode).trim().toLowerCase();
+  return s === "" || s === "0x";
+}
+
 function _solTypeToTestValueExpr(param) {
   const type = typeof param === "string" ? param : String(param && param.type ? param.type : "");
   const internalType = typeof param === "object" && param ? String(param.internalType || "") : "";
@@ -957,11 +974,17 @@ function _renderIndexDts(contractNames) {
  * Generate a transactional e2e test file (JavaScript) for the typed contract package.
  * The test deploys the contract with constructor args (if any) and invokes one write method.
  *
- * @param {{ contractName: string, abi: any[] }} opts
+ * When `bytecode` is omitted, empty, or `"0x"` the contract is treated as an interface:
+ * the generated test still attempts the deploy (the receipt-status assertion still validates
+ * SDK wrapper wiring) but the post-deploy `provider.getCode(...)` bytecode assertion is
+ * skipped, since interfaces deploy with no runtime code by design.
+ *
+ * @param {{ contractName: string, abi: any[], bytecode?: string }} opts
  * @returns {string}
  */
 function generateTransactionalTestJs(opts) {
-  const { contractName, abi } = opts;
+  const { contractName, abi, bytecode } = opts;
+  const isInterface = _isInterfaceBytecode(bytecode);
   const factoryName = `${contractName}__factory`;
   const ctor = _findConstructor(abi);
   const ctorInputs = ctor.inputs || [];
@@ -1127,8 +1150,10 @@ describe("${contractName} transactional", () => {
     assert.ok(deployReceipt);
     assert.ok(deployReceipt.blockNumber != null);
 
-    const code = await provider.getCode(contract.target, "latest");
-    assert.ok(code && code !== "0x");
+    ${isInterface
+      ? `// Skipping bytecode check: ${contractName} is an interface (no bytecode).`
+      : `const code = await provider.getCode(contract.target, "latest");
+    assert.ok(code && code !== "0x");`}
 
     ${erc20Assertions ? erc20Assertions : `// (no ERC-20 surface detected for extra assertions)`}
 
@@ -1191,7 +1216,10 @@ function _getContractTestMeta(opts) {
  * Generate a single transactional e2e test that deploys and invokes methods on ALL contracts.
  * Used when the package has multiple contracts so one test exercises every contract.
  *
- * @param {{ artifacts: Array<{ contractName: string, abi: any[] }> }} opts
+ * Accepts `bytecode` per artifact for forward-compatibility, although the multi-contract
+ * template currently emits no `getCode` assertion (so the value is not yet consumed).
+ *
+ * @param {{ artifacts: Array<{ contractName: string, abi: any[], bytecode?: string }> }} opts
  * @returns {string}
  */
 function generateAllContractsTransactionalTestJs(opts) {

package/src/internal/hex.d.ts

@@ -1,61 +1,68 @@
-/**
- * Return true if `value` is a Uint8Array.
- * @param {any} value
- * @returns {value is Uint8Array}
- */
-export function isUint8Array(value: any): value is Uint8Array;
-/**
- * Normalize a hex string.
- * @param {string} hex
- * @returns {string}
- */
-export function normalizeHex(hex: string): string;
-/**
- * Returns true if value is a hex string.
- * @param {any} value
- * @param {number=} lengthBytes Optional exact byte length.
- * @returns {boolean}
- */
-export function isHexString(value: any, lengthBytes?: number | undefined): boolean;
-/**
- * Strip 0x prefix.
- * @param {string} hex
- * @returns {string}
- */
-export function strip0x(hex: string): string;
-/**
- * Ensure a 0x prefix.
- * @param {string} hex
- * @returns {string}
- */
-export function add0x(hex: string): string;
-/**
- * Convert a hex string to bytes.
- * @param {string} hex
- * @returns {Uint8Array}
- */
-export function hexToBytes(hex: string): Uint8Array;
-/**
- * Convert bytes to hex string.
- * @param {Uint8Array} bytes
- * @returns {string}
- */
-export function bytesToHex(bytes: Uint8Array): string;
-/**
- * UTF-8 encode a string to bytes.
- * @param {string} str
- * @returns {Uint8Array}
- */
-export function utf8ToBytes(str: string): Uint8Array;
-/**
- * UTF-8 decode bytes to a string.
- * @param {Uint8Array} bytes
- * @returns {string}
- */
-export function bytesToUtf8(bytes: Uint8Array): string;
-/**
- * Convert BytesLike to Uint8Array.
- * @param {string | Uint8Array} data
- * @returns {Uint8Array}
- */
-export function arrayify(data: string | Uint8Array): Uint8Array;
+/**
+ * Return true if `value` is a Uint8Array.
+ * @param {any} value
+ * @returns {value is Uint8Array}
+ */
+export function isUint8Array(value: any): value is Uint8Array;
+/**
+ * Normalize a hex string.
+ * @param {string} hex
+ * @returns {string}
+ */
+export function normalizeHex(hex: string): string;
+/**
+ * Format a number/bigint as a JSON-RPC QUANTITY hex string (no leading zeros).
+ * @param value
+ */
+export function toQuantityHex(value: number | bigint): string;
+/** Alias of `toQuantityHex` matching ethers.js v6 naming. */
+export const toQuantity: typeof toQuantityHex;
+/**
+ * Returns true if value is a hex string.
+ * @param {any} value
+ * @param {number=} lengthBytes Optional exact byte length.
+ * @returns {boolean}
+ */
+export function isHexString(value: any, lengthBytes?: number | undefined): boolean;
+/**
+ * Strip 0x prefix.
+ * @param {string} hex
+ * @returns {string}
+ */
+export function strip0x(hex: string): string;
+/**
+ * Ensure a 0x prefix.
+ * @param {string} hex
+ * @returns {string}
+ */
+export function add0x(hex: string): string;
+/**
+ * Convert a hex string to bytes.
+ * @param {string} hex
+ * @returns {Uint8Array}
+ */
+export function hexToBytes(hex: string): Uint8Array;
+/**
+ * Convert bytes to hex string.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+export function bytesToHex(bytes: Uint8Array): string;
+/**
+ * UTF-8 encode a string to bytes.
+ * @param {string} str
+ * @returns {Uint8Array}
+ */
+export function utf8ToBytes(str: string): Uint8Array;
+/**
+ * UTF-8 decode bytes to a string.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+export function bytesToUtf8(bytes: Uint8Array): string;
+/**
+ * Convert BytesLike to Uint8Array.
+ * @param {string | Uint8Array} data
+ * @returns {Uint8Array}
+ */
+export function arrayify(data: string | Uint8Array): Uint8Array;

package/src/internal/hex.js

@@ -35,6 +35,40 @@ function normalizeHex(hex) {
   return h;
 }
 
+/**
+ * Format a number/bigint as a JSON-RPC QUANTITY hex string.
+ *
+ * Per the Ethereum JSON-RPC spec, quantities use the most compact
+ * representation with no leading zeros, with the single exception that
+ * zero is encoded as "0x0".
+ *
+ * Use this for block numbers, gas amounts, nonces, balances, and other
+ * numeric RPC parameters. Do NOT use it for DATA hex (addresses,
+ * bytecode, byte-arrays) — use `normalizeHex` for those.
+ *
+ * @param {number|bigint} value
+ * @returns {string}
+ */
+function toQuantityHex(value) {
+  let n;
+  if (typeof value === "bigint") {
+    n = value;
+  } else if (typeof value === "number") {
+    if (!Number.isInteger(value)) {
+      throw new TypeError("toQuantityHex: value must be an integer or bigint");
+    }
+    n = BigInt(value);
+  } else {
+    throw new TypeError("toQuantityHex: value must be a number or bigint");
+  }
+  if (n < 0n) throw new RangeError("toQuantityHex: value must be non-negative");
+  if (n === 0n) return "0x0";
+  return "0x" + n.toString(16);
+}
+
+/** Alias of `toQuantityHex` matching ethers.js v6 naming. */
+const toQuantity = toQuantityHex;
+
 /**
  * Returns true if value is a hex string.
  * @param {any} value
@@ -132,6 +166,8 @@ function arrayify(data) {
 module.exports = {
   isUint8Array,
   normalizeHex,
+  toQuantityHex,
+  toQuantity,
   isHexString,
   strip0x,
   add0x,

package/src/providers/json-rpc-provider.d.ts

@@ -1,12 +1,12 @@
-export class JsonRpcProvider extends AbstractProvider {
-    /**
-     * @param {string=} url RPC endpoint (defaults to Config.rpcEndpoint or https://public.rpc.quantumcoinapi.com)
-     * @param {number=} chainId Chain ID (defaults to 123123)
-     */
-    constructor(url?: string | undefined, chainId?: number | undefined);
-    url: string;
-    chainId: number;
-}
-export class JsonRpcApiProvider extends JsonRpcProvider {
-}
-import { AbstractProvider } from "./provider";
+export class JsonRpcProvider extends AbstractProvider {
+    /**
+     * @param {string=} url RPC endpoint (defaults to Config.rpcEndpoint or https://public.rpc.quantumcoinapi.com)
+     * @param {number=} chainId Chain ID (defaults to 123123)
+     */
+    constructor(url?: string | undefined, chainId?: number | undefined);
+    url: string;
+    chainId: number;
+}
+export class JsonRpcApiProvider extends JsonRpcProvider {
+}
+import { AbstractProvider } from "./provider";

package/src/providers/provider.js

@@ -7,7 +7,7 @@
 
 const { EventEmitter } = require("events");
 const { makeError, assertArgument } = require("../errors");
-const { normalizeHex, isHexString } = require("../internal/hex");
+const { normalizeHex, toQuantityHex, isHexString } = require("../internal/hex");
 
 /**
  * @typedef {import("../utils/encoding").BytesLike} BytesLike
@@ -58,7 +58,7 @@ function _blockTagToHex(blockTag) {
   if (s === "latest" || s === "pending" || s === "earliest") return s;
   const n = typeof blockTag === "number" ? blockTag : Number(blockTag);
   if (!Number.isInteger(n) || n < 0) return undefined;
-  return normalizeHex("0x" + n.toString(16));
+  return toQuantityHex(n);
 }
 
 /**
@@ -251,7 +251,7 @@ class AbstractProvider extends Provider {
    * @returns {Promise<Block>}
    */
   async getBlock(blockNumber) {
-    const tag = blockNumber === "latest" ? "latest" : normalizeHex("0x" + Number(blockNumber).toString(16));
+    const tag = blockNumber === "latest" ? "latest" : toQuantityHex(blockNumber);
     const block = await this._perform("eth_getBlockByNumber", [tag, false]);
     return new Block(block, this);
   }