damm-sdk 1.4.24 → 1.4.26

package/dist/integrations/aaveV3/aave.v3.d.ts

@@ -76,5 +76,22 @@ export declare const repayToAaveV3Trx: <Asset = number | `0x${string}`>({ args,
     args: RepayAaveV3Args<Asset>;
     compact: boolean;
 }) => Unwrapable<Call>;
+export type SetUserEModeOnAaveV3Args = Readonly<{
+    categoryId: number;
+}>;
+export declare const SetUserEModeOnAaveV3Calldata: ({ categoryId }: SetUserEModeOnAaveV3Args) => HexString;
+export declare const setUserEModeOnAaveV3Trx: ({ poolAddress, args, }: {
+    poolAddress: Address;
+    args: SetUserEModeOnAaveV3Args;
+}) => Unwrapable<Call>;
+export type SetUserUseReserveAsCollateralOnAaveV3Args = Readonly<{
+    asset: Address;
+    useAsCollateral: boolean;
+}>;
+export declare const SetUserUseReserveAsCollateralOnAaveV3Calldata: ({ asset, useAsCollateral, }: SetUserUseReserveAsCollateralOnAaveV3Args) => HexString;
+export declare const setUserUseReserveAsCollateralOnAaveV3Trx: ({ poolAddress, args, }: {
+    poolAddress: Address;
+    args: SetUserUseReserveAsCollateralOnAaveV3Args;
+}) => Unwrapable<Call>;
 export {};
 //# sourceMappingURL=aave.v3.d.ts.map

package/dist/integrations/aaveV3/aave.v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aave.v3.d.ts","sourceRoot":"","sources":["../../../src/integrations/aaveV3/aave.v3.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aave.v3.d.ts","sourceRoot":"","sources":["../../../src/integrations/aaveV3/aave.v3.ts"],"names":[],"mappings":"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"}

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

@@ -44,11 +44,27 @@ export type EnsoRouteArgs = Readonly<{
      * string").
      */
     slippageBips: number;
-    /** Optional Enso API key for 10 rps; no key = 1 rps global limit. */
-    apiKey?: string;
+    /**
+     * Enso API key. **Required** to use this integration — calls without a
+     * key share a global 1 rps limit and fail often in production. Sign up
+     * at https://developers.enso.build.
+     *
+     * If this is falsy (undefined, empty string), `fetchEnsoRoute` throws
+     * `EnsoApiKeyMissingError` before hitting the network.
+     */
+    apiKey: string;
     /** Override the API base URL (useful for tests). */
     apiBase?: string;
 }>;
+/**
+ * Thrown when `fetchEnsoRoute` is called without an API key. Without a
+ * key the caller shares Enso's global 1 rps limit and will hit 429 in
+ * production — we fail fast so the misconfiguration shows up immediately
+ * in logs instead of after a long, confusing 429 trail.
+ */
+export declare class EnsoApiKeyMissingError extends Error {
+    constructor();
+}
 export declare class EnsoRouteApiError extends Error {
     readonly status: number;
     readonly statusText: string;

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

@@ -1 +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;IACH,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACxB,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"}
+{"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;IACH,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACxB,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;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAED,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,CA+CnF,CAAC"}

package/package.json

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

package/src/integrations/aaveV3/aave.v3.ts

@@ -241,3 +241,67 @@ export const repayToAaveV3Trx = <Asset = L1AaveV3AssetIdentifier | L2AaveV3Asset
         data,
     });
 };
