zerc20-client-sdk 0.1.15 → 0.2.0

package/dist/registry/loader.js.map

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

package/dist/registry/normalize.d.ts

@@ -1,4 +1,4 @@
-import type { TokensFile, NormalizedTokens } from "./types.js";
+import type { TokensFile, NormalizedTokens, RpcOverrides } from "./types.js";
 /**
  * Normalizes a tokens file by validating and transforming all entries.
  * Handles both camelCase and snake_case field names.
@@ -26,4 +26,16 @@ export declare function asNormalizedTokens(file: TokensFile): NormalizedTokens;
  * Normalizes a tokens file and returns it with the raw data preserved.
  */
 export declare function normalizeTokens(file: TokensFile): NormalizedTokens;
+/**
+ * Normalizes a tokens file with optional RPC URL overrides.
+ *
+ * @remarks
+ * This is a convenience wrapper that:
+ * 1. Clones the input to avoid mutation
+ * 2. Applies RPC URL overrides (matched by token `label`)
+ * 3. Runs full normalization (snake_case → camelCase, address normalization, validation)
+ *
+ * Accepts both camelCase and snake_case input (the underlying `normalizeTokensFile` handles both).
+ */
+export declare function normalizeTokensWithOverrides(file: TokensFile, overrides?: RpcOverrides): NormalizedTokens;
 //# sourceMappingURL=normalize.d.ts.map

package/dist/registry/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/registry/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA8EhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAM5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAOrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAElE"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/registry/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc7E;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA8EhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAM5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAOrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAElE;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,YAAY,GACvB,gBAAgB,CAKlB"}

package/dist/registry/normalize.js

