zerc20-client-sdk 0.1.13 → 0.1.14

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

@@ -0,0 +1,224 @@
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { quoteLocalUnwrap, unwrapWithLiquidityManager } from "../unwrap.js";
+// Mock dependencies
+vi.mock("../../../onchain/contracts.js", () => ({
+    getLiquidityManagerContract: vi.fn(),
+    getZerc20Contract: vi.fn(),
+}));
+vi.mock("viem/actions", () => ({
+    waitForTransactionReceipt: vi.fn(),
+}));
+import { getLiquidityManagerContract, getZerc20Contract } from "../../../onchain/contracts.js";
+import { waitForTransactionReceipt } from "viem/actions";
+const mockGetLiquidityManagerContract = vi.mocked(getLiquidityManagerContract);
+const mockGetZerc20Contract = vi.mocked(getZerc20Contract);
+const mockWaitForTransactionReceipt = vi.mocked(waitForTransactionReceipt);
+describe("quoteLocalUnwrap", () => {
+    const mockPublicClient = {};
+    const mockManagerContract = {
+        read: {
+            quoteUnwrapFee: vi.fn(),
+        },
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetLiquidityManagerContract.mockReturnValue(mockManagerContract);
+    });
+    test("returns fee and expected output", async () => {
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(50n);
+        const result = await quoteLocalUnwrap({
+            publicClient: mockPublicClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+        });
+        expect(result.fee).toBe(50n);
+        expect(result.expectedOut).toBe(950n);
+    });
+    test("returns zero expected output when fee exceeds amount", async () => {
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(1500n);
+        const result = await quoteLocalUnwrap({
+            publicClient: mockPublicClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+        });
+        expect(result.fee).toBe(1500n);
+        expect(result.expectedOut).toBe(0n);
+    });
+    test("accepts string amount", async () => {
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(10n);
+        const result = await quoteLocalUnwrap({
+            publicClient: mockPublicClient,
+            liquidityManagerAddress: "0xManager",
+            amount: "100",
+        });
+        expect(result.fee).toBe(10n);
+        expect(result.expectedOut).toBe(90n);
+    });
+    test("accepts number amount", async () => {
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(5n);
+        const result = await quoteLocalUnwrap({
+            publicClient: mockPublicClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 50,
+        });
+        expect(result.fee).toBe(5n);
+        expect(result.expectedOut).toBe(45n);
+    });
+});
+describe("unwrapWithLiquidityManager", () => {
+    const mockWalletClient = {
+        account: { address: "0xAccount1234567890123456789012345678901234" },
+        chain: { id: 1 },
+    };
+    const mockManagerContract = {
+        read: {
+            quoteUnwrapFee: vi.fn(),
+        },
+        write: {
+            unwrap: vi.fn(),
+            unwrapWithMinOut: vi.fn(),
+        },
+    };
+    const mockZerc20Contract = {
+        read: {
+            allowance: vi.fn(),
+        },
+        write: {
+            approve: vi.fn(),
+        },
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetLiquidityManagerContract.mockReturnValue(mockManagerContract);
+        mockGetZerc20Contract.mockReturnValue(mockZerc20Contract);
+        mockZerc20Contract.read.allowance.mockResolvedValue(0n);
+        mockZerc20Contract.write.approve.mockResolvedValue("0xApprovalHash");
+        mockManagerContract.write.unwrap.mockResolvedValue("0xUnwrapHash");
+        mockWaitForTransactionReceipt.mockResolvedValue({ transactionHash: "0xReceiptHash" });
+    });
+    test("unwraps with approval when allowance insufficient", async () => {
+        const result = await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+        expect(result.approvalTransactionHash).toBe("0xReceiptHash");
+        expect(mockZerc20Contract.write.approve).toHaveBeenCalled();
+        expect(mockManagerContract.write.unwrap).toHaveBeenCalled();
+    });
+    test("skips approval when allowance is sufficient", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+        expect(result.approvalTransactionHash).toBeUndefined();
+        expect(mockZerc20Contract.write.approve).not.toHaveBeenCalled();
+    });
+    test("throws for zero amount", async () => {
+        await expect(unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 0n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+    test("throws for negative amount", async () => {
+        await expect(unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: -100n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+    test("uses custom recipient", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        const customRecipient = "0xCustomRecipient123456789012345678901234";
+        await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+            recipient: customRecipient,
+        });
+        expect(mockManagerContract.write.unwrap).toHaveBeenCalledWith([1000n, expect.any(String)], expect.any(Object));
+    });
+    test("accepts string amount", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: "1000",
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+    });
+    test("accepts number amount", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+    });
+    test("calls unwrapWithMinOut when minAmountOut is provided", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(50n);
+        mockManagerContract.write.unwrapWithMinOut.mockResolvedValue("0xUnwrapHash");
+        await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+            minAmountOut: 900n,
+        });
+        expect(mockManagerContract.write.unwrapWithMinOut).toHaveBeenCalledWith([1000n, 900n, expect.any(String)], expect.any(Object));
+        expect(mockManagerContract.write.unwrap).not.toHaveBeenCalled();
+    });
+    test("calls regular unwrap when minAmountOut is zero", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+            minAmountOut: 0n,
+        });
+        expect(mockManagerContract.write.unwrap).toHaveBeenCalled();
+        expect(mockManagerContract.write.unwrapWithMinOut).not.toHaveBeenCalled();
+    });
+    test("throws when expectedOut is below minAmountOut (slippage check)", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        // Fee is 200, so expectedOut = 1000 - 200 = 800
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(200n);
+        await expect(unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+            minAmountOut: 900n, // expectedOut (800) < minAmountOut (900)
+        })).rejects.toThrow("Price changed beyond slippage tolerance");
+    });
+    test("proceeds when expectedOut meets minAmountOut", async () => {
+        mockZerc20Contract.read.allowance.mockResolvedValue(2000n);
+        // Fee is 50, so expectedOut = 1000 - 50 = 950
+        mockManagerContract.read.quoteUnwrapFee.mockResolvedValue(50n);
+        mockManagerContract.write.unwrapWithMinOut.mockResolvedValue("0xUnwrapHash");
+        const result = await unwrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            zerc20TokenAddress: "0xZerc20",
+            amount: 1000n,
+            minAmountOut: 950n, // expectedOut (950) >= minAmountOut (950)
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+    });
+});
+//# sourceMappingURL=unwrap.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,144 @@
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { wrapWithLiquidityManager } from "../wrap.js";
+import { NATIVE_TOKEN_ADDRESS } from "../helpers.js";
+// Mock dependencies
+vi.mock("../../../onchain/contracts.js", () => ({
+    getLiquidityManagerContract: vi.fn(),
+}));
+vi.mock("viem/actions", () => ({
+    waitForTransactionReceipt: vi.fn(),
+}));
+vi.mock("../helpers.js", async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        getErc20Contract: vi.fn(),
+    };
+});
+import { getLiquidityManagerContract } from "../../../onchain/contracts.js";
+import { waitForTransactionReceipt } from "viem/actions";
+import { getErc20Contract } from "../helpers.js";
+const mockGetLiquidityManagerContract = vi.mocked(getLiquidityManagerContract);
+const mockWaitForTransactionReceipt = vi.mocked(waitForTransactionReceipt);
+const mockGetErc20Contract = vi.mocked(getErc20Contract);
+describe("wrapWithLiquidityManager", () => {
+    const mockWalletClient = {
+        account: { address: "0xAccount1234567890123456789012345678901234" },
+        chain: { id: 1 },
+    };
+    const mockManagerContract = {
+        read: {
+            underlyingToken: vi.fn(),
+        },
+        write: {
+            wrap: vi.fn(),
+        },
+    };
+    const mockErc20Contract = {
+        read: {
+            allowance: vi.fn(),
+        },
+        write: {
+            approve: vi.fn(),
+        },
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetLiquidityManagerContract.mockReturnValue(mockManagerContract);
+        mockGetErc20Contract.mockReturnValue(mockErc20Contract);
+        mockManagerContract.read.underlyingToken.mockResolvedValue("0x1234567890123456789012345678901234567890");
+        mockErc20Contract.read.allowance.mockResolvedValue(0n);
+        mockErc20Contract.write.approve.mockResolvedValue("0xApprovalHash");
+        mockManagerContract.write.wrap.mockResolvedValue("0xWrapHash");
+        mockWaitForTransactionReceipt.mockResolvedValue({ transactionHash: "0xReceiptHash" });
+    });
+    test("wraps ERC20 token with approval", async () => {
+        const result = await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+        expect(result.approvalTransactionHash).toBe("0xReceiptHash");
+        expect(mockErc20Contract.write.approve).toHaveBeenCalled();
+        expect(mockManagerContract.write.wrap).toHaveBeenCalled();
+    });
+    test("skips approval when allowance is sufficient", async () => {
+        mockErc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+        expect(result.approvalTransactionHash).toBeUndefined();
+        expect(mockErc20Contract.write.approve).not.toHaveBeenCalled();
+    });
+    test("wraps native token without approval", async () => {
+        mockManagerContract.read.underlyingToken.mockResolvedValue(NATIVE_TOKEN_ADDRESS);
+        const result = await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+        expect(result.approvalTransactionHash).toBeUndefined();
+        expect(mockErc20Contract.write.approve).not.toHaveBeenCalled();
+    });
+    test("throws for zero amount", async () => {
+        await expect(wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 0n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+    test("throws for negative amount", async () => {
+        await expect(wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: -100n,
+        })).rejects.toThrow("amount must be greater than zero");
+    });
+    test("uses provided underlying token address", async () => {
+        const providedUnderlying = "0xProvidedUnderlying12345678901234567890";
+        mockErc20Contract.read.allowance.mockResolvedValue(2000n);
+        await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+            underlyingTokenAddress: providedUnderlying,
+        });
+        // Should not call underlyingToken() when address is provided
+        expect(mockManagerContract.read.underlyingToken).not.toHaveBeenCalled();
+    });
+    test("uses custom recipient", async () => {
+        mockErc20Contract.read.allowance.mockResolvedValue(2000n);
+        const customRecipient = "0xCustomRecipient123456789012345678901234";
+        await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000n,
+            recipient: customRecipient,
+        });
+        expect(mockManagerContract.write.wrap).toHaveBeenCalledWith([1000n, expect.any(String)], expect.any(Object));
+    });
+    test("accepts string amount", async () => {
+        mockErc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: "1000",
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+    });
+    test("accepts number amount", async () => {
+        mockErc20Contract.read.allowance.mockResolvedValue(2000n);
+        const result = await wrapWithLiquidityManager({
+            walletClient: mockWalletClient,
+            liquidityManagerAddress: "0xManager",
+            amount: 1000,
+        });
+        expect(result.transactionHash).toBe("0xReceiptHash");
+    });
+});
+//# sourceMappingURL=wrap.test.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Balance fetching operations for liquidity manager.
+ */
+import type { PublicClient } from "viem";
+import type { LiquidityBalances } from "./types.js";
+/**
+ * Fetch balances/decimals for the underlying token and its corresponding zERC20 for an account.
+ * @remarks
+ * - If the liquidity manager's `underlyingToken` is the native-token sentinel address,
+ *   balance is fetched via `publicClient.getBalance(...)` and decimals are assumed to be 18.
+ * - Otherwise ERC-20 `balanceOf` and `decimals` are read for the underlying token.
+ */
+export declare function fetchLiquidityManagerBalances(params: {
+    publicClient: PublicClient;
+    account: string;
+    liquidityManagerAddress: string;
+    zerc20TokenAddress: string;
+}): Promise<LiquidityBalances>;
+//# sourceMappingURL=balance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../../src/operations/liquidityManager/balance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAKzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyD7B"}

