quantum-coin-js-sdk 2.0.1 → 2.1.0

package/example/node_modules/quantumcoin/src/contract/contract-factory.d.ts

@@ -1,28 +0,0 @@
-export class ContractFactory {
-    /**
-     * @param {any[]|Interface} abi
-     * @param {string} bytecode
-     * @param {any} signer
-     */
-    constructor(abi: any[] | Interface, bytecode: string, signer: any);
-    abi: any;
-    interface: Interface;
-    bytecode: string;
-    signer: any;
-    /**
-     * Compute deploy transaction request.
-     * @param  {...any} args
-     * @returns {import("../providers/provider").TransactionRequest}
-     */
-    getDeployTransaction(...args: any[]): import("../providers/provider").TransactionRequest;
-    /**
-     * Deploy contract.
-     * @param  {...any} args
-     * @returns {Promise<Contract>}
-     */
-    deploy(...args: any[]): Promise<Contract>;
-    attach(address: any): Contract;
-    connect(signer: any): ContractFactory;
-}
-import { Interface } from "../abi/interface";
-import { Contract } from "./contract";

package/example/node_modules/quantumcoin/src/contract/contract-factory.js

@@ -1,111 +0,0 @@
-/**
- * @fileoverview ContractFactory implementation.
- */
-
-const qcsdk = require("quantum-coin-js-sdk");
-const { Interface } = require("../abi/interface");
-const jsAbi = require("../abi/js-abi-coder");
-const { Contract } = require("./contract");
-const { makeError, assertArgument } = require("../errors");
-const { normalizeHex, strip0x, bytesToHex } = require("../internal/hex");
-const { getCreateAddress } = require("../utils/address");
-
-function _requireInitialized() {
-  // eslint-disable-next-line global-require
-  const { isInitialized, getInitializationPromise } = require("../../config");
-  if (isInitialized()) return;
-  if (getInitializationPromise() != null) {
-    throw makeError(
-      "QuantumCoin SDK is still initializing. Await the Initialize() promise before using SDK methods.",
-      "UNKNOWN_ERROR",
-      { operation: "requireInitialized" },
-    );
-  }
-  throw makeError("QuantumCoin SDK not initialized. Call Initialize() first.", "UNKNOWN_ERROR", { operation: "contract-factory" });
-}
-
-class ContractFactory {
-  /**
-   * @param {any[]|Interface} abi
-   * @param {string} bytecode
-   * @param {any} signer
-   */
-  constructor(abi, bytecode, signer) {
-    _requireInitialized();
-    this.abi = abi instanceof Interface ? JSON.parse(abi.formatJson()) : abi;
-    this.interface = abi instanceof Interface ? abi : new Interface(abi);
-    this.bytecode = normalizeHex(bytecode);
-    this.signer = signer;
-  }
-
-  /**
-   * Compute deploy transaction request.
-   * @param  {...any} args
-   * @returns {import("../providers/provider").TransactionRequest}
-   */
-  getDeployTransaction(...args) {
-    _requireInitialized();
-    const ctor = this.interface.getConstructor();
-    const ctorInputs = ctor ? ctor.inputs : [];
-
-    // If the constructor includes tuples/structs, use the JS ABI encoder fallback.
-    if (jsAbi.hasTuple(ctorInputs)) {
-      const enc = jsAbi.encodeTupleLike(ctorInputs, args);
-      const data = normalizeHex(this.bytecode + strip0x(bytesToHex(enc)));
-      return { to: null, data, value: 0n };
-    }
-
-    const normArgs = this.interface._qcsdkNormalizeValues(ctorInputs, args);
-    const res = qcsdk.packCreateContractData(this.interface._qcsdkFormatJson(), this.bytecode, ...normArgs);
-    if (!res || typeof res.error !== "string") throw makeError("packCreateContractData failed", "UNKNOWN_ERROR", {});
-    if (res.error) throw makeError(res.error, "UNKNOWN_ERROR", { operation: "packCreateContractData" });
-    return { to: null, data: normalizeHex(res.result), value: 0n };
-  }
-
-  /**
-   * Deploy contract.
-   * @param  {...any} args
-   * @returns {Promise<Contract>}
-   */
-  async deploy(...args) {
-    if (!this.signer) throw makeError("missing signer", "UNKNOWN_ERROR", { operation: "deploy" });
-    const tx = this.getDeployTransaction(...args);
-
-    // Compute deterministic address from (from, nonce)
-    const from =
-      typeof this.signer.getAddress === "function"
-        ? await this.signer.getAddress()
-        : this.signer.address;
-    if (typeof from !== "string") throw makeError("unable to resolve deployer address", "UNKNOWN_ERROR", {});
-
-    const provider = this.signer.provider || null;
-    if (!provider || typeof provider.getTransactionCount !== "function") {
-      throw makeError("missing provider for deploy", "UNKNOWN_ERROR", { operation: "deploy" });
-    }
-
-    // Prefer pending nonce to avoid collisions with in-flight transactions.
-    let nonce;
-    try {
-      nonce = await provider.getTransactionCount(from, "pending");
-    } catch {
-      nonce = await provider.getTransactionCount(from, "latest");
-    }
-    const address = getCreateAddress({ from, nonce });
-
-    const resp = await this.signer.sendTransaction({ ...tx, nonce });
-    const contract = new Contract(address, this.interface, this.signer, this.bytecode);
-    contract._deployTx = resp;
-    return contract;
-  }
-
-  attach(address) {
-    return new Contract(address, this.interface, this.signer, this.bytecode);
-  }
-
-  connect(signer) {
-    return new ContractFactory(this.interface, this.bytecode, signer);
-  }
-}
-
-module.exports = { ContractFactory };
-

