@lendasat/lendaswap-sdk-pure 0.2.24 → 0.2.26

package/dist/cctp-inbound/index.js

@@ -0,0 +1,33 @@
+/**
+ * CCTP-inbound flow — "any CCTPv2 chain → Arbitrum USDC → BTC" swaps.
+ *
+ * The SDK orchestrates:
+ *   1. Source-chain USDC burn via `TokenMessenger.depositForBurn`
+ *      (`destinationCaller` pinned to the user's Kernel smart account).
+ *   2. IRIS attestation polling.
+ *   3. Settlement-chain UserOp via the user's Kernel smart account
+ *      (atomic `receiveMessage` + `USDC.approve(Permit2)` +
+ *      `executeAndCreateWithPermit2`), paymaster-sponsored so the user
+ *      needs no ETH on Arbitrum.
+ *
+ * The Kernel smart account is owned by the user's connected wallet
+ * (viem `Account` / Privy / wagmi / raw key) — no SDK-derived key
+ * material. Consumer-side wallet prompts cover Permit2 typed data and
+ * the UserOp signature.
+ *
+ * Public API:
+ *   - `client.cctpInbound.*` — step-by-step primitives (for custom UX)
+ *   - `client.fundSwap(swapId, signer)` — one-shot wrapper built on top
+ */
+export { approveAndBurn, } from "./approveAndBurn.js";
+export { encodeDepositForBurn, } from "./burn.js";
+export { CCTP_VIEM_CHAINS, CHAIN_ID_TO_CCTP_NAME, cctpMetaForChainId, DIRECT_SOURCE_CHAIN_IDS, getCctpViemChain, getCctpViemChainByName, isCctpOnlySource, } from "./chainMap.js";
+export { CctpInboundClient } from "./client.js";
+export { buildDomainSeparator, MAX_UINT256, signEip2612Permit, USDC_DOMAIN_FIELDS, } from "./eip2612.js";
+export { cctpFundSwap, } from "./fundSwap.js";
+export { signPermit2Witness, } from "./permit2.js";
+export { extractRevertData, simulateBatchCalls, } from "./preflight.js";
+export { createSwapSmartAccountClient, } from "./smartAccount.js";
+export { submitCctpInboundUserOp, } from "./submit.js";
+export { addressToBytes32Hex, buildCctpInboundBatch, } from "./userOp.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cctp-inbound/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,WAAW,EAGX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAKL,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EAEjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EAInB,qBAAqB,GAGtB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Permit2 signing for `executeAndCreateWithPermit2` using the SDK's
+ * HD-derived EVM key.
+ *
+ * Wraps the existing `buildPermit2FundingDigest` + `signEvmDigest` and
+ * returns the compact 65-byte signature format (`r ‖ s ‖ v`) that
+ * `HTLCCoordinator.executeAndCreateWithPermit2` expects, ready to POST
+ * to the backend's gasless-funding endpoint.
+ */
+import { type Permit2FundingParams } from "../evm/coordinator.js";
+/** Parameters for signing a Permit2 witness with the SDK's HD key. */
+export interface SignPermit2Params {
+    /** Signer's secp256k1 private key. */
+    secretKey: Uint8Array | string;
+    /** All fields of the Permit2 witness + TokenPermissions. */
+    funding: Permit2FundingParams;
+}
+/** Signed Permit2 witness in the shape the backend's gasless endpoint expects. */
+export interface SignedPermit2Witness {
+    /** Random Permit2 nonce (stringified for API transport). */
+    nonce: string;
+    /** Signature deadline (unix seconds). */
+    deadline: number;
+    /** Compact signature: `0x` + r(32) + s(32) + v(1), 65 bytes. */
+    signature: string;
+}
+/**
+ * Signs the Permit2 EIP-712 digest using the SDK's derived key and packs
+ * the signature in the compact `r ‖ s ‖ v` form the backend submitter
+ * forwards to Permit2 on-chain.
+ */
+export declare function signPermit2Witness(params: SignPermit2Params): SignedPermit2Witness;
+//# sourceMappingURL=permit2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.d.ts","sourceRoot":"","sources":["../../src/cctp-inbound/permit2.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAG/B,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CAkBtB"}

package/dist/cctp-inbound/permit2.js

