damm-sdk 1.4.21 → 1.4.23

package/dist/integrations/ccip/ccip.router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ccip.router.d.ts","sourceRoot":"","sources":["../../../src/integrations/ccip/ccip.router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQhE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,MAMtD,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,uBAAuB;IACvB,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;CACxB,CAAC,CAAC;AAIH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SAAU,UAAU,KAAG,SAcrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;mBAIP,OAAO;UAChB,UAAU;MAChB,WAAW,IAAI,CAOlB,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAAU,YAAY,KAAG,SAcrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;mBAIL,OAAO;UAChB,YAAY;MAClB,WAAW,IAAI,CAOlB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;cAKf,OAAO;WACV,OAAO;YACN,MAAM;MACd,cAWH,CAAC"}
+{"version":3,"file":"ccip.router.d.ts","sourceRoot":"","sources":["../../../src/integrations/ccip/ccip.router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAShE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,MAMtD,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,uBAAuB;IACvB,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;CACxB,CAAC,CAAC;AAIH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SAAU,UAAU,KAAG,SAcrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;mBAIP,OAAO;UAChB,UAAU;MAChB,WAAW,IAAI,CAOlB,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAAU,YAAY,KAAG,SAcrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;mBAIL,OAAO;UAChB,YAAY;MAClB,WAAW,IAAI,CAOlB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;cAKf,OAAO;WACV,OAAO;YACN,MAAM;MACd,cAWH,CAAC"}

package/dist/integrations/enso/enso.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Enso RouterV2 transaction builders.
+ *
+ * Enso's `/v1/shortcuts/route` API only returns `routeSingle(Token tokenOut,
+ * bytes data)` calldata. Our Zodiac Roles scopes only permit the stricter
+ * 4-arg `safeRouteSingle(Token tokenIn, Token tokenOut, address receiver,
+ * bytes data)`, which validates tokenIn consumption and an explicit receiver.
+ *
+ * The shortcut `bundle` payload is identical between the two entry points —
+ * safeRouteSingle just layers additional validation on top — so we fetch the
+ * route once, extract the bundle, and re-encode as safeRouteSingle.
+ *
+ * Workflow:
+ *   ensoSafeRouteSingleTrx({ api args, routerAddress })
+ *     → fetchEnsoRoute(...)                                  (HTTP)
+ *     → rewrapRouteSingleAsSafeRouteSingle(...)              (pure)
+ *     → createCall({ to: routerAddress, data, … })           (Unwrapable<Call>)
+ */
+import { type Address } from "viem";
+import type { Call, HexString, Unwrapable } from "../../types";
+import { type EnsoRouteArgs } from "./enso.route.api.ts";
+export declare enum EnsoTokenType {
+    Native = 0,
+    ERC20 = 1
+}
+export type EnsoToken = Readonly<{
+    tokenType: EnsoTokenType;
+    data: HexString;
+}>;
+/**
+ * Encode a token as Enso's `Token` struct:
+ *   - ERC20:  (tokenType=1, abi.encode(address, uint256))
+ *   - Native: (tokenType=0, abi.encode(uint256))
+ */
+export declare const encodeEnsoToken: (token: Address, amount: bigint) => EnsoToken;
+export declare class UnexpectedEnsoSelectorError extends Error {
+    readonly selector: string;
+    constructor(selector: string);
+}
+export type RewrapArgs = Readonly<{
+    routeSingleCalldata: HexString;
+    tokenIn: Address;
+    amountIn: bigint;
+    receiver: Address;
+}>;
+/**
+ * Decode `routeSingle(tokenOut, bundle)` calldata, then re-encode as
+ * `safeRouteSingle(tokenIn, tokenOut, receiver, bundle)` using the same
+ * bundle payload. The bundle is byte-identical; only the wrapper changes.
+ *
+ * Throws `UnexpectedEnsoSelectorError` if the input doesn't start with the
+ * routeSingle selector — a fail-fast guard in case Enso's API ever switches
+ * output format.
+ */
+export declare const rewrapRouteSingleAsSafeRouteSingle: (args: RewrapArgs) => HexString;
+export declare class EnsoUnexpectedRouterError extends Error {
+    readonly got: Address;
+    readonly expected: Address;
+    constructor(got: Address, expected: Address);
+}
+export type EnsoSafeRouteSingleTrxArgs = EnsoRouteArgs & Readonly<{
+    /** Address of the Enso RouterV2 on the target chain. Must match the scope in Zodiac Roles. */
+    routerAddress: Address;
+}>;
+/**
+ * Fetch an Enso route and return a `safeRouteSingle` call ready to be added
+ * to a MultisendBuilder.
+ *
+ * Aborts (throws) if Enso's API returns a tx targeting any address other than
+ * the provided RouterV2 — this protects against the API silently switching to
+ * EnsoWallet or EnsoShortcutsDelegate, neither of which our Zodiac scope
+ * permits.
+ */
+export declare const ensoSafeRouteSingleTrx: (args: EnsoSafeRouteSingleTrxArgs) => Promise<Unwrapable<Call>>;
+//# sourceMappingURL=enso.d.ts.map

package/dist/integrations/enso/enso.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enso.d.ts","sourceRoot":"","sources":["../../../src/integrations/enso/enso.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA+D,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AACjG,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAkB,KAAK,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAIjG,oBAAY,aAAa;IACrB,MAAM,IAAI;IACV,KAAK,IAAI;CACZ;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;CACnB,CAAC,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAW,OAAO,UAAU,MAAM,KAAG,SAWhE,CAAC;AAMF,qBAAa,2BAA4B,SAAQ,KAAK;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM;CAQ/B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAC9B,mBAAmB,EAAE,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC,SAAU,UAAU,KAAG,SAyBrE,CAAC;AAIF,qBAAa,yBAA0B,SAAQ,KAAK;IAChD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBACf,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO;CAS9C;AAED,MAAM,MAAM,0BAA0B,GAAG,aAAa,GAClD,QAAQ,CAAC;IACL,8FAA8F;IAC9F,aAAa,EAAE,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEP;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,SAAgB,0BAA0B,KAAG,QAAQ,WAAW,IAAI,CAAC,CAsBvG,CAAC"}

package/dist/integrations/enso/enso.route.api.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Enso Shortcuts API client.
+ *
+ * Fetches a swap route from Enso's public `/v1/shortcuts/route` endpoint and
+ * returns the raw `tx.data` (which is always `routeSingle` calldata — see
+ * `enso.ts` for the rewrap into `safeRouteSingle`).
+ *
+ * API reference: https://docs.enso.build/pages/api-reference/shortcuts/route
+ */
+import type { Address } from "viem";
+import type { HexString } from "../../types";
+export declare const ENSO_API_BASE: "https://api.enso.finance";
+/**
+ * Raw response shape from the Enso route endpoint. We only model the fields
+ * we use; Enso returns many more (amountOut, priceImpact, route, …) that are
+ * intentionally ignored.
+ */
+export type EnsoRouteResponse = Readonly<{
+    tx: Readonly<{
+        to: HexString;
+        data: HexString;
+        value: string;
+    }>;
+}>;
+export type EnsoRouteArgs = Readonly<{
+    chainId: number;
+    /** Caller address — also used as `receiver` by default. */
+    fromAddress: Address;
+    /** Destination for the swap output. Typically equal to `fromAddress` (the Safe). */
+    receiver: Address;
+    tokenIn: Address;
+    tokenOut: Address;
+    /** Decimal string, no decimals adjustment — matches token units. */
+    amountIn: string;
+    /**
+     * Slippage in integer basis points (e.g. 20 = 0.2%, 300 = 3%).
+     *
+     * Enso's `slippage` param is a number string in bips. Passing a decimal
+     * like `0.2` triggers a 400 Bad Request ("slippage must be a number
+     * string").
+     */
+    slippageBips: number;
+    /** Optional Enso API key for 10 rps; no key = 1 rps global limit. */
+    apiKey?: string;
+    /** Override the API base URL (useful for tests). */
+    apiBase?: string;
+}>;
+export declare class EnsoRouteApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly tokenIn: Address;
+    readonly tokenOut: Address;
+    constructor({ status, statusText, tokenIn, tokenOut, }: {
+        status: number;
+        statusText: string;
+        tokenIn: Address;
+        tokenOut: Address;
+    });
+}
+/**
+ * Fetch a shortcut route from Enso. Always returns `routeSingle` calldata —
+ * use `rewrapRouteSingleAsSafeRouteSingle` in `enso.ts` to convert to
+ * `safeRouteSingle` before submitting on-chain if your Safe's Zodiac scope
+ * only permits safeRouteSingle.
+ */
+export declare const fetchEnsoRoute: (args: EnsoRouteArgs) => Promise<EnsoRouteResponse>;
+//# sourceMappingURL=enso.route.api.d.ts.map

package/dist/integrations/enso/enso.route.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enso.route.api.d.ts","sourceRoot":"","sources":["../../../src/integrations/enso/enso.route.api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,aAAa,4BAAsC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACrC,EAAE,EAAE,QAAQ,CAAC;QACT,EAAE,EAAE,SAAS,CAAC;QACd,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACN,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEf,EACR,MAAM,EACN,UAAU,EACV,OAAO,EACP,QAAQ,GACX,EAAE;QACC,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;KACrB;CAQJ;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SAAgB,aAAa,KAAG,QAAQ,iBAAiB,CA0CnF,CAAC"}

package/dist/integrations/enso/enso.router.abi.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Enso RouterV2 — minimal ABI covering the entry points we use:
+ *
+ *   routeSingle(Token tokenOut, bytes data)
+ *   safeRouteSingle(Token tokenIn, Token tokenOut, address receiver, bytes data)
+ *
+ * `Token` is Enso's internal struct `{ uint8 tokenType, bytes data }` where:
+ *   - tokenType = 0 (Native):  data = abi.encode(uint256 amount)
+ *   - tokenType = 1 (ERC20):   data = abi.encode(address token, uint256 amount)
+ *
+ * We intentionally expose only these two selectors — we never call the Enso
+ * router with routeMulti / safeRouteMulti / delegate variants from any DAMM
+ * context, and shipping their ABIs here would just invite unaudited usage.
+ */
+declare const _default: readonly [{
+    readonly name: "routeSingle";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "tokenOut";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "tokenType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "safeRouteSingle";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "tokenIn";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "tokenType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "tokenOut";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "tokenType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}];
+export default _default;
+//# sourceMappingURL=enso.router.abi.d.ts.map

package/dist/integrations/enso/enso.router.abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enso.router.abi.d.ts","sourceRoot":"","sources":["../../../src/integrations/enso/enso.router.abi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,wBAuBW"}

package/dist/integrations/enso/index.d.ts

@@ -0,0 +1,4 @@
+export { default as ensoRouterAbi } from "./enso.router.abi";
+export * from "./enso";
+export * from "./enso.route.api";
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/enso/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/enso/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7D,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC"}

package/dist/integrations/index.d.ts

@@ -24,4 +24,5 @@ export * from "./fluidLite";
 export * from "./weth";
 export * from "./pendle";
 export * from "./wormhole";
+export * from "./enso";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/package.json

@@ -4,7 +4,7 @@
     "main": "./dist/index.cjs",
     "types": "./dist/index.d.ts",
     "type": "module",
-    "version": "1.4.21",
+    "version": "1.4.23",
     "files": [
         "dist",
         "src",

package/src/integrations/ccip/ccip.router.ts

@@ -19,6 +19,7 @@ export const CCIP_CHAIN_SELECTORS: Readonly<Record<number, string>> = Object.fre
     137: "4051577828743386545", // Polygon
     56: "11344663589394136015", // BSC
     143: "8481857512324358265", // Monad
+    4326: "6093540873831549674", // MegaETH
 });
 
 /**

package/src/integrations/enso/enso.route.api.ts

@@ -0,0 +1,127 @@
+/**
+ * Enso Shortcuts API client.
+ *
+ * Fetches a swap route from Enso's public `/v1/shortcuts/route` endpoint and
+ * returns the raw `tx.data` (which is always `routeSingle` calldata — see
+ * `enso.ts` for the rewrap into `safeRouteSingle`).
+ *
+ * API reference: https://docs.enso.build/pages/api-reference/shortcuts/route
+ */
+
+import type { Address } from "viem";
+import type { HexString } from "../../types";
+
+export const ENSO_API_BASE = "https://api.enso.finance" as const;
+
+/**
+ * Raw response shape from the Enso route endpoint. We only model the fields
+ * we use; Enso returns many more (amountOut, priceImpact, route, …) that are
+ * intentionally ignored.
+ */
+export type EnsoRouteResponse = Readonly<{
+    tx: Readonly<{
+        to: HexString;
+        data: HexString;
+        value: string;
+    }>;
+}>;
+
+export type EnsoRouteArgs = Readonly<{
+    chainId: number;
+    /** Caller address — also used as `receiver` by default. */
+    fromAddress: Address;
+    /** Destination for the swap output. Typically equal to `fromAddress` (the Safe). */
+    receiver: Address;
+    tokenIn: Address;
+    tokenOut: Address;
+    /** Decimal string, no decimals adjustment — matches token units. */
+    amountIn: string;
+    /**
+     * Slippage in integer basis points (e.g. 20 = 0.2%, 300 = 3%).
+     *
+     * Enso's `slippage` param is a number string in bips. Passing a decimal
+     * like `0.2` triggers a 400 Bad Request ("slippage must be a number
+     * string").
+     */
+    slippageBips: number;
+    /** Optional Enso API key for 10 rps; no key = 1 rps global limit. */
+    apiKey?: string;
+    /** Override the API base URL (useful for tests). */
+    apiBase?: string;
+}>;
+
+export class EnsoRouteApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly tokenIn: Address;
+    readonly tokenOut: Address;
+
+    constructor({
+        status,
+        statusText,
+        tokenIn,
+        tokenOut,
+    }: {
+        status: number;
+        statusText: string;
+        tokenIn: Address;
+        tokenOut: Address;
+    }) {
+        super(`Enso route API request failed with status ${status} (${statusText}) for swap ${tokenIn} -> ${tokenOut}`);
+        this.name = "EnsoRouteApiError";
+        this.status = status;
+        this.statusText = statusText;
+        this.tokenIn = tokenIn;
+        this.tokenOut = tokenOut;
+    }
+}
+
+/**
+ * Fetch a shortcut route from Enso. Always returns `routeSingle` calldata —
+ * use `rewrapRouteSingleAsSafeRouteSingle` in `enso.ts` to convert to
+ * `safeRouteSingle` before submitting on-chain if your Safe's Zodiac scope
+ * only permits safeRouteSingle.
+ */
+export const fetchEnsoRoute = async (args: EnsoRouteArgs): Promise<EnsoRouteResponse> => {
+    const {
+        chainId,
+        fromAddress,
+        receiver,
+        tokenIn,
+        tokenOut,
+        amountIn,
+        slippageBips,
+        apiKey,
+        apiBase = ENSO_API_BASE,
+    } = args;
+
+    const params = new URLSearchParams({
+        chainId: String(chainId),
+        fromAddress,
+        receiver,
+        tokenIn,
+        tokenOut,
+        amountIn,
+        slippage: String(slippageBips),
+    });
+
+    const headers: Record<string, string> = { Accept: "application/json" };
+    if (apiKey) {
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    }
+
+    const response = await fetch(`${apiBase}/api/v1/shortcuts/route?${params.toString()}`, {
+        headers,
+    });
+
+    if (!response.ok) {
+        throw new EnsoRouteApiError({
+            status: response.status,
+            statusText: response.statusText,
+            tokenIn,
+            tokenOut,
+        });
+    }
+
+    return (await response.json()) as EnsoRouteResponse;
+};

package/src/integrations/enso/enso.router.abi.ts

@@ -0,0 +1,48 @@
+/**
+ * Enso RouterV2 — minimal ABI covering the entry points we use:
+ *
+ *   routeSingle(Token tokenOut, bytes data)
+ *   safeRouteSingle(Token tokenIn, Token tokenOut, address receiver, bytes data)
+ *
+ * `Token` is Enso's internal struct `{ uint8 tokenType, bytes data }` where:
+ *   - tokenType = 0 (Native):  data = abi.encode(uint256 amount)
+ *   - tokenType = 1 (ERC20):   data = abi.encode(address token, uint256 amount)
+ *
+ * We intentionally expose only these two selectors — we never call the Enso
+ * router with routeMulti / safeRouteMulti / delegate variants from any DAMM
+ * context, and shipping their ABIs here would just invite unaudited usage.
+ */
+
+const tokenTuple = {
+    name: "token",
+    type: "tuple",
+    components: [
+        { name: "tokenType", type: "uint8" },
+        { name: "data", type: "bytes" },
+    ],
+} as const;
+
+export default [
+    {
+        name: "routeSingle",
+        type: "function",
+        stateMutability: "payable",
+        inputs: [
+            { ...tokenTuple, name: "tokenOut" },
+            { name: "data", type: "bytes" },
+        ],
+        outputs: [],
+    },
+    {
+        name: "safeRouteSingle",
+        type: "function",
+        stateMutability: "payable",
+        inputs: [
+            { ...tokenTuple, name: "tokenIn" },
+            { ...tokenTuple, name: "tokenOut" },
+            { name: "receiver", type: "address" },
+            { name: "data", type: "bytes" },
+        ],
+        outputs: [],
+    },
+] as const;

package/src/integrations/enso/enso.ts

@@ -0,0 +1,172 @@
+/**
+ * Enso RouterV2 transaction builders.
+ *
+ * Enso's `/v1/shortcuts/route` API only returns `routeSingle(Token tokenOut,
+ * bytes data)` calldata. Our Zodiac Roles scopes only permit the stricter
+ * 4-arg `safeRouteSingle(Token tokenIn, Token tokenOut, address receiver,
+ * bytes data)`, which validates tokenIn consumption and an explicit receiver.
+ *
+ * The shortcut `bundle` payload is identical between the two entry points —
+ * safeRouteSingle just layers additional validation on top — so we fetch the
+ * route once, extract the bundle, and re-encode as safeRouteSingle.
+ *
+ * Workflow:
+ *   ensoSafeRouteSingleTrx({ api args, routerAddress })
+ *     → fetchEnsoRoute(...)                                  (HTTP)
+ *     → rewrapRouteSingleAsSafeRouteSingle(...)              (pure)
+ *     → createCall({ to: routerAddress, data, … })           (Unwrapable<Call>)
+ */
+
+import { decodeFunctionData, encodeAbiParameters, encodeFunctionData, type Address } from "viem";
+import type { Call, HexString, Unwrapable } from "../../types";
+import { createCall } from "../../types";
+import ensoRouterAbi from "./enso.router.abi.ts";
+import { fetchEnsoRoute, type EnsoRouteArgs, type EnsoRouteResponse } from "./enso.route.api.ts";
+
+// --- Token struct --------------------------------------------------------
+
+export enum EnsoTokenType {
+    Native = 0,
+    ERC20 = 1,
+}
+
+export type EnsoToken = Readonly<{
+    tokenType: EnsoTokenType;
+    data: HexString;
+}>;
+
+const ZERO_ADDRESS: Address = "0x0000000000000000000000000000000000000000";
+
+const isNativeToken = (token: Address): boolean => token.toLowerCase() === ZERO_ADDRESS;
+
+/**
+ * Encode a token as Enso's `Token` struct:
+ *   - ERC20:  (tokenType=1, abi.encode(address, uint256))
+ *   - Native: (tokenType=0, abi.encode(uint256))
+ */
+export const encodeEnsoToken = (token: Address, amount: bigint): EnsoToken => {
+    if (isNativeToken(token)) {
+        return {
+            tokenType: EnsoTokenType.Native,
+            data: encodeAbiParameters([{ type: "uint256" }], [amount]),
+        };
+    }
+    return {
+        tokenType: EnsoTokenType.ERC20,
+        data: encodeAbiParameters([{ type: "address" }, { type: "uint256" }], [token, amount]),
+    };
+};
+
+// --- routeSingle → safeRouteSingle rewrap --------------------------------
+
+const ROUTE_SINGLE_SELECTOR = "0xb94c3609" as const;
+
+export class UnexpectedEnsoSelectorError extends Error {
+    readonly selector: string;
+    constructor(selector: string) {
+        super(
+            `Expected routeSingle selector ${ROUTE_SINGLE_SELECTOR}, got ${selector}. ` +
+                `The Enso API may have changed its output format.`,
+        );
+        this.name = "UnexpectedEnsoSelectorError";
+        this.selector = selector;
+    }
+}
+
+export type RewrapArgs = Readonly<{
+    routeSingleCalldata: HexString;
+    tokenIn: Address;
+    amountIn: bigint;
+    receiver: Address;
+}>;
+
+/**
+ * Decode `routeSingle(tokenOut, bundle)` calldata, then re-encode as
+ * `safeRouteSingle(tokenIn, tokenOut, receiver, bundle)` using the same
+ * bundle payload. The bundle is byte-identical; only the wrapper changes.
+ *
+ * Throws `UnexpectedEnsoSelectorError` if the input doesn't start with the
+ * routeSingle selector — a fail-fast guard in case Enso's API ever switches
+ * output format.
+ */
+export const rewrapRouteSingleAsSafeRouteSingle = (args: RewrapArgs): HexString => {
+    const { routeSingleCalldata, tokenIn, amountIn, receiver } = args;
+
+    const selector = routeSingleCalldata.slice(0, 10).toLowerCase();
+    if (selector !== ROUTE_SINGLE_SELECTOR) {
+        throw new UnexpectedEnsoSelectorError(selector);
+    }
+
+    const decoded = decodeFunctionData({
+        abi: ensoRouterAbi,
+        data: routeSingleCalldata,
+    });
+
+    if (decoded.functionName !== "routeSingle") {
+        throw new UnexpectedEnsoSelectorError(selector);
+    }
+    const [tokenOutStruct, bundle] = decoded.args as readonly [EnsoToken, HexString];
+
+    const tokenInStruct = encodeEnsoToken(tokenIn, amountIn);
+
+    return encodeFunctionData({
+        abi: ensoRouterAbi,
+        functionName: "safeRouteSingle",
+        args: [tokenInStruct, tokenOutStruct, receiver, bundle],
+    }) as HexString;
+};
+
+// --- High-level helper: fetch route + rewrap + build Call ----------------
+
+export class EnsoUnexpectedRouterError extends Error {
+    readonly got: Address;
+    readonly expected: Address;
+    constructor(got: Address, expected: Address) {
+        super(
+            `Enso API routed to ${got} but we expected RouterV2 ${expected}. ` +
+                `Unsupported routing (e.g. EnsoWallet / ShortcutsDelegate) — aborting.`,
+        );
+        this.name = "EnsoUnexpectedRouterError";
+        this.got = got;
+        this.expected = expected;
+    }
+}
+
+export type EnsoSafeRouteSingleTrxArgs = EnsoRouteArgs &
+    Readonly<{
+        /** Address of the Enso RouterV2 on the target chain. Must match the scope in Zodiac Roles. */
+        routerAddress: Address;
+    }>;
+
+/**
+ * Fetch an Enso route and return a `safeRouteSingle` call ready to be added
+ * to a MultisendBuilder.
+ *
+ * Aborts (throws) if Enso's API returns a tx targeting any address other than
+ * the provided RouterV2 — this protects against the API silently switching to
+ * EnsoWallet or EnsoShortcutsDelegate, neither of which our Zodiac scope
+ * permits.
+ */
+export const ensoSafeRouteSingleTrx = async (args: EnsoSafeRouteSingleTrxArgs): Promise<Unwrapable<Call>> => {
+    const { routerAddress, tokenIn, amountIn, receiver } = args;
+
+    const route: EnsoRouteResponse = await fetchEnsoRoute(args);
+
+    if (route.tx.to.toLowerCase() !== routerAddress.toLowerCase()) {
+        throw new EnsoUnexpectedRouterError(route.tx.to as Address, routerAddress);
+    }
+
+    const safeRouteSingleCalldata = rewrapRouteSingleAsSafeRouteSingle({
+        routeSingleCalldata: route.tx.data,
+        tokenIn,
+        amountIn: BigInt(amountIn),
+        receiver,
+    });
+
+    return createCall({
+        to: routerAddress,
+        data: safeRouteSingleCalldata,
+        operation: 0,
+        value: BigInt(route.tx.value || "0"),
+    });
+};

package/src/integrations/enso/index.ts

@@ -0,0 +1,3 @@
+export { default as ensoRouterAbi } from "./enso.router.abi";
+export * from "./enso";
+export * from "./enso.route.api";

package/src/integrations/index.ts

@@ -24,3 +24,4 @@ export * from "./fluidLite";
 export * from "./weth";
 export * from "./pendle";
 export * from "./wormhole";
+export * from "./enso";

package/src/lib/contractsRegistry.json

@@ -1013,6 +1013,19 @@
                 "safeL2Singleton": "0x29fcB43b46531BcA003ddC8FCB67FFE91900C762",
                 "proxyFactory": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67"
             }
+        },
+        "tokens": {
+            "wsteth": "0x601aC63637933D88285A025C685AC4e9a92a98dA",
+            "usdt0": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb"
+        },
+        "aaveV3": {
+            "pool": "0x7e324AbC5De01d112AfC03a584966ff199741C28"
+        },
+        "ccip": {
+            "router": "0xfa546248C54939AA6C48279CdC1EAf9A1125c411"
+        },
+        "OFTAdapters": {
+            "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb": "0x9151434b16b9763660705744891fa906f660ecc5"
         }
     }
 }