+
+// ─── setUserEMode(uint8 categoryId) ─────────────────────────────────────
+//
+// E-Mode lets correlated assets (wstETH/ETH, stable/stable, etc.) enjoy
+// higher LTV and liquidation thresholds. categoryId 0 = exit E-Mode back
+// to the standard market. Same selector on L1 and L2 pools — no packed-
+// args variant needed.
+
+export type SetUserEModeOnAaveV3Args = Readonly<{
+    categoryId: number;
+}>;
+
+export const SetUserEModeOnAaveV3Calldata = ({ categoryId }: SetUserEModeOnAaveV3Args): HexString => {
+    return poolInterface_L1.encodeFunctionData("setUserEMode", [categoryId]) as HexString;
+};
+
+export const setUserEModeOnAaveV3Trx = ({
+    poolAddress,
+    args,
+}: {
+    poolAddress: Address;
+    args: SetUserEModeOnAaveV3Args;
+}): Unwrapable<Call> => {
+    return createCall({
+        operation: 0,
+        to: poolAddress,
+        value: 0n,
+        data: SetUserEModeOnAaveV3Calldata(args),
+    });
+};
+
+// ─── setUserUseReserveAsCollateral(address asset, bool useAsCollateral) ─
+//
+// Opts the supplied reserve into / out of counting as collateral for the
+// user's position. Required when the reserve's `usageAsCollateralEnabled`
+// is true but the user wants to explicitly toggle it (e.g., isolation
+// mode interactions). Same selector on L1 and L2.
+
+export type SetUserUseReserveAsCollateralOnAaveV3Args = Readonly<{
+    asset: Address;
+    useAsCollateral: boolean;
+}>;
+
+export const SetUserUseReserveAsCollateralOnAaveV3Calldata = ({
+    asset,
+    useAsCollateral,
+}: SetUserUseReserveAsCollateralOnAaveV3Args): HexString => {
+    return poolInterface_L1.encodeFunctionData("setUserUseReserveAsCollateral", [asset, useAsCollateral]) as HexString;
+};
+
+export const setUserUseReserveAsCollateralOnAaveV3Trx = ({
+    poolAddress,
+    args,
+}: {
+    poolAddress: Address;
+    args: SetUserUseReserveAsCollateralOnAaveV3Args;
+}): Unwrapable<Call> => {
+    return createCall({
+        operation: 0,
+        to: poolAddress,
+        value: 0n,
+        data: SetUserUseReserveAsCollateralOnAaveV3Calldata(args),
+    });
+};

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

@@ -48,12 +48,32 @@ export type EnsoRouteArgs = Readonly<{
      * string").
      */
     slippageBips: number;
-    /** Optional Enso API key for 10 rps; no key = 1 rps global limit. */
-    apiKey?: string;
+    /**
+     * Enso API key. **Required** to use this integration — calls without a
+     * key share a global 1 rps limit and fail often in production. Sign up
+     * at https://developers.enso.build.
+     *
+     * If this is falsy (undefined, empty string), `fetchEnsoRoute` throws
+     * `EnsoApiKeyMissingError` before hitting the network.
+     */
+    apiKey: string;
     /** Override the API base URL (useful for tests). */
     apiBase?: string;
 }>;
 
+/**
+ * Thrown when `fetchEnsoRoute` is called without an API key. Without a
+ * key the caller shares Enso's global 1 rps limit and will hit 429 in
+ * production — we fail fast so the misconfiguration shows up immediately
+ * in logs instead of after a long, confusing 429 trail.
+ */
+export class EnsoApiKeyMissingError extends Error {
+    constructor() {
+        super("Enso API key required; pass `apiKey`.");
+        this.name = "EnsoApiKeyMissingError";
+    }
+}
+
 export class EnsoRouteApiError extends Error {
     readonly status: number;
     readonly statusText: string;
@@ -99,6 +119,11 @@ export const fetchEnsoRoute = async (args: EnsoRouteArgs): Promise<EnsoRouteResp
         apiBase = ENSO_API_BASE,
     } = args;
 
+    // Fail fast if no API key — see EnsoApiKeyMissingError doc for rationale.
+    if (!apiKey) {
+        throw new EnsoApiKeyMissingError();
+    }
+
     const params = new URLSearchParams({
         chainId: String(chainId),
         fromAddress,
@@ -109,10 +134,10 @@ export const fetchEnsoRoute = async (args: EnsoRouteArgs): Promise<EnsoRouteResp
         slippage: String(slippageBips),
     });
 
-    const headers: Record<string, string> = { Accept: "application/json" };
-    if (apiKey) {
-        headers["Authorization"] = `Bearer ${apiKey}`;
-    }
+    const headers: Record<string, string> = {
+        Accept: "application/json",
+        Authorization: `Bearer ${apiKey}`,
+    };
 
     const response = await fetch(`${apiBase}/api/v1/shortcuts/route?${params.toString()}`, {
         headers,