@@ -78,4 +78,47 @@ export function asNormalizedTokens(file) {
 export function normalizeTokens(file) {
     return asNormalizedTokens(file);
 }
+/**
+ * Applies RPC URL overrides to a tokens file **before** normalization.
+ * Matches tokens by `label` and sets both `rpcUrls` and `rpc_urls` so that
+ * either camelCase or snake_case input is handled correctly.
+ */
+function applyRpcOverrides(file, overrides) {
+    if (overrides.tokens && Array.isArray(file.tokens)) {
+        const tokenOverrides = overrides.tokens;
+        file.tokens = file.tokens.map((entry) => {
+            if (entry == null || typeof entry !== "object")
+                return entry;
+            const record = entry;
+            const label = record["label"];
+            if (label && Object.hasOwn(tokenOverrides, label)) {
+                const urls = tokenOverrides[label];
+                return { ...entry, rpcUrls: urls, rpc_urls: urls };
+            }
+            return entry;
+        });
+    }
+    if (overrides.hub && file.hub) {
+        file.hub = { ...file.hub, rpcUrls: overrides.hub, rpc_urls: overrides.hub };
+    }
+    return file;
+}
+/**
+ * Normalizes a tokens file with optional RPC URL overrides.
+ *
+ * @remarks
+ * This is a convenience wrapper that:
+ * 1. Clones the input to avoid mutation
+ * 2. Applies RPC URL overrides (matched by token `label`)
+ * 3. Runs full normalization (snake_case → camelCase, address normalization, validation)
+ *
+ * Accepts both camelCase and snake_case input (the underlying `normalizeTokensFile` handles both).
+ */
+export function normalizeTokensWithOverrides(file, overrides) {
+    if (!overrides)
+        return normalizeTokens(file);
+    const cloned = cloneTokensFile(file);
+    const overridden = applyRpcOverrides(cloned, overrides);
+    return asNormalizedTokens(overridden);
+}
 //# sourceMappingURL=normalize.js.map

package/dist/registry/normalize.js.map

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

package/dist/registry/types.d.ts

@@ -55,7 +55,7 @@ export interface HubEntry {
 /**
  * Raw tokens file structure before normalization.
  * @remarks
- * Callers typically use `normalizeTokens` / `loadTokens` to validate and normalize this structure.
+ * Callers typically use `normalizeTokens` / `TokensCacheManager.load()` to validate and normalize this structure.
  */
 export interface TokensFile {
     hub?: HubEntry;
@@ -69,12 +69,23 @@ export interface NormalizedTokens {
     tokens: TokenEntry[];
     raw: TokensFile;
 }
+/**
+ * RPC URL overrides applied before normalization.
+ * @remarks
+ * Used to replace JSON-bundled RPC URLs with runtime-configured endpoints
+ * (e.g. environment-specific Alchemy/Infura keys).
+ */
+export interface RpcOverrides {
+    /** token label → rpc URLs mapping */
+    tokens?: Record<string, string[]>;
+    /** hub rpc URLs override */
+    hub?: string[];
+}
 /**
  * Options for loading tokens from compressed data.
  */
 export interface LoadTokensOptions {
     cacheKey?: string;
-    cache?: Map<string, Promise<NormalizedTokens>>;
     decoder?: TextDecoder;
     decompress?: (data: Uint8Array) => Uint8Array | ArrayBuffer;
 }

package/dist/registry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,GAAG,WAAW,CAAC;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,GAAG,WAAW,CAAC;CAC7D"}

package/dist/types/__tests__/evm.test.d.ts

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

package/dist/types/__tests__/evm.test.d.ts.map

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

package/dist/types/__tests__/evm.test.js

@@ -0,0 +1,15 @@
+import { describe, expectTypeOf, test } from "vitest";
+describe("EvmReadProvider type compatibility", () => {
+    test("viem PublicClient satisfies EvmReadProvider", () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+describe("EvmWriteProvider type compatibility", () => {
+    test("object with writeContract satisfies EvmWriteProvider", () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    test("WalletClient.writeContract returns Promise<Hex> (runtime compatible)", () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+//# sourceMappingURL=evm.test.js.map

package/dist/types/__tests__/evm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.test.js","sourceRoot":"","sources":["../../../src/types/__tests__/evm.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAItD,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,YAAY,EAAgB,CAAC,aAAa,EAAmB,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAiBhE,YAAY,EAAoB,CAAC,aAAa,EAAoB,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAIhF,YAAY,EAAiB,CAAC,aAAa,EAA0B,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/evm.d.ts

@@ -0,0 +1,95 @@
+/**
+ * EVM provider interfaces for library-agnostic contract interaction.
+ *
+ * @remarks
+ * These interfaces define the minimal surface that SDK public functions require.
+ * viem's `PublicClient` and `WalletClient` satisfy these interfaces structurally
+ * (no wrapper/adapter needed), while users of ethers.js or other libraries can
+ * provide thin adapters.
+ */
+/** Hex-encoded string with `0x` prefix. Identical to viem's `Hex` type. */
+export type Hex = `0x${string}`;
+/**
+ * Read-only EVM provider for contract reads, balance queries, and fee estimation.
+ *
+ * @remarks
+ * viem's `PublicClient` satisfies this interface without any adapter.
+ */
+export interface EvmReadProvider {
+    readContract(args: {
+        address: Hex;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    /** Optional — only required by functions that query native balances (e.g. `fetchLiquidityManagerBalances`). */
+    getBalance?(args: {
+        address: Hex;
+    }): Promise<bigint>;
+    /** Optional — not all providers support EIP-1559 fee estimation. */
+    estimateFeesPerGas?(): Promise<{
+        gasPrice?: bigint | null;
+        maxFeePerGas?: bigint | null;
+        maxPriorityFeePerGas?: bigint | null;
+    }>;
+    /** Optional — legacy gas price fallback. */
+    getGasPrice?(): Promise<bigint>;
+    /** Optional — only required by write flows that need receipt polling. */
+    waitForTransactionReceipt?(args: {
+        hash: Hex;
+    }): Promise<{
+        transactionHash: Hex;
+    }>;
+    /** Optional — required by layerzeroScan codec to decode tx input. */
+    getTransaction?(args: {
+        hash: Hex;
+    }): Promise<{
+        input: Hex;
+        [key: string]: unknown;
+    }>;
+    /** Optional — required by layerzeroScan codec to read tx logs. */
+    getTransactionReceipt?(args: {
+        hash: Hex;
+    }): Promise<{
+        logs: ReadonlyArray<{
+            topics: readonly Hex[];
+            data: Hex;
+        }>;
+        [key: string]: unknown;
+    }>;
+}
+/**
+ * Write provider for signing and submitting EVM transactions.
+ *
+ * @remarks
+ * viem's `WalletClient` (with `publicActions` extension) satisfies this interface.
+ * A plain `WalletClient` without `publicActions` only has `writeContract` but may
+ * lack `readContract` / `waitForTransactionReceipt`; pass a separate `EvmReadProvider`
+ * in that case.
+ */
+export interface EvmWriteProvider {
+    account?: {
+        address: Hex;
+    };
+    chain?: {
+        id: number;
+    };
+    writeContract(args: {
+        address: Hex;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+        account?: Hex | {
+            address: Hex;
+        };
+        chain?: {
+            id: number;
+        };
+        value?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        type?: string;
+    }): Promise<Hex>;
+}
+//# sourceMappingURL=evm.d.ts.map

package/dist/types/evm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/types/evm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,GAAG,CAAC;QACb,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB,+GAA+G;IAC/G,UAAU,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD,oEAAoE;IACpE,kBAAkB,CAAC,IAAI,OAAO,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC,yEAAyE;IACzE,yBAAyB,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,eAAe,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAEnF,qEAAqE;IACrE,cAAc,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAEtF,kEAAkE;IAClE,qBAAqB,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC;QACnD,IAAI,EAAE,aAAa,CAAC;YAAE,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;QAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IAC3B,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvB,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,GAAG,CAAC;QACb,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,GAAG,GAAG;YAAE,OAAO,EAAE,GAAG,CAAA;SAAE,CAAC;QACjC,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAClB"}

package/dist/types/evm.js

@@ -0,0 +1,11 @@
+/**
+ * EVM provider interfaces for library-agnostic contract interaction.
+ *
+ * @remarks
+ * These interfaces define the minimal surface that SDK public functions require.
+ * viem's `PublicClient` and `WalletClient` satisfy these interfaces structurally
+ * (no wrapper/adapter needed), while users of ethers.js or other libraries can
+ * provide thin adapters.
+ */
+export {};
+//# sourceMappingURL=evm.js.map

package/dist/types/evm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.js","sourceRoot":"","sources":["../../src/types/evm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/types.d.ts

@@ -42,9 +42,9 @@ export interface BurnArtifacts {
     generalRecipient: GeneralRecipient;
 }
 /**
- * Preparation output for the private send flow (before submitting the announcement).
+ * Prepared private send (includes derivation and announcement artifacts).
  */
-export interface PrivateSendPreparation {
+export interface PreparedPrivateSend {
     /** Payment advice identifier (hex string). */
     paymentAdviceId: string;
     /** Secret used for burn derivation (hex string). */
@@ -57,27 +57,29 @@ export interface PrivateSendPreparation {
     burnPayload: string;
     /** General recipient derived from the burn payload. */
     generalRecipient: GeneralRecipient;
-}
-/**
- * Artifacts required to submit an encrypted announcement.
- */
-export interface AnnouncementArtifacts {
     /** Announcement payload to submit to the storage canister. */
     announcement: AnnouncementInput;
     /** Session key used for symmetric encryption. */
     sessionKey: Uint8Array;
-}
-/**
- * Prepared private send (includes both derivation and announcement artifacts).
- */
-export interface PreparedPrivateSend extends PrivateSendPreparation, AnnouncementArtifacts {
     /** Payment advice identifier as bytes. */
     paymentAdviceIdBytes: Uint8Array;
 }
 /**
  * Result of private send submission.
  */
-export interface PrivateSendResult extends PrivateSendPreparation {
+export interface PrivateSendResult {
+    /** Payment advice identifier (hex string). */
+    paymentAdviceId: string;
+    /** Secret used for burn derivation (hex string). */
+    secret: string;
+    /** Tweak used for burn derivation (hex string). */
+    tweak: string;
+    /** Burn address derived for the recipient. */
+    burnAddress: string;
+    /** Full burn payload as hex string (used for scanning/decoding). */
+    burnPayload: string;
+    /** General recipient derived from the burn payload. */
+    generalRecipient: GeneralRecipient;
     /** Stored announcement as returned from the canister. */
     announcement: Announcement;
 }

package/dist/types.d.ts.map

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

package/dist/utils/__tests__/fees.test.js

@@ -1,84 +1,121 @@
 import { describe, expect, test, vi } from "vitest";
-import { buildFeeOverrides } from "../fees.js";
+import { buildFeeOverrides, spreadFeeOverrides } from "../fees.js";
+describe("spreadFeeOverrides", () => {
+    test("returns empty object when overrides is undefined", () => {
+        expect(spreadFeeOverrides(undefined)).toEqual({});
+    });
+    test("returns empty object when overrides is not provided", () => {
+        expect(spreadFeeOverrides()).toEqual({});
+    });
+    test("spreads legacy fee overrides", () => {
+        expect(spreadFeeOverrides({ type: "legacy", gasPrice: 42n })).toEqual({
+            gasPrice: 42n,
+            type: "legacy",
+        });
+    });
+    test("spreads EIP-1559 fee overrides", () => {
+        expect(spreadFeeOverrides({ maxFeePerGas: 10n, maxPriorityFeePerGas: 2n })).toEqual({
+            maxFeePerGas: 10n,
+            maxPriorityFeePerGas: 2n,
+        });
+    });
+});
 describe("buildFeeOverrides", () => {
-    test("returns EIP-1559 overrides when estimateFeesPerGas provides both maxFeePerGas and maxPriorityFeePerGas", async () => {
-        const publicClient = {
+    test("returns EIP-1559 overrides when estimateFeesPerGas provides both fields", async () => {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockResolvedValue({
                 maxFeePerGas: 10n,
                 maxPriorityFeePerGas: 2n,
             }),
-            getGasPrice: vi.fn(),
         };
-        await expect(buildFeeOverrides(publicClient)).resolves.toEqual({
+        await expect(buildFeeOverrides(provider)).resolves.toEqual({
             maxFeePerGas: 10n,
             maxPriorityFeePerGas: 2n,
         });
-        expect(publicClient.getGasPrice).not.toHaveBeenCalled();
     });
     test("returns legacy gasPrice when preferLegacy and estimateFeesPerGas provides gasPrice", async () => {
-        const publicClient = {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockResolvedValue({
                 gasPrice: 7n,
                 maxFeePerGas: 10n,
                 maxPriorityFeePerGas: 2n,
             }),
-            getGasPrice: vi.fn(),
         };
-        await expect(buildFeeOverrides(publicClient, { legacyTx: true })).resolves.toEqual({
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toEqual({
             type: "legacy",
             gasPrice: 7n,
         });
-        expect(publicClient.getGasPrice).not.toHaveBeenCalled();
     });
-    test("returns legacy gasPrice when preferLegacy and estimateFeesPerGas provides maxFeePerGas (but no gasPrice)", async () => {
-        const publicClient = {
+    test("falls back to maxFeePerGas as legacy gasPrice when gasPrice is absent", async () => {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockResolvedValue({
                 maxFeePerGas: 9n,
                 maxPriorityFeePerGas: 1n,
             }),
-            getGasPrice: vi.fn(),
         };
-        await expect(buildFeeOverrides(publicClient, { legacyTx: true })).resolves.toEqual({
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toEqual({
             type: "legacy",
             gasPrice: 9n,
         });
-        expect(publicClient.getGasPrice).not.toHaveBeenCalled();
     });
-    test("returns undefined when estimateFeesPerGas lacks required bigint fields for selected mode", async () => {
-        const publicClient = {
+    test("returns undefined when estimateFeesPerGas fields are not bigint", async () => {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockResolvedValue({
                 maxFeePerGas: "10",
                 maxPriorityFeePerGas: 2n,
             }),
-            getGasPrice: vi.fn(),
         };
-        await expect(buildFeeOverrides(publicClient)).resolves.toBeUndefined();
-        expect(publicClient.getGasPrice).not.toHaveBeenCalled();
+        await expect(buildFeeOverrides(provider)).resolves.toBeUndefined();
     });
     test("falls back to getGasPrice for legacy mode when estimateFeesPerGas throws", async () => {
-        const publicClient = {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockRejectedValue(new Error("RPC failed")),
             getGasPrice: vi.fn().mockResolvedValue(42n),
         };
-        await expect(buildFeeOverrides(publicClient, { legacyTx: true })).resolves.toEqual({
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toEqual({
             type: "legacy",
             gasPrice: 42n,
         });
     });
-    test("returns undefined in legacy mode when both estimateFeesPerGas and getGasPrice fail", async () => {
-        const publicClient = {
+    test("returns undefined in legacy mode when both methods fail", async () => {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockRejectedValue(new Error("RPC failed")),
             getGasPrice: vi.fn().mockRejectedValue(new Error("RPC failed")),
         };
-        await expect(buildFeeOverrides(publicClient, { legacyTx: true })).resolves.toBeUndefined();
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toBeUndefined();
     });
-    test("does not call getGasPrice when legacyTx is false, even if estimateFeesPerGas throws", async () => {
-        const publicClient = {
+    test("does not call getGasPrice when legacyTx is false", async () => {
+        const provider = {
+            readContract: vi.fn(),
             estimateFeesPerGas: vi.fn().mockRejectedValue(new Error("RPC failed")),
             getGasPrice: vi.fn(),
         };
-        await expect(buildFeeOverrides(publicClient)).resolves.toBeUndefined();
-        expect(publicClient.getGasPrice).not.toHaveBeenCalled();
+        await expect(buildFeeOverrides(provider)).resolves.toBeUndefined();
+        expect(provider.getGasPrice).not.toHaveBeenCalled();
+    });
+    test("returns undefined when estimateFeesPerGas is not available", async () => {
+        const provider = { readContract: vi.fn() };
+        await expect(buildFeeOverrides(provider)).resolves.toBeUndefined();
+    });
+    test("returns undefined in legacy mode when neither method is available", async () => {
+        const provider = { readContract: vi.fn() };
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toBeUndefined();
+    });
+    test("uses getGasPrice in legacy mode when estimateFeesPerGas is absent", async () => {
+        const provider = {
+            readContract: vi.fn(),
+            getGasPrice: vi.fn().mockResolvedValue(50n),
+        };
+        await expect(buildFeeOverrides(provider, { legacyTx: true })).resolves.toEqual({
+            type: "legacy",
+            gasPrice: 50n,
+        });
     });
 });
 //# sourceMappingURL=fees.test.js.map

package/dist/utils/__tests__/fees.test.js.map

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

package/dist/utils/__tests__/hex.test.js

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
-import { bytesToHex, normalizeHex, hexToBytes, ensureHexLength, addressToBytes, randomBytes, toBigInt, } from "../hex.js";
+import { bytesToHex, normalizeHex, hexToBytes, ensureHexLength, addressToBytes, randomBytes, toBigInt, isHex, keccak256, } from "../hex.js";
 describe("bytesToHex", () => {
     test("converts empty array", () => {
         expect(bytesToHex(new Uint8Array([]))).toBe("0x");
@@ -249,4 +249,67 @@ describe("toBigInt", () => {
         });
     });
 });
+describe("isHex", () => {
+    test("returns true for valid 0x-prefixed hex", () => {
+        expect(isHex("0xabcdef")).toBe(true);
+    });
+    test("returns true for 0x alone", () => {
+        expect(isHex("0x")).toBe(true);
+    });
+    test("returns true for uppercase hex digits", () => {
+        expect(isHex("0xABCDEF")).toBe(true);
+    });
+    test("returns true for mixed case hex digits", () => {
+        expect(isHex("0xaBcDeF")).toBe(true);
+    });
+    test("returns false for 0X prefix", () => {
+        expect(isHex("0Xabcd")).toBe(false);
+    });
+    test("returns false for missing prefix", () => {
+        expect(isHex("abcdef")).toBe(false);
+    });
+    test("returns false for non-hex characters", () => {
+        expect(isHex("0xghij")).toBe(false);
+    });
+    test("returns false for empty string", () => {
+        expect(isHex("")).toBe(false);
+    });
+    test("returns false for null", () => {
+        expect(isHex(null)).toBe(false);
+    });
+    test("returns false for undefined", () => {
+        expect(isHex(undefined)).toBe(false);
+    });
+    test("returns false for number", () => {
+        expect(isHex(123)).toBe(false);
+    });
+    test("returns false for string with spaces", () => {
+        expect(isHex(" 0xabc ")).toBe(false);
+    });
+});
+describe("keccak256", () => {
+    test("hashes a Uint8Array", () => {
+        const result = keccak256(new Uint8Array([0x01, 0x02, 0x03]));
+        expect(result).toMatch(/^0x[0-9a-f]{64}$/);
+    });
+    test("hashes a hex string", () => {
+        const result = keccak256("0x010203");
+        expect(result).toMatch(/^0x[0-9a-f]{64}$/);
+    });
+    test("returns consistent hash for same input", () => {
+        const a = keccak256("0xdeadbeef");
+        const b = keccak256("0xdeadbeef");
+        expect(a).toBe(b);
+    });
+    test("returns different hash for different input", () => {
+        const a = keccak256("0xdeadbeef");
+        const b = keccak256("0xcafebabe");
+        expect(a).not.toBe(b);
+    });
+    test("Uint8Array and hex produce same hash for same bytes", () => {
+        const fromBytes = keccak256(new Uint8Array([0xde, 0xad, 0xbe, 0xef]));
+        const fromHex = keccak256("0xdeadbeef");
+        expect(fromBytes).toBe(fromHex);
+    });
+});
 //# sourceMappingURL=hex.test.js.map