@lendasat/lendaswap-sdk-pure 0.2.24 → 0.2.25

package/dist/arkade-network.d.ts

@@ -0,0 +1,8 @@
+import { type NetworkName } from "@arkade-os/sdk";
+/** Default Arkade server URL by network */
+export declare const DEFAULT_ARKADE_URLS: Record<string, string>;
+export declare function getNetworkName(network: string): NetworkName;
+export declare function getNetworkHrp(networkName: NetworkName): string;
+export declare function resolveArkadeServerUrl(network: string, arkadeServerUrl?: string): string;
+export declare function resolveArkadeServerUrlByName(networkName: NetworkName, arkadeServerUrl?: string): string;
+//# sourceMappingURL=arkade-network.d.ts.map

package/dist/arkade-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-network.d.ts","sourceRoot":"","sources":["../src/arkade-network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,gBAAgB,CAAC;AAE5D,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKtD,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAgB3D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAGR;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,WAAW,EACxB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAQR"}

package/dist/arkade-network.js

@@ -0,0 +1,40 @@
+import { networks } from "@arkade-os/sdk";
+/** Default Arkade server URL by network */
+export const DEFAULT_ARKADE_URLS = {
+    bitcoin: "https://arkade.computer",
+    mainnet: "https://arkade.computer",
+    signet: "https://mutinynet.arkade.sh",
+    mutinynet: "https://mutinynet.arkade.sh",
+};
+export function getNetworkName(network) {
+    switch (network.toLowerCase()) {
+        case "mainnet":
+        case "bitcoin":
+            return "bitcoin";
+        case "testnet":
+            return "testnet";
+        case "signet":
+            return "signet";
+        case "mutinynet":
+            return "mutinynet";
+        case "regtest":
+            return "regtest";
+        default:
+            throw new Error(`Unknown network: ${network}`);
+    }
+}
+export function getNetworkHrp(networkName) {
+    return networks[networkName].hrp;
+}
+export function resolveArkadeServerUrl(network, arkadeServerUrl) {
+    const networkName = getNetworkName(network);
+    return resolveArkadeServerUrlByName(networkName, arkadeServerUrl);
+}
+export function resolveArkadeServerUrlByName(networkName, arkadeServerUrl) {
+    const serverUrl = arkadeServerUrl ?? DEFAULT_ARKADE_URLS[networkName];
+    if (!serverUrl) {
+        throw new Error(`No Arkade server URL configured for network: ${networkName}`);
+    }
+    return serverUrl;
+}
+//# sourceMappingURL=arkade-network.js.map

