@lendasat/lendaswap-sdk-pure 0.2.24 → 0.2.26

package/dist/cctp-inbound/approveAndBurn.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Source-chain USDC approve + burn for the CCTP-inbound flow.
+ *
+ * Handles the full source-chain leg in one call:
+ *   1. Read current allowance via `EvmSigner.call`. If < `amount`,
+ *      send an `approve` and wait for its receipt.
+ *   2. Call `TokenMessenger.depositForBurn(...)` with `mintRecipient`
+ *      and `destinationCaller` both pinned to the caller's
+ *      smart-account address.
+ *   3. Return the tx hashes.
+ *
+ * Takes the SDK's `EvmSigner` so the same signer used for direct
+ * Permit2 swaps (wagmi, Privy, raw key via the `evm/wallet` adapter)
+ * also powers the CCTP flow.
+ */
+import type { Address, Hex } from "viem";
+import type { EvmSigner } from "../evm/wallet.js";
+export interface ApproveAndBurnParams {
+    /** SDK signer bound to the source chain. */
+    signer: EvmSigner;
+    /** USDC amount in smallest units (6 decimals). */
+    amount: bigint;
+    /** USDC contract address on the source chain. */
+    usdcAddress: Address;
+    /** CCTP destination domain id (3 = Arbitrum mainnet). */
+    destinationDomain: number;
+    /**
+     * The address that will both (a) receive the minted USDC on the
+     * destination chain and (b) be the sole caller allowed to submit
+     * `receiveMessage`. For the CCTP-inbound settlement flow this is
+     * the caller's Kernel smart-account address.
+     */
+    smartAccountAddress: Address;
+    /**
+     * Max CCTPv2 fast-transfer fee in USDC units, from the IRIS fee API.
+     * The caller is responsible for fetching this — typical value is
+     * ~1/10000 of the amount.
+     */
+    maxFee: bigint;
+    /**
+     * CCTP finality threshold. Defaults to fast transfer (1000).
+     * Use 2000 for standard (cheaper, ~13 minutes) transfers.
+     */
+    minFinalityThreshold?: number;
+    /**
+     * Override the TokenMessenger contract address. Defaults to the
+     * canonical CCTPv2 deployment shared across all EVM chains.
+     */
+    tokenMessengerAddress?: Address;
+    /**
+     * When `true`, always send `approve` even if existing allowance is
+     * sufficient. Defaults to `false` to avoid unnecessary txs.
+     */
+    forceApprove?: boolean;
+}
+export interface ApproveAndBurnResult {
+    /** Tx hash of the USDC approval; omitted when the existing allowance was sufficient. */
+    approveTxHash?: Hex;
+    /** Tx hash of the `depositForBurn` call. */
+    burnTxHash: Hex;
+}
+/**
+ * Approve USDC to the TokenMessenger (if needed) then burn it for the
+ * cross-chain transfer. Returns the tx hashes. Does NOT wait for the
+ * burn receipt — the caller pairs this with `waitForAttestation`.
+ */
+export declare function approveAndBurn(params: ApproveAndBurnParams): Promise<ApproveAndBurnResult>;
+//# sourceMappingURL=approveAndBurn.d.ts.map

package/dist/cctp-inbound/approveAndBurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approveAndBurn.d.ts","sourceRoot":"","sources":["../../src/cctp-inbound/approveAndBurn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAIzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMlD,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,MAAM,EAAE,SAAS,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,4CAA4C;IAC5C,UAAU,EAAE,GAAG,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAoE/B"}

package/dist/cctp-inbound/approveAndBurn.js

