zerc20-client-sdk 0.2.0 → 0.2.1

package/README.md

@@ -170,6 +170,42 @@ const quote = await buildCrossUnwrapQuote({
 });
 ```
 
+### Adaptor Withdraw (Stuck Fund Recovery)
+
+When a cross-chain unwrap fails (e.g. due to Stargate liquidity shortage), user funds may remain in the destination chain's Adaptor contract. The SDK provides functions to detect and recover these stuck funds:
+
+```typescript
+import {
+  fetchAdaptorBalances,
+  hasStuckFunds,
+  withdrawFromAdaptor,
+  NATIVE_TOKEN_ADDRESS,
+} from "zerc20-client-sdk";
+
+// Check if a user has stuck funds in an adaptor
+const stuck = await hasStuckFunds({
+  provider: readProvider,
+  account: "0xUser...",
+  adaptorAddress: "0xAdaptor...",
+});
+
+// Fetch detailed balances
+const balances = await fetchAdaptorBalances({
+  provider: readProvider,
+  account: "0xUser...",
+  adaptorAddress: "0xAdaptor...",
+});
+// balances.underlyingTokenBalance, balances.zerc20Balance, balances.nativeBalance
+
+// Withdraw stuck funds
+const result = await withdrawFromAdaptor({
+  writeProvider,
+  adaptorAddress: "0xAdaptor...",
+  token: balances.underlyingTokenAddress, // or zerc20TokenAddress, or NATIVE_TOKEN_ADDRESS
+  amount: balances.underlyingTokenBalance,
+});
+```
+
 ### LayerZero Scan
 
 Track and decode LayerZero cross-chain messages. Configuration and providers are injected as parameters, making this module framework-agnostic:

package/dist/operations/liquidityManager/__tests__/adaptorWithdraw.test.d.ts

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

package/dist/operations/liquidityManager/__tests__/adaptorWithdraw.test.d.ts.map

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

package/dist/operations/liquidityManager/__tests__/adaptorWithdraw.test.js

@@ -0,0 +1,157 @@
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { fetchAdaptorBalances, hasStuckFunds, withdrawFromAdaptor } from "../adaptorWithdraw.js";
+describe("fetchAdaptorBalances", () => {
+    const mockProvider = {
+        readContract: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    test("fetches all adaptor balances for a user", async () => {
+        const underlyingToken = "0x1234567890123456789012345678901234567890";
+        const zerc20Token = "0xabcdef1234567890abcdef1234567890abcdef12";
+        mockProvider.readContract
+            .mockResolvedValueOnce(100n) // underlyingTokenBalances
+            .mockResolvedValueOnce(200n) // zerc20Balances
+            .mockResolvedValueOnce(300n) // nativeBalances
+            .mockResolvedValueOnce(underlyingToken) // UNDERLYING_TOKEN
+            .mockResolvedValueOnce(zerc20Token); // ZERC20_TOKEN
+        const result = await fetchAdaptorBalances({
+            provider: mockProvider,
+            account: "0xUser1234567890123456789012345678901234",
+            adaptorAddress: "0xAdaptor123456789012345678901234567890ab",
+        });
+        expect(result.underlyingTokenBalance).toBe(100n);
+        expect(result.zerc20Balance).toBe(200n);
+        expect(result.nativeBalance).toBe(300n);
+        expect(result.underlyingTokenAddress).toBe(underlyingToken.toLowerCase());
+        expect(result.zerc20TokenAddress).toBe(zerc20Token.toLowerCase());
+    });
+    test("returns zero balances when no funds are stuck", async () => {
+        mockProvider.readContract
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce("0x1234567890123456789012345678901234567890")
+            .mockResolvedValueOnce("0xabcdef1234567890abcdef1234567890abcdef12");
+        const result = await fetchAdaptorBalances({
+            provider: mockProvider,
+            account: "0xUser",
+            adaptorAddress: "0xAdaptor",
+        });
+        expect(result.underlyingTokenBalance).toBe(0n);
+        expect(result.zerc20Balance).toBe(0n);
+        expect(result.nativeBalance).toBe(0n);
+    });
+    test("calls readContract with correct function names", async () => {
+        mockProvider.readContract
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce(0n)
+            .mockResolvedValueOnce("0x1234567890123456789012345678901234567890")
+            .mockResolvedValueOnce("0xabcdef1234567890abcdef1234567890abcdef12");
+        await fetchAdaptorBalances({
+            provider: mockProvider,
+            account: "0xUser1234567890123456789012345678901234",
+            adaptorAddress: "0xAdaptor123456789012345678901234567890ab",
+        });
+        const calls = mockProvider.readContract.mock.calls;
+        const functionNames = calls.map((c) => c[0].functionName);
+        expect(functionNames).toContain("underlyingTokenBalances");
+        expect(functionNames).toContain("zerc20Balances");
+        expect(functionNames).toContain("nativeBalances");
+        expect(functionNames).toContain("UNDERLYING_TOKEN");
+        expect(functionNames).toContain("ZERC20_TOKEN");
+    });
+});
+describe("hasStuckFunds", () => {
+    const mockProvider = {
+        readContract: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    const setupMock = (underlying, zerc20, native) => {
+        mockProvider.readContract
+            .mockResolvedValueOnce(underlying)
+            .mockResolvedValueOnce(zerc20)
+            .mockResolvedValueOnce(native)
+            .mockResolvedValueOnce("0x1234567890123456789012345678901234567890")
+            .mockResolvedValueOnce("0xabcdef1234567890abcdef1234567890abcdef12");
+    };
+    test("returns true when underlying balance is stuck", async () => {
+        setupMock(100n, 0n, 0n);
+        expect(await hasStuckFunds({
+            provider: mockProvider,
+            account: "0xUser",
+            adaptorAddress: "0xAdaptor",
+        })).toBe(true);
+    });
+    test("returns true when zerc20 balance is stuck", async () => {
+        setupMock(0n, 50n, 0n);
+        expect(await hasStuckFunds({
+            provider: mockProvider,
+            account: "0xUser",
+            adaptorAddress: "0xAdaptor",
+        })).toBe(true);
+    });
+    test("returns true when native balance is stuck", async () => {
+        setupMock(0n, 0n, 10n);
+        expect(await hasStuckFunds({
+            provider: mockProvider,
+            account: "0xUser",
+            adaptorAddress: "0xAdaptor",
+        })).toBe(true);
+    });
+    test("returns false when no funds are stuck", async () => {
+        setupMock(0n, 0n, 0n);
+        expect(await hasStuckFunds({
+            provider: mockProvider,
+            account: "0xUser",
+            adaptorAddress: "0xAdaptor",
+        })).toBe(false);
+    });
+});
+describe("withdrawFromAdaptor", () => {
+    const mockWriteProvider = {
+        account: { address: "0xUser1234567890123456789012345678901234" },
+        chain: { id: 1 },
+        writeContract: vi.fn(),
+        waitForTransactionReceipt: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    test("executes withdraw transaction", async () => {
+        const txHash = "0xabc123";
+        mockWriteProvider.writeContract.mockResolvedValue(txHash);
+        mockWriteProvider.waitForTransactionReceipt.mockResolvedValue({ transactionHash: txHash });
+        const result = await withdrawFromAdaptor({
+            writeProvider: mockWriteProvider,
+            adaptorAddress: "0xAdaptor123456789012345678901234567890ab",
+            token: "0xToken1234567890123456789012345678901234",
+            amount: 100n,
+        });
+        expect(result.transactionHash).toBe(txHash);
+        const call = mockWriteProvider.writeContract.mock.calls[0][0];
+        expect(call.functionName).toBe("withdraw");
+        expect(call.args).toEqual(["0x0token1234567890123456789012345678901234", 100n]);
+    });
+    test("throws when amount is zero", async () => {
+        await expect(withdrawFromAdaptor({
+            writeProvider: mockWriteProvider,
+            adaptorAddress: "0xAdaptor",
+            token: "0xToken",
+            amount: 0n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+    test("throws when amount is negative", async () => {
+        await expect(withdrawFromAdaptor({
+            writeProvider: mockWriteProvider,
+            adaptorAddress: "0xAdaptor",
+            token: "0xToken",
+            amount: -1n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+});
+//# sourceMappingURL=adaptorWithdraw.test.js.map

package/dist/operations/liquidityManager/__tests__/adaptorWithdraw.test.js.map

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

package/dist/operations/liquidityManager/adaptorWithdraw.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Adaptor withdraw operations for rescuing stuck funds from failed cross-chain unwraps.
+ */
+import type { EvmReadProvider, EvmWriteProvider } from "../../types/evm.js";
+import { type FeeOverrides } from "../../utils/fees.js";
+/**
+ * Balances stuck in an adaptor contract for a given user.
+ */
+export interface AdaptorBalances {
+    /** Underlying token balance stuck in the adaptor. */
+    underlyingTokenBalance: bigint;
+    /** zERC20 token balance stuck in the adaptor. */
+    zerc20Balance: bigint;
+    /** Native token balance stuck in the adaptor. */
+    nativeBalance: bigint;
+    /** Underlying token address as configured in the adaptor. */
+    underlyingTokenAddress: `0x${string}`;
+    /** zERC20 token address as configured in the adaptor. */
+    zerc20TokenAddress: `0x${string}`;
+}
+/**
+ * Parameters for `withdrawFromAdaptor`.
+ */
+export interface AdaptorWithdrawParams {
+    /** Write provider used to sign and submit transactions. */
+    writeProvider: EvmWriteProvider;
+    /** Optional read provider for receipt polling. */
+    readProvider?: EvmReadProvider;
+    /** Adaptor contract address. */
+    adaptorAddress: string;
+    /** Token address to withdraw (underlying, zERC20, or native sentinel). */
+    token: string;
+    /** Amount to withdraw (bigint-like). */
+    amount: bigint | number | string;
+    /** Optional fee overrides (e.g., gas, maxFeePerGas). */
+    feeOverrides?: FeeOverrides;
+}
+/**
+ * Fetch balances stuck in an adaptor contract for a given user.
+ *
+ * @remarks
+ * When a cross-chain unwrap fails (e.g. due to Stargate liquidity shortage),
+ * user funds remain in the adaptor contract. This function reads those balances
+ * so the UI can prompt the user to withdraw.
+ *
+ * @param params.provider - Provider to use for contract reads.
+ * @param params.account - User address to check balances for.
+ * @param params.adaptorAddress - Adaptor contract address.
+ */
+export declare function fetchAdaptorBalances(params: {
+    provider: EvmReadProvider;
+    account: string;
+    adaptorAddress: string;
+}): Promise<AdaptorBalances>;
+/**
+ * Check whether any funds are stuck in the adaptor for a given user.
+ *
+ * @remarks Convenience wrapper around `fetchAdaptorBalances` that returns `true`
+ * if any balance (underlying, zERC20, or native) is greater than zero.
+ */
+export declare function hasStuckFunds(params: {
+    provider: EvmReadProvider;
+    account: string;
+    adaptorAddress: string;
+}): Promise<boolean>;
+/**
+ * Withdraw stuck funds from an adaptor contract.
+ *
+ * @remarks
+ * Calls the adaptor's `withdraw(token, amount)` function. The token parameter
+ * should be one of:
+ * - The underlying token address (for funds that were unwrapped but failed to bridge)
+ * - The zERC20 token address (for funds that failed before unwrap)
+ * - The native token sentinel `0xEeee...` (for stuck native token)
+ *
+ * @throws If `amount` is not positive.
+ * @returns Transaction hash for the withdraw.
+ */
+export declare function withdrawFromAdaptor(params: AdaptorWithdrawParams): Promise<{
+    transactionHash: string;
+}>;
+//# sourceMappingURL=adaptorWithdraw.d.ts.map

package/dist/operations/liquidityManager/adaptorWithdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorWithdraw.d.ts","sourceRoot":"","sources":["../../../src/operations/liquidityManager/adaptorWithdraw.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAO,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAW5E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,sBAAsB,EAAE,KAAK,MAAM,EAAE,CAAC;IACtC,yDAAyD;IACzD,kBAAkB,EAAE,KAAK,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,aAAa,EAAE,gBAAgB,CAAC;IAChC,kDAAkD;IAClD,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiD3B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBtC"}

package/dist/operations/liquidityManager/adaptorWithdraw.js

@@ -0,0 +1,107 @@
+/**
+ * Adaptor withdraw operations for rescuing stuck funds from failed cross-chain unwraps.
+ */
+import AdaptorArtifact from "../../assets/abi/Adaptor.json" with { type: "json" };
+import { spreadFeeOverrides } from "../../utils/fees.js";
+import { ensureAccount, ensureBigintLike, normalizeAddress, receiptProvider, } from "./helpers.js";
+/**
+ * Fetch balances stuck in an adaptor contract for a given user.
+ *
+ * @remarks
+ * When a cross-chain unwrap fails (e.g. due to Stargate liquidity shortage),
+ * user funds remain in the adaptor contract. This function reads those balances
+ * so the UI can prompt the user to withdraw.
+ *
+ * @param params.provider - Provider to use for contract reads.
+ * @param params.account - User address to check balances for.
+ * @param params.adaptorAddress - Adaptor contract address.
+ */
+export async function fetchAdaptorBalances(params) {
+    const { provider, account, adaptorAddress } = params;
+    const normalizedAccount = normalizeAddress(account);
+    const normalizedAdaptor = normalizeAddress(adaptorAddress);
+    const [underlyingTokenBalance, zerc20Balance, nativeBalance, underlyingTokenAddress, zerc20TokenAddress,] = await Promise.all([
+        provider.readContract({
+            address: normalizedAdaptor,
+            abi: AdaptorArtifact.abi,
+            functionName: "underlyingTokenBalances",
+            args: [normalizedAccount],
+        }),
+        provider.readContract({
+            address: normalizedAdaptor,
+            abi: AdaptorArtifact.abi,
+            functionName: "zerc20Balances",
+            args: [normalizedAccount],
+        }),
+        provider.readContract({
+            address: normalizedAdaptor,
+            abi: AdaptorArtifact.abi,
+            functionName: "nativeBalances",
+            args: [normalizedAccount],
+        }),
+        provider.readContract({
+            address: normalizedAdaptor,
+            abi: AdaptorArtifact.abi,
+            functionName: "UNDERLYING_TOKEN",
+        }),
+        provider.readContract({
+            address: normalizedAdaptor,
+            abi: AdaptorArtifact.abi,
+            functionName: "ZERC20_TOKEN",
+        }),
+    ]);
+    return {
+        underlyingTokenBalance: ensureBigintLike(underlyingTokenBalance, "underlyingTokenBalance"),
+        zerc20Balance: ensureBigintLike(zerc20Balance, "zerc20Balance"),
+        nativeBalance: ensureBigintLike(nativeBalance, "nativeBalance"),
+        underlyingTokenAddress: normalizeAddress(underlyingTokenAddress),
+        zerc20TokenAddress: normalizeAddress(zerc20TokenAddress),
+    };
+}
+/**
+ * Check whether any funds are stuck in the adaptor for a given user.
+ *
+ * @remarks Convenience wrapper around `fetchAdaptorBalances` that returns `true`
+ * if any balance (underlying, zERC20, or native) is greater than zero.
+ */
+export async function hasStuckFunds(params) {
+    const balances = await fetchAdaptorBalances(params);
+    return (balances.underlyingTokenBalance > 0n ||
+        balances.zerc20Balance > 0n ||
+        balances.nativeBalance > 0n);
+}
+/**
+ * Withdraw stuck funds from an adaptor contract.
+ *
+ * @remarks
+ * Calls the adaptor's `withdraw(token, amount)` function. The token parameter
+ * should be one of:
+ * - The underlying token address (for funds that were unwrapped but failed to bridge)
+ * - The zERC20 token address (for funds that failed before unwrap)
+ * - The native token sentinel `0xEeee...` (for stuck native token)
+ *
+ * @throws If `amount` is not positive.
+ * @returns Transaction hash for the withdraw.
+ */
+export async function withdrawFromAdaptor(params) {
+    const { writeProvider, readProvider, adaptorAddress, token, amount, feeOverrides } = params;
+    const normalizedAmount = ensureBigintLike(amount, "amount");
+    if (normalizedAmount <= 0n) {
+        throw new Error("amount must be greater than zero");
+    }
+    const account = ensureAccount(writeProvider);
+    const normalizedAdaptor = normalizeAddress(adaptorAddress);
+    const normalizedToken = normalizeAddress(token);
+    const receipt = receiptProvider(writeProvider, readProvider);
+    const txOverrides = { account, chain: writeProvider.chain, ...spreadFeeOverrides(feeOverrides) };
+    const withdrawHash = await writeProvider.writeContract({
+        address: normalizedAdaptor,
+        abi: AdaptorArtifact.abi,
+        functionName: "withdraw",
+        args: [normalizedToken, normalizedAmount],
+        ...txOverrides,
+    });
+    const withdrawReceipt = await receipt.waitForTransactionReceipt({ hash: withdrawHash });
+    return { transactionHash: withdrawReceipt.transactionHash };
+}
+//# sourceMappingURL=adaptorWithdraw.js.map

package/dist/operations/liquidityManager/adaptorWithdraw.js.map

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

package/dist/operations/liquidityManager/index.d.ts

@@ -9,5 +9,7 @@ export type { LocalUnwrapParams } from "./unwrap.js";
 export { quoteLocalUnwrap, unwrapWithLiquidityManager } from "./unwrap.js";
 export type { CrossUnwrapQuoteParams, CrossUnwrapSendParams } from "./crossUnwrap.js";
 export { applySlippage, buildCrossUnwrapQuote, sendCrossUnwrap } from "./crossUnwrap.js";
-export { removeDust } from "./helpers.js";
+export type { AdaptorBalances, AdaptorWithdrawParams } from "./adaptorWithdraw.js";
+export { fetchAdaptorBalances, hasStuckFunds, withdrawFromAdaptor } from "./adaptorWithdraw.js";
+export { NATIVE_TOKEN_ADDRESS, removeDust } from "./helpers.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/operations/liquidityManager/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/liquidityManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,YAAY,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAG3E,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGzF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/liquidityManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,YAAY,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAG3E,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGzF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhG,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/operations/liquidityManager/index.js

@@ -6,6 +6,7 @@ export { fetchLiquidityManagerBalances } from "./balance.js";
 export { wrapWithLiquidityManager } from "./wrap.js";
 export { quoteLocalUnwrap, unwrapWithLiquidityManager } from "./unwrap.js";
 export { applySlippage, buildCrossUnwrapQuote, sendCrossUnwrap } from "./crossUnwrap.js";
+export { fetchAdaptorBalances, hasStuckFunds, withdrawFromAdaptor } from "./adaptorWithdraw.js";
 // Helpers
-export { removeDust } from "./helpers.js";
+export { NATIVE_TOKEN_ADDRESS, removeDust } from "./helpers.js";
 //# sourceMappingURL=index.js.map

package/dist/operations/liquidityManager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/operations/liquidityManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,qBAAqB;AACrB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAI7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAI3E,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzF,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/operations/liquidityManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,qBAAqB;AACrB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAI7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAI3E,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIzF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhG,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/operations/receive/__tests__/cache.test.js

@@ -124,6 +124,39 @@ describe("AggregationStateCacheManager", () => {
             });
             expect(mockFetchAggregationTreeState).toHaveBeenCalledTimes(2);
         });
+        test("uses different cache keys for different eventBlockSpan values", async () => {
+            const manager = new AggregationStateCacheManager();
+            await manager.fetchWithCache({
+                hub: mockHub,
+                token: mockToken,
+                eventBlockSpan: 1000n,
+                cacheTtlMs: 60000,
+            });
+            await manager.fetchWithCache({
+                hub: mockHub,
+                token: mockToken,
+                eventBlockSpan: 2000n,
+                cacheTtlMs: 60000,
+            });
+            expect(mockFetchAggregationTreeState).toHaveBeenCalledTimes(2);
+            expect(manager.size()).toBe(2);
+        });
+        test("uses different cache keys when eventBlockSpan is present vs absent", async () => {
+            const manager = new AggregationStateCacheManager();
+            await manager.fetchWithCache({
+                hub: mockHub,
+                token: mockToken,
+                cacheTtlMs: 60000,
+            });
+            await manager.fetchWithCache({
+                hub: mockHub,
+                token: mockToken,
+                eventBlockSpan: 1000n,
+                cacheTtlMs: 60000,
+            });
+            expect(mockFetchAggregationTreeState).toHaveBeenCalledTimes(2);
+            expect(manager.size()).toBe(2);
+        });
         test("passes eventBlockSpan to fetchAggregationTreeState", async () => {
             const manager = new AggregationStateCacheManager();
             await manager.fetchWithCache({

package/dist/operations/receive/__tests__/cache.test.js.map

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

package/dist/operations/receive/cache.d.ts

@@ -46,6 +46,6 @@ export declare class AggregationStateCacheManager {
     /**
      * Return true if the cache contains an entry for the given hub and chain.
      */
-    hasEntry(hubAddress: string, chainId: bigint): boolean;
+    hasEntry(hubAddress: string, chainId: bigint, eventBlockSpan?: bigint | number): boolean;
 }
 //# sourceMappingURL=cache.d.ts.map

package/dist/operations/receive/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAa3D,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,GAAG,EAAE,QAAQ,CAAC;IACd,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBxF;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAGvD"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAa3D,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,GAAG,EAAE,QAAQ,CAAC;IACd,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwBxF;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;CAGzF"}

package/dist/operations/receive/cache.js

@@ -5,8 +5,9 @@ import { fetchAggregationTreeState } from "../../wasm/index.js";
 // ============================================================================
 // Internal Utilities
 // ============================================================================
-function getCacheKey(hubAddress, chainId) {
-    return `${hubAddress.toLowerCase()}-${chainId}`;
+function getCacheKey(hubAddress, chainId, eventBlockSpan) {
+    const base = `${hubAddress.toLowerCase()}-${chainId}`;
+    return eventBlockSpan != null ? `${base}-${eventBlockSpan}` : base;
 }
 // ============================================================================
 // AggregationStateCacheManager Class
@@ -22,7 +23,7 @@ export class AggregationStateCacheManager {
      */
     async fetchWithCache(params) {
         const cacheTtl = params.cacheTtlMs;
-        const cacheKey = getCacheKey(params.hub.hubAddress, params.token.chainId);
+        const cacheKey = getCacheKey(params.hub.hubAddress, params.token.chainId, params.eventBlockSpan);
         const cached = this.cache.get(cacheKey);
         const now = Date.now();
         if (cacheTtl != null && cached && now - cached.timestamp < cacheTtl) {
@@ -68,8 +69,8 @@ export class AggregationStateCacheManager {
     /**
      * Return true if the cache contains an entry for the given hub and chain.
      */
-    hasEntry(hubAddress, chainId) {
-        return this.cache.has(getCacheKey(hubAddress, chainId));
+    hasEntry(hubAddress, chainId, eventBlockSpan) {
+        return this.cache.has(getCacheKey(hubAddress, chainId, eventBlockSpan));
     }
 }
 //# sourceMappingURL=cache.js.map

package/dist/operations/receive/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AA0BhE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,SAAS,WAAW,CAAC,UAAkB,EAAE,OAAe;IACtD,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACtB,KAAK,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEnE;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAmC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,KAAK;YACL,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;SAC9B,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAY;QAChB,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAe;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AA0BhE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,SAAS,WAAW,CAClB,UAAkB,EAClB,OAAe,EACf,cAAgC;IAEhC,MAAM,IAAI,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;IACtD,OAAO,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACtB,KAAK,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEnE;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAmC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAC1B,MAAM,CAAC,GAAG,CAAC,UAAU,EACrB,MAAM,CAAC,KAAK,CAAC,OAAO,EACpB,MAAM,CAAC,cAAc,CACtB,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,KAAK;YACL,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;SAC9B,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAY;QAChB,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAe,EAAE,cAAgC;QAC5E,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerc20-client-sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Client SDK for interacting with ZERC20 rollup services from browser or node environments.",
   "type": "module",
   "license": "MIT",