package/example/node_modules/quantumcoin/src/contract/contract.d.ts

@@ -1,113 +0,0 @@
-/**
- * BaseContract placeholder (ethers-like).
- */
-export class BaseContract {
-}
-export class Contract extends BaseContract {
-    static from(target: any, abi: any, runner: any): Contract;
-    /**
-     * @param {string} address
-     * @param {any[]|Interface} abi
-     * @param {any=} providerOrSigner
-     * @param {string=} bytecode
-     */
-    constructor(address: string, abi: any[] | Interface, providerOrSigner?: any | undefined, bytecode?: string | undefined);
-    address: string;
-    target: string;
-    bytecode: string;
-    interface: Interface;
-    provider: any;
-    signer: any;
-    runner: any;
-    _listeners: Map<any, any>;
-    populateTransaction: {};
-    getAddress(): string;
-    /**
-     * Invoke a contract function, dispatching to call() or send().
-     * @param {string} methodName
-     * @param {any[]} args
-     * @returns {Promise<any>}
-     */
-    _invoke(methodName: string, args: any[]): Promise<any>;
-    /**
-     * Build an unsigned transaction request for a contract method call.
-     * @param {string} methodName
-     * @param {any[]} args
-     * @returns {Promise<import("../providers/provider").TransactionRequest>}
-     */
-    _populate(methodName: string, args: any[]): Promise<import("../providers/provider").TransactionRequest>;
-    /**
-     * Perform a read-only call.
-     * @param {string} methodName
-     * @param {any[]} args
-     * @param {import("../providers/provider").TransactionRequest=} overrides
-     * @returns {Promise<any>}
-     */
-    call(methodName: string, args: any[], overrides?: import("../providers/provider").TransactionRequest | undefined): Promise<any>;
-    /**
-     * Send a state-changing transaction.
-     * @param {string} methodName
-     * @param {any[]} args
-     * @param {import("../providers/provider").TransactionRequest=} overrides
-     * @returns {Promise<ContractTransactionResponse>}
-     */
-    send(methodName: string, args: any[], overrides?: import("../providers/provider").TransactionRequest | undefined): Promise<ContractTransactionResponse>;
-    /**
-     * Query logs for an event.
-     * @param {any} event
-     * @param {number|string=} fromBlock
-     * @param {number|string=} toBlock
-     * @returns {Promise<EventLog[]>}
-     */
-    queryFilter(event: any, fromBlock?: (number | string) | undefined, toBlock?: (number | string) | undefined): Promise<EventLog[]>;
-    on(event: any, callback: any): this;
-    once(event: any, callback: any): this;
-    removeListener(event: any, callback: any): this;
-    removeAllListeners(event: any): this;
-    connect(signerOrProvider: any): Contract;
-    attach(address: any): Contract;
-    deployTransaction(): any;
-    getTransactionReceipt(hash: any): Promise<ContractTransactionReceipt>;
-    waitForDeployment(): Promise<this>;
-    getDeployedCode(): Promise<any>;
-}
-/**
- * ContractTransactionResponse (aliasing provider TransactionResponse).
- */
-export class ContractTransactionResponse {
-    /**
-     * @param {any} tx
-     */
-    constructor(tx: any);
-    _tx: any;
-    /**
-     * Wait for confirmations (delegated to underlying TransactionResponse).
-     * @param {number=} confirmations
-     * @param {number=} timeoutMs
-     * @returns {Promise<any>}
-     */
-    wait(confirmations?: number | undefined, timeoutMs?: number | undefined): Promise<any>;
-    /**
-     * Return the underlying transaction response object.
-     * @returns {any}
-     */
-    getTransaction(): any;
-}
-/**
- * ContractTransactionReceipt (aliasing provider TransactionReceipt).
- */
-export class ContractTransactionReceipt {
-    /**
-     * @param {any} receipt
-     */
-    constructor(receipt: any);
-    getEvent(eventName: any): any;
-    getEvents(eventName: any): any;
-}
-/**
- * EventLog placeholder.
- */
-export class EventLog {
-    constructor(log: any);
-}
-import { Interface } from "../abi/interface";