@@ -0,0 +1,95 @@
+/**
+ * Source-chain USDC approve + burn for the CCTP-inbound flow.
+ *
+ * Handles the full source-chain leg in one call:
+ *   1. Read current allowance via `EvmSigner.call`. If < `amount`,
+ *      send an `approve` and wait for its receipt.
+ *   2. Call `TokenMessenger.depositForBurn(...)` with `mintRecipient`
+ *      and `destinationCaller` both pinned to the caller's
+ *      smart-account address.
+ *   3. Return the tx hashes.
+ *
+ * Takes the SDK's `EvmSigner` so the same signer used for direct
+ * Permit2 swaps (wagmi, Privy, raw key via the `evm/wallet` adapter)
+ * also powers the CCTP flow.
+ */
+import { encodeFunctionData, erc20Abi, parseAbi } from "viem";
+import { FINALITY_FAST, TOKEN_MESSENGER_V2 } from "../cctp/constants.js";
+import { addressToBytes32 } from "../cctp/utils.js";
+const TOKEN_MESSENGER_ABI = parseAbi([
+    "function depositForBurn(uint256 amount, uint32 destinationDomain, bytes32 mintRecipient, address burnToken, bytes32 destinationCaller, uint256 maxFee, uint32 minFinalityThreshold) external returns (uint64)",
+]);
+/**
+ * Approve USDC to the TokenMessenger (if needed) then burn it for the
+ * cross-chain transfer. Returns the tx hashes. Does NOT wait for the
+ * burn receipt — the caller pairs this with `waitForAttestation`.
+ */
+export async function approveAndBurn(params) {
+    const { signer, amount, usdcAddress, destinationDomain, smartAccountAddress, maxFee, minFinalityThreshold = FINALITY_FAST, tokenMessengerAddress = TOKEN_MESSENGER_V2, forceApprove = false, } = params;
+    // 1. Allowance check — skip `approve` if the user already granted
+    //    enough USDC to the TokenMessenger. Saves a tx + signature
+    //    prompt on repeat swaps.
+    let approveTxHash;
+    const needsApprove = forceApprove ||
+        !(await hasEnoughAllowance({
+            signer,
+            usdcAddress,
+            spender: tokenMessengerAddress,
+            minAmount: amount,
+        }));
+    if (needsApprove) {
+        approveTxHash = (await signer.sendTransaction({
+            to: usdcAddress,
+            data: encodeFunctionData({
+                abi: erc20Abi,
+                functionName: "approve",
+                args: [tokenMessengerAddress, amount],
+            }),
+        }));
+        // Wait for the approve to mine — otherwise depositForBurn sees a
+        // stale allowance and reverts.
+        const receipt = await signer.waitForReceipt(approveTxHash);
+        if (receipt.status !== "success") {
+            throw new Error(`USDC approve reverted: tx ${approveTxHash}`);
+        }
+    }
+    // 2. Burn. `mintRecipient` and `destinationCaller` both pinned to
+    //    the smart-account address:
+    //      - Destination USDC mints into the smart account (not the EOA).
+    //      - Only that account can call `receiveMessage` on the
+    //        destination chain → blocks front-runners from drawing gas
+    //        from our paymaster via a racing UserOp.
+    const recipientBytes32 = addressToBytes32(smartAccountAddress);
+    const burnTxHash = (await signer.sendTransaction({
+        to: tokenMessengerAddress,
+        data: encodeFunctionData({
+            abi: TOKEN_MESSENGER_ABI,
+            functionName: "depositForBurn",
+            args: [
+                amount,
+                destinationDomain,
+                recipientBytes32,
+                usdcAddress,
+                recipientBytes32,
+                maxFee,
+                minFinalityThreshold,
+            ],
+        }),
+    }));
+    return { approveTxHash, burnTxHash };
+}
+/** ERC-20 `allowance(owner, spender)` read via `EvmSigner.call`. */
+async function hasEnoughAllowance(args) {
+    const { signer, usdcAddress, spender, minAmount } = args;
+    const data = encodeFunctionData({
+        abi: erc20Abi,
+        functionName: "allowance",
+        args: [signer.address, spender],
+    });
+    const result = await signer.call({ to: usdcAddress, data });
+    // `allowance` returns uint256 — 32 bytes, big-endian hex.
+    const hex = result.replace(/^0x/, "") || "0";
+    const current = BigInt(`0x${hex}`);
+    return current >= minAmount;
+}
+//# sourceMappingURL=approveAndBurn.js.map

