quantumcoin 7.0.14 → 8.0.0

package/src/providers/provider.d.ts

@@ -1,206 +1,233 @@
-export type BytesLike = import("../utils/encoding").BytesLike;
-export type TransactionRequest = {
-    to?: string | undefined;
-    from?: string | undefined;
-    value?: (bigint | string | number) | undefined;
-    data?: string | undefined;
-    gasLimit?: (bigint | string | number) | undefined;
-    nonce?: number | undefined;
-    chainId?: number | undefined;
-    /**
-     * Optional remark field (hex, max 32 bytes)
-     */
-    remarks?: string | undefined;
-    /**
-     * Optional signing context (0, 1, 2, or null). Passed to SDK TransactionSigningRequest; default null.
-     */
-    signingContext?: (number | null) | undefined;
-};
-export type Filter = {
-    address?: (string | string[]) | undefined;
-    topics?: (string | string[] | null)[] | undefined;
-    fromBlock?: (number | string) | undefined;
-    toBlock?: (number | string) | undefined;
-    blockHash?: string | undefined;
-};
-/**
- * Base Provider class.
- */
-export class Provider {
-}
-/**
- * AbstractProvider base class (ethers-like).
- */
-export class AbstractProvider extends Provider {
-    /**
-     * Implemented by subclasses to perform JSON-RPC.
-     * @param {string} method
-     * @param {any[]=} params
-     * @returns {Promise<any>}
-     */
-    _perform(method: string, params?: any[] | undefined): Promise<any>;
-    getBlockNumber(): Promise<number>;
-    /**
-     * @param {number|"latest"} blockNumber
-     * @returns {Promise<Block>}
-     */
-    getBlock(blockNumber: number | "latest"): Promise<Block>;
-    /**
-     * @param {string} txHash
-     * @returns {Promise<TransactionResponse>}
-     */
-    getTransaction(txHash: string): Promise<TransactionResponse>;
-    /**
-     * @param {string} txHash
-     * @returns {Promise<TransactionReceipt>}
-     */
-    getTransactionReceipt(txHash: string): Promise<TransactionReceipt>;
-    /**
-     * @param {string} address
-     * @returns {Promise<bigint>}
-     */
-    getBalance(address: string): Promise<bigint>;
-    /**
-     * @param {string} address
-     * @param {string=} blockTag
-     * @returns {Promise<number>}
-     */
-    getTransactionCount(address: string, blockTag?: string | undefined): Promise<number>;
-    /**
-     * Broadcasts a signed transaction.
-     * @param {TransactionRequest|string} tx
-     * @returns {Promise<TransactionResponse>}
-     */
-    sendTransaction(tx: TransactionRequest | string): Promise<TransactionResponse>;
-    /**
-     * Broadcast a signed raw transaction.
-     * Alias of sendTransaction(rawTx) for clarity when doing offline signing flows.
-     *
-     * @param {string} rawTx
-     * @returns {Promise<TransactionResponse>}
-     */
-    sendRawTransaction(rawTx: string): Promise<TransactionResponse>;
-    /**
-     * Perform a call (read-only) and return hex data.
-     * @param {TransactionRequest} tx
-     * @param {string=} blockTag
-     * @returns {Promise<string>}
-     */
-    call(tx: TransactionRequest, blockTag?: string | undefined): Promise<string>;
-    /**
-     * Estimate gas for a call/transaction.
-     * @param {TransactionRequest} tx
-     * @returns {Promise<bigint>}
-     */
-    estimateGas(tx: TransactionRequest): Promise<bigint>;
-    /**
-     * @param {string} address
-     * @param {string=} blockTag
-     * @returns {Promise<string>}
-     */
-    getCode(address: string, blockTag?: string | undefined): Promise<string>;
-    /**
-     * @param {string} address
-     * @param {bigint} position
-     * @param {string=} blockTag
-     * @returns {Promise<string>}
-     */
-    getStorageAt(address: string, position: bigint, blockTag?: string | undefined): Promise<string>;
-    /**
-     * @param {Filter} filter
-     * @returns {Promise<Log[]>}
-     */
-    getLogs(filter: Filter): Promise<Log[]>;
-}
-/**
- * Minimal Block wrapper (ethers-like).
- */
-export class Block {
-    /**
-     * @param {any} block
-     * @param {AbstractProvider=} provider
-     */
-    constructor(block: any, provider?: AbstractProvider | undefined);
-    provider: AbstractProvider;
-    hash: any;
-    parentHash: any;
-    number: number;
-    timestamp: number;
-    transactions: any;
-    getTransaction(indexOrHash: any): Promise<TransactionResponse>;
-    getTransactionReceipt(indexOrHash: any): Promise<TransactionReceipt>;
-    getPrefetchedTransactions(): any[];
-}
-/**
- * Minimal TransactionResponse wrapper (ethers-like).
- */
-export class TransactionResponse {
-    /**
-     * @param {any} tx
-     * @param {AbstractProvider=} provider
-     */
-    constructor(tx: any, provider?: AbstractProvider | undefined);
-    provider: AbstractProvider;
-    hash: any;
-    to: any;
-    from: any;
-    nonce: number;
-    data: any;
-    value: any;
-    gasLimit: any;
-    chainId: number;
-    blockNumber: number;
-    txType: number | null;
-    remarks: string;
-    /**
-     * Wait for confirmations.
-     * @param {number=} confirmations
-     * @param {number=} timeoutMs
-     * @returns {Promise<TransactionReceipt>}
-     */
-    wait(confirmations?: number | undefined, timeoutMs?: number | undefined): Promise<TransactionReceipt>;
-}
-/**
- * Minimal TransactionReceipt wrapper (ethers-like).
- */
-export class TransactionReceipt {
-    /**
-     * @param {any} receipt
-     * @param {AbstractProvider=} provider
-     */
-    constructor(receipt: any, provider?: AbstractProvider | undefined);
-    provider: AbstractProvider;
-    to: any;
-    from: any;
-    contractAddress: any;
-    transactionHash: any;
-    blockHash: any;
-    blockNumber: number;
-    transactionIndex: number;
-    gasUsed: any;
-    status: number;
-    logs: any;
-}
-/**
- * Minimal Log wrapper (ethers-like).
- */
-export class Log {
-    /**
-     * @param {any} log
-     * @param {AbstractProvider=} provider
-     */
-    constructor(log: any, provider?: AbstractProvider | undefined);
-    provider: AbstractProvider;
-    address: any;
-    topics: any;
-    data: any;
-    blockHash: any;
-    blockNumber: number;
-    transactionHash: any;
-    transactionIndex: number;
-    logIndex: number;
-    removed: boolean;
-    getBlock(): Promise<Block>;
-    getTransaction(): Promise<TransactionResponse>;
-    getTransactionReceipt(): Promise<TransactionReceipt>;
-}
+export type BytesLike = import("../utils/encoding").BytesLike;
+export type TransactionRequest = {
+    to?: string | undefined;
+    from?: string | undefined;
+    value?: (bigint | string | number) | undefined;
+    data?: string | undefined;
+    gasLimit?: (bigint | string | number) | undefined;
+    nonce?: number | undefined;
+    chainId?: number | undefined;
+    /**
+     * Optional remark field (hex, max 32 bytes)
+     */
+    remarks?: string | undefined;
+    /**
+     * Optional signing context (0, 1, 2, or null). Passed to SDK TransactionSigningRequest; default null.
+     */
+    signingContext?: (number | null) | undefined;
+};
+export type Filter = {
+    address?: (string | string[]) | undefined;
+    topics?: (string | string[] | null)[] | undefined;
+    fromBlock?: (number | string) | undefined;
+    toBlock?: (number | string) | undefined;
+    blockHash?: string | undefined;
+};
+/**
+ * Base Provider class.
+ */
+export class Provider extends EventEmitter {
+}
+/**
+ * AbstractProvider base class (ethers-like).
+ */
+export class AbstractProvider extends Provider {
+    /**
+     * Implemented by subclasses to perform JSON-RPC.
+     * @param {string} method
+     * @param {any[]=} params
+     * @returns {Promise<any>}
+     */
+    _perform(method: string, params?: any[] | undefined): Promise<any>;
+    getBlockNumber(): Promise<number>;
+    /**
+     * @param {number|"latest"} blockNumber
+     * @returns {Promise<Block>}
+     */
+    getBlock(blockNumber: number | "latest"): Promise<Block>;
+    /**
+     * @param {string} txHash
+     * @returns {Promise<TransactionResponse>}
+     */
+    getTransaction(txHash: string): Promise<TransactionResponse>;
+    /**
+     * @param {string} txHash
+     * @returns {Promise<TransactionReceipt>}
+     */
+    getTransactionReceipt(txHash: string): Promise<TransactionReceipt>;
+    /**
+     * @param {string} address
+     * @returns {Promise<bigint>}
+     */
+    getBalance(address: string): Promise<bigint>;
+    /**
+     * @param {string} address
+     * @param {string=} blockTag
+     * @returns {Promise<number>}
+     */
+    getTransactionCount(address: string, blockTag?: string | undefined): Promise<number>;
+    /**
+     * Broadcasts a signed transaction.
+     * @param {TransactionRequest|string} tx
+     * @param {{ expectedHash?: string }=} opts Optional. When `expectedHash` is set,
+     *   the hash returned by the node (and the fetched-back transaction's hash) must
+     *   match it, otherwise an error is thrown (do not trust the RPC node to
+     *   broadcast the exact transaction that was signed).
+     * @returns {Promise<TransactionResponse>}
+     */
+    sendTransaction(tx: TransactionRequest | string, opts?: {
+        expectedHash?: string;
+    } | undefined): Promise<TransactionResponse>;
+    /**
+     * Broadcast a signed raw transaction.
+     * Alias of sendTransaction(rawTx) for clarity when doing offline signing flows.
+     *
+     * @param {string} rawTx
+     * @returns {Promise<TransactionResponse>}
+     */
+    sendRawTransaction(rawTx: string): Promise<TransactionResponse>;
+    /**
+     * Perform a call (read-only) and return hex data.
+     * @param {TransactionRequest} tx
+     * @param {string=} blockTag
+     * @returns {Promise<string>}
+     */
+    call(tx: TransactionRequest, blockTag?: string | undefined): Promise<string>;
+    /**
+     * Estimate gas for a call/transaction.
+     * @param {TransactionRequest} tx
+     * @returns {Promise<bigint>}
+     */
+    estimateGas(tx: TransactionRequest): Promise<bigint>;
+    /**
+     * Returns fee data (currently the gas price per unit of gas, in wei).
+     * Supports only DynamicFeeTx (dynamic-fee transactions); other fee tx types are not supported.
+     * @param {import("../wallet/wallet").Wallet|number} walletOrKeyType A Wallet, or a key type number (3 or 5).
+     * @param {boolean|null=} fullSign  Full signing (keyType 3 only; ignored for keyType 5).
+     * @returns {Promise<FeeData>}
+     */
+    getFeeData(walletOrKeyType: import("../wallet/wallet").Wallet | number, fullSign?: (boolean | null) | undefined): Promise<FeeData>;
+    /**
+     * @param {string} address
+     * @param {string=} blockTag
+     * @returns {Promise<string>}
+     */
+    getCode(address: string, blockTag?: string | undefined): Promise<string>;
+    /**
+     * @param {string} address
+     * @param {bigint} position
+     * @param {string=} blockTag
+     * @returns {Promise<string>}
+     */
+    getStorageAt(address: string, position: bigint, blockTag?: string | undefined): Promise<string>;
+    /**
+     * @param {Filter} filter
+     * @returns {Promise<Log[]>}
+     */
+    getLogs(filter: Filter): Promise<Log[]>;
+}
+/**
+ * Minimal Block wrapper (ethers-like).
+ */
+export class Block {
+    /**
+     * @param {any} block
+     * @param {AbstractProvider=} provider
+     */
+    constructor(block: any, provider?: AbstractProvider | undefined);
+    provider: AbstractProvider | null;
+    hash: any;
+    parentHash: any;
+    number: number | null;
+    timestamp: number | null;
+    transactions: any;
+    getTransaction(indexOrHash: any): Promise<TransactionResponse | null>;
+    getTransactionReceipt(indexOrHash: any): Promise<TransactionReceipt | null>;
+    getPrefetchedTransactions(): never[];
+}
+/**
+ * Minimal TransactionResponse wrapper (ethers-like).
+ */
+export class TransactionResponse {
+    /**
+     * @param {any} tx
+     * @param {AbstractProvider=} provider
+     */
+    constructor(tx: any, provider?: AbstractProvider | undefined);
+    provider: AbstractProvider | null;
+    hash: any;
+    to: any;
+    from: any;
+    nonce: number | null;
+    data: any;
+    value: any;
+    gasLimit: any;
+    chainId: number | null;
+    blockNumber: number | null;
+    txType: number | null;
+    remarks: string | null;
+    /**
+     * Wait for confirmations.
+     * @param {number=} confirmations
+     * @param {number=} timeoutMs
+     * @returns {Promise<TransactionReceipt>}
+     */
+    wait(confirmations?: number | undefined, timeoutMs?: number | undefined): Promise<TransactionReceipt>;
+}
+/**
+ * Minimal TransactionReceipt wrapper (ethers-like).
+ */
+export class TransactionReceipt {
+    /**
+     * @param {any} receipt
+     * @param {AbstractProvider=} provider
+     */
+    constructor(receipt: any, provider?: AbstractProvider | undefined);
+    provider: AbstractProvider | null;
+    to: any;
+    from: any;
+    contractAddress: any;
+    transactionHash: any;
+    blockHash: any;
+    blockNumber: number | null;
+    transactionIndex: number | null;
+    gasUsed: any;
+    status: number | null;
+    logs: any;
+}
+/**
+ * Minimal Log wrapper (ethers-like).
+ */
+export class Log {
+    /**
+     * @param {any} log
+     * @param {AbstractProvider=} provider
+     */
+    constructor(log: any, provider?: AbstractProvider | undefined);
+    provider: AbstractProvider | null;
+    address: any;
+    topics: any;
+    data: any;
+    blockHash: any;
+    blockNumber: number | null;
+    transactionHash: any;
+    transactionIndex: number | null;
+    logIndex: number | null;
+    removed: boolean;
+    getBlock(): Promise<Block | null>;
+    getTransaction(): Promise<TransactionResponse | null>;
+    getTransactionReceipt(): Promise<TransactionReceipt | null>;
+}
+/**
+ * Fee data for a transaction. Currently only `gasPrice` (per unit of gas, in wei)
+ * is populated. `maxFeePerGas` / `maxPriorityFeePerGas` are not supported yet:
+ * QuantumCoin uses a fixed per-scheme fee model with no EIP-1559 base fee / priority tip.
+ */
+export class FeeData {
+    /**
+     * @param {bigint} gasPrice
+     */
+    constructor(gasPrice: bigint);
+    gasPrice: bigint;
+}
+import EventEmitter = require("../internal/event-emitter");