@@ -0,0 +1,32 @@
+/**
+ * Permit2 signing for `executeAndCreateWithPermit2` using the SDK's
+ * HD-derived EVM key.
+ *
+ * Wraps the existing `buildPermit2FundingDigest` + `signEvmDigest` and
+ * returns the compact 65-byte signature format (`r ‖ s ‖ v`) that
+ * `HTLCCoordinator.executeAndCreateWithPermit2` expects, ready to POST
+ * to the backend's gasless-funding endpoint.
+ */
+import { buildPermit2FundingDigest, } from "../evm/coordinator.js";
+import { signEvmDigest } from "../evm/signing.js";
+/**
+ * Signs the Permit2 EIP-712 digest using the SDK's derived key and packs
+ * the signature in the compact `r ‖ s ‖ v` form the backend submitter
+ * forwards to Permit2 on-chain.
+ */
+export function signPermit2Witness(params) {
+    const digest = buildPermit2FundingDigest(params.funding);
+    const sig = signEvmDigest(params.secretKey, digest);
+    const r = sig.r.replace(/^0x/, "");
+    const s = sig.s.replace(/^0x/, "");
+    const v = sig.v.toString(16).padStart(2, "0");
+    if (r.length !== 64 || s.length !== 64) {
+        throw new Error(`Malformed signature scalars: r=${r.length}, s=${s.length}`);
+    }
+    return {
+        nonce: params.funding.nonce.toString(),
+        deadline: Number(params.funding.deadline),
+        signature: `0x${r}${s}${v}`,
+    };
+}
+//# sourceMappingURL=permit2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.js","sourceRoot":"","sources":["../../src/cctp-inbound/permit2.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoBlD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAyB;IAEzB,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEpD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,kCAAkC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE;QACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Optional per-call pre-flight for the CCTP-inbound UserOp batch.
+ *
+ * The bundler simulates the whole UserOp and returns a single
+ * "execution reverted" if any inner call fails — useless for
+ * iterating. This helper runs each call individually via `eth_call`
+ * with the smart account as `from`, surfacing the per-call revert
+ * data before we even talk to the bundler.
+ *
+ * Limitation: any call that re-enters the smart account (e.g. Permit2
+ * invoking `IERC1271.isValidSignature`) reverts here because the
+ * account isn't deployed at simulation time but WILL be in the real
+ * UserOp via factoryData. Treat these reverts as informational — the
+ * bundler's full-simulation is the authoritative check.
+ */
+import type { Address, PublicClient } from "viem";
+import type { BatchCall } from "./userOp.js";
+/**
+ * Walk a viem error chain and surface any RPC-level revert data
+ * (selector + encoded args). viem buries these under `cause` /
+ * `data` / nested `data.data`.
+ */
+export declare function extractRevertData(err: unknown): string | undefined;
+export interface SimulateBatchCallsArgs {
+    calls: BatchCall[];
+    smartAccount: Address;
+    publicClient: PublicClient;
+}
+/**
+ * Run `eth_call` once per batch call with the smart account as
+ * `from`. Logs per-call status via `console.log` / `console.warn` so
+ * failures are visible in devtools. Never throws — pre-flight reverts
+ * for calls that re-enter the smart account are expected.
+ */
+export declare function simulateBatchCalls(args: SimulateBatchCallsArgs): Promise<void>;
+//# sourceMappingURL=preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/cctp-inbound/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBlE;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/cctp-inbound/preflight.js

@@ -0,0 +1,67 @@
+/**
+ * Optional per-call pre-flight for the CCTP-inbound UserOp batch.
+ *
+ * The bundler simulates the whole UserOp and returns a single
+ * "execution reverted" if any inner call fails — useless for
+ * iterating. This helper runs each call individually via `eth_call`
+ * with the smart account as `from`, surfacing the per-call revert
+ * data before we even talk to the bundler.
+ *
+ * Limitation: any call that re-enters the smart account (e.g. Permit2
+ * invoking `IERC1271.isValidSignature`) reverts here because the
+ * account isn't deployed at simulation time but WILL be in the real
+ * UserOp via factoryData. Treat these reverts as informational — the
+ * bundler's full-simulation is the authoritative check.
+ */
+/**
+ * Walk a viem error chain and surface any RPC-level revert data
+ * (selector + encoded args). viem buries these under `cause` /
+ * `data` / nested `data.data`.
+ */
+export function extractRevertData(err) {
+    let cur = err;
+    for (let depth = 0; depth < 10 && cur; depth++) {
+        const node = cur;
+        if (typeof node.data === "string" && node.data.startsWith("0x")) {
+            return node.data;
+        }
+        if (typeof node.data === "object" && node.data !== null) {
+            const nested = node.data.data;
+            if (typeof nested === "string" && nested.startsWith("0x")) {
+                return nested;
+            }
+        }
+        cur = node.cause;
+    }
+    return undefined;
+}
+/**
+ * Run `eth_call` once per batch call with the smart account as
+ * `from`. Logs per-call status via `console.log` / `console.warn` so
+ * failures are visible in devtools. Never throws — pre-flight reverts
+ * for calls that re-enter the smart account are expected.
+ */
+export async function simulateBatchCalls(args) {
+    const { calls, smartAccount, publicClient } = args;
+    for (let i = 0; i < calls.length; i++) {
+        const call = calls[i];
+        const label = `[cctp-inbound/preflight] call ${i + 1}/${calls.length} to ${call.to}`;
+        try {
+            await publicClient.call({
+                account: smartAccount,
+                to: call.to,
+                data: call.data,
+                value: call.value,
+            });
+            console.log(`${label} OK`);
+        }
+        catch (err) {
+            const revertData = extractRevertData(err);
+            console.warn(`${label} reverted in pre-flight (may be OK at send)`, {
+                revertData: revertData ?? "(none)",
+                error: err,
+            });
+        }
+    }
+}
+//# sourceMappingURL=preflight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/cctp-inbound/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,GAA0C,CAAC;QACxD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,MAAM,GAAI,IAAI,CAAC,IAA0B,CAAC,IAAI,CAAC;YACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,iCAAiC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,CAAC;gBACtB,OAAO,EAAE,YAAY;gBACrB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,6CAA6C,EAAE;gBAClE,UAAU,EAAE,UAAU,IAAI,QAAQ;gBAClC,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}