package/dist/cctp-inbound/approveAndBurn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approveAndBurn.js","sourceRoot":"","sources":["../../src/cctp-inbound/approveAndBurn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACnC,+MAA+M;CAChN,CAAC,CAAC;AAgDH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B;IAE5B,MAAM,EACJ,MAAM,EACN,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,EACN,oBAAoB,GAAG,aAAa,EACpC,qBAAqB,GAAG,kBAA6B,EACrD,YAAY,GAAG,KAAK,GACrB,GAAG,MAAM,CAAC;IAEX,kEAAkE;IAClE,+DAA+D;IAC/D,6BAA6B;IAC7B,IAAI,aAA8B,CAAC;IACnC,MAAM,YAAY,GAChB,YAAY;QACZ,CAAC,CAAC,MAAM,kBAAkB,CAAC;YACzB,MAAM;YACN,WAAW;YACX,OAAO,EAAE,qBAAqB;YAC9B,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC,CAAC;IAEN,IAAI,YAAY,EAAE,CAAC;QACjB,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC;YAC5C,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,kBAAkB,CAAC;gBACvB,GAAG,EAAE,QAAQ;gBACb,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC,qBAAqB,EAAE,MAAM,CAAC;aACtC,CAAC;SACH,CAAC,CAAQ,CAAC;QACX,iEAAiE;QACjE,+BAA+B;QAC/B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,aAAa,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,gCAAgC;IAChC,sEAAsE;IACtE,4DAA4D;IAC5D,mEAAmE;IACnE,iDAAiD;IACjD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,mBAAmB,CAAQ,CAAC;IACtE,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC;QAC/C,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,mBAAmB;YACxB,YAAY,EAAE,gBAAgB;YAC9B,IAAI,EAAE;gBACJ,MAAM;gBACN,iBAAiB;gBACjB,gBAAgB;gBAChB,WAAW;gBACX,gBAAgB;gBAChB,MAAM;gBACN,oBAAoB;aACrB;SACF,CAAC;KACH,CAAC,CAAQ,CAAC;IAEX,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC;AAED,oEAAoE;AACpE,KAAK,UAAU,kBAAkB,CAAC,IAKjC;IACC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACzD,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,MAAM,CAAC,OAAkB,EAAE,OAAO,CAAC;KAC3C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACnC,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC"}

package/dist/cctp-inbound/burn.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Source-chain burn calldata for the CCTP-inbound flow.
+ *
+ * Encodes `TokenMessenger.depositForBurn(...)` on CCTPv2. The user submits
+ * this tx on the source chain (e.g. Optimism, Base); the resulting CCTP
+ * message lets our backend's Multicall3 tx on Arbitrum call
+ * `receiveMessage` to mint USDC to the SDK-derived Arbitrum address.
+ *
+ * Note: we intentionally use the plain `depositForBurn` (no hook), with
+ * `destinationCaller = bytes32(0)` so anyone can call `receiveMessage`.
+ * The HTLC-locking logic lives on the Arbitrum side inside the multicall,
+ * not in a CCTP hook.
+ */
+/** Parameters for `depositForBurn` on CCTPv2 TokenMessenger. */
+export interface DepositForBurnParams {
+    /** USDC amount in smallest units (6 decimals). */
+    amount: bigint;
+    /** CCTP destination domain ID (e.g. 3 = Arbitrum). */
+    destinationDomain: number;
+    /**
+     * Destination address the USDC will be minted to. Accepts either a 20-byte
+     * EVM address (will be left-padded to bytes32) or a pre-padded bytes32 hex.
+     */
+    mintRecipient: string;
+    /** Source-chain USDC contract address. */
+    burnToken: string;
+    /**
+     * Bytes32-encoded address allowed to call `receiveMessage` on destination.
+     * Defaults to `bytes32(0)` — unrestricted, required for our backend-
+     * submitted multicall flow.
+     */
+    destinationCaller?: string;
+    /**
+     * Maximum CCTPv2 fast-transfer fee in USDC units (from IRIS fee API).
+     * Ignored if `minFinalityThreshold` is ≥ standard.
+     */
+    maxFee: bigint;
+    /**
+     * Finality threshold: `FINALITY_FAST` (1000) for fast transfers,
+     * `FINALITY_STANDARD` (2000) for slow. Defaults to fast.
+     */
+    minFinalityThreshold?: number;
+}
+/**
+ * Encodes the `depositForBurn` call data for CCTPv2 TokenMessenger.
+ *
+ * Returns a 0x-prefixed hex string ready to submit as a tx's `data` field
+ * against the source chain's TokenMessenger address.
+ */
+export declare function encodeDepositForBurn(params: DepositForBurnParams): string;
+//# sourceMappingURL=burn.d.ts.map