package/src/providers/provider.js

@@ -5,7 +5,8 @@
  * The concrete JSON-RPC implementation lives in `json-rpc-provider.js`.
  */
 
-const { EventEmitter } = require("events");
+const EventEmitter = require("../internal/event-emitter");
+const qcsdk = require("quantum-coin-js-sdk");
 const { makeError, assertArgument } = require("../errors");
 const { normalizeHex, toQuantityHex, isHexString } = require("../internal/hex");
 
@@ -263,6 +264,20 @@ class Block {
   }
 }
 
+/**
+ * Fee data for a transaction. Currently only `gasPrice` (per unit of gas, in wei)
+ * is populated. `maxFeePerGas` / `maxPriorityFeePerGas` are not supported yet:
+ * QuantumCoin uses a fixed per-scheme fee model with no EIP-1559 base fee / priority tip.
+ */
+class FeeData {
+  /**
+   * @param {bigint} gasPrice
+   */
+  constructor(gasPrice) {
+    this.gasPrice = gasPrice;
+  }
+}
+
 /**
  * Base Provider class.
  */
@@ -459,6 +474,30 @@ class AbstractProvider extends Provider {
     return _hexToBigInt(gas);
   }
 
+  /**
+   * Returns fee data (currently the gas price per unit of gas, in wei).
+   * Supports only DynamicFeeTx (dynamic-fee transactions); other fee tx types are not supported.
+   * @param {import("../wallet/wallet").Wallet|number} walletOrKeyType A Wallet, or a key type number (3 or 5).
+   * @param {boolean|null=} fullSign  Full signing (keyType 3 only; ignored for keyType 5).
+   * @returns {Promise<FeeData>}
+   */
+  async getFeeData(walletOrKeyType, fullSign) {
+    let keyType;
+    if (typeof walletOrKeyType === "number") {
+      keyType = walletOrKeyType;
+    } else if (walletOrKeyType && typeof walletOrKeyType.getKeyType === "function") {
+      keyType = walletOrKeyType.getKeyType();
+    } else {
+      assertArgument(false, "expected a Wallet or a keyType number", "walletOrKeyType", walletOrKeyType);
+    }
+
+    const res = qcsdk.getGasPrice(keyType, fullSign ?? false);
+    if (!res || res.resultCode !== 0 || res.gasPrice == null) {
+      throw makeError("getGasPrice failed", "UNKNOWN_ERROR", { resultCode: res && res.resultCode, keyType });
+    }
+    return new FeeData(BigInt(res.gasPrice));
+  }
+
   /**
    * @param {string} address
    * @param {string=} blockTag
@@ -520,5 +559,6 @@ module.exports = {
   TransactionResponse,
   TransactionReceipt,
   Log,
+  FeeData,
 };
 

package/src/utils/encoding.js

@@ -3,7 +3,8 @@
  *
  * Notes:
  * - QuantumCoin addresses are 32 bytes (not 20).
- * - This module intentionally uses only built-in Node.js APIs.
+ * - This module is platform agnostic (works in Node.js and the browser) and
+ *   avoids Node-only APIs such as Buffer.
  */
 
 const {
@@ -166,8 +167,13 @@ function decodeBytes32String(bytes) {
  * @returns {Uint8Array}
  */
 function decodeBase64(data) {
-  const buf = Buffer.from(data, "base64");
-  return new Uint8Array(buf);
+  if (typeof globalThis.atob !== "function") {
+    throw new Error("base64 decoding not supported in this environment");
+  }
+  const binary = globalThis.atob(data);
+  const out = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
+  return out;
 }
 
 /**
@@ -176,7 +182,13 @@ function decodeBase64(data) {
  * @returns {string}
  */
 function encodeBase64(data) {
-  return Buffer.from(arrayify(data)).toString("base64");
+  if (typeof globalThis.btoa !== "function") {
+    throw new Error("base64 encoding not supported in this environment");
+  }
+  const bytes = arrayify(data);
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+  return globalThis.btoa(binary);
 }
 
 // Minimal base58 implementation (Bitcoin alphabet) for compatibility with ethers helpers.

package/src/utils/fixednumber.d.ts

@@ -1,57 +1,57 @@
-import type { BytesLike } from "./encoding";
-
-export type BigNumberish = string | number | bigint;
-
-export type FixedFormat = number | string | {
-    signed?: boolean;
-    width?: number;
-    decimals?: number;
-};
-
-export class FixedNumber {
-    private constructor(guard: any, value: bigint, format: any);
-
-    readonly format: string;
-    readonly _value: string;
-
-    get signed(): boolean;
-    get width(): number;
-    get decimals(): number;
-    get value(): bigint;
-
-    add(other: FixedNumber): FixedNumber;
-    addUnsafe(other: FixedNumber): FixedNumber;
-    sub(other: FixedNumber): FixedNumber;
-    subUnsafe(other: FixedNumber): FixedNumber;
-    mul(other: FixedNumber): FixedNumber;
-    mulUnsafe(other: FixedNumber): FixedNumber;
-    mulSignal(other: FixedNumber): FixedNumber;
-    div(other: FixedNumber): FixedNumber;
-    divUnsafe(other: FixedNumber): FixedNumber;
-    divSignal(other: FixedNumber): FixedNumber;
-
-    cmp(other: FixedNumber): number;
-    eq(other: FixedNumber): boolean;
-    lt(other: FixedNumber): boolean;
-    lte(other: FixedNumber): boolean;
-    gt(other: FixedNumber): boolean;
-    gte(other: FixedNumber): boolean;
-
-    floor(): FixedNumber;
-    ceiling(): FixedNumber;
-    round(decimals?: number): FixedNumber;
-
-    isZero(): boolean;
-    isNegative(): boolean;
-
-    toString(): string;
-    toUnsafeFloat(): number;
-    toFormat(format: FixedFormat): FixedNumber;
-    toHexString(width?: number): string;
-
-    static fromValue(value: BigNumberish, decimals?: number, format?: FixedFormat): FixedNumber;
-    static fromString(value: string, format?: FixedFormat): FixedNumber;
-    static fromBytes(value: BytesLike, format?: FixedFormat): FixedNumber;
-    static from(value: any, format?: FixedFormat): FixedNumber;
-    static isFixedNumber(value: any): value is FixedNumber;
-}
+import type { BytesLike } from "./encoding";
+
+export type BigNumberish = string | number | bigint;
+
+export type FixedFormat = number | string | {
+    signed?: boolean;
+    width?: number;
+    decimals?: number;
+};
+
+export class FixedNumber {
+    private constructor(guard: any, value: bigint, format: any);
+
+    readonly format: string;
+    readonly _value: string;
+
+    get signed(): boolean;
+    get width(): number;
+    get decimals(): number;
+    get value(): bigint;
+
+    add(other: FixedNumber): FixedNumber;
+    addUnsafe(other: FixedNumber): FixedNumber;
+    sub(other: FixedNumber): FixedNumber;
+    subUnsafe(other: FixedNumber): FixedNumber;
+    mul(other: FixedNumber): FixedNumber;
+    mulUnsafe(other: FixedNumber): FixedNumber;
+    mulSignal(other: FixedNumber): FixedNumber;
+    div(other: FixedNumber): FixedNumber;
+    divUnsafe(other: FixedNumber): FixedNumber;
+    divSignal(other: FixedNumber): FixedNumber;
+
+    cmp(other: FixedNumber): number;
+    eq(other: FixedNumber): boolean;
+    lt(other: FixedNumber): boolean;
+    lte(other: FixedNumber): boolean;
+    gt(other: FixedNumber): boolean;
+    gte(other: FixedNumber): boolean;
+
+    floor(): FixedNumber;
+    ceiling(): FixedNumber;
+    round(decimals?: number): FixedNumber;
+
+    isZero(): boolean;
+    isNegative(): boolean;
+
+    toString(): string;
+    toUnsafeFloat(): number;
+    toFormat(format: FixedFormat): FixedNumber;
+    toHexString(width?: number): string;
+
+    static fromValue(value: BigNumberish, decimals?: number, format?: FixedFormat): FixedNumber;
+    static fromString(value: string, format?: FixedFormat): FixedNumber;
+    static fromBytes(value: BytesLike, format?: FixedFormat): FixedNumber;
+    static from(value: any, format?: FixedFormat): FixedNumber;
+    static isFixedNumber(value: any): value is FixedNumber;
+}