@earnforge/sdk 0.1.0

package/dist/esm/index.d.mts

@@ -0,0 +1,2929 @@
+import { z } from "zod";
+
+//#region src/retry.d.ts
+interface RetryOptions {
+  maxRetries?: number;
+  baseDelay?: number;
+  maxDelay?: number;
+}
+/**
+ * Retry with exponential backoff on 429 / 5xx / network errors.
+ */
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+declare function isRetryable(error: unknown): boolean;
+//#endregion
+//#region src/schemas/vault.d.ts
+/** Protocol info — always has name + url */
+declare const ProtocolSchema: z.ZodObject<{
+  name: z.ZodString;
+  url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  url: string;
+}, {
+  name: string;
+  url: string;
+}>;
+/** Underlying token — symbol, address, decimals */
+declare const UnderlyingTokenSchema: z.ZodObject<{
+  symbol: z.ZodString;
+  address: z.ZodString;
+  decimals: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+  symbol: string;
+  address: string;
+  decimals: number;
+}, {
+  symbol: string;
+  address: string;
+  decimals: number;
+}>;
+/** Pack (deposit or redeem method) */
+declare const PackSchema: z.ZodObject<{
+  name: z.ZodString;
+  stepsType: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  stepsType: string;
+}, {
+  name: string;
+  stepsType: string;
+}>;
+/**
+ * APY — base and total always present.
+ * reward: Morpho returns 0, Euler/Aave return null. Normalize to 0.
+ * (Pitfall #17)
+ */
+declare const ApySchema: z.ZodObject<{
+  base: z.ZodNumber;
+  total: z.ZodNumber;
+  reward: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
+}, "strip", z.ZodTypeAny, {
+  base: number;
+  total: number;
+  reward: number;
+}, {
+  base: number;
+  total: number;
+  reward: number | null;
+}>;
+/**
+ * TVL — usd is always a string from the API.
+ * We parse it into { raw, parsed, bigint } at the boundary.
+ * (Pitfall #8)
+ */
+declare const TvlSchema: z.ZodObject<{
+  usd: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  usd: string;
+}, {
+  usd: string;
+}>;
+type TvlParsed = {
+  raw: string;
+  parsed: number;
+  bigint: bigint;
+};
+declare function parseTvl(tvl: z.infer<typeof TvlSchema>): TvlParsed;
+/**
+ * Analytics — apy1d, apy7d, apy30d can all be null.
+ * Fallback chain: apy.total → apy30d → apy7d → apy1d
+ * (Pitfalls #7, #18)
+ */
+declare const AnalyticsSchema: z.ZodObject<{
+  apy: z.ZodObject<{
+    base: z.ZodNumber;
+    total: z.ZodNumber;
+    reward: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
+  }, "strip", z.ZodTypeAny, {
+    base: number;
+    total: number;
+    reward: number;
+  }, {
+    base: number;
+    total: number;
+    reward: number | null;
+  }>;
+  tvl: z.ZodObject<{
+    usd: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    usd: string;
+  }, {
+    usd: string;
+  }>;
+  apy1d: z.ZodNullable<z.ZodNumber>;
+  apy7d: z.ZodNullable<z.ZodNumber>;
+  apy30d: z.ZodNullable<z.ZodNumber>;
+  updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  apy: {
+    base: number;
+    total: number;
+    reward: number;
+  };
+  tvl: {
+    usd: string;
+  };
+  apy1d: number | null;
+  apy7d: number | null;
+  apy30d: number | null;
+  updatedAt: string;
+}, {
+  apy: {
+    base: number;
+    total: number;
+    reward: number | null;
+  };
+  tvl: {
+    usd: string;
+  };
+  apy1d: number | null;
+  apy7d: number | null;
+  apy30d: number | null;
+  updatedAt: string;
+}>;
+/**
+ * Get best available APY with fallback chain.
+ * Order: apy.total → apy30d → apy7d → apy1d
+ */
+declare function getBestApy(analytics: z.infer<typeof AnalyticsSchema>): number;
+/**
+ * Vault schema — generated from real fixture (earn.li.fi, Apr 11 2026).
+ *
+ * Key edge cases handled:
+ * - description is optional (~14% of vaults have it) (Pitfall #16)
+ * - underlyingTokens can be empty array (Pitfall #15)
+ * - apy.reward null → 0 (Pitfall #17)
+ * - apy1d/apy7d/apy30d nullable (Pitfall #18)
+ * - tvl.usd is a string (Pitfall #8)
+ */
+declare const VaultSchema: z.ZodObject<{
+  address: z.ZodString;
+  chainId: z.ZodNumber;
+  name: z.ZodString;
+  slug: z.ZodString;
+  network: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  protocol: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    url: string;
+  }, {
+    name: string;
+    url: string;
+  }>;
+  provider: z.ZodString;
+  syncedAt: z.ZodString;
+  tags: z.ZodArray<z.ZodString, "many">;
+  underlyingTokens: z.ZodArray<z.ZodObject<{
+    symbol: z.ZodString;
+    address: z.ZodString;
+    decimals: z.ZodNumber;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    address: string;
+    decimals: number;
+  }, {
+    symbol: string;
+    address: string;
+    decimals: number;
+  }>, "many">;
+  lpTokens: z.ZodArray<z.ZodUnknown, "many">;
+  analytics: z.ZodObject<{
+    apy: z.ZodObject<{
+      base: z.ZodNumber;
+      total: z.ZodNumber;
+      reward: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
+    }, "strip", z.ZodTypeAny, {
+      base: number;
+      total: number;
+      reward: number;
+    }, {
+      base: number;
+      total: number;
+      reward: number | null;
+    }>;
+    tvl: z.ZodObject<{
+      usd: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      usd: string;
+    }, {
+      usd: string;
+    }>;
+    apy1d: z.ZodNullable<z.ZodNumber>;
+    apy7d: z.ZodNullable<z.ZodNumber>;
+    apy30d: z.ZodNullable<z.ZodNumber>;
+    updatedAt: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    apy: {
+      base: number;
+      total: number;
+      reward: number;
+    };
+    tvl: {
+      usd: string;
+    };
+    apy1d: number | null;
+    apy7d: number | null;
+    apy30d: number | null;
+    updatedAt: string;
+  }, {
+    apy: {
+      base: number;
+      total: number;
+      reward: number | null;
+    };
+    tvl: {
+      usd: string;
+    };
+    apy1d: number | null;
+    apy7d: number | null;
+    apy30d: number | null;
+    updatedAt: string;
+  }>;
+  isTransactional: z.ZodBoolean;
+  isRedeemable: z.ZodBoolean;
+  depositPacks: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    stepsType: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    stepsType: string;
+  }, {
+    name: string;
+    stepsType: string;
+  }>, "many">;
+  redeemPacks: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    stepsType: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    stepsType: string;
+  }, {
+    name: string;
+    stepsType: string;
+  }>, "many">;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  address: string;
+  chainId: number;
+  slug: string;
+  network: string;
+  protocol: {
+    name: string;
+    url: string;
+  };
+  provider: string;
+  syncedAt: string;
+  tags: string[];
+  underlyingTokens: {
+    symbol: string;
+    address: string;
+    decimals: number;
+  }[];
+  lpTokens: unknown[];
+  analytics: {
+    apy: {
+      base: number;
+      total: number;
+      reward: number;
+    };
+    tvl: {
+      usd: string;
+    };
+    apy1d: number | null;
+    apy7d: number | null;
+    apy30d: number | null;
+    updatedAt: string;
+  };
+  isTransactional: boolean;
+  isRedeemable: boolean;
+  depositPacks: {
+    name: string;
+    stepsType: string;
+  }[];
+  redeemPacks: {
+    name: string;
+    stepsType: string;
+  }[];
+  description?: string | undefined;
+}, {
+  name: string;
+  address: string;
+  chainId: number;
+  slug: string;
+  network: string;
+  protocol: {
+    name: string;
+    url: string;
+  };
+  provider: string;
+  syncedAt: string;
+  tags: string[];
+  underlyingTokens: {
+    symbol: string;
+    address: string;
+    decimals: number;
+  }[];
+  lpTokens: unknown[];
+  analytics: {
+    apy: {
+      base: number;
+      total: number;
+      reward: number | null;
+    };
+    tvl: {
+      usd: string;
+    };
+    apy1d: number | null;
+    apy7d: number | null;
+    apy30d: number | null;
+    updatedAt: string;
+  };
+  isTransactional: boolean;
+  isRedeemable: boolean;
+  depositPacks: {
+    name: string;
+    stepsType: string;
+  }[];
+  redeemPacks: {
+    name: string;
+    stepsType: string;
+  }[];
+  description?: string | undefined;
+}>;
+type Vault = z.infer<typeof VaultSchema>;
+/** Paginated vault list response */
+declare const VaultListResponseSchema: z.ZodObject<{
+  data: z.ZodArray<z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    name: z.ZodString;
+    slug: z.ZodString;
+    network: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodObject<{
+      name: z.ZodString;
+      url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      name: string;
+      url: string;
+    }, {
+      name: string;
+      url: string;
+    }>;
+    provider: z.ZodString;
+    syncedAt: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    underlyingTokens: z.ZodArray<z.ZodObject<{
+      symbol: z.ZodString;
+      address: z.ZodString;
+      decimals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }, {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }>, "many">;
+    lpTokens: z.ZodArray<z.ZodUnknown, "many">;
+    analytics: z.ZodObject<{
+      apy: z.ZodObject<{
+        base: z.ZodNumber;
+        total: z.ZodNumber;
+        reward: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
+      }, "strip", z.ZodTypeAny, {
+        base: number;
+        total: number;
+        reward: number;
+      }, {
+        base: number;
+        total: number;
+        reward: number | null;
+      }>;
+      tvl: z.ZodObject<{
+        usd: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        usd: string;
+      }, {
+        usd: string;
+      }>;
+      apy1d: z.ZodNullable<z.ZodNumber>;
+      apy7d: z.ZodNullable<z.ZodNumber>;
+      apy30d: z.ZodNullable<z.ZodNumber>;
+      updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      apy: {
+        base: number;
+        total: number;
+        reward: number;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    }, {
+      apy: {
+        base: number;
+        total: number;
+        reward: number | null;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    }>;
+    isTransactional: z.ZodBoolean;
+    isRedeemable: z.ZodBoolean;
+    depositPacks: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      stepsType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      name: string;
+      stepsType: string;
+    }, {
+      name: string;
+      stepsType: string;
+    }>, "many">;
+    redeemPacks: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      stepsType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      name: string;
+      stepsType: string;
+    }, {
+      name: string;
+      stepsType: string;
+    }>, "many">;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    address: string;
+    chainId: number;
+    slug: string;
+    network: string;
+    protocol: {
+      name: string;
+      url: string;
+    };
+    provider: string;
+    syncedAt: string;
+    tags: string[];
+    underlyingTokens: {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }[];
+    lpTokens: unknown[];
+    analytics: {
+      apy: {
+        base: number;
+        total: number;
+        reward: number;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    };
+    isTransactional: boolean;
+    isRedeemable: boolean;
+    depositPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    redeemPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    description?: string | undefined;
+  }, {
+    name: string;
+    address: string;
+    chainId: number;
+    slug: string;
+    network: string;
+    protocol: {
+      name: string;
+      url: string;
+    };
+    provider: string;
+    syncedAt: string;
+    tags: string[];
+    underlyingTokens: {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }[];
+    lpTokens: unknown[];
+    analytics: {
+      apy: {
+        base: number;
+        total: number;
+        reward: number | null;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    };
+    isTransactional: boolean;
+    isRedeemable: boolean;
+    depositPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    redeemPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    description?: string | undefined;
+  }>, "many">;
+  nextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+  total: number;
+  data: {
+    name: string;
+    address: string;
+    chainId: number;
+    slug: string;
+    network: string;
+    protocol: {
+      name: string;
+      url: string;
+    };
+    provider: string;
+    syncedAt: string;
+    tags: string[];
+    underlyingTokens: {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }[];
+    lpTokens: unknown[];
+    analytics: {
+      apy: {
+        base: number;
+        total: number;
+        reward: number;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    };
+    isTransactional: boolean;
+    isRedeemable: boolean;
+    depositPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    redeemPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    description?: string | undefined;
+  }[];
+  nextCursor?: string | null | undefined;
+}, {
+  total: number;
+  data: {
+    name: string;
+    address: string;
+    chainId: number;
+    slug: string;
+    network: string;
+    protocol: {
+      name: string;
+      url: string;
+    };
+    provider: string;
+    syncedAt: string;
+    tags: string[];
+    underlyingTokens: {
+      symbol: string;
+      address: string;
+      decimals: number;
+    }[];
+    lpTokens: unknown[];
+    analytics: {
+      apy: {
+        base: number;
+        total: number;
+        reward: number | null;
+      };
+      tvl: {
+        usd: string;
+      };
+      apy1d: number | null;
+      apy7d: number | null;
+      apy30d: number | null;
+      updatedAt: string;
+    };
+    isTransactional: boolean;
+    isRedeemable: boolean;
+    depositPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    redeemPacks: {
+      name: string;
+      stepsType: string;
+    }[];
+    description?: string | undefined;
+  }[];
+  nextCursor?: string | null | undefined;
+}>;
+type VaultListResponse = z.infer<typeof VaultListResponseSchema>;
+//#endregion
+//#region src/schemas/chain.d.ts
+/** Chain schema — from GET /v1/earn/chains */
+declare const ChainSchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  name: z.ZodString;
+  networkCaip: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  chainId: number;
+  networkCaip: string;
+}, {
+  name: string;
+  chainId: number;
+  networkCaip: string;
+}>;
+type Chain = z.infer<typeof ChainSchema>;
+declare const ChainListResponseSchema: z.ZodArray<z.ZodObject<{
+  chainId: z.ZodNumber;
+  name: z.ZodString;
+  networkCaip: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  chainId: number;
+  networkCaip: string;
+}, {
+  name: string;
+  chainId: number;
+  networkCaip: string;
+}>, "many">;
+//#endregion
+//#region src/schemas/protocol.d.ts
+/** Protocol schema — from GET /v1/earn/protocols */
+declare const ProtocolDetailSchema: z.ZodObject<{
+  name: z.ZodString;
+  url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  url: string;
+}, {
+  name: string;
+  url: string;
+}>;
+type ProtocolDetail = z.infer<typeof ProtocolDetailSchema>;
+declare const ProtocolListResponseSchema: z.ZodArray<z.ZodObject<{
+  name: z.ZodString;
+  url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  url: string;
+}, {
+  name: string;
+  url: string;
+}>, "many">;
+//#endregion
+//#region src/schemas/portfolio.d.ts
+/** Position asset */
+declare const PositionAssetSchema: z.ZodObject<{
+  address: z.ZodString;
+  name: z.ZodString;
+  symbol: z.ZodString;
+  decimals: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+  symbol: string;
+  name: string;
+  address: string;
+  decimals: number;
+}, {
+  symbol: string;
+  name: string;
+  address: string;
+  decimals: number;
+}>;
+/** Single portfolio position */
+declare const PositionSchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  protocolName: z.ZodString;
+  asset: z.ZodObject<{
+    address: z.ZodString;
+    name: z.ZodString;
+    symbol: z.ZodString;
+    decimals: z.ZodNumber;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+  }, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+  }>;
+  balanceUsd: z.ZodString;
+  balanceNative: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  chainId: number;
+  protocolName: string;
+  asset: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+  };
+  balanceUsd: string;
+  balanceNative: string;
+}, {
+  chainId: number;
+  protocolName: string;
+  asset: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+  };
+  balanceUsd: string;
+  balanceNative: string;
+}>;
+type Position = z.infer<typeof PositionSchema>;
+/** Portfolio response */
+declare const PortfolioResponseSchema: z.ZodObject<{
+  positions: z.ZodArray<z.ZodObject<{
+    chainId: z.ZodNumber;
+    protocolName: z.ZodString;
+    asset: z.ZodObject<{
+      address: z.ZodString;
+      name: z.ZodString;
+      symbol: z.ZodString;
+      decimals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    }, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    }>;
+    balanceUsd: z.ZodString;
+    balanceNative: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    chainId: number;
+    protocolName: string;
+    asset: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    };
+    balanceUsd: string;
+    balanceNative: string;
+  }, {
+    chainId: number;
+    protocolName: string;
+    asset: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    };
+    balanceUsd: string;
+    balanceNative: string;
+  }>, "many">;
+}, "strip", z.ZodTypeAny, {
+  positions: {
+    chainId: number;
+    protocolName: string;
+    asset: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    };
+    balanceUsd: string;
+    balanceNative: string;
+  }[];
+}, {
+  positions: {
+    chainId: number;
+    protocolName: string;
+    asset: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+    };
+    balanceUsd: string;
+    balanceNative: string;
+  }[];
+}>;
+type PortfolioResponse = z.infer<typeof PortfolioResponseSchema>;
+//#endregion
+//#region src/schemas/quote.d.ts
+/** Token info in Composer responses */
+declare const ComposerTokenSchema: z.ZodObject<{
+  address: z.ZodString;
+  chainId: z.ZodNumber;
+  symbol: z.ZodString;
+  decimals: z.ZodNumber;
+  name: z.ZodString;
+  coinKey: z.ZodOptional<z.ZodString>;
+  logoURI: z.ZodOptional<z.ZodString>;
+  priceUSD: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+  verificationStatus: z.ZodOptional<z.ZodString>;
+  verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+}, "strip", z.ZodTypeAny, {
+  symbol: string;
+  name: string;
+  address: string;
+  decimals: number;
+  chainId: number;
+  tags?: string[] | undefined;
+  coinKey?: string | undefined;
+  logoURI?: string | undefined;
+  priceUSD?: string | undefined;
+  verificationStatus?: string | undefined;
+  verificationStatusBreakdown?: unknown[] | undefined;
+}, {
+  symbol: string;
+  name: string;
+  address: string;
+  decimals: number;
+  chainId: number;
+  tags?: string[] | undefined;
+  coinKey?: string | undefined;
+  logoURI?: string | undefined;
+  priceUSD?: string | undefined;
+  verificationStatus?: string | undefined;
+  verificationStatusBreakdown?: unknown[] | undefined;
+}>;
+/** Tool details */
+declare const ToolDetailsSchema: z.ZodObject<{
+  key: z.ZodString;
+  name: z.ZodString;
+  logoURI: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  key: string;
+  logoURI?: string | undefined;
+}, {
+  name: string;
+  key: string;
+  logoURI?: string | undefined;
+}>;
+/** Fee split */
+declare const FeeSplitSchema: z.ZodObject<{
+  integratorFee: z.ZodString;
+  lifiFee: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  integratorFee: string;
+  lifiFee: string;
+}, {
+  integratorFee: string;
+  lifiFee: string;
+}>;
+/** Fee cost */
+declare const FeeCostSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  token: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    symbol: z.ZodString;
+    decimals: z.ZodNumber;
+    name: z.ZodString;
+    coinKey: z.ZodOptional<z.ZodString>;
+    logoURI: z.ZodOptional<z.ZodString>;
+    priceUSD: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    verificationStatus: z.ZodOptional<z.ZodString>;
+    verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }>;
+  amount: z.ZodString;
+  amountUSD: z.ZodString;
+  percentage: z.ZodString;
+  included: z.ZodBoolean;
+  feeSplit: z.ZodOptional<z.ZodObject<{
+    integratorFee: z.ZodString;
+    lifiFee: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    integratorFee: string;
+    lifiFee: string;
+  }, {
+    integratorFee: string;
+    lifiFee: string;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  name: string;
+  token: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  amount: string;
+  amountUSD: string;
+  percentage: string;
+  included: boolean;
+  description?: string | undefined;
+  feeSplit?: {
+    integratorFee: string;
+    lifiFee: string;
+  } | undefined;
+}, {
+  name: string;
+  token: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  amount: string;
+  amountUSD: string;
+  percentage: string;
+  included: boolean;
+  description?: string | undefined;
+  feeSplit?: {
+    integratorFee: string;
+    lifiFee: string;
+  } | undefined;
+}>;
+/** Gas cost */
+declare const GasCostSchema: z.ZodObject<{
+  type: z.ZodString;
+  price: z.ZodOptional<z.ZodString>;
+  estimate: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+  amount: z.ZodString;
+  amountUSD: z.ZodString;
+  token: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    symbol: z.ZodString;
+    decimals: z.ZodNumber;
+    name: z.ZodString;
+    coinKey: z.ZodOptional<z.ZodString>;
+    logoURI: z.ZodOptional<z.ZodString>;
+    priceUSD: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    verificationStatus: z.ZodOptional<z.ZodString>;
+    verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }>;
+}, "strip", z.ZodTypeAny, {
+  type: string;
+  token: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  amount: string;
+  amountUSD: string;
+  price?: string | undefined;
+  estimate?: string | undefined;
+  limit?: string | undefined;
+}, {
+  type: string;
+  token: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  amount: string;
+  amountUSD: string;
+  price?: string | undefined;
+  estimate?: string | undefined;
+  limit?: string | undefined;
+}>;
+/** Quote action */
+declare const QuoteActionSchema: z.ZodObject<{
+  fromToken: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    symbol: z.ZodString;
+    decimals: z.ZodNumber;
+    name: z.ZodString;
+    coinKey: z.ZodOptional<z.ZodString>;
+    logoURI: z.ZodOptional<z.ZodString>;
+    priceUSD: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    verificationStatus: z.ZodOptional<z.ZodString>;
+    verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }>;
+  fromAmount: z.ZodString;
+  toToken: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    symbol: z.ZodString;
+    decimals: z.ZodNumber;
+    name: z.ZodString;
+    coinKey: z.ZodOptional<z.ZodString>;
+    logoURI: z.ZodOptional<z.ZodString>;
+    priceUSD: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    verificationStatus: z.ZodOptional<z.ZodString>;
+    verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+  }, "strip", z.ZodTypeAny, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }, {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  }>;
+  fromChainId: z.ZodNumber;
+  toChainId: z.ZodNumber;
+  slippage: z.ZodNumber;
+  fromAddress: z.ZodString;
+  toAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+  fromToken: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  fromAmount: string;
+  toToken: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  fromChainId: number;
+  toChainId: number;
+  slippage: number;
+  fromAddress: string;
+  toAddress: string;
+}, {
+  fromToken: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  fromAmount: string;
+  toToken: {
+    symbol: string;
+    name: string;
+    address: string;
+    decimals: number;
+    chainId: number;
+    tags?: string[] | undefined;
+    coinKey?: string | undefined;
+    logoURI?: string | undefined;
+    priceUSD?: string | undefined;
+    verificationStatus?: string | undefined;
+    verificationStatusBreakdown?: unknown[] | undefined;
+  };
+  fromChainId: number;
+  toChainId: number;
+  slippage: number;
+  fromAddress: string;
+  toAddress: string;
+}>;
+/** Quote estimate */
+declare const QuoteEstimateSchema: z.ZodObject<{
+  tool: z.ZodString;
+  approvalAddress: z.ZodOptional<z.ZodString>;
+  toAmountMin: z.ZodString;
+  toAmount: z.ZodString;
+  fromAmount: z.ZodString;
+  feeCosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    token: z.ZodObject<{
+      address: z.ZodString;
+      chainId: z.ZodNumber;
+      symbol: z.ZodString;
+      decimals: z.ZodNumber;
+      name: z.ZodString;
+      coinKey: z.ZodOptional<z.ZodString>;
+      logoURI: z.ZodOptional<z.ZodString>;
+      priceUSD: z.ZodOptional<z.ZodString>;
+      tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+      verificationStatus: z.ZodOptional<z.ZodString>;
+      verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }>;
+    amount: z.ZodString;
+    amountUSD: z.ZodString;
+    percentage: z.ZodString;
+    included: z.ZodBoolean;
+    feeSplit: z.ZodOptional<z.ZodObject<{
+      integratorFee: z.ZodString;
+      lifiFee: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      integratorFee: string;
+      lifiFee: string;
+    }, {
+      integratorFee: string;
+      lifiFee: string;
+    }>>;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    percentage: string;
+    included: boolean;
+    description?: string | undefined;
+    feeSplit?: {
+      integratorFee: string;
+      lifiFee: string;
+    } | undefined;
+  }, {
+    name: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    percentage: string;
+    included: boolean;
+    description?: string | undefined;
+    feeSplit?: {
+      integratorFee: string;
+      lifiFee: string;
+    } | undefined;
+  }>, "many">>;
+  gasCosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    price: z.ZodOptional<z.ZodString>;
+    estimate: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    amount: z.ZodString;
+    amountUSD: z.ZodString;
+    token: z.ZodObject<{
+      address: z.ZodString;
+      chainId: z.ZodNumber;
+      symbol: z.ZodString;
+      decimals: z.ZodNumber;
+      name: z.ZodString;
+      coinKey: z.ZodOptional<z.ZodString>;
+      logoURI: z.ZodOptional<z.ZodString>;
+      priceUSD: z.ZodOptional<z.ZodString>;
+      tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+      verificationStatus: z.ZodOptional<z.ZodString>;
+      verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }>;
+  }, "strip", z.ZodTypeAny, {
+    type: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    price?: string | undefined;
+    estimate?: string | undefined;
+    limit?: string | undefined;
+  }, {
+    type: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    price?: string | undefined;
+    estimate?: string | undefined;
+    limit?: string | undefined;
+  }>, "many">>;
+  executionDuration: z.ZodNumber;
+  fromAmountUSD: z.ZodOptional<z.ZodString>;
+  toAmountUSD: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  fromAmount: string;
+  tool: string;
+  toAmountMin: string;
+  toAmount: string;
+  executionDuration: number;
+  approvalAddress?: string | undefined;
+  feeCosts?: {
+    name: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    percentage: string;
+    included: boolean;
+    description?: string | undefined;
+    feeSplit?: {
+      integratorFee: string;
+      lifiFee: string;
+    } | undefined;
+  }[] | undefined;
+  gasCosts?: {
+    type: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    price?: string | undefined;
+    estimate?: string | undefined;
+    limit?: string | undefined;
+  }[] | undefined;
+  fromAmountUSD?: string | undefined;
+  toAmountUSD?: string | undefined;
+}, {
+  fromAmount: string;
+  tool: string;
+  toAmountMin: string;
+  toAmount: string;
+  executionDuration: number;
+  approvalAddress?: string | undefined;
+  feeCosts?: {
+    name: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    percentage: string;
+    included: boolean;
+    description?: string | undefined;
+    feeSplit?: {
+      integratorFee: string;
+      lifiFee: string;
+    } | undefined;
+  }[] | undefined;
+  gasCosts?: {
+    type: string;
+    token: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    amount: string;
+    amountUSD: string;
+    price?: string | undefined;
+    estimate?: string | undefined;
+    limit?: string | undefined;
+  }[] | undefined;
+  fromAmountUSD?: string | undefined;
+  toAmountUSD?: string | undefined;
+}>;
+/** Transaction request — ready to sign */
+declare const TransactionRequestSchema: z.ZodObject<{
+  to: z.ZodString;
+  data: z.ZodString;
+  value: z.ZodString;
+  chainId: z.ZodNumber;
+  gasPrice: z.ZodOptional<z.ZodString>;
+  gasLimit: z.ZodOptional<z.ZodString>;
+  from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  value: string;
+  chainId: number;
+  data: string;
+  to: string;
+  gasPrice?: string | undefined;
+  gasLimit?: string | undefined;
+  from?: string | undefined;
+}, {
+  value: string;
+  chainId: number;
+  data: string;
+  to: string;
+  gasPrice?: string | undefined;
+  gasLimit?: string | undefined;
+  from?: string | undefined;
+}>;
+type TransactionRequest = z.infer<typeof TransactionRequestSchema>;
+/** Included step */
+declare const IncludedStepSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+  tool: z.ZodString;
+  toolDetails: z.ZodOptional<z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    logoURI: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  }, {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  }>>;
+  action: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  estimate: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+  type: string;
+  estimate: Record<string, unknown>;
+  tool: string;
+  id: string;
+  action: Record<string, unknown>;
+  toolDetails?: {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  } | undefined;
+}, {
+  type: string;
+  estimate: Record<string, unknown>;
+  tool: string;
+  id: string;
+  action: Record<string, unknown>;
+  toolDetails?: {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  } | undefined;
+}>;
+/** Full Composer quote response */
+declare const QuoteResponseSchema: z.ZodObject<{
+  type: z.ZodString;
+  id: z.ZodString;
+  tool: z.ZodString;
+  toolDetails: z.ZodOptional<z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    logoURI: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  }, {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  }>>;
+  action: z.ZodObject<{
+    fromToken: z.ZodObject<{
+      address: z.ZodString;
+      chainId: z.ZodNumber;
+      symbol: z.ZodString;
+      decimals: z.ZodNumber;
+      name: z.ZodString;
+      coinKey: z.ZodOptional<z.ZodString>;
+      logoURI: z.ZodOptional<z.ZodString>;
+      priceUSD: z.ZodOptional<z.ZodString>;
+      tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+      verificationStatus: z.ZodOptional<z.ZodString>;
+      verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }>;
+    fromAmount: z.ZodString;
+    toToken: z.ZodObject<{
+      address: z.ZodString;
+      chainId: z.ZodNumber;
+      symbol: z.ZodString;
+      decimals: z.ZodNumber;
+      name: z.ZodString;
+      coinKey: z.ZodOptional<z.ZodString>;
+      logoURI: z.ZodOptional<z.ZodString>;
+      priceUSD: z.ZodOptional<z.ZodString>;
+      tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+      verificationStatus: z.ZodOptional<z.ZodString>;
+      verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }, {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    }>;
+    fromChainId: z.ZodNumber;
+    toChainId: z.ZodNumber;
+    slippage: z.ZodNumber;
+    fromAddress: z.ZodString;
+    toAddress: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    fromToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromAmount: string;
+    toToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromChainId: number;
+    toChainId: number;
+    slippage: number;
+    fromAddress: string;
+    toAddress: string;
+  }, {
+    fromToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromAmount: string;
+    toToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromChainId: number;
+    toChainId: number;
+    slippage: number;
+    fromAddress: string;
+    toAddress: string;
+  }>;
+  estimate: z.ZodObject<{
+    tool: z.ZodString;
+    approvalAddress: z.ZodOptional<z.ZodString>;
+    toAmountMin: z.ZodString;
+    toAmount: z.ZodString;
+    fromAmount: z.ZodString;
+    feeCosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      token: z.ZodObject<{
+        address: z.ZodString;
+        chainId: z.ZodNumber;
+        symbol: z.ZodString;
+        decimals: z.ZodNumber;
+        name: z.ZodString;
+        coinKey: z.ZodOptional<z.ZodString>;
+        logoURI: z.ZodOptional<z.ZodString>;
+        priceUSD: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        verificationStatus: z.ZodOptional<z.ZodString>;
+        verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+      }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      }, {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      }>;
+      amount: z.ZodString;
+      amountUSD: z.ZodString;
+      percentage: z.ZodString;
+      included: z.ZodBoolean;
+      feeSplit: z.ZodOptional<z.ZodObject<{
+        integratorFee: z.ZodString;
+        lifiFee: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        integratorFee: string;
+        lifiFee: string;
+      }, {
+        integratorFee: string;
+        lifiFee: string;
+      }>>;
+    }, "strip", z.ZodTypeAny, {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }, {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }>, "many">>;
+    gasCosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      price: z.ZodOptional<z.ZodString>;
+      estimate: z.ZodOptional<z.ZodString>;
+      limit: z.ZodOptional<z.ZodString>;
+      amount: z.ZodString;
+      amountUSD: z.ZodString;
+      token: z.ZodObject<{
+        address: z.ZodString;
+        chainId: z.ZodNumber;
+        symbol: z.ZodString;
+        decimals: z.ZodNumber;
+        name: z.ZodString;
+        coinKey: z.ZodOptional<z.ZodString>;
+        logoURI: z.ZodOptional<z.ZodString>;
+        priceUSD: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        verificationStatus: z.ZodOptional<z.ZodString>;
+        verificationStatusBreakdown: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+      }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      }, {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      }>;
+    }, "strip", z.ZodTypeAny, {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }, {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }>, "many">>;
+    executionDuration: z.ZodNumber;
+    fromAmountUSD: z.ZodOptional<z.ZodString>;
+    toAmountUSD: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    fromAmount: string;
+    tool: string;
+    toAmountMin: string;
+    toAmount: string;
+    executionDuration: number;
+    approvalAddress?: string | undefined;
+    feeCosts?: {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }[] | undefined;
+    gasCosts?: {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }[] | undefined;
+    fromAmountUSD?: string | undefined;
+    toAmountUSD?: string | undefined;
+  }, {
+    fromAmount: string;
+    tool: string;
+    toAmountMin: string;
+    toAmount: string;
+    executionDuration: number;
+    approvalAddress?: string | undefined;
+    feeCosts?: {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }[] | undefined;
+    gasCosts?: {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }[] | undefined;
+    fromAmountUSD?: string | undefined;
+    toAmountUSD?: string | undefined;
+  }>;
+  includedSteps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    tool: z.ZodString;
+    toolDetails: z.ZodOptional<z.ZodObject<{
+      key: z.ZodString;
+      name: z.ZodString;
+      logoURI: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    }, {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    }>>;
+    action: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    estimate: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, "strip", z.ZodTypeAny, {
+    type: string;
+    estimate: Record<string, unknown>;
+    tool: string;
+    id: string;
+    action: Record<string, unknown>;
+    toolDetails?: {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    } | undefined;
+  }, {
+    type: string;
+    estimate: Record<string, unknown>;
+    tool: string;
+    id: string;
+    action: Record<string, unknown>;
+    toolDetails?: {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    } | undefined;
+  }>, "many">>;
+  integrator: z.ZodOptional<z.ZodString>;
+  transactionRequest: z.ZodObject<{
+    to: z.ZodString;
+    data: z.ZodString;
+    value: z.ZodString;
+    chainId: z.ZodNumber;
+    gasPrice: z.ZodOptional<z.ZodString>;
+    gasLimit: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    value: string;
+    chainId: number;
+    data: string;
+    to: string;
+    gasPrice?: string | undefined;
+    gasLimit?: string | undefined;
+    from?: string | undefined;
+  }, {
+    value: string;
+    chainId: number;
+    data: string;
+    to: string;
+    gasPrice?: string | undefined;
+    gasLimit?: string | undefined;
+    from?: string | undefined;
+  }>;
+  transactionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  type: string;
+  estimate: {
+    fromAmount: string;
+    tool: string;
+    toAmountMin: string;
+    toAmount: string;
+    executionDuration: number;
+    approvalAddress?: string | undefined;
+    feeCosts?: {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }[] | undefined;
+    gasCosts?: {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }[] | undefined;
+    fromAmountUSD?: string | undefined;
+    toAmountUSD?: string | undefined;
+  };
+  tool: string;
+  id: string;
+  action: {
+    fromToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromAmount: string;
+    toToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromChainId: number;
+    toChainId: number;
+    slippage: number;
+    fromAddress: string;
+    toAddress: string;
+  };
+  transactionRequest: {
+    value: string;
+    chainId: number;
+    data: string;
+    to: string;
+    gasPrice?: string | undefined;
+    gasLimit?: string | undefined;
+    from?: string | undefined;
+  };
+  toolDetails?: {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  } | undefined;
+  includedSteps?: {
+    type: string;
+    estimate: Record<string, unknown>;
+    tool: string;
+    id: string;
+    action: Record<string, unknown>;
+    toolDetails?: {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    } | undefined;
+  }[] | undefined;
+  integrator?: string | undefined;
+  transactionId?: string | undefined;
+}, {
+  type: string;
+  estimate: {
+    fromAmount: string;
+    tool: string;
+    toAmountMin: string;
+    toAmount: string;
+    executionDuration: number;
+    approvalAddress?: string | undefined;
+    feeCosts?: {
+      name: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      percentage: string;
+      included: boolean;
+      description?: string | undefined;
+      feeSplit?: {
+        integratorFee: string;
+        lifiFee: string;
+      } | undefined;
+    }[] | undefined;
+    gasCosts?: {
+      type: string;
+      token: {
+        symbol: string;
+        name: string;
+        address: string;
+        decimals: number;
+        chainId: number;
+        tags?: string[] | undefined;
+        coinKey?: string | undefined;
+        logoURI?: string | undefined;
+        priceUSD?: string | undefined;
+        verificationStatus?: string | undefined;
+        verificationStatusBreakdown?: unknown[] | undefined;
+      };
+      amount: string;
+      amountUSD: string;
+      price?: string | undefined;
+      estimate?: string | undefined;
+      limit?: string | undefined;
+    }[] | undefined;
+    fromAmountUSD?: string | undefined;
+    toAmountUSD?: string | undefined;
+  };
+  tool: string;
+  id: string;
+  action: {
+    fromToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromAmount: string;
+    toToken: {
+      symbol: string;
+      name: string;
+      address: string;
+      decimals: number;
+      chainId: number;
+      tags?: string[] | undefined;
+      coinKey?: string | undefined;
+      logoURI?: string | undefined;
+      priceUSD?: string | undefined;
+      verificationStatus?: string | undefined;
+      verificationStatusBreakdown?: unknown[] | undefined;
+    };
+    fromChainId: number;
+    toChainId: number;
+    slippage: number;
+    fromAddress: string;
+    toAddress: string;
+  };
+  transactionRequest: {
+    value: string;
+    chainId: number;
+    data: string;
+    to: string;
+    gasPrice?: string | undefined;
+    gasLimit?: string | undefined;
+    from?: string | undefined;
+  };
+  toolDetails?: {
+    name: string;
+    key: string;
+    logoURI?: string | undefined;
+  } | undefined;
+  includedSteps?: {
+    type: string;
+    estimate: Record<string, unknown>;
+    tool: string;
+    id: string;
+    action: Record<string, unknown>;
+    toolDetails?: {
+      name: string;
+      key: string;
+      logoURI?: string | undefined;
+    } | undefined;
+  }[] | undefined;
+  integrator?: string | undefined;
+  transactionId?: string | undefined;
+}>;
+type QuoteResponse = z.infer<typeof QuoteResponseSchema>;
+//#endregion
+//#region src/clients/earn-data-client.d.ts
+interface EarnDataClientOptions {
+  baseUrl?: string;
+  cache?: {
+    ttl?: number;
+    maxSize?: number;
+  };
+  rateLimiter?: {
+    maxPerMinute?: number;
+  };
+  retry?: RetryOptions;
+}
+interface VaultListParams {
+  chainId?: number;
+  asset?: string;
+  minTvl?: number;
+  sortBy?: string;
+  cursor?: string;
+}
+declare class EarnDataClient {
+  private readonly baseUrl;
+  private readonly cache;
+  private readonly rateLimiter;
+  private readonly retryOpts;
+  constructor(options?: EarnDataClientOptions);
+  /**
+   * Low-level fetch with rate limiting, caching, retry.
+   * No auth header — Earn Data API is public (Pitfall #2).
+   */
+  private fetch;
+  /** Fetch a single page of vaults */
+  listVaults(params?: VaultListParams): Promise<VaultListResponse>;
+  /**
+   * Async iterator for all vaults with auto-pagination via nextCursor.
+   * Page size is 50 (API default).
+   * (Pitfall #6)
+   */
+  listAllVaults(params?: Omit<VaultListParams, 'cursor'>): AsyncIterable<Vault>;
+  /**
+   * Get a single vault by chainId + address.
+   * chainId MUST be a number, not chain name (Pitfall — /vaults/Base/0x... returns 400).
+   */
+  getVault(chainId: number, address: string): Promise<Vault>;
+  /** Get a vault by slug (e.g., "8453-0xbeef...") */
+  getVaultBySlug(slug: string): Promise<Vault>;
+  /** List supported chains */
+  listChains(): Promise<Chain[]>;
+  /** List supported protocols */
+  listProtocols(): Promise<ProtocolDetail[]>;
+  /** Get portfolio positions for a wallet */
+  getPortfolio(walletAddress: string): Promise<PortfolioResponse>;
+  /** Rate limiter remaining tokens */
+  get rateLimitRemaining(): number;
+  /** Clear cache */
+  clearCache(): void;
+}
+//#endregion
+//#region src/clients/composer-client.d.ts
+interface ComposerClientOptions {
+  apiKey: string;
+  baseUrl?: string;
+  retry?: RetryOptions;
+}
+interface QuoteParams {
+  fromChain: number;
+  toChain: number;
+  fromToken: string;
+  toToken: string;
+  fromAddress: string;
+  toAddress: string;
+  fromAmount: string;
+  slippage?: number;
+  fromAmountForGas?: string;
+}
+declare class ComposerClient {
+  private readonly baseUrl;
+  private readonly apiKey;
+  private readonly retryOpts;
+  constructor(options: ComposerClientOptions);
+  /**
+   * Get a deposit/swap/bridge quote.
+   * Uses GET, not POST (Pitfall #4).
+   * Sends x-lifi-api-key header (Pitfall #3).
+   */
+  getQuote(params: QuoteParams): Promise<QuoteResponse>;
+}
+//#endregion
+//#region src/build-deposit-quote.d.ts
+interface DepositQuoteOptions {
+  fromAmount: string;
+  wallet: string;
+  fromToken?: string;
+  fromChain?: number;
+  slippage?: number;
+  fromAmountForGas?: string;
+}
+interface DepositQuoteResult {
+  quote: QuoteResponse;
+  vault: Vault;
+  humanAmount: string;
+  rawAmount: string;
+  decimals: number;
+}
+/**
+ * Build a deposit quote with all 18 pitfalls handled:
+ *
+ * - toToken = vault.address (Pitfall #5)
+ * - Uses correct decimals from underlyingTokens (Pitfall #9)
+ * - Validates isTransactional (Pitfall #13)
+ * - Validates underlyingTokens is non-empty (Pitfall #15)
+ * - GET request via ComposerClient (Pitfall #4)
+ * - API key in header via ComposerClient (Pitfall #3)
+ */
+declare function buildDepositQuote(vault: Vault, options: DepositQuoteOptions, composer: ComposerClient): Promise<DepositQuoteResult>;
+/**
+ * Convert a human-readable amount to the smallest unit.
+ * e.g., "1" with 6 decimals → "1000000" (Pitfall #9)
+ */
+declare function toSmallestUnit(amount: string, decimals: number): string;
+/**
+ * Convert smallest unit to human-readable amount.
+ */
+declare function fromSmallestUnit(rawAmount: string, decimals: number): string;
+//#endregion
+//#region src/build-redeem-quote.d.ts
+interface RedeemQuoteOptions {
+  /** Amount of vault tokens to redeem (human-readable) */
+  fromAmount: string;
+  wallet: string;
+  /** Token to receive. Defaults to underlying token on vault chain. */
+  toToken?: string;
+  /** Destination chain. Defaults to vault chain. */
+  toChain?: number;
+  slippage?: number;
+}
+interface RedeemQuoteResult {
+  quote: QuoteResponse;
+  vault: Vault;
+  humanAmount: string;
+  rawAmount: string;
+}
+/**
+ * Build a withdrawal/redeem quote.
+ *
+ * Withdrawal is the reverse of deposit:
+ * - fromToken = vault.address (the vault share token)
+ * - toToken = underlying token address (what you get back)
+ *
+ * Uses the same Composer /v1/quote endpoint — just swapped tokens.
+ */
+declare function buildRedeemQuote(vault: Vault, options: RedeemQuoteOptions, composer: ComposerClient): Promise<RedeemQuoteResult>;
+//#endregion
+//#region src/errors.d.ts
+declare class EarnForgeError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string);
+}
+declare class EarnApiError extends EarnForgeError {
+  readonly status: number;
+  readonly url: string;
+  constructor(message: string, status: number, url: string);
+}
+declare class ComposerError extends EarnForgeError {
+  readonly status: number;
+  constructor(message: string, status: number);
+}
+declare class PreflightError extends EarnForgeError {
+  readonly issues: PreflightIssue[];
+  constructor(message: string, issues: PreflightIssue[]);
+}
+declare class RateLimitError extends EarnForgeError {
+  readonly retryAfter: number;
+  constructor(retryAfter: number);
+}
+interface PreflightIssue {
+  code: string;
+  message: string;
+  severity: 'error' | 'warning';
+}
+//#endregion
+//#region src/rate-limiter.d.ts
+/**
+ * Token-bucket rate limiter with queued async acquisition.
+ * Default: 100 requests per minute for Earn Data API (Pitfall #14).
+ */
+declare class TokenBucketRateLimiter {
+  private tokens;
+  private lastRefill;
+  private readonly maxTokens;
+  private readonly refillRate;
+  private _queue;
+  constructor(maxRequestsPerMinute?: number);
+  private refill;
+  acquire(): void;
+  /**
+   * Queued async acquire — serializes concurrent callers to prevent
+   * race conditions where multiple callers pass the token check simultaneously.
+   */
+  acquireAsync(): Promise<void>;
+  private _acquireInternal;
+  get remaining(): number;
+}
+//#endregion
+//#region src/cache.d.ts
+/**
+ * In-memory LRU cache with configurable TTL.
+ * Evicts least-recently-used entries when capacity is reached.
+ */
+declare class LRUCache<T> {
+  private readonly map;
+  private readonly maxSize;
+  private readonly ttl;
+  constructor(options?: {
+    maxSize?: number;
+    ttl?: number;
+  });
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  has(key: string): boolean;
+  clear(): void;
+  get size(): number;
+}
+//#endregion
+//#region src/preflight.d.ts
+interface PreflightReport {
+  ok: boolean;
+  issues: PreflightIssue[];
+  vault: Vault;
+  wallet: string;
+}
+interface PreflightOptions {
+  walletChainId?: number;
+  nativeBalance?: bigint;
+  tokenBalance?: bigint;
+  tokenDecimals?: number;
+  depositAmount?: string;
+  /** If true, cross-chain deposit is intended — skip chain mismatch error */
+  crossChain?: boolean;
+}
+/**
+ * Run preflight checks before a deposit:
+ * - isTransactional check (Pitfall #13)
+ * - Chain mismatch check (Pitfall #12) — warning for cross-chain, error for same-chain
+ * - Gas token balance check (Pitfall #11)
+ * - Token balance check (uses string-based toSmallestUnit to avoid float precision loss)
+ * - underlyingTokens existence (Pitfall #15)
+ * - isRedeemable warning
+ */
+declare function preflight(vault: Vault, wallet: string, options?: PreflightOptions): PreflightReport;
+//#endregion
+//#region src/risk-scorer.d.ts
+interface RiskBreakdown {
+  tvl: number;
+  apyStability: number;
+  protocol: number;
+  redeemability: number;
+  assetType: number;
+}
+interface RiskScore {
+  score: number;
+  breakdown: RiskBreakdown;
+  label: 'low' | 'medium' | 'high';
+}
+/**
+ * Compute a composite 0–10 risk score for a vault.
+ *
+ * Dimensions:
+ * - TVL magnitude: higher TVL = lower risk
+ * - APY stability: small divergence between apy1d/apy30d/total = more stable
+ * - Protocol maturity: known blue-chip protocols score higher
+ * - Redeemability: non-redeemable = liquidity risk
+ * - Asset type: stablecoin tag = lower asset risk
+ */
+declare function riskScore(vault: Vault): RiskScore;
+//#endregion
+//#region src/strategies.d.ts
+type StrategyPreset = 'conservative' | 'max-apy' | 'diversified' | 'risk-adjusted';
+interface StrategyConfig {
+  name: StrategyPreset;
+  description: string;
+  filters: Partial<VaultListParams> & {
+    minTvlUsd?: number;
+    tags?: string[];
+    protocols?: string[];
+    minRiskScore?: number;
+  };
+  sort: 'apy' | 'tvl' | 'risk';
+  sortDirection: 'asc' | 'desc';
+}
+declare const STRATEGIES: Record<StrategyPreset, StrategyConfig>;
+declare function getStrategy(preset: StrategyPreset): StrategyConfig;
+//#endregion
+//#region src/suggest.d.ts
+interface SuggestParams {
+  amount: number;
+  asset?: string;
+  maxChains?: number;
+  strategy?: StrategyPreset;
+  maxVaults?: number;
+}
+interface Allocation {
+  vault: Vault;
+  risk: RiskScore;
+  percentage: number;
+  amount: number;
+  apy: number;
+}
+interface SuggestResult {
+  totalAmount: number;
+  expectedApy: number;
+  allocations: Allocation[];
+}
+/**
+ * Portfolio allocation engine.
+ * Uses a risk-adjusted score: score = apy / (11 - riskScore)
+ * to weight allocations proportionally.
+ * Enforces maxChains diversification constraint.
+ */
+declare function suggest(vaults: Vault[], params: SuggestParams): SuggestResult;
+//#endregion
+//#region src/gas-optimizer.d.ts
+interface GasRoute {
+  fromChain: number;
+  fromChainName: string;
+  quote: QuoteResponse;
+  totalCostUsd: number;
+  gasCostUsd: number;
+  feeCostUsd: number;
+  executionDuration: number;
+}
+interface GasOptimizeOptions {
+  fromAmount: string;
+  wallet: string;
+  /** Token address on the vault's chain (used for same-chain route) */
+  fromToken?: string;
+  /** Map of chainId → token address for cross-chain routes */
+  fromTokens?: Record<number, string>;
+  fromChains?: number[];
+  fromAmountForGas?: string;
+}
+/**
+ * Compare deposit routes from multiple source chains.
+ * Returns routes sorted by total cost (cheapest first).
+ * Integrates LI.Fuel via fromAmountForGas parameter.
+ */
+declare function optimizeGasRoutes(vault: Vault, composer: ComposerClient, options: GasOptimizeOptions): Promise<GasRoute[]>;
+//#endregion
+//#region src/watch.d.ts
+interface WatchOptions {
+  apyDropPercent?: number;
+  tvlDropPercent?: number;
+  interval?: number;
+  /** AbortSignal to cancel the watcher */
+  signal?: AbortSignal;
+  /** Maximum number of iterations (0 = unlimited) */
+  maxIterations?: number;
+}
+type WatchEventType = 'apy-drop' | 'tvl-drop' | 'update';
+interface WatchEvent {
+  type: WatchEventType;
+  vault: Vault;
+  previous: {
+    apy: number;
+    tvlUsd: number;
+  } | null;
+  current: {
+    apy: number;
+    tvlUsd: number;
+  };
+  timestamp: Date;
+}
+/**
+ * Watch a vault for APY/TVL changes.
+ * Returns an AsyncGenerator that yields events.
+ * Supports cancellation via AbortSignal and maxIterations.
+ */
+declare function watch(client: EarnDataClient, vaultSlug: string, options?: WatchOptions): AsyncGenerator<WatchEvent>;
+//#endregion
+//#region src/apy-history.d.ts
+interface ApyDataPoint {
+  timestamp: string;
+  apy: number;
+  tvlUsd: number;
+}
+/**
+ * Fetch 30-day APY history from DeFiLlama's free yields API.
+ *
+ * Properly matches LI.FI vaults to DeFiLlama pools using:
+ * project name + chain + underlying tokens + symbol + TVL proximity.
+ *
+ * Caches the 10MB+ pools list for 1 hour to avoid repeated fetches.
+ */
+declare function getApyHistory(vault: Vault): Promise<ApyDataPoint[]>;
+declare function getApyHistory(vaultAddress: string, chainId: number): Promise<ApyDataPoint[]>;
+//#endregion
+//#region src/allowance.d.ts
+/**
+ * ERC-20 allowance checking and approval transaction building.
+ *
+ * Uses the standard ERC-20 ABI for allowance() and approve().
+ * Works with any EVM JSON-RPC provider via raw fetch — no viem dependency required.
+ * The approval address comes from the Composer quote's estimate.approvalAddress.
+ */
+interface AllowanceResult {
+  allowance: bigint;
+  sufficient: boolean;
+  requiredAmount: bigint;
+}
+interface ApprovalTx {
+  to: string;
+  data: string;
+  value: '0x0';
+  chainId: number;
+}
+/**
+ * Check the ERC-20 allowance for a token.
+ *
+ * @param rpcUrl - JSON-RPC endpoint for the chain
+ * @param tokenAddress - ERC-20 token contract address
+ * @param owner - Wallet address (token holder)
+ * @param spender - Address to check allowance for (from quote.estimate.approvalAddress)
+ * @param requiredAmount - Amount needed in smallest unit
+ */
+declare function checkAllowance(rpcUrl: string, tokenAddress: string, owner: string, spender: string, requiredAmount: bigint): Promise<AllowanceResult>;
+/**
+ * Build an ERC-20 approve transaction.
+ *
+ * @param tokenAddress - ERC-20 token contract
+ * @param spender - Address to approve (from quote.estimate.approvalAddress)
+ * @param amount - Amount to approve in smallest unit (use MaxUint256 for unlimited)
+ * @param chainId - Chain ID for the transaction
+ */
+declare function buildApprovalTx(tokenAddress: string, spender: string, amount: bigint, chainId: number): ApprovalTx;
+/** MaxUint256 for unlimited approval */
+declare const MAX_UINT256: bigint;
+//#endregion
+//#region src/index.d.ts
+interface EarnForgeOptions {
+  composerApiKey?: string;
+  earnData?: EarnDataClientOptions;
+  composerBaseUrl?: string;
+  cache?: {
+    ttl?: number;
+    maxSize?: number;
+  };
+}
+interface EarnForge {
+  vaults: {
+    list: (params?: VaultListQueryParams) => Promise<VaultListResponse>;
+    listAll: (params?: Omit<VaultListQueryParams, 'cursor'>) => AsyncIterable<Vault>;
+    get: (slug: string) => Promise<Vault>;
+    top: (params?: TopVaultsParams) => Promise<Vault[]>;
+  };
+  chains: {
+    list: () => Promise<Chain[]>;
+  };
+  protocols: {
+    list: () => Promise<ProtocolDetail[]>;
+  };
+  portfolio: {
+    get: (wallet: string) => Promise<PortfolioResponse>;
+  };
+  buildDepositQuote: (vault: Vault, options: DepositQuoteOptions) => Promise<DepositQuoteResult>;
+  buildRedeemQuote: (vault: Vault, options: RedeemQuoteOptions) => Promise<RedeemQuoteResult>;
+  preflight: (vault: Vault, wallet: string, options?: PreflightOptions) => PreflightReport;
+  riskScore: (vault: Vault) => RiskScore;
+  suggest: (params: SuggestParams & {
+    vaults?: Vault[];
+  }) => Promise<SuggestResult>;
+  optimizeGasRoutes: (vault: Vault, options: GasOptimizeOptions) => Promise<GasRoute[]>;
+  watch: (vaultSlug: string, options?: WatchOptions) => AsyncGenerator<WatchEvent>;
+  getApyHistory: {
+    (vault: Vault): Promise<ApyDataPoint[]>;
+    (vaultAddress: string, chainId: number): Promise<ApyDataPoint[]>;
+  };
+  earnDataClient: EarnDataClient;
+  composerClient: ComposerClient | null;
+}
+interface VaultListQueryParams {
+  chainId?: number;
+  asset?: string;
+  minTvl?: number;
+  sortBy?: string;
+  cursor?: string;
+  strategy?: StrategyPreset;
+}
+interface TopVaultsParams {
+  asset?: string;
+  chainId?: number;
+  limit?: number;
+  strategy?: StrategyPreset;
+  minTvl?: number;
+}
+/**
+ * Create an EarnForge instance — the main entry point.
+ *
+ * ```ts
+ * const forge = createEarnForge({ composerApiKey: process.env.LIFI_API_KEY });
+ * for await (const vault of forge.vaults.listAll({ chainId: 8453 })) {
+ *   console.log(vault.name, vault.analytics.apy.total);
+ * }
+ * ```
+ */
+declare function createEarnForge(options?: EarnForgeOptions): EarnForge;
+//#endregion
+export { type Allocation, type AllowanceResult, AnalyticsSchema, type ApprovalTx, type ApyDataPoint, ApySchema, Chain, ChainListResponseSchema, ChainSchema, ComposerClient, type ComposerClientOptions, ComposerError, ComposerTokenSchema, type DepositQuoteOptions, type DepositQuoteResult, EarnApiError, EarnDataClient, type EarnDataClientOptions, EarnForge, EarnForgeError, EarnForgeOptions, FeeCostSchema, FeeSplitSchema, GasCostSchema, type GasOptimizeOptions, type GasRoute, IncludedStepSchema, LRUCache, MAX_UINT256, PackSchema, PortfolioResponse, PortfolioResponseSchema, Position, PositionAssetSchema, PositionSchema, PreflightError, PreflightIssue, type PreflightOptions, type PreflightReport, ProtocolDetail, ProtocolDetailSchema, ProtocolListResponseSchema, ProtocolSchema, QuoteActionSchema, QuoteEstimateSchema, type QuoteParams, QuoteResponse, QuoteResponseSchema, RateLimitError, type RedeemQuoteOptions, type RedeemQuoteResult, RetryOptions, type RiskBreakdown, type RiskScore, STRATEGIES, type StrategyConfig, type StrategyPreset, type SuggestParams, type SuggestResult, TokenBucketRateLimiter, ToolDetailsSchema, TransactionRequest, TransactionRequestSchema, type TvlParsed, TvlSchema, UnderlyingTokenSchema, Vault, type VaultListParams, VaultListResponse, VaultListResponseSchema, VaultSchema, type WatchEvent, type WatchEventType, type WatchOptions, buildApprovalTx, buildDepositQuote, buildRedeemQuote, checkAllowance, createEarnForge, fromSmallestUnit, getApyHistory, getBestApy, getStrategy, isRetryable, optimizeGasRoutes, parseTvl, preflight, riskScore, suggest, toSmallestUnit, watch, withRetry };
+//# sourceMappingURL=index.d.mts.map