package/dist/cctp-inbound/burn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn.d.ts","sourceRoot":"","sources":["../../src/cctp-inbound/burn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAyBzE"}

package/dist/cctp-inbound/burn.js

@@ -0,0 +1,66 @@
+/**
+ * Source-chain burn calldata for the CCTP-inbound flow.
+ *
+ * Encodes `TokenMessenger.depositForBurn(...)` on CCTPv2. The user submits
+ * this tx on the source chain (e.g. Optimism, Base); the resulting CCTP
+ * message lets our backend's Multicall3 tx on Arbitrum call
+ * `receiveMessage` to mint USDC to the SDK-derived Arbitrum address.
+ *
+ * Note: we intentionally use the plain `depositForBurn` (no hook), with
+ * `destinationCaller = bytes32(0)` so anyone can call `receiveMessage`.
+ * The HTLC-locking logic lives on the Arbitrum side inside the multicall,
+ * not in a CCTP hook.
+ */
+import { keccak_256 } from "@noble/hashes/sha3.js";
+import { bytesToHex } from "@noble/hashes/utils.js";
+import { FINALITY_FAST } from "../cctp/constants.js";
+import { addressToBytes32 } from "../cctp/utils.js";
+/**
+ * Encodes the `depositForBurn` call data for CCTPv2 TokenMessenger.
+ *
+ * Returns a 0x-prefixed hex string ready to submit as a tx's `data` field
+ * against the source chain's TokenMessenger address.
+ */
+export function encodeDepositForBurn(params) {
+    const destinationCaller = params.destinationCaller ??
+        "0x0000000000000000000000000000000000000000000000000000000000000000";
+    const minFinalityThreshold = params.minFinalityThreshold ?? FINALITY_FAST;
+    // depositForBurn(uint256,uint32,bytes32,address,bytes32,uint256,uint32)
+    const selector = keccak256Hex("depositForBurn(uint256,uint32,bytes32,address,bytes32,uint256,uint32)").slice(0, 10);
+    const mintRecipientBytes32 = ensureBytes32(params.mintRecipient);
+    const destinationCallerBytes32 = ensureBytes32(destinationCaller);
+    const encoded = selector +
+        encodeUint256(params.amount) +
+        encodeUint256(BigInt(params.destinationDomain)) +
+        stripHex(mintRecipientBytes32) +
+        encodeAddress(params.burnToken) +
+        stripHex(destinationCallerBytes32) +
+        encodeUint256(params.maxFee) +
+        encodeUint256(BigInt(minFinalityThreshold));
+    return encoded;
+}
+function ensureBytes32(value) {
+    const clean = value.replace(/^0x/, "");
+    if (clean.length === 64) {
+        return `0x${clean.toLowerCase()}`;
+    }
+    if (clean.length === 40) {
+        return addressToBytes32(value);
+    }
+    throw new Error(`Invalid mintRecipient/destinationCaller: expected 20-byte address or 32-byte hex, got ${clean.length / 2} bytes`);
+}
+function keccak256Hex(input) {
+    return `0x${bytesToHex(keccak_256(new TextEncoder().encode(input)))}`;
+}
+function encodeUint256(value) {
+    if (value < 0n)
+        throw new Error("uint256 cannot be negative");
+    return value.toString(16).padStart(64, "0");
+}
+function encodeAddress(address) {
+    return address.replace(/^0x/, "").toLowerCase().padStart(64, "0");
+}
+function stripHex(value) {
+    return value.replace(/^0x/, "").toLowerCase();
+}
+//# sourceMappingURL=burn.js.map

