zerc20-client-sdk 0.1.13 → 0.1.14

package/dist/utils/fees.d.ts

@@ -1,4 +1,10 @@
 import type { PublicClient } from "viem";
+/**
+ * Fee override parameters compatible with viem transaction calls.
+ * @remarks
+ * - Legacy transactions use `gasPrice` and must be tagged with `{ type: "legacy" }` for viem.
+ * - EIP-1559 transactions use `maxFeePerGas` and `maxPriorityFeePerGas`.
+ */
 export type FeeOverrides = {
     type: "legacy";
     gasPrice: bigint;

package/dist/utils/fees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/utils/fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAAC;AAM3D,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAoCnC"}
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/utils/fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAAC;AAM3D,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAwCnC"}

package/dist/utils/fees.js

@@ -2,6 +2,9 @@ function isBigint(value) {
     return typeof value === "bigint";
 }
 export async function buildFeeOverrides(publicClient, options) {
+    /**
+     * If `legacyTx` is enabled, prefer returning a legacy fee override even when the RPC returns EIP-1559 fields.
+     */
     const preferLegacy = options?.legacyTx === true;
     try {
         const fees = await publicClient.estimateFeesPerGas();
@@ -27,6 +30,7 @@ export async function buildFeeOverrides(publicClient, options) {
     }
     if (preferLegacy) {
         try {
+            // Last-resort fallback for legacy chains/providers.
             const gasPrice = await publicClient.getGasPrice();
             if (isBigint(gasPrice)) {
                 return { type: "legacy", gasPrice };

package/dist/utils/fees.js.map

@@ -1 +1 @@
-{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../src/utils/fees.ts"],"names":[],"mappings":"AAMA,SAAS,QAAQ,CAAC,KAAqB;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAA0B,EAC1B,OAAgC;IAEhC,MAAM,YAAY,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACvE,OAAO;oBACL,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;iBAChD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../src/utils/fees.ts"],"names":[],"mappings":"AAYA,SAAS,QAAQ,CAAC,KAAqB;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAA0B,EAC1B,OAAgC;IAEhC;;OAEG;IACH,MAAM,YAAY,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACvE,OAAO;oBACL,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;iBAChD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/hex.d.ts

@@ -1,13 +1,50 @@
+/**
+ * Hex and byte utilities used throughout the SDK.
+ * @remarks
+ * - All normalized hex strings are returned as lowercase with a `0x` prefix.
+ * - Odd-length hex is left-padded with a `0` nibble (e.g. `0xabc` -> `0x0abc`).
+ * - The input prefix `0X` is accepted and normalized to `0x`.
+ */
 export type HexLike = string | number | bigint | Uint8Array | {
     toHexString(): string;
 } | {
     _hex: string;
 };
 export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Normalize an input into a lowercase `0x`-prefixed hex string.
+ * @param value - Hex-like input (string/number/bigint/bytes or ethers-like objects).
+ * @throws If the input is unsupported or invalid (e.g. empty string, non-integer number).
+ */
 export declare function normalizeHex(value: HexLike): string;
+/**
+ * Convert a hex string into bytes.
+ * @remarks The input is normalized before decoding.
+ */
 export declare function hexToBytes(value: string): Uint8Array;
+/**
+ * Ensure a value is a hex string of the expected byte length.
+ * @param value - Hex-like input to validate.
+ * @param expectedBytes - Expected length in bytes.
+ * @param label - Used in error messages.
+ * @throws If the decoded byte length does not match `expectedBytes`.
+ */
 export declare function ensureHexLength(value: HexLike, expectedBytes: number, label: string): string;
+/**
+ * Convert an EVM address string into bytes (20 bytes).
+ * @throws If the address is not exactly 20 bytes.
+ */
 export declare function addressToBytes(address: string): Uint8Array;
+/**
+ * Generate cryptographically secure random bytes.
+ * @throws If secure randomness is not available (missing global `crypto.getRandomValues`).
+ */
 export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Convert a bigint-like value into bigint.
+ * @remarks
+ * - For numbers, only integers are accepted.
+ * - For strings, both decimal and `0x`/`0X`-prefixed hex are accepted.
+ */
 export declare function toBigInt(value: number | string | bigint): bigint;
 //# sourceMappingURL=hex.d.ts.map

package/dist/utils/hex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GACf,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,WAAW,IAAI,MAAM,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AASrB,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsCnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5F;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAG1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAqBhE"}
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GACf,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,WAAW,IAAI,MAAM,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AASrB,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsCnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMpD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAG1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAqBhE"}

package/dist/utils/hex.js

@@ -8,6 +8,11 @@ function ensureEvenHex(hex) {
 export function bytesToHex(bytes) {
     return viemBytesToHex(bytes);
 }
+/**
+ * Normalize an input into a lowercase `0x`-prefixed hex string.
+ * @param value - Hex-like input (string/number/bigint/bytes or ethers-like objects).
+ * @throws If the input is unsupported or invalid (e.g. empty string, non-integer number).
+ */
 export function normalizeHex(value) {
     if (typeof value === "string") {
         const trimmed = value.trim();
@@ -42,6 +47,10 @@ export function normalizeHex(value) {
     }
     throw new Error("normalizeHex: unsupported value type");
 }
+/**
+ * Convert a hex string into bytes.
+ * @remarks The input is normalized before decoding.
+ */
 export function hexToBytes(value) {
     const normalized = normalizeHex(value);
     if (normalized === "0x") {
@@ -49,6 +58,13 @@ export function hexToBytes(value) {
     }
     return viemHexToBytes(normalized);
 }
+/**
+ * Ensure a value is a hex string of the expected byte length.
+ * @param value - Hex-like input to validate.
+ * @param expectedBytes - Expected length in bytes.
+ * @param label - Used in error messages.
+ * @throws If the decoded byte length does not match `expectedBytes`.
+ */
 export function ensureHexLength(value, expectedBytes, label) {
     const normalized = normalizeHex(value);
     const bytes = hexToBytes(normalized);
@@ -57,10 +73,18 @@ export function ensureHexLength(value, expectedBytes, label) {
     }
     return normalized;
 }
+/**
+ * Convert an EVM address string into bytes (20 bytes).
+ * @throws If the address is not exactly 20 bytes.
+ */
 export function addressToBytes(address) {
     const normalized = ensureHexLength(address, 20, "address");
     return hexToBytes(normalized);
 }
+/**
+ * Generate cryptographically secure random bytes.
+ * @throws If secure randomness is not available (missing global `crypto.getRandomValues`).
+ */
 export function randomBytes(length) {
     const buffer = new Uint8Array(length);
     if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
@@ -69,6 +93,12 @@ export function randomBytes(length) {
     }
     throw new Error("secure randomness is not available (missing global crypto)");
 }
+/**
+ * Convert a bigint-like value into bigint.
+ * @remarks
+ * - For numbers, only integers are accepted.
+ * - For strings, both decimal and `0x`/`0X`-prefixed hex are accepted.
+ */
 export function toBigInt(value) {
     if (typeof value === "bigint") {
         return value;

package/dist/utils/hex.js.map

@@ -1 +1 @@
-{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,MAAM,CAAC;AAUlF,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3E,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,OAAQ,KAAmC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAC3E,OAAO,YAAY,CAAE,KAAmC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,YAAY,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAkB,CAAC;IACxD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,aAAqB,EAAE,KAAa;IAClF,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,aAAa,oBAAoB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAClF,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAA+B;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/utils/hex.ts"],"names":[],"mappings":"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"}

package/dist/utils/http.d.ts

@@ -1,2 +1,102 @@
+/**
+ * HTTP utilities for making requests with common patterns.
+ */
+/**
+ * Options for creating an HTTP client.
+ */
+export interface HttpClientOptions {
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetchImpl?: typeof fetch;
+    /** Default headers to include in all requests */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Options for polling until a condition is met.
+ */
+export interface PollOptions<T> {
+    /** Function to check if polling should stop */
+    until: (response: T) => boolean;
+    /** Interval between polls in milliseconds */
+    intervalMs: number;
+    /** Maximum time to poll in milliseconds */
+    timeoutMs: number;
+    /** Optional callback when a poll iteration completes */
+    onPoll?: (response: T, elapsedMs: number) => void;
+}
+/**
+ * Ensures fetch is available in the current environment.
+ * @remarks
+ * This returns a thin wrapper around the global `fetch` so the call site has a stable function type.
+ * @throws If `fetch` is not available in the current environment (e.g. older Node.js without polyfill).
+ */
 export declare function ensureFetch(): typeof fetch;
+/**
+ * Normalizes a base URL to ensure it ends with a slash.
+ */
+export declare function normalizeBaseUrl(url: string): string;
+/**
+ * Builds a full URL from a base URL and a path.
+ */
+export declare function buildUrl(baseUrl: string, path: string): string;
+/**
+ * Wraps a fetch error with context about the request.
+ */
+export declare function wrapFetchError(url: string, error: unknown, context?: string): Error;
+/**
+ * Sleeps for the specified number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Merges multiple header sources into a single Record.
+ * Handles HeadersInit types: Record, Headers, or [string, string][].
+ */
+export declare function mergeHeaders(...sources: (HeadersInit | undefined)[]): Record<string, string>;
+/**
+ * Options for individual fetch requests.
+ */
+export type FetchOptions = RequestInit;
+/**
+ * A reusable HTTP client with common patterns.
+ */
+export declare class HttpClient {
+    private readonly fetchFn;
+    private readonly defaultHeaders;
+    readonly baseUrl: string;
+    constructor(baseUrl: string, options?: HttpClientOptions);
+    /**
+     * Builds a full URL from a relative path.
+     */
+    url(path: string): string;
+    /**
+     * Makes a fetch request with error handling.
+     */
+    fetch(path: string, options?: FetchOptions): Promise<Response>;
+    /**
+     * Makes a fetch request and throws if the response is not ok.
+     * @remarks
+     * - This does not consume the response body. Callers can still read `.json()`, `.text()`, etc.
+     * - The thrown error message is intentionally stable for tests and debugging:
+     *   `request to <url> failed with status <status>`.
+     */
+    fetchOk(path: string, options?: FetchOptions): Promise<Response>;
+    /**
+     * Makes a GET request and returns JSON.
+     */
+    getJson<T>(path: string, options?: FetchOptions): Promise<T>;
+    /**
+     * Makes a POST request with JSON body and returns the Response (does not parse body).
+     * Use this when you only need to verify the request succeeded.
+     */
+    postOk<T>(path: string, body: T, options?: FetchOptions): Promise<Response>;
+    /**
+     * Makes a POST request with JSON body and returns JSON response.
+     */
+    postJson<T, R = unknown>(path: string, body: T, options?: FetchOptions): Promise<R>;
+    /**
+     * Polls an endpoint until a condition is met or timeout is reached.
+     * @returns The final response that satisfied the condition.
+     * @throws Error if timeout is reached before condition is met.
+     */
+    poll<T>(path: string, options: PollOptions<T>, fetchOptions?: FetchOptions): Promise<T>;
+}
 //# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,IAAI,OAAO,KAAK,CAK1C"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IAChC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,OAAO,KAAK,CAK1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAInF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB5F;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AAEvC;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAM5D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIzB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAexE;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ1E;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE;;;OAGG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IASrF;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK7F;;;;OAIG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,CAAC,CAAC;CAuBd"}

package/dist/utils/http.js

@@ -1,7 +1,165 @@
+/**
+ * HTTP utilities for making requests with common patterns.
+ */
+/**
+ * Ensures fetch is available in the current environment.
+ * @remarks
+ * This returns a thin wrapper around the global `fetch` so the call site has a stable function type.
+ * @throws If `fetch` is not available in the current environment (e.g. older Node.js without polyfill).
+ */
 export function ensureFetch() {
     if (typeof fetch === "undefined") {
         throw new Error("fetch is not available in the current environment");
     }
     return (input, init) => fetch(input, init);
 }
+/**
+ * Normalizes a base URL to ensure it ends with a slash.
+ */
+export function normalizeBaseUrl(url) {
+    return url.endsWith("/") ? url : `${url}/`;
+}
+/**
+ * Builds a full URL from a base URL and a path.
+ */
+export function buildUrl(baseUrl, path) {
+    return new URL(path, normalizeBaseUrl(baseUrl)).toString();
+}
+/**
+ * Wraps a fetch error with context about the request.
+ */
+export function wrapFetchError(url, error, context) {
+    const reason = error instanceof Error ? error.message : String(error);
+    const prefix = context ? `${context}: ` : "";
+    return new Error(`${prefix}request to ${url} failed: ${reason}`);
+}
+/**
+ * Sleeps for the specified number of milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Merges multiple header sources into a single Record.
+ * Handles HeadersInit types: Record, Headers, or [string, string][].
+ */
+export function mergeHeaders(...sources) {
+    const result = {};
+    for (const source of sources) {
+        if (!source)
+            continue;
+        if (source instanceof Headers) {
+            source.forEach((value, key) => {
+                result[key] = value;
+            });
+        }
+        else if (Array.isArray(source)) {
+            for (const [key, value] of source) {
+                result[key] = value;
+            }
+        }
+        else {
+            Object.assign(result, source);
+        }
+    }
+    return result;
+}
+/**
+ * A reusable HTTP client with common patterns.
+ */
+export class HttpClient {
+    fetchFn;
+    defaultHeaders;
+    baseUrl;
+    constructor(baseUrl, options = {}) {
+        this.baseUrl = normalizeBaseUrl(baseUrl);
+        this.fetchFn = options.fetchImpl ?? ensureFetch();
+        this.defaultHeaders = options.defaultHeaders ?? {};
+    }
+    /**
+     * Builds a full URL from a relative path.
+     */
+    url(path) {
+        return buildUrl(this.baseUrl, path);
+    }
+    /**
+     * Makes a fetch request with error handling.
+     */
+    async fetch(path, options = {}) {
+        const url = this.url(path);
+        const { headers: optionHeaders, ...fetchInit } = options;
+        // Merge headers safely
+        const headers = mergeHeaders(this.defaultHeaders, optionHeaders);
+        try {
+            const response = await this.fetchFn(url, { ...fetchInit, headers });
+            return response;
+        }
+        catch (error) {
+            throw wrapFetchError(url, error);
+        }
+    }
+    /**
+     * Makes a fetch request and throws if the response is not ok.
+     * @remarks
+     * - This does not consume the response body. Callers can still read `.json()`, `.text()`, etc.
+     * - The thrown error message is intentionally stable for tests and debugging:
+     *   `request to <url> failed with status <status>`.
+     */
+    async fetchOk(path, options = {}) {
+        const response = await this.fetch(path, options);
+        if (!response.ok) {
+            throw new Error(`request to ${this.url(path)} failed with status ${response.status}`);
+        }
+        return response;
+    }
+    /**
+     * Makes a GET request and returns JSON.
+     */
+    async getJson(path, options = {}) {
+        const response = await this.fetchOk(path, { ...options, method: "GET" });
+        return response.json();
+    }
+    /**
+     * Makes a POST request with JSON body and returns the Response (does not parse body).
+     * Use this when you only need to verify the request succeeded.
+     */
+    async postOk(path, body, options = {}) {
+        return this.fetchOk(path, {
+            ...options,
+            method: "POST",
+            headers: mergeHeaders({ "Content-Type": "application/json" }, options.headers),
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * Makes a POST request with JSON body and returns JSON response.
+     */
+    async postJson(path, body, options = {}) {
+        const response = await this.postOk(path, body, options);
+        return response.json();
+    }
+    /**
+     * Polls an endpoint until a condition is met or timeout is reached.
+     * @returns The final response that satisfied the condition.
+     * @throws Error if timeout is reached before condition is met.
+     */
+    async poll(path, options, fetchOptions = {}) {
+        const { until, intervalMs, timeoutMs, onPoll } = options;
+        const started = Date.now();
+        while (true) {
+            const elapsed = Date.now() - started;
+            if (elapsed > timeoutMs) {
+                throw new Error(`polling ${this.url(path)} timed out after ${timeoutMs}ms`);
+            }
+            const response = await this.getJson(path, fetchOptions);
+            if (onPoll) {
+                onPoll(response, elapsed);
+            }
+            if (until(response)) {
+                return response;
+            }
+            await sleep(intervalMs);
+        }
+    }
+}
 //# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,KAAwB,EAAE,IAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"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"}

package/dist/utils/merkle.d.ts

@@ -1,15 +1,41 @@
 import type { GlobalTeleportProof, IndexedEvent } from "../types.js";
+/**
+ * Merkle proof verification utilities for zERC20 teleport flows.
+ * @remarks
+ * - Hashing uses Poseidon over the BN254 scalar field.
+ * - Inputs that exceed the BN254 field modulus are rejected to avoid invalid circuit assumptions.
+ * - All hex strings are normalized via {@link normalizeHex} before conversion.
+ */
 declare const BN254_FIELD_MODULUS: bigint;
 export declare function computeLeafHash(fromAddressHex: string, toAddressHex: string, value: bigint | number | string): bigint;
+/**
+ * Compute a Merkle root given a leaf value, siblings, and leaf index.
+ * @param params.leaf - Leaf field element value.
+ * @param params.siblings - Sibling field elements as hex strings (bottom-up).
+ * @param params.leafIndex - Leaf index (0-based).
+ * @throws If `leafIndex` is negative or any field element is invalid/out-of-field.
+ */
 export declare function computeMerkleRootFromSiblings(params: {
     leaf: bigint;
     siblings: readonly string[];
     leafIndex: bigint | number;
 }): bigint;
+/**
+ * Verify that the provided global teleport proofs match the expected aggregation root.
+ * @remarks
+ * This verifies:
+ * - `events.length === proofs.length` (pairs correspond by index)
+ * - each `(event, proof)` pair hashes to a Merkle root equal to `aggregationRoot`
+ *
+ * @throws If lengths mismatch, any input is invalid, or a proof does not match the aggregation root.
+ */
 export declare function verifyGlobalTeleportProofs(args: {
     aggregationRoot: string;
     events: readonly IndexedEvent[];
     proofs: readonly GlobalTeleportProof[];
 }): void;
+/**
+ * BN254 scalar field modulus used by Poseidon hashing and field checks.
+ */
 export { BN254_FIELD_MODULUS };
 //# sourceMappingURL=merkle.d.ts.map

package/dist/utils/merkle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merkle.d.ts","sourceRoot":"","sources":["../../src/utils/merkle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrE,QAAA,MAAM,mBAAmB,QAExB,CAAC;AAqEF,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAC9B,MAAM,CAKR;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,GAAG,MAAM,CAkBT;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACxC,GAAG,IAAI,CAyBP;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"merkle.d.ts","sourceRoot":"","sources":["../../src/utils/merkle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrE;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB,QAExB,CAAC;AAqEF,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAC9B,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,GAAG,MAAM,CAkBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACxC,GAAG,IAAI,CAyBP;AAED;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/utils/merkle.js

@@ -1,5 +1,12 @@
 import * as poseidonLite from "poseidon-lite";
 import { normalizeHex, toBigInt } from "./hex.js";
+/**
+ * Merkle proof verification utilities for zERC20 teleport flows.
+ * @remarks
+ * - Hashing uses Poseidon over the BN254 scalar field.
+ * - Inputs that exceed the BN254 field modulus are rejected to avoid invalid circuit assumptions.
+ * - All hex strings are normalized via {@link normalizeHex} before conversion.
+ */
 const BN254_FIELD_MODULUS = BigInt("0x30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47");
 function resolvePoseidon(mod, functionName) {
     const defaultExport = mod.default;
@@ -57,6 +64,13 @@ export function computeLeafHash(fromAddressHex, toAddressHex, value) {
     const valueField = intoField(value, "leaf value");
     return hashTriple(fromField, toField, valueField);
 }
+/**
+ * Compute a Merkle root given a leaf value, siblings, and leaf index.
+ * @param params.leaf - Leaf field element value.
+ * @param params.siblings - Sibling field elements as hex strings (bottom-up).
+ * @param params.leafIndex - Leaf index (0-based).
+ * @throws If `leafIndex` is negative or any field element is invalid/out-of-field.
+ */
 export function computeMerkleRootFromSiblings(params) {
     let state = ensureFieldElement(params.leaf, "leaf");
     let index = toBigInt(params.leafIndex);
@@ -75,6 +89,15 @@ export function computeMerkleRootFromSiblings(params) {
     });
     return state;
 }
+/**
+ * Verify that the provided global teleport proofs match the expected aggregation root.
+ * @remarks
+ * This verifies:
+ * - `events.length === proofs.length` (pairs correspond by index)
+ * - each `(event, proof)` pair hashes to a Merkle root equal to `aggregationRoot`
+ *
+ * @throws If lengths mismatch, any input is invalid, or a proof does not match the aggregation root.
+ */
 export function verifyGlobalTeleportProofs(args) {
     const { aggregationRoot, events, proofs } = args;
     if (events.length !== proofs.length) {
@@ -99,5 +122,8 @@ export function verifyGlobalTeleportProofs(args) {
         }
     }
 }
+/**
+ * BN254 scalar field modulus used by Poseidon hashing and field checks.
+ */
 export { BN254_FIELD_MODULUS };
 //# sourceMappingURL=merkle.js.map

package/dist/utils/merkle.js.map

@@ -1 +1 @@
-{"version":3,"file":"merkle.js","sourceRoot":"","sources":["../../src/utils/merkle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"merkle.js","sourceRoot":"","sources":["../../src/utils/merkle.ts"],"names":[],"mappings":"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"}

package/dist/wasm/__tests__/artifacts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artifacts.test.d.ts.map

package/dist/wasm/__tests__/artifacts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.test.d.ts","sourceRoot":"","sources":["../../../src/wasm/__tests__/artifacts.test.ts"],"names":[],"mappings":""}