package/example/node_modules/quantumcoin/src/contract/contract.js

@@ -1,408 +0,0 @@
-/**
- * @fileoverview Contract implementation (ethers.js v6 compatible shape).
- */
-
-const qcsdk = require("quantum-coin-js-sdk");
-const { Interface } = require("../abi/interface");
-const { makeError, assertArgument } = require("../errors");
-const { getAddress } = require("../utils/address");
-const { normalizeHex } = require("../internal/hex");
-
-function _requireInitialized() {
-  // eslint-disable-next-line global-require
-  const { isInitialized, getInitializationPromise } = require("../../config");
-  if (isInitialized()) return;
-  if (getInitializationPromise() != null) {
-    throw makeError(
-      "QuantumCoin SDK is still initializing. Await the Initialize() promise before using SDK methods.",
-      "UNKNOWN_ERROR",
-      { operation: "requireInitialized" },
-    );
-  }
-  throw makeError("QuantumCoin SDK not initialized. Call Initialize() first.", "UNKNOWN_ERROR", { operation: "contract" });
-}
-
-function _isProvider(obj) {
-  return Boolean(obj && typeof obj === "object" && typeof obj.call === "function" && typeof obj.getBlockNumber === "function");
-}
-
-function _isSigner(obj) {
-  return Boolean(obj && typeof obj === "object" && typeof obj.signTransaction === "function");
-}
-
-function _isOverridesLike(value) {
-  if (!value || typeof value !== "object") return false;
-  if (Array.isArray(value)) return false;
-  if (value instanceof Uint8Array) return false;
-  return true;
-}
-
-// Fields a caller is allowed to set via `overrides`. Protected routing /
-// payload fields (`to`, `data`, `from`) are intentionally excluded so that a
-// caller-supplied overrides object can never redirect the transaction to a
-// different contract or replace the encoded calldata. Unknown keys are dropped.
-const _ALLOWED_OVERRIDE_KEYS = [
-  "value",
-  "gasLimit",
-  "gasPrice",
-  "maxFeePerGas",
-  "maxPriorityFeePerGas",
-  "nonce",
-  "chainId",
-  "remarks",
-  "signingContext",
-];
-
-/**
- * Return a copy of `overrides` containing only the allow-listed fields.
- * Drops `to`, `data`, `from`, and any unknown/prototype keys so the protected
- * fields computed by the contract layer always win.
- * @param {any} overrides
- * @returns {Record<string, any>}
- */
-function _sanitizeOverrides(overrides) {
-  const out = {};
-  if (!_isOverridesLike(overrides)) return out;
-  for (const key of _ALLOWED_OVERRIDE_KEYS) {
-    if (Object.prototype.hasOwnProperty.call(overrides, key) && overrides[key] !== undefined) {
-      out[key] = overrides[key];
-    }
-  }
-  return out;
-}
-
-/**
- * BaseContract placeholder (ethers-like).
- */
-class BaseContract {
-  constructor() {}
-}
-
-/**
- * ContractTransactionResponse (aliasing provider TransactionResponse).
- */
-class ContractTransactionResponse {
-  /**
-   * @param {any} tx
-   */
-  constructor(tx) {
-    this._tx = tx;
-    // Copy common enumerable fields (hash, from, to, etc.)
-    Object.assign(this, tx);
-  }
-
-  /**
-   * Wait for confirmations (delegated to underlying TransactionResponse).
-   * @param {number=} confirmations
-   * @param {number=} timeoutMs
-   * @returns {Promise<any>}
-   */
-  wait(confirmations, timeoutMs) {
-    if (!this._tx || typeof this._tx.wait !== "function") {
-      throw makeError("underlying transaction does not support wait()", "UNKNOWN_ERROR", {});
-    }
-    return this._tx.wait(confirmations, timeoutMs);
-  }
-
-  /**
-   * Return the underlying transaction response object.
-   * @returns {any}
-   */
-  getTransaction() {
-    return this._tx;
-  }
-}
-
-/**
- * ContractTransactionReceipt (aliasing provider TransactionReceipt).
- */
-class ContractTransactionReceipt {
-  /**
-   * @param {any} receipt
-   */
-  constructor(receipt) {
-    Object.assign(this, receipt);
-  }
-
-  getEvent(eventName) {
-    const list = this.getEvents(eventName);
-    return list.length ? list[0] : null;
-  }
-
-  getEvents(eventName) {
-    if (!this.logs) return [];
-    return this.logs.filter((l) => l && l.eventName === eventName);
-  }
-}
-
-/**
- * EventLog placeholder.
- */
-class EventLog {
-  constructor(log) {
-    Object.assign(this, log);
-  }
-}
-
-class Contract extends BaseContract {
-  /**
-   * @param {string} address
-   * @param {any[]|Interface} abi
-   * @param {any=} providerOrSigner
-   * @param {string=} bytecode
-   */
-  constructor(address, abi, providerOrSigner, bytecode) {
-    super();
-    _requireInitialized();
-    this.address = getAddress(address);
-    this.target = this.address;
-    this.bytecode = bytecode || null;
-    this.interface = abi instanceof Interface ? abi : new Interface(abi);
-
-    this.provider = null;
-    this.signer = null;
-    this.runner = null;
-    if (providerOrSigner) {
-      if (_isProvider(providerOrSigner)) this.provider = providerOrSigner;
-      if (_isSigner(providerOrSigner)) this.signer = providerOrSigner;
-      // Ethers' ContractRunner can be a provider or signer
-      this.runner = providerOrSigner;
-      if (!this.provider && this.signer && this.signer.provider) this.provider = this.signer.provider;
-    }
-
-    this._listeners = new Map();
-
-    // ethers-style populateTransaction namespace:
-    //   await contract.populateTransaction.someMethod(arg1, ..., overrides?)
-    //
-    // NOTE: This will shadow any ABI function literally named "populateTransaction".
-    // Such a function can still be invoked via `contract.call("populateTransaction", ...)`
-    // or `contract.send("populateTransaction", ...)`.
-    const self = this;
-    this.populateTransaction = new Proxy(
-      {},
-      {
-        get(_t, prop) {
-          if (typeof prop !== "string") return undefined;
-          const fn = self.interface.abi.find((f) => f && f.type === "function" && f.name === prop);
-          if (!fn) return undefined;
-          return (...args) => self._populate(prop, args);
-        },
-      },
-    );
-
-    // Proxy to support dynamic method names: contract.someMethod(...)
-    return new Proxy(this, {
-      get: (target, prop, receiver) => {
-        if (typeof prop === "string" && !(prop in target)) {
-          // Treat unknown properties as function invocations if present in ABI
-          const fn = target.interface.abi.find((f) => f && f.type === "function" && f.name === prop);
-          if (fn) {
-            return (...args) => target._invoke(prop, args);
-          }
-        }
-        return Reflect.get(target, prop, receiver);
-      },
-    });
-  }
-
-  getAddress() {
-    return this.address;
-  }
-
-  /**
-   * Invoke a contract function, dispatching to call() or send().
-   * @param {string} methodName
-   * @param {any[]} args
-   * @returns {Promise<any>}
-   */
-  async _invoke(methodName, args) {
-    const fn = this.interface.abi.find((f) => f && f.type === "function" && f.name === methodName);
-    if (!fn) throw makeError("function not found", "INVALID_ARGUMENT", { methodName });
-
-    const mut = fn.stateMutability || "";
-    const isView = mut === "view" || mut === "pure";
-
-    // ethers-style overrides:
-    // - for nonpayable/payable: last arg may be overrides object
-    // - for view/pure: last arg may be overrides (call overrides)
-    const inputCount = Array.isArray(fn.inputs) ? fn.inputs.length : 0;
-    let overrides = undefined;
-    let callArgs = Array.isArray(args) ? args : [];
-
-    if (callArgs.length === inputCount + 1 && _isOverridesLike(callArgs[callArgs.length - 1])) {
-      overrides = callArgs[callArgs.length - 1];
-      callArgs = callArgs.slice(0, inputCount);
-    }
-
-    if (isView) {
-      return this.call(methodName, callArgs, overrides);
-    }
-
-    return this.send(methodName, callArgs, overrides);
-  }
-
-  /**
-   * Build an unsigned transaction request for a contract method call.
-   * @param {string} methodName
-   * @param {any[]} args
-   * @returns {Promise<import("../providers/provider").TransactionRequest>}
-   */
-  async _populate(methodName, args) {
-    const fn = this.interface.abi.find((f) => f && f.type === "function" && f.name === methodName);
-    if (!fn) throw makeError("function not found", "INVALID_ARGUMENT", { methodName });
-
-    const inputCount = Array.isArray(fn.inputs) ? fn.inputs.length : 0;
-    let overrides = undefined;
-    let callArgs = Array.isArray(args) ? args : [];
-
-    if (callArgs.length === inputCount + 1 && _isOverridesLike(callArgs[callArgs.length - 1])) {
-      overrides = callArgs[callArgs.length - 1];
-      callArgs = callArgs.slice(0, inputCount);
-    }
-
-    const data = this.interface.encodeFunctionData(methodName, callArgs);
-    // Protected fields (to/data) must win over caller-supplied overrides.
-    return { ..._sanitizeOverrides(overrides), to: this.address, data };
-  }
-
-  /**
-   * Perform a read-only call.
-   * @param {string} methodName
-   * @param {any[]} args
-   * @param {import("../providers/provider").TransactionRequest=} overrides
-   * @returns {Promise<any>}
-   */
-  async call(methodName, args, overrides) {
-    if (!this.provider) throw makeError("missing provider", "UNKNOWN_ERROR", { operation: "call" });
-    const data = this.interface.encodeFunctionData(methodName, args);
-    // Protected fields (to/data) must win over caller-supplied overrides.
-    const tx = { ..._sanitizeOverrides(overrides), to: this.address, data };
-    const raw = await this.provider.call(tx, "latest");
-    const decoded = this.interface.decodeFunctionResult(methodName, raw);
-    return decoded;
-  }
-
-  /**
-   * Send a state-changing transaction.
-   * @param {string} methodName
-   * @param {any[]} args
-   * @param {import("../providers/provider").TransactionRequest=} overrides
-   * @returns {Promise<ContractTransactionResponse>}
-   */
-  async send(methodName, args, overrides) {
-    if (!this.signer) throw makeError("missing signer", "UNKNOWN_ERROR", { operation: "send" });
-    const data = this.interface.encodeFunctionData(methodName, args);
-    // Protected fields (to/data) must win over caller-supplied overrides.
-    const tx = { ..._sanitizeOverrides(overrides), to: this.address, data };
-    const resp = await this.signer.sendTransaction(tx);
-    return new ContractTransactionResponse(resp);
-  }
-
-  /**
-   * Query logs for an event.
-   * @param {any} event
-   * @param {number|string=} fromBlock
-   * @param {number|string=} toBlock
-   * @returns {Promise<EventLog[]>}
-   */
-  async queryFilter(event, fromBlock, toBlock) {
-    if (!this.provider) throw makeError("missing provider", "UNKNOWN_ERROR", { operation: "queryFilter" });
-    const name = typeof event === "string" ? event : event?.name;
-    assertArgument(typeof name === "string", "invalid event", "event", event);
-
-    // Bind the query to the requested event's topic0 so a malicious node cannot
-    // return same-address logs for a *different* event. We both constrain the RPC
-    // filter and verify the returned logs' topic0 client-side.
-    const topic0 = this.interface.getEventTopic(name);
-    const filter = { address: this.address, topics: [topic0], fromBlock, toBlock };
-    const logs = await this.provider.getLogs(filter);
-    return logs
-      .filter((l) => {
-        const t = Array.isArray(l && l.topics) ? l.topics[0] : null;
-        return typeof t === "string" && normalizeHex(t).toLowerCase() === topic0.toLowerCase();
-      })
-      .map((l) => new EventLog(l));
-  }
-
-  on(event, callback) {
-    const name = typeof event === "string" ? event : event?.name;
-    if (!name) throw makeError("invalid event", "INVALID_ARGUMENT", { event });
-    const list = this._listeners.get(name) || [];
-    list.push(callback);
-    this._listeners.set(name, list);
-    return this;
-  }
-
-  once(event, callback) {
-    const wrap = (...args) => {
-      this.removeListener(event, wrap);
-      callback(...args);
-    };
-    return this.on(event, wrap);
-  }
-
-  removeListener(event, callback) {
-    const name = typeof event === "string" ? event : event?.name;
-    const list = this._listeners.get(name) || [];
-    this._listeners.set(
-      name,
-      list.filter((cb) => cb !== callback),
-    );
-    return this;
-  }
-
-  removeAllListeners(event) {
-    if (!event) {
-      this._listeners.clear();
-      return this;
-    }
-    const name = typeof event === "string" ? event : event?.name;
-    this._listeners.delete(name);
-    return this;
-  }
-
-  connect(signerOrProvider) {
-    return new Contract(this.address, this.interface, signerOrProvider, this.bytecode);
-  }
-
-  attach(address) {
-    return new Contract(address, this.interface, this.runner, this.bytecode);
-  }
-
-  deployTransaction() {
-    return this._deployTx || null;
-  }
-
-  async getTransactionReceipt(hash) {
-    if (!this.provider) return null;
-    const receipt = await this.provider.getTransactionReceipt(hash);
-    return receipt ? new ContractTransactionReceipt(receipt) : null;
-  }
-
-  async waitForDeployment() {
-    if (!this._deployTx) return this;
-    await this._deployTx.wait();
-    return this;
-  }
-
-  async getDeployedCode() {
-    if (!this.provider) return null;
-    return this.provider.getCode(this.address, "latest");
-  }
-
-  static from(target, abi, runner) {
-    const address = typeof target === "string" ? target : target?.address || target?.target;
-    return new Contract(address, abi, runner);
-  }
-}
-
-module.exports = {
-  BaseContract,
-  Contract,
-  ContractTransactionResponse,
-  ContractTransactionReceipt,
-  EventLog,
-  _sanitizeOverrides,
-};
-

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

@@ -1,9 +0,0 @@
-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/example/node_modules/quantumcoin/src/contract/index.js

@@ -1,9 +0,0 @@
-/**
- * @fileoverview Contract exports.
- */
-
-module.exports = {
-  ...require("./contract"),
-  ...require("./contract-factory"),
-};
-