package/dist/cctp-inbound/burn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn.js","sourceRoot":"","sources":["../../src/cctp-inbound/burn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAiCpD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,MAAM,iBAAiB,GACrB,MAAM,CAAC,iBAAiB;QACxB,oEAAoE,CAAC;IACvE,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,IAAI,aAAa,CAAC;IAE1E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,YAAY,CAC3B,uEAAuE,CACxE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEf,MAAM,oBAAoB,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,wBAAwB,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAElE,MAAM,OAAO,GACX,QAAQ;QACR,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5B,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC/C,QAAQ,CAAC,oBAAoB,CAAC;QAC9B,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC;QAC/B,QAAQ,CAAC,wBAAwB,CAAC;QAClC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5B,aAAa,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,yFAAyF,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAClH,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,UAAU,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,KAAK,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}

package/dist/cctp-inbound/chainMap.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Map EVM chain IDs to CCTPv2 source-chain metadata (domain + USDC
+ * address) for the consuming side of the CCTP-inbound flow.
+ *
+ * Callers pass `signer.chainId`; the SDK derives the CCTP domain +
+ * the source-chain USDC address from that alone, so the public API
+ * doesn't need a redundant "sourceChain" string.
+ */
+import type { Chain, Hex } from "viem";
+import { type CctpChainName } from "../cctp/constants.js";
+/** Canonical EVM chain id → CCTP chain name. */
+export declare const CHAIN_ID_TO_CCTP_NAME: Record<number, CctpChainName>;
+/**
+ * EVM chain ids the Lendaswap backend accepts directly as a swap
+ * source via Permit2 — these chains are also CCTP-supported, but
+ * we never route them through CCTP since a direct-Permit2 funding
+ * is cheaper and faster.
+ */
+export declare const DIRECT_SOURCE_CHAIN_IDS: ReadonlySet<number>;
+/**
+ * `true` when `chainId` is a CCTP-supported source that the backend
+ * does NOT accept directly — i.e. funding a swap from this chain
+ * requires a CCTP hop to Arbitrum before the HTLC is created.
+ */
+export declare function isCctpOnlySource(chainId: number): boolean;
+/**
+ * Look up CCTPv2 domain id + native USDC address for a given chain id.
+ * Throws with a clear error if the chain is unsupported.
+ */
+export declare function cctpMetaForChainId(chainId: number): {
+    name: CctpChainName;
+    domain: number;
+    usdc: Hex;
+};
+/**
+ * Map of CCTP source chain id → viem `Chain` object. Mirrors
+ * [`CHAIN_ID_TO_CCTP_NAME`] — keep them in lockstep when adding chains.
+ *
+ * Exposed so browser consumers (wagmi, viem clients) don't have to maintain
+ * their own parallel mapping; tree-shakable so non-browser consumers don't
+ * pay the bundle cost.
+ */
+export declare const CCTP_VIEM_CHAINS: Record<number, Chain>;
+/** Look up the viem `Chain` for a CCTP source chain id, or `undefined`. */
+export declare function getCctpViemChain(chainId: number): Chain | undefined;
+/** Look up the viem `Chain` for a CCTP source chain name, or `undefined`. */
+export declare function getCctpViemChainByName(name: string): Chain | undefined;
+//# sourceMappingURL=chainMap.d.ts.map

package/dist/cctp-inbound/chainMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainMap.d.ts","sourceRoot":"","sources":["../../src/cctp-inbound/chainMap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAiBvC,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAE9B,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAgB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAItD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;CACX,CAkBA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAelD,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEnE;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAKtE"}

package/dist/cctp-inbound/chainMap.js