package/dist/arkade-network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-network.js","sourceRoot":"","sources":["../src/arkade-network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,OAAO,EAAE,yBAAyB;IAClC,OAAO,EAAE,yBAAyB;IAClC,MAAM,EAAE,6BAA6B;IACrC,SAAS,EAAE,6BAA6B;CACzC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,QAAQ,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9B,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,eAAwB;IAExB,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,4BAA4B,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,WAAwB,EACxB,eAAwB;IAExB,MAAM,SAAS,GAAG,eAAe,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,gDAAgD,WAAW,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/arkade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arkade.d.ts","sourceRoot":"","sources":["../src/arkade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,WAAW,GACX,aAAa,GACb,OAAO,GACP,OAAO,CAAC;AAEZ,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAyDvB"}
+{"version":3,"file":"arkade.d.ts","sourceRoot":"","sources":["../src/arkade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,WAAW,GACX,aAAa,GACb,OAAO,GACP,OAAO,CAAC;AAEZ,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAsDvB"}

package/dist/arkade.js

@@ -5,11 +5,7 @@
  */
 import { ArkAddress, RestIndexerProvider, } from "@arkade-os/sdk";
 import { hex } from "@scure/base";
-/** Default Arkade server URLs by network */
-const DEFAULT_ARKADE_URLS = {
-    bitcoin: "https://arkade.computer",
-    signet: "https://signet.arkade.computer",
-};
+import { resolveArkadeServerUrl } from "./arkade-network.js";
 /**
  * Queries the Arkade indexer for spendable, spent, and recoverable balances
  * at a VHTLC address.
@@ -23,10 +19,7 @@ export async function getVhtlcAmounts(params) {
     const decoded = ArkAddress.decode(vhtlcAddress);
     const pkScript = hex.encode(decoded.pkScript);
     // Determine Arkade server URL: explicit override > network default
-    const serverUrl = arkadeServerUrl ?? DEFAULT_ARKADE_URLS[network];
-    if (!serverUrl) {
-        throw new Error(`Unknown network for Arkade: ${network}`);
-    }
+    const serverUrl = resolveArkadeServerUrl(network, arkadeServerUrl);
     const indexerProvider = new RestIndexerProvider(serverUrl);
     // Query each category separately
     const [spendableResult, spentResult, recoverableResult] = await Promise.all([

package/dist/arkade.js.map

@@ -1 +1 @@
-{"version":3,"file":"arkade.js","sourceRoot":"","sources":["../src/arkade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arkade.js","sourceRoot":"","sources":["../src/arkade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EAEV,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAgC7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA6B;IAE7B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAE1D,oEAAoE;IACpE,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9C,mEAAmE;IACnE,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAEnE,MAAM,eAAe,GAAoB,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAE5E,iCAAiC;IACjC,MAAM,CAAC,eAAe,EAAE,WAAW,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1E,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACtE,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAClE,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,CAAC,KAA0B,EAAE,EAAE,CACzC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7C,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,uDAAuD;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC;QAC5C,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5B,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;IAEpE,MAAM,UAAU,GACd,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC;QACjD,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,SAAS,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC;YAChC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,SAAS,GAAG,CAAC;gBACb,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,WAAW,GAAG,CAAC;oBACf,CAAC,CAAC,aAAa;oBACf,CAAC,CAAC,OAAO,CAAC;IAEpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACvD,CAAC"}

package/dist/cctp/fee.d.ts

@@ -0,0 +1,49 @@
+/** Fee tiers returned by the IRIS API (low/med/high gas estimates for the forwarder). */
+export interface IrisForwardFeeTiers {
+    low: number;
+    med: number;
+    high: number;
+}
+/** Raw entry from `GET /v2/burn/USDC/fees/{sourceDomain}/{destDomain}`. */
+export interface IrisFeeEntry {
+    finalityThreshold: number;
+    /** CCTPv2 fast-transfer fee in basis points (e.g. `1.3` = 0.013%). */
+    minimumFee: number;
+    /** Forward-service relayer fees (absolute USDC smallest-units). */
+    forwardFee: IrisForwardFeeTiers;
+}
+export interface FetchCctpFeeOptions {
+    /** CCTP source domain ID (e.g. 2 = Optimism, 6 = Base). */
+    sourceDomain: number;
+    /** CCTP destination domain ID (3 = Arbitrum). */
+    destinationDomain: number;
+    /** Finality threshold to query — defaults to `FINALITY_FAST` (1000). */
+    finalityThreshold?: number;
+    /** IRIS API base URL. Defaults to mainnet. */
+    irisApiUrl?: string;
+    /** Optional abort signal. */
+    signal?: AbortSignal;
+}
+/**
+ * Fetch the fee entry for the given source → destination pair and
+ * finality threshold. Returns the raw IRIS shape — callers that want
+ * an applied maxFee should pass this to {@link computeCctpFastFee}.
+ */
+export declare function fetchCctpFee(options: FetchCctpFeeOptions): Promise<IrisFeeEntry>;
+/**
+ * Cached variant of {@link fetchCctpFee}. Multiple callers within a
+ * 60-second window share a single IRIS round-trip per source→dest pair.
+ */
+export declare function getCachedCctpFee(options: FetchCctpFeeOptions): Promise<IrisFeeEntry>;
+/**
+ * Apply IRIS's `minimumFee` (basis points) to an amount in USDC smallest
+ * units, matching the Rust backend's formula:
+ *   protocolFee = amount × round(minimumFee × 100) ÷ 1_000_000
+ *
+ * Adds a conservative 20% buffer to absorb rounding drift between quote
+ * time and burn time. Return value is the fee in USDC smallest units,
+ * suitable for `maxFee` in `depositForBurn` and as the subtracted amount
+ * when sizing the Permit2 permit.
+ */
+export declare function computeCctpFastFee(entry: IrisFeeEntry, amountUsdcUnits: bigint): bigint;
+//# sourceMappingURL=fee.d.ts.map

package/dist/cctp/fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/cctp/fee.ts"],"names":[],"mappings":"AAaA,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA0BvB;AAUD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAevB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,GACtB,MAAM,CAIR"}

package/dist/cctp/fee.js

@@ -0,0 +1,70 @@
+/**
+ * CCTP v2 fast-transfer fee query against Circle's IRIS API.
+ *
+ * The fast-transfer fee (`minimumFee`, in basis points × 100) is deducted
+ * from the minted amount on the destination chain whenever the burn's
+ * `minFinalityThreshold ≤ 1000`. We need to query it to know precisely
+ * how much USDC will arrive so the Permit2 signature pulls the right
+ * amount and the Multicall doesn't underflow.
+ *
+ * Mirrors the Rust backend's `swap/src/cctp.rs::compute_max_fee`.
+ */
+import { FINALITY_FAST, IRIS_API_MAINNET } from "./constants.js";
+/**
+ * Fetch the fee entry for the given source → destination pair and
+ * finality threshold. Returns the raw IRIS shape — callers that want
+ * an applied maxFee should pass this to {@link computeCctpFastFee}.
+ */
+export async function fetchCctpFee(options) {
+    const { sourceDomain, destinationDomain, finalityThreshold = FINALITY_FAST, irisApiUrl = IRIS_API_MAINNET, signal, } = options;
+    const url = `${irisApiUrl}/v2/burn/USDC/fees/${sourceDomain}/${destinationDomain}?forward=true`;
+    const response = await fetch(url, { signal });
+    if (!response.ok) {
+        throw new Error(`IRIS fee lookup failed: ${response.status} ${response.statusText}`);
+    }
+    const entries = (await response.json());
+    const entry = entries.find((e) => e.finalityThreshold === finalityThreshold) ??
+        entries[0];
+    if (!entry) {
+        throw new Error(`IRIS returned no fee entries for ${sourceDomain}→${destinationDomain}`);
+    }
+    return entry;
+}
+/**
+ * Tiny TTL cache for CCTP fee lookups. The IRIS fee is effectively
+ * constant per-pair minute-to-minute — re-fetching on every quote
+ * keystroke would bomb IRIS for no gain. 60s TTL is ample.
+ */
+const feeCache = new Map();
+const FEE_CACHE_TTL_MS = 60_000;
+/**
+ * Cached variant of {@link fetchCctpFee}. Multiple callers within a
+ * 60-second window share a single IRIS round-trip per source→dest pair.
+ */
+export async function getCachedCctpFee(options) {
+    const { sourceDomain, destinationDomain, finalityThreshold = FINALITY_FAST, irisApiUrl = IRIS_API_MAINNET, } = options;
+    const key = `${sourceDomain}-${destinationDomain}-${finalityThreshold}-${irisApiUrl}`;
+    const cached = feeCache.get(key);
+    if (cached && cached.expiresAt > Date.now()) {
+        return cached.entry;
+    }
+    const entry = await fetchCctpFee(options);
+    feeCache.set(key, { entry, expiresAt: Date.now() + FEE_CACHE_TTL_MS });
+    return entry;
+}
+/**
+ * Apply IRIS's `minimumFee` (basis points) to an amount in USDC smallest
+ * units, matching the Rust backend's formula:
+ *   protocolFee = amount × round(minimumFee × 100) ÷ 1_000_000
+ *
+ * Adds a conservative 20% buffer to absorb rounding drift between quote
+ * time and burn time. Return value is the fee in USDC smallest units,
+ * suitable for `maxFee` in `depositForBurn` and as the subtracted amount
+ * when sizing the Permit2 permit.
+ */
+export function computeCctpFastFee(entry, amountUsdcUnits) {
+    const bpsScaled = Math.round(entry.minimumFee * 100);
+    const protocolFee = (amountUsdcUnits * BigInt(bpsScaled)) / 1000000n;
+    return (protocolFee * 120n) / 100n;
+}
+//# sourceMappingURL=fee.js.map

package/dist/cctp/fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../src/cctp/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA+BjE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,EACJ,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAAG,aAAa,EACjC,UAAU,GAAG,gBAAgB,EAC7B,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,GAAG,UAAU,sBAAsB,YAAY,IAAI,iBAAiB,eAAe,CAAC;IAChG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,2BAA2B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;IAC1D,MAAM,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,iBAAiB,CAAC;QAC9D,OAAO,CAAC,CAAC,CAAC,CAAC;IACb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,oCAAoC,YAAY,IAAI,iBAAiB,EAAE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsD,CAAC;AAC/E,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA4B;IAE5B,MAAM,EACJ,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAAG,aAAa,EACjC,UAAU,GAAG,gBAAgB,GAC9B,GAAG,OAAO,CAAC;IACZ,MAAM,GAAG,GAAG,GAAG,YAAY,IAAI,iBAAiB,IAAI,iBAAiB,IAAI,UAAU,EAAE,CAAC;IACtF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,eAAuB;IAEvB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,QAAU,CAAC;IACvE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC"}

package/dist/cctp/index.d.ts

@@ -8,6 +8,7 @@
  */
 export { type AttestationResult, type FetchAttestationOptions, fetchAttestation, type TrackCctpMessageOptions, trackCctpMessage, } from "./attestation.js";
 export { CCTP_DOMAINS, type CctpChainName, EURC_ADDRESSES, FINALITY_FAST, FINALITY_STANDARD, FORWARDING_FEE_ETHEREUM, FORWARDING_FEE_OTHER, FORWARDING_SERVICE_HOOK_DATA, IRIS_API_MAINNET, IRIS_API_TESTNET, MESSAGE_TRANSMITTER_ADDRESSES, MESSAGE_TRANSMITTER_V2, TOKEN_MESSENGER_ADDRESSES, TOKEN_MESSENGER_V2, USAT_ADDRESSES, USDC_ADDRESSES, } from "./constants.js";
+export { computeCctpFastFee, type FetchCctpFeeOptions, fetchCctpFee, getCachedCctpFee, type IrisFeeEntry, type IrisForwardFeeTiers, } from "./fee.js";
 export type { AttestationResponse, AttestationStatus, BridgeParams, BurnResult, CctpMessageResult, CctpMessageStatus, MintResult, } from "./types.js";
 export { addressToBytes32, bytes32ToAddress, getDomain, needsBridge, } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cctp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cctp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cctp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,YAAY,EACZ,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/cctp/index.js

@@ -8,5 +8,6 @@
  */
 export { fetchAttestation, trackCctpMessage, } from "./attestation.js";
 export { CCTP_DOMAINS, EURC_ADDRESSES, FINALITY_FAST, FINALITY_STANDARD, FORWARDING_FEE_ETHEREUM, FORWARDING_FEE_OTHER, FORWARDING_SERVICE_HOOK_DATA, IRIS_API_MAINNET, IRIS_API_TESTNET, MESSAGE_TRANSMITTER_ADDRESSES, MESSAGE_TRANSMITTER_V2, TOKEN_MESSENGER_ADDRESSES, TOKEN_MESSENGER_V2, USAT_ADDRESSES, USDC_ADDRESSES, } from "./constants.js";
+export { computeCctpFastFee, fetchCctpFee, getCachedCctpFee, } from "./fee.js";
 export { addressToBytes32, bytes32ToAddress, getDomain, needsBridge, } from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/cctp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cctp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,gBAAgB,EAEhB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EAEZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAYxB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cctp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,gBAAgB,EAEhB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EAEZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAElB,YAAY,EACZ,gBAAgB,GAGjB,MAAM,UAAU,CAAC;AAWlB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/cctp-bridge/bridge.d.ts

@@ -0,0 +1,62 @@
+import { type BridgeChainIdentifier, type BridgeConfig, type BridgeParams, type BridgeResult, type EstimateResult } from "@circle-fin/bridge-kit";
+type BridgeKitAdapter = BridgeParams["from"]["adapter"];
+type BridgeEventPayload = any;
+export interface BridgeUsdcParams {
+    /** Source chain + pre-built bridge-kit adapter. */
+    source: {
+        adapter: BridgeKitAdapter;
+        chain: BridgeChainIdentifier;
+        /** Required when the adapter is developer-controlled. */
+        address?: string;
+    };
+    /**
+     * Destination. Adapter may be the same instance as `source.adapter` if the
+     * user holds the same key on both chains (the common case).
+     */
+    destination: {
+        adapter: BridgeKitAdapter;
+        chain: BridgeChainIdentifier;
+        /** Required when the adapter is developer-controlled. */
+        address?: string;
+        /** Send to a different EVM address than the adapter's own. */
+        recipientAddress?: string;
+    };
+    /** Human-readable USDC amount, e.g. "10.50". */
+    amount: string;
+    config?: BridgeConfig;
+    /** Subscribe to all bridge-kit lifecycle events (approve/burn/attest/mint). */
+    onEvent?: (event: BridgeEventPayload) => void;
+    /** Subscribe to a single lifecycle event. */
+    onApprove?: (event: BridgeEventPayload) => void;
+    onBurn?: (event: BridgeEventPayload) => void;
+    onAttestation?: (event: BridgeEventPayload) => void;
+    onMint?: (event: BridgeEventPayload) => void;
+}
+/**
+ * Bridge USDC cross-chain via Circle CCTPv2.
+ *
+ * Runs the full approve → burn → attest → mint flow in one call. Returns a
+ * `BridgeResult` whose `state` is `'success'` or `'error'`; inspect `steps`
+ * for per-action details. Recoverable failures can be resumed with
+ * `BridgeKit.retry()` — see bridge-kit's retry guide.
+ */
+export declare function bridgeUsdc(params: BridgeUsdcParams): Promise<BridgeResult>;
+/**
+ * Bridge USDC from any CCTPv2-supported chain into Arbitrum.
+ *
+ * Convenience for the common Lendaswap flow: land USDC on Arbitrum so the
+ * existing Arbitrum USDC → BTC HTLC swap can run against it.
+ */
+export declare function bridgeUsdcToArbitrum(params: Omit<BridgeUsdcParams, "destination"> & {
+    destination: Omit<BridgeUsdcParams["destination"], "chain"> & {
+        chain?: BridgeChainIdentifier;
+    };
+}): Promise<BridgeResult>;
+/**
+ * Estimate CCTPv2 bridge costs (protocol fee + gas on source and destination)
+ * without executing anything. Requires an adapter on both sides because gas
+ * estimation depends on the specific wallet/account.
+ */
+export declare function estimateUsdcBridgeFees(params: Omit<BridgeUsdcParams, "onEvent" | "onApprove" | "onBurn" | "onAttestation" | "onMint">): Promise<EstimateResult>;
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/cctp-bridge/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/cctp-bridge/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;AAGxD,KAAK,kBAAkB,GAAG,GAAG,CAAC;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,MAAM,EAAE;QACN,OAAO,EAAE,gBAAgB,CAAC;QAC1B,KAAK,EAAE,qBAAqB,CAAC;QAC7B,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;OAGG;IACH,WAAW,EAAE;QACX,OAAO,EAAE,gBAAgB,CAAC;QAC1B,KAAK,EAAE,qBAAqB,CAAC;QAC7B,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8DAA8D;QAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,6CAA6C;IAC7C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,GAAG;IAC9C,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,GAAG;QAC5D,KAAK,CAAC,EAAE,qBAAqB,CAAC;KAC/B,CAAC;CACH,GACA,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CACV,gBAAgB,EAChB,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,GAAG,QAAQ,CAChE,GACA,OAAO,CAAC,cAAc,CAAC,CAGzB"}

package/dist/cctp-bridge/bridge.js

@@ -0,0 +1,74 @@
+import { BridgeChain, BridgeKit, } from "@circle-fin/bridge-kit";
+/**
+ * Bridge USDC cross-chain via Circle CCTPv2.
+ *
+ * Runs the full approve → burn → attest → mint flow in one call. Returns a
+ * `BridgeResult` whose `state` is `'success'` or `'error'`; inspect `steps`
+ * for per-action details. Recoverable failures can be resumed with
+ * `BridgeKit.retry()` — see bridge-kit's retry guide.
+ */
+export async function bridgeUsdc(params) {
+    const kit = new BridgeKit();
+    attachListeners(kit, params);
+    return kit.bridge(buildBridgeParams(params));
+}
+/**
+ * Bridge USDC from any CCTPv2-supported chain into Arbitrum.
+ *
+ * Convenience for the common Lendaswap flow: land USDC on Arbitrum so the
+ * existing Arbitrum USDC → BTC HTLC swap can run against it.
+ */
+export async function bridgeUsdcToArbitrum(params) {
+    return bridgeUsdc({
+        ...params,
+        destination: {
+            ...params.destination,
+            chain: params.destination.chain ?? BridgeChain.Arbitrum,
+        },
+    });
+}
+/**
+ * Estimate CCTPv2 bridge costs (protocol fee + gas on source and destination)
+ * without executing anything. Requires an adapter on both sides because gas
+ * estimation depends on the specific wallet/account.
+ */
+export async function estimateUsdcBridgeFees(params) {
+    const kit = new BridgeKit();
+    return kit.estimate(buildBridgeParams(params));
+}
+function buildBridgeParams(params) {
+    const from = {
+        adapter: params.source.adapter,
+        chain: params.source.chain,
+        ...(params.source.address ? { address: params.source.address } : {}),
+    };
+    const to = {
+        adapter: params.destination.adapter,
+        chain: params.destination.chain,
+        ...(params.destination.address
+            ? { address: params.destination.address }
+            : {}),
+        ...(params.destination.recipientAddress
+            ? { recipientAddress: params.destination.recipientAddress }
+            : {}),
+    };
+    return {
+        from,
+        to,
+        amount: params.amount,
+        ...(params.config ? { config: params.config } : {}),
+    };
+}
+function attachListeners(kit, params) {
+    if (params.onEvent)
+        kit.on("*", params.onEvent);
+    if (params.onApprove)
+        kit.on("approve", params.onApprove);
+    if (params.onBurn)
+        kit.on("burn", params.onBurn);
+    if (params.onAttestation)
+        kit.on("fetchAttestation", params.onAttestation);
+    if (params.onMint)
+        kit.on("mint", params.onMint);
+}
+//# sourceMappingURL=bridge.js.map

package/dist/cctp-bridge/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/cctp-bridge/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAGX,SAAS,GAIV,MAAM,wBAAwB,CAAC;AAuChC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;IAC5B,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAIC;IAED,OAAO,UAAU,CAAC;QAChB,GAAG,MAAM;QACT,WAAW,EAAE;YACX,GAAG,MAAM,CAAC,WAAW;YACrB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,QAAQ;SACxD;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAGC;IAED,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;IAC5B,OAAO,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwB;IACjD,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;QAC1B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;IAE1B,MAAM,EAAE,GAAG;QACT,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO;QACnC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK;QAC/B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO;YAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,gBAAgB;YACrC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE;YAC3D,CAAC,CAAC,EAAE,CAAC;KACc,CAAC;IAExB,OAAO;QACL,IAAI;QACJ,EAAE;QACF,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAc,EAAE,MAAwB;IAC/D,IAAI,MAAM,CAAC,OAAO;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,SAAS;QAAE,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM;QAAE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,aAAa;QAAE,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,MAAM;QAAE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/cctp-bridge/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CCTP bridge (source-side) — wraps Circle's @circle-fin/bridge-kit.
+ *
+ * Used for bridging USDC from any CCTPv2-supported chain into Arbitrum,
+ * so it can feed into an Arbitrum USDC → BTC swap. Exposed as a subpath
+ * export so bridge-kit + its viem adapter stay optional peer deps; consumers
+ * that don't import from `@lendasat/lendaswap-sdk-pure/cctp-bridge` don't
+ * pay the bundle cost.
+ *
+ * Attestation tracking for the *target* side of an existing swap (Circle's
+ * forwarding service) still lives in `../cctp` — that flow isn't what
+ * bridge-kit drives.
+ */
+export type { AdapterContext, BridgeChainIdentifier, BridgeConfig, BridgeParams, EstimateResult, } from "@circle-fin/bridge-kit";
+export { BridgeChain, BridgeKit, type BridgeResult, TransferSpeed, } from "@circle-fin/bridge-kit";
+export { type BridgeUsdcParams, bridgeUsdc, bridgeUsdcToArbitrum, estimateUsdcBridgeFees, } from "./bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cctp-bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cctp-bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,YAAY,EACjB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,gBAAgB,EACrB,UAAU,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

package/dist/cctp-bridge/index.js

@@ -0,0 +1,16 @@
+/**
+ * CCTP bridge (source-side) — wraps Circle's @circle-fin/bridge-kit.
+ *
+ * Used for bridging USDC from any CCTPv2-supported chain into Arbitrum,
+ * so it can feed into an Arbitrum USDC → BTC swap. Exposed as a subpath
+ * export so bridge-kit + its viem adapter stay optional peer deps; consumers
+ * that don't import from `@lendasat/lendaswap-sdk-pure/cctp-bridge` don't
+ * pay the bundle cost.
+ *
+ * Attestation tracking for the *target* side of an existing swap (Circle's
+ * forwarding service) still lives in `../cctp` — that flow isn't what
+ * bridge-kit drives.
+ */
+export { BridgeChain, BridgeKit, TransferSpeed, } from "@circle-fin/bridge-kit";
+export { bridgeUsdc, bridgeUsdcToArbitrum, estimateUsdcBridgeFees, } from "./bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/cctp-bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cctp-bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,WAAW,EACX,SAAS,EAET,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,UAAU,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

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":"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"}