@lendasat/lendaswap-sdk-pure 0.2.24 → 0.2.26

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/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cctp/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAC/E,eAAO,MAAM,sBAAsB,+CACW,CAAC;AAO/C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAMtD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAejD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAOF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG1D,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG9D,CAAC;AAMJ;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uEAC6B,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,WAAa,CAAC;AAClD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,UAAW,CAAC;AAM7C,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,gBAAgB,wCAAwC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cctp/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAC/E,eAAO,MAAM,sBAAsB,+CACW,CAAC;AAO/C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAMtD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBjD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAOF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG1D,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG9D,CAAC;AAMJ;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uEAC6B,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,WAAa,CAAC;AAClD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,UAAW,CAAC;AAM7C,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,gBAAgB,wCAAwC,CAAC"}

package/dist/cctp/constants.js

@@ -48,6 +48,10 @@ export const USDC_ADDRESSES = {
     Sei: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
     HyperEVM: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
     Monad: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+    // Solana's USDC is an SPL mint, encoded as a base58 pubkey rather than
+    // an EVM `0x...` hex address. Callers that parse the value with viem's
+    // `getAddress` / `Address.from_str` must guard against this entry.
+    Solana: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
 };
 export const EURC_ADDRESSES = {
     Ethereum: "0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c",

package/dist/cctp/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cctp/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GACjC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,kBAAkB;AAClB,gFAAgF;AAChF,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,EAAE;IACjB,KAAK,EAAE,EAAE;IACT,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,GAAG,EAAE,EAAE;CACC,CAAC;AAIX,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,KAAK,EAAE,4CAA4C;IACnD,QAAQ,EAAE,4CAA4C;IACtD,aAAa,EAAE,4CAA4C;IAC3D,GAAG,EAAE,4CAA4C;IACjD,KAAK,EAAE,4CAA4C;IACnD,GAAG,EAAE,4CAA4C;IACjD,QAAQ,EAAE,4CAA4C;IACtD,KAAK,EAAE,4CAA4C;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,+EAA+E;AAC/E,mEAAmE;AACnE,wEAAwE;AACxE,+EAA+E;AAE/E,MAAM,CAAC,MAAM,yBAAyB,GACpC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CACtE,CAAC;AAEJ,MAAM,CAAC,MAAM,6BAA6B,GACxC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAC1E,CAAC;AAEJ,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,oEAAoE,CAAC;AAEvE,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAU,CAAC;AAClD,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAQ,CAAC;AAE7C,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qCAAqC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cctp/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GACjC,4CAA4C,CAAC;AAE/C,+EAA+E;AAC/E,kBAAkB;AAClB,gFAAgF;AAChF,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,EAAE;IACjB,KAAK,EAAE,EAAE;IACT,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,GAAG,EAAE,EAAE;CACC,CAAC;AAIX,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,4CAA4C;IACrD,QAAQ,EAAE,4CAA4C;IACtD,IAAI,EAAE,4CAA4C;IAClD,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,KAAK,EAAE,4CAA4C;IACnD,QAAQ,EAAE,4CAA4C;IACtD,aAAa,EAAE,4CAA4C;IAC3D,GAAG,EAAE,4CAA4C;IACjD,KAAK,EAAE,4CAA4C;IACnD,GAAG,EAAE,4CAA4C;IACjD,QAAQ,EAAE,4CAA4C;IACtD,KAAK,EAAE,4CAA4C;IACnD,uEAAuE;IACvE,uEAAuE;IACvE,mEAAmE;IACnE,MAAM,EAAE,8CAA8C;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF,+EAA+E;AAC/E,mEAAmE;AACnE,wEAAwE;AACxE,+EAA+E;AAE/E,MAAM,CAAC,MAAM,yBAAyB,GACpC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CACtE,CAAC;AAEJ,MAAM,CAAC,MAAM,6BAA6B,GACxC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAC1E,CAAC;AAEJ,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,oEAAoE,CAAC;AAEvE,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAU,CAAC;AAClD,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAQ,CAAC;AAE7C,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qCAAqC,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";
+export { addressToBytes32, bytes32ToAddress, getDomain, isValidSolanaAddress, needsBridge, solanaAddressToBytes32, } 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,oBAAoB,EACpB,WAAW,EACX,sBAAsB,GACvB,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 { addressToBytes32, bytes32ToAddress, getDomain, needsBridge, } from "./utils.js";
+export { computeCctpFastFee, fetchCctpFee, getCachedCctpFee, } from "./fee.js";
+export { addressToBytes32, bytes32ToAddress, getDomain, isValidSolanaAddress, needsBridge, solanaAddressToBytes32, } 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,oBAAoB,EACpB,WAAW,EACX,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/cctp/utils.d.ts

@@ -26,4 +26,19 @@ export declare function getDomain(chainName: string): number | undefined;
  * @returns true if CCTP bridging is needed
  */
 export declare function needsBridge(sourceChain: string, targetChain: string): boolean;
+/**
+ * Validate a Solana address. Solana pubkeys are base58-encoded 32-byte
+ * values, typically 32-44 base58 characters. Cheap structural check —
+ * does not verify on-curve / system-program semantics.
+ */
+export declare function isValidSolanaAddress(address: string): boolean;
+/**
+ * Decode a base58-encoded Solana pubkey into CCTP's 32-byte recipient
+ * format. Solana pubkeys are natively 32 bytes — no padding needed.
+ *
+ * Returns a `0x`-prefixed 64-character hex string (the bytes32 form
+ * accepted by Circle's TokenMessenger `mintRecipient` field), so the
+ * shape matches `addressToBytes32` for EVM addresses.
+ */
+export declare function solanaAddressToBytes32(address: string): string;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cctp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK7E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cctp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW7D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY9D"}

package/dist/cctp/utils.js

@@ -1,6 +1,7 @@
 /**
  * CCTP utility functions.
  */
+import { base58 } from "@scure/base";
 import { CCTP_DOMAINS } from "./constants.js";
 /**
  * Convert an EVM address to CCTP's bytes32 format (left-padded with zeros).
@@ -47,4 +48,44 @@ export function needsBridge(sourceChain, targetChain) {
     const targetDomain = getDomain(targetChain);
     return sourceDomain !== undefined && targetDomain !== undefined;
 }
+/**
+ * Validate a Solana address. Solana pubkeys are base58-encoded 32-byte
+ * values, typically 32-44 base58 characters. Cheap structural check —
+ * does not verify on-curve / system-program semantics.
+ */
+export function isValidSolanaAddress(address) {
+    if (!address)
+        return false;
+    if (address.length < 32 || address.length > 44)
+        return false;
+    // Disallow base58-illegal characters early so we don't rely on the
+    // decode throwing for obvious junk.
+    if (!/^[1-9A-HJ-NP-Za-km-z]+$/.test(address))
+        return false;
+    try {
+        return base58.decode(address).length === 32;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Decode a base58-encoded Solana pubkey into CCTP's 32-byte recipient
+ * format. Solana pubkeys are natively 32 bytes — no padding needed.
+ *
+ * Returns a `0x`-prefixed 64-character hex string (the bytes32 form
+ * accepted by Circle's TokenMessenger `mintRecipient` field), so the
+ * shape matches `addressToBytes32` for EVM addresses.
+ */
+export function solanaAddressToBytes32(address) {
+    const decoded = base58.decode(address);
+    if (decoded.length !== 32) {
+        throw new Error(`Solana pubkey must decode to 32 bytes, got ${decoded.length} for ${address}`);
+    }
+    let hex = "0x";
+    for (const byte of decoded) {
+        hex += byte.toString(16).padStart(2, "0");
+    }
+    return hex;
+}
 //# sourceMappingURL=utils.js.map

package/dist/cctp/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cctp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,MAAM,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,MAAM,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,YAAY,CAAC,SAA0B,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,WAAmB;IAClE,IAAI,WAAW,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,CAAC;AAClE,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cctp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,MAAM,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,MAAM,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,YAAY,CAAC,SAA0B,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,WAAmB;IAClE,IAAI,WAAW,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7D,mEAAmE;IACnE,oCAAoC;IACpC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8CAA8C,OAAO,CAAC,MAAM,QAAQ,OAAO,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,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"}