@@ -0,0 +1,103 @@
+/**
+ * Map EVM chain IDs to CCTPv2 source-chain metadata (domain + USDC
+ * address) for the consuming side of the CCTP-inbound flow.
+ *
+ * Callers pass `signer.chainId`; the SDK derives the CCTP domain +
+ * the source-chain USDC address from that alone, so the public API
+ * doesn't need a redundant "sourceChain" string.
+ */
+import { arbitrum, avalanche, base, hyperEvm, ink, linea, mainnet, monad, optimism, polygon, sei, sonic, unichain, worldchain, } from "viem/chains";
+import { CCTP_DOMAINS, USDC_ADDRESSES, } from "../cctp/constants.js";
+/** Canonical EVM chain id → CCTP chain name. */
+export const CHAIN_ID_TO_CCTP_NAME = {
+    1: "Ethereum",
+    10: "Optimism",
+    130: "Unichain",
+    137: "Polygon",
+    146: "Sonic",
+    1329: "Sei",
+    8453: "Base",
+    42161: "Arbitrum",
+    43114: "Avalanche",
+    59144: "Linea",
+    480: "World Chain",
+    57073: "Ink",
+    999: "HyperEVM",
+    143: "Monad",
+    // Solana lands later (non-EVM, needs a different signer path).
+};
+/**
+ * EVM chain ids the Lendaswap backend accepts directly as a swap
+ * source via Permit2 — these chains are also CCTP-supported, but
+ * we never route them through CCTP since a direct-Permit2 funding
+ * is cheaper and faster.
+ */
+export const DIRECT_SOURCE_CHAIN_IDS = new Set([
+    1, // Ethereum
+    137, // Polygon
+    42161, // Arbitrum
+]);
+/**
+ * `true` when `chainId` is a CCTP-supported source that the backend
+ * does NOT accept directly — i.e. funding a swap from this chain
+ * requires a CCTP hop to Arbitrum before the HTLC is created.
+ */
+export function isCctpOnlySource(chainId) {
+    return (chainId in CHAIN_ID_TO_CCTP_NAME && !DIRECT_SOURCE_CHAIN_IDS.has(chainId));
+}
+/**
+ * Look up CCTPv2 domain id + native USDC address for a given chain id.
+ * Throws with a clear error if the chain is unsupported.
+ */
+export function cctpMetaForChainId(chainId) {
+    const name = CHAIN_ID_TO_CCTP_NAME[chainId];
+    if (!name) {
+        throw new Error(`Chain id ${chainId} is not a supported CCTP source chain. Supported ids: ${Object.keys(CHAIN_ID_TO_CCTP_NAME).join(", ")}.`);
+    }
+    const usdc = USDC_ADDRESSES[name];
+    if (!usdc) {
+        throw new Error(`CCTP chain ${name} has no native USDC address in the SDK registry.`);
+    }
+    return {
+        name,
+        domain: CCTP_DOMAINS[name],
+        usdc: usdc,
+    };
+}
+/**
+ * Map of CCTP source chain id → viem `Chain` object. Mirrors
+ * [`CHAIN_ID_TO_CCTP_NAME`] — keep them in lockstep when adding chains.
+ *
+ * Exposed so browser consumers (wagmi, viem clients) don't have to maintain
+ * their own parallel mapping; tree-shakable so non-browser consumers don't
+ * pay the bundle cost.
+ */
+export const CCTP_VIEM_CHAINS = {
+    1: mainnet,
+    10: optimism,
+    130: unichain,
+    137: polygon,
+    146: sonic,
+    1329: sei,
+    8453: base,
+    42161: arbitrum,
+    43114: avalanche,
+    59144: linea,
+    480: worldchain,
+    57073: ink,
+    999: hyperEvm,
+    143: monad,
+};
+/** Look up the viem `Chain` for a CCTP source chain id, or `undefined`. */
+export function getCctpViemChain(chainId) {
+    return CCTP_VIEM_CHAINS[chainId];
+}
+/** Look up the viem `Chain` for a CCTP source chain name, or `undefined`. */
+export function getCctpViemChainByName(name) {
+    for (const [chainId, chainName] of Object.entries(CHAIN_ID_TO_CCTP_NAME)) {
+        if (chainName === name)
+            return CCTP_VIEM_CHAINS[Number(chainId)];
+    }
+    return undefined;
+}
+//# sourceMappingURL=chainMap.js.map

package/dist/cctp-inbound/chainMap.js.map

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