@agether/sdk 2.13.0 → 2.14.0

package/dist/index.js

@@ -1155,7 +1155,7 @@ var MorphoClient = class {
     const chainId = this.config.chainId;
     const query = `{
       markets(
-        first: 50
+        first: 500
         orderBy: SupplyAssetsUsd
         orderDirection: Desc
         where: { chainId_in: [${chainId}] }
@@ -1277,6 +1277,14 @@ var MorphoClient = class {
         lltv: m.lltv
       };
     }
+    if (!collateralSymbolOrAddress.startsWith("0x")) {
+      const searched = await this.searchMarkets(collateralSymbolOrAddress, { asCollateral: true });
+      for (const m of searched) {
+        if (loanAddr && m.loanAddress.toLowerCase() !== loanAddr) continue;
+        if (loanTokenSymbolOrAddress && !loanTokenSymbolOrAddress.startsWith("0x") && m.loanToken.toUpperCase() !== loanTokenSymbolOrAddress.toUpperCase()) continue;
+        return this.getMarketParams(m.marketId);
+      }
+    }
     throw new AgetherError(
       `No Morpho market found for collateral ${collateralSymbolOrAddress}` + (loanTokenSymbolOrAddress ? ` with loan token ${loanTokenSymbolOrAddress}` : ""),
       "MARKET_NOT_FOUND"
@@ -1447,41 +1455,39 @@ var MorphoClient = class {
   async getMarketRates(collateralSymbolOrAddress, loanTokenSymbolOrAddress) {
     const chainId = this.config.chainId;
     let collateralFilter = "";
+    let loanFilter = "";
+    let searchTerm = "";
     if (collateralSymbolOrAddress) {
-      let colAddr;
       if (collateralSymbolOrAddress.startsWith("0x")) {
-        colAddr = collateralSymbolOrAddress.toLowerCase();
+        collateralFilter = `, collateralAssetAddress_in: ["${collateralSymbolOrAddress.toLowerCase()}"]`;
       } else {
-        try {
-          const resolved = await this._resolveToken(collateralSymbolOrAddress);
-          colAddr = resolved.address.toLowerCase();
-        } catch {
-          colAddr = collateralSymbolOrAddress.toLowerCase();
+        const cached = this._tokenCache.get(collateralSymbolOrAddress.toUpperCase());
+        if (cached) {
+          collateralFilter = `, collateralAssetAddress_in: ["${cached.address.toLowerCase()}"]`;
+        } else {
+          searchTerm = collateralSymbolOrAddress;
         }
       }
-      collateralFilter = `, collateralAssetAddress_in: ["${colAddr}"]`;
     }
-    let loanFilter = "";
     if (loanTokenSymbolOrAddress) {
-      let loanAddr;
       if (loanTokenSymbolOrAddress.startsWith("0x")) {
-        loanAddr = loanTokenSymbolOrAddress.toLowerCase();
+        loanFilter = `, loanAssetAddress_in: ["${loanTokenSymbolOrAddress.toLowerCase()}"]`;
       } else {
-        try {
-          const resolved = await this._resolveToken(loanTokenSymbolOrAddress);
-          loanAddr = resolved.address.toLowerCase();
-        } catch {
-          loanAddr = loanTokenSymbolOrAddress.toLowerCase();
+        const cached = this._tokenCache.get(loanTokenSymbolOrAddress.toUpperCase());
+        if (cached) {
+          loanFilter = `, loanAssetAddress_in: ["${cached.address.toLowerCase()}"]`;
+        } else {
+          searchTerm = searchTerm || loanTokenSymbolOrAddress;
         }
       }
-      loanFilter = `, loanAssetAddress_in: ["${loanAddr}"]`;
     }
+    const searchClause = searchTerm ? `, search: "${searchTerm}"` : "";
     const query = `{
       markets(
-        first: 50
+        first: 100
         orderBy: SupplyAssetsUsd
         orderDirection: Desc
-        where: { chainId_in: [${chainId}]${loanFilter}${collateralFilter} }
+        where: { chainId_in: [${chainId}]${loanFilter}${collateralFilter}${searchClause} }
       ) {
         items {
           uniqueKey
@@ -1500,7 +1506,15 @@ var MorphoClient = class {
     }`;
     try {
       const resp = await import_axios.default.post(MORPHO_API_URL, { query }, { timeout: 1e4 });
-      const items = resp.data?.data?.markets?.items ?? [];
+      let items = resp.data?.data?.markets?.items ?? [];
+      if (searchTerm && collateralSymbolOrAddress && !collateralSymbolOrAddress.startsWith("0x")) {
+        const sym = collateralSymbolOrAddress.toUpperCase();
+        items = items.filter((m) => m.collateralAsset?.symbol?.toUpperCase() === sym);
+      }
+      if (searchTerm && loanTokenSymbolOrAddress && !loanTokenSymbolOrAddress.startsWith("0x")) {
+        const sym = loanTokenSymbolOrAddress.toUpperCase();
+        items = items.filter((m) => m.loanAsset?.symbol?.toUpperCase() === sym);
+      }
       return items.filter((m) => m.collateralAsset?.address && m.collateralAsset.address !== import_ethers2.ethers.ZeroAddress).map((m) => {
         const loanDecimals = m.loanAsset?.decimals ?? 18;
         return {
@@ -1521,6 +1535,205 @@ var MorphoClient = class {
       return [];
     }
   }
+  // ════════════════════════════════════════════════════════
+  //  Market Search & Wallet Discovery
+  // ════════════════════════════════════════════════════════
+  /**
+   * Search Morpho markets by token name using the Morpho GraphQL API `search` field.
+   * No hardcoded token lists — uses Morpho's built-in fuzzy search.
+   *
+   * @param search - token name or symbol (e.g. 'WETH', 'staked ETH', 'ezETH')
+   * @param options.asCollateral - only return markets where the searched token is collateral
+   * @param options.asLoanToken - only return markets where the searched token is the loan asset
+   */
+  async searchMarkets(search, options) {
+    const chainId = this.config.chainId;
+    const query = `{
+      markets(
+        first: 100
+        orderBy: SupplyAssetsUsd
+        orderDirection: Desc
+        where: { chainId_in: [${chainId}], search: "${search}" }
+      ) {
+        items {
+          uniqueKey
+          lltv
+          loanAsset { address symbol decimals }
+          collateralAsset { address symbol decimals }
+          state {
+            borrowAssets
+            supplyAssets
+            utilization
+            supplyApy
+            borrowApy
+          }
+        }
+      }
+    }`;
+    try {
+      const resp = await import_axios.default.post(MORPHO_API_URL, { query }, { timeout: 1e4 });
+      let items = resp.data?.data?.markets?.items ?? [];
+      items = items.filter((m) => m.collateralAsset?.address && m.collateralAsset.address !== import_ethers2.ethers.ZeroAddress);
+      const searchUpper = search.toUpperCase();
+      if (options?.asCollateral) {
+        items = items.filter((m) => m.collateralAsset?.symbol?.toUpperCase() === searchUpper);
+      }
+      if (options?.asLoanToken) {
+        items = items.filter((m) => m.loanAsset?.symbol?.toUpperCase() === searchUpper);
+      }
+      return items.map((m) => {
+        const loanDecimals = m.loanAsset?.decimals ?? 18;
+        const collateralDecimals = m.collateralAsset?.decimals ?? 18;
+        return {
+          collateralToken: m.collateralAsset.symbol,
+          loanToken: m.loanAsset.symbol,
+          loanDecimals,
+          collateralDecimals,
+          supplyApy: m.state?.supplyApy ? Number(m.state.supplyApy) : 0,
+          borrowApy: m.state?.borrowApy ? Number(m.state.borrowApy) : 0,
+          utilization: m.state?.utilization ? Number(m.state.utilization) : 0,
+          totalSupplyUsd: m.state?.supplyAssets ? Number(m.state.supplyAssets) / 10 ** loanDecimals : 0,
+          totalBorrowUsd: m.state?.borrowAssets ? Number(m.state.borrowAssets) / 10 ** loanDecimals : 0,
+          lltv: `${(Number(m.lltv) / 1e16).toFixed(0)}%`,
+          marketId: m.uniqueKey,
+          collateralAddress: m.collateralAsset.address,
+          loanAddress: m.loanAsset.address
+        };
+      });
+    } catch (e) {
+      console.warn("[agether] searchMarkets failed:", e instanceof Error ? e.message : e);
+      return [];
+    }
+  }
+  /**
+   * Scan the AgentAccount wallet for all ERC-20 tokens that appear in Morpho
+   * markets on the current chain. Returns tokens where balance > 0.
+   *
+   * Uses the full market list (500 markets) to discover all relevant tokens,
+   * then checks on-chain balance for each unique token address.
+   *
+   * @returns Array of tokens with non-zero balance, sorted by balance descending.
+   */
+  async getWalletTokenBalances() {
+    const acctAddr = await this.getAccountAddress();
+    await this.getMarkets();
+    const uniqueTokens = /* @__PURE__ */ new Map();
+    for (const [key, info] of this._tokenCache.entries()) {
+      if (key.startsWith("0x") && !uniqueTokens.has(key)) {
+        uniqueTokens.set(key, info);
+      }
+    }
+    const results = [];
+    try {
+      const ethBalance = await this.provider.getBalance(acctAddr);
+      if (ethBalance > 0n) {
+        results.push({
+          symbol: "ETH",
+          address: import_ethers2.ethers.ZeroAddress,
+          decimals: 18,
+          balance: ethBalance,
+          balanceFormatted: import_ethers2.ethers.formatEther(ethBalance)
+        });
+      }
+    } catch {
+    }
+    const tokenEntries = Array.from(uniqueTokens.values());
+    const batchSize = 20;
+    for (let i = 0; i < tokenEntries.length; i += batchSize) {
+      const batch = tokenEntries.slice(i, i + batchSize);
+      const checks = batch.map(async (info) => {
+        try {
+          const token = new import_ethers2.Contract(info.address, ERC20_ABI, this.provider);
+          const balance = await token.balanceOf(acctAddr);
+          if (balance > 0n) {
+            return {
+              symbol: info.symbol,
+              address: info.address,
+              decimals: info.decimals,
+              balance,
+              balanceFormatted: import_ethers2.ethers.formatUnits(balance, info.decimals)
+            };
+          }
+        } catch {
+        }
+        return null;
+      });
+      const batchResults = await Promise.all(checks);
+      for (const r of batchResults) {
+        if (r) results.push(r);
+      }
+    }
+    results.sort((a, b) => b.balance > a.balance ? 1 : b.balance < a.balance ? -1 : 0);
+    return results;
+  }
+  /**
+   * Find borrowing opportunities for the agent.
+   *
+   * - If `collateralSymbol` is provided: find all markets where that token is collateral.
+   * - If omitted: scan wallet balances and find markets for each token the agent holds.
+   *
+   * Returns markets grouped by collateral token with APY, liquidity, and balance info.
+   *
+   * @param collateralSymbol - optional, e.g. 'WETH'. If omitted, scans wallet.
+   */
+  async findBorrowingOptions(collateralSymbol) {
+    let tokensToCheck;
+    if (collateralSymbol) {
+      tokensToCheck = [{ symbol: collateralSymbol, balanceFormatted: "N/A" }];
+      try {
+        const balance = await this.getTokenBalance(collateralSymbol);
+        const info = await this._resolveToken(collateralSymbol);
+        tokensToCheck = [{ symbol: collateralSymbol, balanceFormatted: import_ethers2.ethers.formatUnits(balance, info.decimals) }];
+      } catch {
+      }
+    } else {
+      const walletTokens = await this.getWalletTokenBalances();
+      tokensToCheck = walletTokens.filter((t) => t.symbol !== "ETH").map((t) => ({ symbol: t.symbol, balanceFormatted: t.balanceFormatted }));
+      if (tokensToCheck.length === 0) {
+        return [];
+      }
+    }
+    const results = [];
+    for (const token of tokensToCheck) {
+      const markets = await this.searchMarkets(token.symbol, { asCollateral: true });
+      if (markets.length === 0) continue;
+      results.push({
+        collateralToken: token.symbol,
+        collateralBalance: token.balanceFormatted,
+        markets: markets.map((m) => ({
+          loanToken: m.loanToken,
+          borrowApy: `${(m.borrowApy * 100).toFixed(2)}%`,
+          supplyApy: `${(m.supplyApy * 100).toFixed(2)}%`,
+          lltv: m.lltv,
+          utilization: `${(m.utilization * 100).toFixed(1)}%`,
+          availableLiquidity: `$${(m.totalSupplyUsd - m.totalBorrowUsd).toFixed(0)}`,
+          marketId: m.marketId
+        }))
+      });
+    }
+    return results;
+  }
+  /**
+   * Find supply/lending opportunities for a specific loan token.
+   *
+   * "What can I supply to earn WETH?" → shows all markets where WETH is the loan token
+   * (user supplies WETH to earn yield from borrowers).
+   *
+   * @param loanTokenSymbol - e.g. 'USDC', 'WETH'
+   */
+  async findSupplyOptions(loanTokenSymbol) {
+    const markets = await this.searchMarkets(loanTokenSymbol, { asLoanToken: true });
+    return markets.map((m) => ({
+      collateralToken: m.collateralToken,
+      loanToken: m.loanToken,
+      supplyApy: `${(m.supplyApy * 100).toFixed(2)}%`,
+      borrowApy: `${(m.borrowApy * 100).toFixed(2)}%`,
+      lltv: m.lltv,
+      utilization: `${(m.utilization * 100).toFixed(1)}%`,
+      totalSupply: `$${m.totalSupplyUsd.toFixed(0)}`,
+      marketId: m.marketId
+    }));
+  }
   /**
    * Estimate theoretical yield for a given collateral amount over a period.
    *
@@ -2523,6 +2736,24 @@ var MorphoClient = class {
     await this.getMarkets();
     const fromApi = this._tokenCache.get(key);
     if (fromApi) return fromApi;
+    if (!symbolOrAddress.startsWith("0x")) {
+      const searchResults = await this.searchMarkets(symbolOrAddress);
+      const sym = symbolOrAddress.toUpperCase();
+      for (const m of searchResults) {
+        if (m.collateralToken.toUpperCase() === sym) {
+          const info = { address: m.collateralAddress, symbol: m.collateralToken, decimals: m.collateralDecimals };
+          this._tokenCache.set(sym, info);
+          this._tokenCache.set(m.collateralAddress.toLowerCase(), info);
+          return info;
+        }
+        if (m.loanToken.toUpperCase() === sym) {
+          const info = { address: m.loanAddress, symbol: m.loanToken, decimals: m.loanDecimals };
+          this._tokenCache.set(sym, info);
+          this._tokenCache.set(m.loanAddress.toLowerCase(), info);
+          return info;
+        }
+      }
+    }
     throw new AgetherError(
       `Unknown token: ${symbolOrAddress}. No Morpho market found with this token.`,
       "UNKNOWN_TOKEN"

package/dist/index.mjs

@@ -1080,7 +1080,7 @@ var MorphoClient = class {
     const chainId = this.config.chainId;
     const query = `{
       markets(
-        first: 50
+        first: 500
         orderBy: SupplyAssetsUsd
         orderDirection: Desc
         where: { chainId_in: [${chainId}] }
@@ -1202,6 +1202,14 @@ var MorphoClient = class {
         lltv: m.lltv
       };
     }
+    if (!collateralSymbolOrAddress.startsWith("0x")) {
+      const searched = await this.searchMarkets(collateralSymbolOrAddress, { asCollateral: true });
+      for (const m of searched) {
+        if (loanAddr && m.loanAddress.toLowerCase() !== loanAddr) continue;
+        if (loanTokenSymbolOrAddress && !loanTokenSymbolOrAddress.startsWith("0x") && m.loanToken.toUpperCase() !== loanTokenSymbolOrAddress.toUpperCase()) continue;
+        return this.getMarketParams(m.marketId);
+      }
+    }
     throw new AgetherError(
       `No Morpho market found for collateral ${collateralSymbolOrAddress}` + (loanTokenSymbolOrAddress ? ` with loan token ${loanTokenSymbolOrAddress}` : ""),
       "MARKET_NOT_FOUND"
@@ -1372,41 +1380,39 @@ var MorphoClient = class {
   async getMarketRates(collateralSymbolOrAddress, loanTokenSymbolOrAddress) {
     const chainId = this.config.chainId;
     let collateralFilter = "";
+    let loanFilter = "";
+    let searchTerm = "";
     if (collateralSymbolOrAddress) {
-      let colAddr;
       if (collateralSymbolOrAddress.startsWith("0x")) {
-        colAddr = collateralSymbolOrAddress.toLowerCase();
+        collateralFilter = `, collateralAssetAddress_in: ["${collateralSymbolOrAddress.toLowerCase()}"]`;
       } else {
-        try {
-          const resolved = await this._resolveToken(collateralSymbolOrAddress);
-          colAddr = resolved.address.toLowerCase();
-        } catch {
-          colAddr = collateralSymbolOrAddress.toLowerCase();
+        const cached = this._tokenCache.get(collateralSymbolOrAddress.toUpperCase());
+        if (cached) {
+          collateralFilter = `, collateralAssetAddress_in: ["${cached.address.toLowerCase()}"]`;
+        } else {
+          searchTerm = collateralSymbolOrAddress;
         }
       }
-      collateralFilter = `, collateralAssetAddress_in: ["${colAddr}"]`;
     }
-    let loanFilter = "";
     if (loanTokenSymbolOrAddress) {
-      let loanAddr;
       if (loanTokenSymbolOrAddress.startsWith("0x")) {
-        loanAddr = loanTokenSymbolOrAddress.toLowerCase();
+        loanFilter = `, loanAssetAddress_in: ["${loanTokenSymbolOrAddress.toLowerCase()}"]`;
       } else {
-        try {
-          const resolved = await this._resolveToken(loanTokenSymbolOrAddress);
-          loanAddr = resolved.address.toLowerCase();
-        } catch {
-          loanAddr = loanTokenSymbolOrAddress.toLowerCase();
+        const cached = this._tokenCache.get(loanTokenSymbolOrAddress.toUpperCase());
+        if (cached) {
+          loanFilter = `, loanAssetAddress_in: ["${cached.address.toLowerCase()}"]`;
+        } else {
+          searchTerm = searchTerm || loanTokenSymbolOrAddress;
         }
       }
-      loanFilter = `, loanAssetAddress_in: ["${loanAddr}"]`;
     }
+    const searchClause = searchTerm ? `, search: "${searchTerm}"` : "";
     const query = `{
       markets(
-        first: 50
+        first: 100
         orderBy: SupplyAssetsUsd
         orderDirection: Desc
-        where: { chainId_in: [${chainId}]${loanFilter}${collateralFilter} }
+        where: { chainId_in: [${chainId}]${loanFilter}${collateralFilter}${searchClause} }
       ) {
         items {
           uniqueKey
@@ -1425,7 +1431,15 @@ var MorphoClient = class {
     }`;
     try {
       const resp = await axios.post(MORPHO_API_URL, { query }, { timeout: 1e4 });
-      const items = resp.data?.data?.markets?.items ?? [];
+      let items = resp.data?.data?.markets?.items ?? [];
+      if (searchTerm && collateralSymbolOrAddress && !collateralSymbolOrAddress.startsWith("0x")) {
+        const sym = collateralSymbolOrAddress.toUpperCase();
+        items = items.filter((m) => m.collateralAsset?.symbol?.toUpperCase() === sym);
+      }
+      if (searchTerm && loanTokenSymbolOrAddress && !loanTokenSymbolOrAddress.startsWith("0x")) {
+        const sym = loanTokenSymbolOrAddress.toUpperCase();
+        items = items.filter((m) => m.loanAsset?.symbol?.toUpperCase() === sym);
+      }
       return items.filter((m) => m.collateralAsset?.address && m.collateralAsset.address !== ethers2.ZeroAddress).map((m) => {
         const loanDecimals = m.loanAsset?.decimals ?? 18;
         return {
@@ -1446,6 +1460,205 @@ var MorphoClient = class {
       return [];
     }
   }
+  // ════════════════════════════════════════════════════════
+  //  Market Search & Wallet Discovery
+  // ════════════════════════════════════════════════════════
+  /**
+   * Search Morpho markets by token name using the Morpho GraphQL API `search` field.
+   * No hardcoded token lists — uses Morpho's built-in fuzzy search.
+   *
+   * @param search - token name or symbol (e.g. 'WETH', 'staked ETH', 'ezETH')
+   * @param options.asCollateral - only return markets where the searched token is collateral
+   * @param options.asLoanToken - only return markets where the searched token is the loan asset
+   */
+  async searchMarkets(search, options) {
+    const chainId = this.config.chainId;
+    const query = `{
+      markets(
+        first: 100
+        orderBy: SupplyAssetsUsd
+        orderDirection: Desc
+        where: { chainId_in: [${chainId}], search: "${search}" }
+      ) {
+        items {
+          uniqueKey
+          lltv
+          loanAsset { address symbol decimals }
+          collateralAsset { address symbol decimals }
+          state {
+            borrowAssets
+            supplyAssets
+            utilization
+            supplyApy
+            borrowApy
+          }
+        }
+      }
+    }`;
+    try {
+      const resp = await axios.post(MORPHO_API_URL, { query }, { timeout: 1e4 });
+      let items = resp.data?.data?.markets?.items ?? [];
+      items = items.filter((m) => m.collateralAsset?.address && m.collateralAsset.address !== ethers2.ZeroAddress);
+      const searchUpper = search.toUpperCase();
+      if (options?.asCollateral) {
+        items = items.filter((m) => m.collateralAsset?.symbol?.toUpperCase() === searchUpper);
+      }
+      if (options?.asLoanToken) {
+        items = items.filter((m) => m.loanAsset?.symbol?.toUpperCase() === searchUpper);
+      }
+      return items.map((m) => {
+        const loanDecimals = m.loanAsset?.decimals ?? 18;
+        const collateralDecimals = m.collateralAsset?.decimals ?? 18;
+        return {
+          collateralToken: m.collateralAsset.symbol,
+          loanToken: m.loanAsset.symbol,
+          loanDecimals,
+          collateralDecimals,
+          supplyApy: m.state?.supplyApy ? Number(m.state.supplyApy) : 0,
+          borrowApy: m.state?.borrowApy ? Number(m.state.borrowApy) : 0,
+          utilization: m.state?.utilization ? Number(m.state.utilization) : 0,
+          totalSupplyUsd: m.state?.supplyAssets ? Number(m.state.supplyAssets) / 10 ** loanDecimals : 0,
+          totalBorrowUsd: m.state?.borrowAssets ? Number(m.state.borrowAssets) / 10 ** loanDecimals : 0,
+          lltv: `${(Number(m.lltv) / 1e16).toFixed(0)}%`,
+          marketId: m.uniqueKey,
+          collateralAddress: m.collateralAsset.address,
+          loanAddress: m.loanAsset.address
+        };
+      });
+    } catch (e) {
+      console.warn("[agether] searchMarkets failed:", e instanceof Error ? e.message : e);
+      return [];
+    }
+  }
+  /**
+   * Scan the AgentAccount wallet for all ERC-20 tokens that appear in Morpho
+   * markets on the current chain. Returns tokens where balance > 0.
+   *
+   * Uses the full market list (500 markets) to discover all relevant tokens,
+   * then checks on-chain balance for each unique token address.
+   *
+   * @returns Array of tokens with non-zero balance, sorted by balance descending.
+   */
+  async getWalletTokenBalances() {
+    const acctAddr = await this.getAccountAddress();
+    await this.getMarkets();
+    const uniqueTokens = /* @__PURE__ */ new Map();
+    for (const [key, info] of this._tokenCache.entries()) {
+      if (key.startsWith("0x") && !uniqueTokens.has(key)) {
+        uniqueTokens.set(key, info);
+      }
+    }
+    const results = [];
+    try {
+      const ethBalance = await this.provider.getBalance(acctAddr);
+      if (ethBalance > 0n) {
+        results.push({
+          symbol: "ETH",
+          address: ethers2.ZeroAddress,
+          decimals: 18,
+          balance: ethBalance,
+          balanceFormatted: ethers2.formatEther(ethBalance)
+        });
+      }
+    } catch {
+    }
+    const tokenEntries = Array.from(uniqueTokens.values());
+    const batchSize = 20;
+    for (let i = 0; i < tokenEntries.length; i += batchSize) {
+      const batch = tokenEntries.slice(i, i + batchSize);
+      const checks = batch.map(async (info) => {
+        try {
+          const token = new Contract2(info.address, ERC20_ABI, this.provider);
+          const balance = await token.balanceOf(acctAddr);
+          if (balance > 0n) {
+            return {
+              symbol: info.symbol,
+              address: info.address,
+              decimals: info.decimals,
+              balance,
+              balanceFormatted: ethers2.formatUnits(balance, info.decimals)
+            };
+          }
+        } catch {
+        }
+        return null;
+      });
+      const batchResults = await Promise.all(checks);
+      for (const r of batchResults) {
+        if (r) results.push(r);
+      }
+    }
+    results.sort((a, b) => b.balance > a.balance ? 1 : b.balance < a.balance ? -1 : 0);
+    return results;
+  }
+  /**
+   * Find borrowing opportunities for the agent.
+   *
+   * - If `collateralSymbol` is provided: find all markets where that token is collateral.
+   * - If omitted: scan wallet balances and find markets for each token the agent holds.
+   *
+   * Returns markets grouped by collateral token with APY, liquidity, and balance info.
+   *
+   * @param collateralSymbol - optional, e.g. 'WETH'. If omitted, scans wallet.
+   */
+  async findBorrowingOptions(collateralSymbol) {
+    let tokensToCheck;
+    if (collateralSymbol) {
+      tokensToCheck = [{ symbol: collateralSymbol, balanceFormatted: "N/A" }];
+      try {
+        const balance = await this.getTokenBalance(collateralSymbol);
+        const info = await this._resolveToken(collateralSymbol);
+        tokensToCheck = [{ symbol: collateralSymbol, balanceFormatted: ethers2.formatUnits(balance, info.decimals) }];
+      } catch {
+      }
+    } else {
+      const walletTokens = await this.getWalletTokenBalances();
+      tokensToCheck = walletTokens.filter((t) => t.symbol !== "ETH").map((t) => ({ symbol: t.symbol, balanceFormatted: t.balanceFormatted }));
+      if (tokensToCheck.length === 0) {
+        return [];
+      }
+    }
+    const results = [];
+    for (const token of tokensToCheck) {
+      const markets = await this.searchMarkets(token.symbol, { asCollateral: true });
+      if (markets.length === 0) continue;
+      results.push({
+        collateralToken: token.symbol,
+        collateralBalance: token.balanceFormatted,
+        markets: markets.map((m) => ({
+          loanToken: m.loanToken,
+          borrowApy: `${(m.borrowApy * 100).toFixed(2)}%`,
+          supplyApy: `${(m.supplyApy * 100).toFixed(2)}%`,
+          lltv: m.lltv,
+          utilization: `${(m.utilization * 100).toFixed(1)}%`,
+          availableLiquidity: `$${(m.totalSupplyUsd - m.totalBorrowUsd).toFixed(0)}`,
+          marketId: m.marketId
+        }))
+      });
+    }
+    return results;
+  }
+  /**
+   * Find supply/lending opportunities for a specific loan token.
+   *
+   * "What can I supply to earn WETH?" → shows all markets where WETH is the loan token
+   * (user supplies WETH to earn yield from borrowers).
+   *
+   * @param loanTokenSymbol - e.g. 'USDC', 'WETH'
+   */
+  async findSupplyOptions(loanTokenSymbol) {
+    const markets = await this.searchMarkets(loanTokenSymbol, { asLoanToken: true });
+    return markets.map((m) => ({
+      collateralToken: m.collateralToken,
+      loanToken: m.loanToken,
+      supplyApy: `${(m.supplyApy * 100).toFixed(2)}%`,
+      borrowApy: `${(m.borrowApy * 100).toFixed(2)}%`,
+      lltv: m.lltv,
+      utilization: `${(m.utilization * 100).toFixed(1)}%`,
+      totalSupply: `$${m.totalSupplyUsd.toFixed(0)}`,
+      marketId: m.marketId
+    }));
+  }
   /**
    * Estimate theoretical yield for a given collateral amount over a period.
    *
@@ -2448,6 +2661,24 @@ var MorphoClient = class {
     await this.getMarkets();
     const fromApi = this._tokenCache.get(key);
     if (fromApi) return fromApi;
+    if (!symbolOrAddress.startsWith("0x")) {
+      const searchResults = await this.searchMarkets(symbolOrAddress);
+      const sym = symbolOrAddress.toUpperCase();
+      for (const m of searchResults) {
+        if (m.collateralToken.toUpperCase() === sym) {
+          const info = { address: m.collateralAddress, symbol: m.collateralToken, decimals: m.collateralDecimals };
+          this._tokenCache.set(sym, info);
+          this._tokenCache.set(m.collateralAddress.toLowerCase(), info);
+          return info;
+        }
+        if (m.loanToken.toUpperCase() === sym) {
+          const info = { address: m.loanAddress, symbol: m.loanToken, decimals: m.loanDecimals };
+          this._tokenCache.set(sym, info);
+          this._tokenCache.set(m.loanAddress.toLowerCase(), info);
+          return info;
+        }
+      }
+    }
     throw new AgetherError(
       `Unknown token: ${symbolOrAddress}. No Morpho market found with this token.`,
       "UNKNOWN_TOKEN"