package/dist/operations/liquidityManager/balance.js

@@ -0,0 +1,62 @@
+/**
+ * Balance fetching operations for liquidity manager.
+ */
+import { erc20Abi } from "viem";
+import { getLiquidityManagerContract, getZerc20Contract } from "../../onchain/contracts.js";
+import { isNativeToken, NATIVE_DECIMALS, normalizeAddress } from "./helpers.js";
+/**
+ * Fetch balances/decimals for the underlying token and its corresponding zERC20 for an account.
+ * @remarks
+ * - If the liquidity manager's `underlyingToken` is the native-token sentinel address,
+ *   balance is fetched via `publicClient.getBalance(...)` and decimals are assumed to be 18.
+ * - Otherwise ERC-20 `balanceOf` and `decimals` are read for the underlying token.
+ */
+export async function fetchLiquidityManagerBalances(params) {
+    const { publicClient, account, liquidityManagerAddress, zerc20TokenAddress } = params;
+    const normalizedAccount = normalizeAddress(account);
+    const managerAddress = normalizeAddress(liquidityManagerAddress);
+    const tokenAddress = normalizeAddress(zerc20TokenAddress);
+    const manager = getLiquidityManagerContract(managerAddress, publicClient);
+    const underlyingAddress = normalizeAddress((await manager.read.underlyingToken()));
+    const nativeUnderlying = isNativeToken(underlyingAddress);
+    const zerc20DecimalsPromise = publicClient.readContract({
+        address: tokenAddress,
+        abi: getZerc20Contract(tokenAddress, publicClient).abi,
+        functionName: "decimals",
+    });
+    const underlyingDecimalsPromise = nativeUnderlying
+        ? Promise.resolve(NATIVE_DECIMALS)
+        : publicClient.readContract({
+            address: underlyingAddress,
+            abi: erc20Abi,
+            functionName: "decimals",
+        });
+    const zerc20BalancePromise = publicClient.readContract({
+        address: tokenAddress,
+        abi: getZerc20Contract(tokenAddress, publicClient).abi,
+        functionName: "balanceOf",
+        args: [normalizedAccount],
+    });
+    const underlyingBalancePromise = nativeUnderlying
+        ? publicClient.getBalance({ address: normalizedAccount })
+        : publicClient.readContract({
+            address: underlyingAddress,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [normalizedAccount],
+        });
+    const [zerc20Decimals, underlyingDecimals, underlyingBalance, zerc20Balance] = await Promise.all([
+        zerc20DecimalsPromise,
+        underlyingDecimalsPromise,
+        underlyingBalancePromise,
+        zerc20BalancePromise,
+    ]);
+    return {
+        underlyingAddress,
+        underlyingBalance,
+        underlyingDecimals: Number(underlyingDecimals),
+        zerc20Balance,
+        zerc20Decimals: Number(zerc20Decimals),
+    };
+}
+//# sourceMappingURL=balance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/operations/liquidityManager/balance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,MAKnD;IACC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;IACtF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,2BAA2B,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAE1E,MAAM,iBAAiB,GAAG,gBAAgB,CACxC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,CAAkB,CACxD,CAAC;IACF,MAAM,gBAAgB,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAE1D,MAAM,qBAAqB,GAAG,YAAY,CAAC,YAAY,CAAC;QACtD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,iBAAiB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,GAAG;QACtD,YAAY,EAAE,UAAU;KACzB,CAAoB,CAAC;IAEtB,MAAM,yBAAyB,GAAG,gBAAgB;QAChD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QAClC,CAAC,CAAE,YAAY,CAAC,YAAY,CAAC;YACzB,OAAO,EAAE,iBAAiB;YAC1B,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,UAAU;SACzB,CAAqB,CAAC;IAE3B,MAAM,oBAAoB,GAAG,YAAY,CAAC,YAAY,CAAC;QACrD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,iBAAiB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,GAAG;QACtD,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,iBAAiB,CAAC;KAC1B,CAAoB,CAAC;IAEtB,MAAM,wBAAwB,GAAG,gBAAgB;QAC/C,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;QACzD,CAAC,CAAE,YAAY,CAAC,YAAY,CAAC;YACzB,OAAO,EAAE,iBAAiB;YAC1B,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,iBAAiB,CAAC;SAC1B,CAAqB,CAAC;IAE3B,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/F,qBAAqB;QACrB,yBAAyB;QACzB,wBAAwB;QACxB,oBAAoB;KACrB,CAAC,CAAC;IAEH,OAAO;QACL,iBAAiB;QACjB,iBAAiB;QACjB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC;QAC9C,aAAa;QACb,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;KACvC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * Cross-chain unwrap operations using LayerZero.
+ */
+import type { PublicClient, WalletClient } from "viem";
+import type { TokenEntry } from "../../registry/tokens.js";
+import type { FeeOverrides } from "../../utils/fees.js";
+import type { CrossUnwrapQuote, LiquidityActionResult } from "./types.js";
+/**
+ * Parameters for `buildCrossUnwrapQuote`.
+ */
+export interface CrossUnwrapQuoteParams {
+    /** Source token (zERC20) config on the source chain. */
+    sourceToken: TokenEntry;
+    /** Destination token config on the destination chain (must include adaptor address and eid). */
+    destinationToken: TokenEntry;
+    /** Amount to send/unwrap (bigint-like, in source token local decimals). */
+    amount: bigint | number | string;
+    /** EVM account address initiating the flow (source chain). */
+    account: string;
+    /** Optional public client for source chain reads. */
+    publicClientSource?: PublicClient;
+    /** Optional public client for destination chain reads (adaptor quote). */
+    publicClientDestination?: PublicClient;
+    /**
+     * Slippage tolerance in basis points (e.g. 50 = 0.5%, 300 = 3%).
+     * @remarks Applied to both `SendParam.minAmountLD` and `BridgeRequest.minAmountOut`.
+     */
+    slippageBps?: number;
+}
+/**
+ * Build a cross-chain unwrap quote, including LayerZero options and OFT `send` parameters.
+ * @remarks
+ * - This function performs contract reads on both source and destination chains to compute fees.
+ * - Returned `sendParam` and `bridgeRequest` are safe to pass directly into `sendCrossUnwrap`.
+ * - Slippage is applied and then "dust" is removed so amounts align with shared-decimal precision.
+ * @throws If required token configuration is missing (`eid`, `adaptorAddress`).
+ * @throws If `amount` is not positive or cannot cover required token fees.
+ * @throws If the OFT quote requires LZ token fee payment (unsupported).
+ */
+export declare function buildCrossUnwrapQuote(params: CrossUnwrapQuoteParams): Promise<CrossUnwrapQuote>;
+/**
+ * Apply slippage tolerance to an amount.
+ * @param amount - The original amount
+ * @param slippageBps - Slippage in basis points (e.g. 50 = 0.5%, 300 = 3%)
+ * @returns The minimum acceptable amount after slippage
+ */
+export declare function applySlippage(amount: bigint, slippageBps: number): bigint;
+/**
+ * Parameters for `sendCrossUnwrap`.
+ */
+export interface CrossUnwrapSendParams {
+    /** Wallet client used to sign and submit transactions on the source chain. */
+    walletClient: WalletClient;
+    /** Optional public client for reads and receipt polling. */
+    publicClient?: PublicClient;
+    /** Source token (zERC20) config on the source chain. */
+    sourceToken: TokenEntry;
+    /** Destination token config on the destination chain. */
+    destinationToken: TokenEntry;
+    /** Amount to send/unwrap (bigint-like, in source token local decimals). */
+    amount: bigint | number | string;
+    /** Optional pre-built quote from `buildCrossUnwrapQuote`. If omitted, the quote is built internally. */
+    quote?: CrossUnwrapQuote;
+    /** Optional viem fee overrides (e.g., gas, maxFeePerGas). */
+    feeOverrides?: FeeOverrides;
+}
+/**
+ * Submit the source-chain transaction for cross-chain unwrap (OFT `send(...)`).
+ * @remarks
+ * The required native fee is taken from the quote and sent as `value` with the transaction.
+ */
+export declare function sendCrossUnwrap(params: CrossUnwrapSendParams): Promise<LiquidityActionResult>;
+//# sourceMappingURL=crossUnwrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crossUnwrap.d.ts","sourceRoot":"","sources":["../../../src/operations/liquidityManager/crossUnwrap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAO,MAAM,MAAM,CAAC;AAK5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAiB,gBAAgB,EAAE,qBAAqB,EAAa,MAAM,YAAY,CAAC;AAsFpG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,WAAW,EAAE,UAAU,CAAC;IACxB,gGAAgG;IAChG,gBAAgB,EAAE,UAAU,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,0EAA0E;IAC1E,uBAAuB,CAAC,EAAE,YAAY,CAAC;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAmG3B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,YAAY,EAAE,YAAY,CAAC;IAC3B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wDAAwD;IACxD,WAAW,EAAE,UAAU,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,UAAU,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,wGAAwG;IACxG,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA8BhC"}