@agether/sdk 2.12.2 → 2.14.0

package/dist/index.d.ts

@@ -435,11 +435,19 @@ type MorphoClientConfig = MorphoClientBaseConfig & ({
 interface PositionResult {
     marketId: string;
     collateralToken: string;
+    loanToken: string;
     collateral: string;
     borrowShares: string;
     supplyShares: string;
     debt: string;
 }
+/** Optional filter for market discovery. */
+interface MarketFilter {
+    /** Loan token symbol or address (e.g. 'USDC', '0x833589...'). Omit for all loan tokens. */
+    loanToken?: string;
+    /** Collateral token symbol or address (e.g. 'WETH'). Omit for all collateral tokens. */
+    collateralToken?: string;
+}
 interface StatusResult {
     agentId: string;
     agentAccount: string;
@@ -520,8 +528,9 @@ declare class MorphoClient {
     private morphoBlue;
     private entryPoint;
     private _accountAddress?;
+    /** Market params cache: keyed by market uniqueKey (bytes32 hash) */
     private _marketCache;
-    /** Dynamic token registry: symbol (uppercase) → { address, symbol, decimals } */
+    /** Dynamic token registry: symbol (uppercase) or address (lowercase) → { address, symbol, decimals } */
     private _tokenCache;
     private _discoveredMarkets?;
     private _discoveredAt;
@@ -543,15 +552,24 @@ declare class MorphoClient {
      */
     getSignerAddress(): Promise<string>;
     /**
-     * Fetch USDC borrow markets on Base from Morpho API.
-     * Caches results for 5 minutes.
+     * Fetch available markets on the current chain from Morpho API.
+     * Caches results for 5 minutes. Supports all loan tokens (not just USDC).
+     *
+     * @param forceRefresh - bypass cache TTL
+     * @param filter - optional filter by loan token and/or collateral token
      */
-    getMarkets(forceRefresh?: boolean): Promise<MorphoMarketInfo[]>;
+    getMarkets(forceRefresh?: boolean, filter?: MarketFilter): Promise<MorphoMarketInfo[]>;
     /**
-     * Get MarketParams for a collateral token.
-     * Tries cache → API → onchain idToMarketParams.
+     * Get MarketParams for a collateral token (and optionally a specific loan token).
+     * Tries cache → API discovery.
+     *
+     * When `loanTokenSymbolOrAddress` is omitted, returns the most liquid market
+     * for that collateral (sorted by supply, typically the USDC market).
+     *
+     * @param collateralSymbolOrAddress - e.g. 'WETH', 'wstETH', or '0x4200...'
+     * @param loanTokenSymbolOrAddress - e.g. 'USDC', 'WETH', or '0x833589...' (optional)
      */
-    findMarketForCollateral(collateralSymbolOrAddress: string): Promise<MorphoMarketParams>;
+    findMarketForCollateral(collateralSymbolOrAddress: string, loanTokenSymbolOrAddress?: string): Promise<MorphoMarketParams>;
     /** Read MarketParams onchain by market ID (bytes32). */
     getMarketParams(marketId: string): Promise<MorphoMarketParams>;
     /** Read onchain position for a specific market. */
@@ -560,13 +578,20 @@ declare class MorphoClient {
      * Full status: positions across all discovered markets.
      */
     getStatus(): Promise<StatusResult>;
+    /**
+     * Get the balance of any ERC-20 token in the AgentAccount.
+     * @param symbolOrAddress - token symbol (e.g. 'USDC', 'WETH') or address
+     * @returns balance in raw units
+     */
+    getTokenBalance(symbolOrAddress: string): Promise<bigint>;
     /**
      * Get the USDC balance of the AgentAccount.
      * @returns USDC balance in raw units (6 decimals)
+     * @deprecated Use `getTokenBalance('USDC')` instead.
      */
     getUsdcBalance(): Promise<bigint>;
     /**
-     * Calculate the maximum additional USDC that can be borrowed
+     * Calculate the maximum additional loan token that can be borrowed
      * given the agent's current collateral and debt across all markets.
      *
      * For each market with collateral deposited:
@@ -574,26 +599,32 @@ declare class MorphoClient {
      *
      * Uses the Morpho oracle to price collateral → loan token.
      *
-     * @returns Maximum additional USDC borrowable (6 decimals)
+     * @returns Maximum additional borrowable per market (raw units in each market's loan token)
      */
     getMaxBorrowable(): Promise<{
         total: bigint;
         byMarket: Array<{
             collateralToken: string;
+            loanToken: string;
+            loanDecimals: number;
             maxAdditional: bigint;
             currentDebt: bigint;
             collateralValue: bigint;
         }>;
     }>;
     /**
-     * Fetch current supply/borrow APY for a collateral market from Morpho GraphQL API.
+     * Fetch current supply/borrow APY for markets from Morpho GraphQL API.
      *
      * Note: On Morpho Blue, collateral does NOT earn yield directly. Supply APY
      * is what lenders earn; borrow APY is what borrowers pay.
+     *
+     * @param collateralSymbolOrAddress - filter by collateral token (optional)
+     * @param loanTokenSymbolOrAddress - filter by loan token (optional). Omit for all loan tokens.
      */
-    getMarketRates(collateralSymbolOrAddress?: string): Promise<Array<{
+    getMarketRates(collateralSymbolOrAddress?: string, loanTokenSymbolOrAddress?: string): Promise<Array<{
         collateralToken: string;
         loanToken: string;
+        loanDecimals: number;
         supplyApy: number;
         borrowApy: number;
         utilization: number;
@@ -602,6 +633,89 @@ declare class MorphoClient {
         lltv: string;
         marketId: string;
     }>>;
+    /**
+     * 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
+     */
+    searchMarkets(search: string, options?: {
+        asCollateral?: boolean;
+        asLoanToken?: boolean;
+    }): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        loanDecimals: number;
+        collateralDecimals: number;
+        supplyApy: number;
+        borrowApy: number;
+        utilization: number;
+        totalSupplyUsd: number;
+        totalBorrowUsd: number;
+        lltv: string;
+        marketId: string;
+        collateralAddress: string;
+        loanAddress: string;
+    }>>;
+    /**
+     * 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.
+     */
+    getWalletTokenBalances(): Promise<Array<{
+        symbol: string;
+        address: string;
+        decimals: number;
+        balance: bigint;
+        balanceFormatted: string;
+    }>>;
+    /**
+     * 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.
+     */
+    findBorrowingOptions(collateralSymbol?: string): Promise<Array<{
+        collateralToken: string;
+        collateralBalance: string;
+        markets: Array<{
+            loanToken: string;
+            borrowApy: string;
+            supplyApy: string;
+            lltv: string;
+            utilization: string;
+            availableLiquidity: string;
+            marketId: string;
+        }>;
+    }>>;
+    /**
+     * 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'
+     */
+    findSupplyOptions(loanTokenSymbol: string): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        supplyApy: string;
+        borrowApy: string;
+        lltv: string;
+        utilization: string;
+        totalSupply: string;
+        marketId: string;
+    }>>;
     /**
      * Estimate theoretical yield for a given collateral amount over a period.
      *
@@ -626,17 +740,18 @@ declare class MorphoClient {
         disclaimer: string;
     }>;
     /**
-     * Supply USDC to a Morpho Blue market as a lender (earn yield).
+     * Supply loan token to a Morpho Blue market as a lender (earn yield).
      *
      * Unlike `supplyCollateral` (borrower-side), this is the **lender-side**:
-     * you deposit the loanToken (USDC) into the market's supply pool and earn
+     * you deposit the loanToken into the market's supply pool and earn
      * interest paid by borrowers.
      *
-     * @param usdcAmount - Amount of USDC to supply (e.g. '500')
+     * @param amount - Amount of loan token to supply (e.g. '500' for 500 USDC, '0.5' for 0.5 WETH)
      * @param collateralSymbol - Market collateral token to identify which market (e.g. 'WETH')
      *                           Optional — defaults to highest-APY market
+     * @param loanTokenSymbol - Loan token to filter market (e.g. 'USDC', 'WETH'). Optional.
      */
-    supplyAsset(usdcAmount: string, collateralSymbol?: string): Promise<SupplyAssetResult>;
+    supplyAsset(amount: string, collateralSymbol?: string, loanTokenSymbol?: string): Promise<SupplyAssetResult>;
     /**
      * Withdraw supplied USDC (+ earned interest) from a Morpho Blue market.
      *
@@ -644,7 +759,15 @@ declare class MorphoClient {
      * @param collateralSymbol - Market collateral to identify which market
      * @param receiver - Destination address (defaults to EOA)
      */
-    withdrawSupply(usdcAmount: string, collateralSymbol?: string, receiver?: string): Promise<WithdrawSupplyResult>;
+    /**
+     * Withdraw supplied loan token (+ earned interest) from a Morpho Blue market.
+     *
+     * @param amount - Amount to withdraw (e.g. '100' or 'all' for full position)
+     * @param collateralSymbol - Market collateral to identify which market
+     * @param receiver - Destination address (defaults to EOA)
+     * @param loanTokenSymbol - Loan token to filter market (optional)
+     */
+    withdrawSupply(amount: string, collateralSymbol?: string, receiver?: string, loanTokenSymbol?: string): Promise<WithdrawSupplyResult>;
     /**
      * Get supply (lending) positions with yield tracking.
      *
@@ -662,11 +785,11 @@ declare class MorphoClient {
      * Computes available yield, verifies the requested amount doesn't exceed it,
      * then withdraws from the supply position and sends directly to the recipient.
      *
-     * @param recipient - Address to receive the USDC
-     * @param usdcAmount - Amount to pay from yield (e.g. '5.50')
+     * @param recipient - Address to receive the loan token
+     * @param amount - Amount to pay from yield (e.g. '5.50')
      * @param collateralSymbol - Market collateral to identify which supply position
      */
-    payFromYield(recipient: string, usdcAmount: string, collateralSymbol?: string): Promise<PayFromYieldResult>;
+    payFromYield(recipient: string, amount: string, collateralSymbol?: string): Promise<PayFromYieldResult>;
     /**
      * Deposit collateral into Morpho Blue.
      *
@@ -677,30 +800,46 @@ declare class MorphoClient {
      */
     supplyCollateral(tokenSymbol: string, amount: string, marketParams?: MorphoMarketParams): Promise<DepositResult>;
     /**
-     * Borrow USDC against existing collateral.
+     * Borrow loan token against existing collateral.
      *
      * AgentAccount.execute: Morpho.borrow(params, amount, 0, account, account)
      *
-     * @param usdcAmount - USDC amount (e.g. '100')
+     * @param amount - Loan token amount (e.g. '100' for 100 USDC, '0.5' for 0.5 WETH)
      * @param tokenSymbol - collateral symbol to identify which market (default: first with collateral)
+     * @param marketParams - explicit market params (optional)
+     * @param loanTokenSymbol - loan token to filter market (optional, e.g. 'USDC', 'WETH')
      */
-    borrow(usdcAmount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams): Promise<BorrowResult>;
+    borrow(amount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams, loanTokenSymbol?: string): Promise<BorrowResult>;
     /**
      * Deposit collateral AND borrow USDC in one batched transaction.
      *
+    /**
+     * Deposit collateral AND borrow loan token in one batched transaction.
+     *
      * AgentAccount.executeBatch:
      *   [collateral.approve, Morpho.supplyCollateral, Morpho.borrow]
      *
      * The collateral must be transferred to AgentAccount first.
+     *
+     * @param tokenSymbol - collateral token symbol (e.g. 'WETH')
+     * @param collateralAmount - amount of collateral (e.g. '0.05')
+     * @param borrowAmount - amount of loan token to borrow (e.g. '100')
+     * @param marketParams - explicit market params (optional)
+     * @param loanTokenSymbol - loan token to filter market (optional)
      */
-    depositAndBorrow(tokenSymbol: string, collateralAmount: string, borrowUsdcAmount: string, marketParams?: MorphoMarketParams): Promise<DepositAndBorrowResult>;
+    depositAndBorrow(tokenSymbol: string, collateralAmount: string, borrowAmount: string, marketParams?: MorphoMarketParams, loanTokenSymbol?: string): Promise<DepositAndBorrowResult>;
     /**
-     * Repay borrowed USDC from AgentAccount.
+     * Repay borrowed loan token from AgentAccount.
      *
      * AgentAccount.executeBatch:
-     *   [USDC.approve(MorphoBlue), Morpho.repay(params)]
+     *   [loanToken.approve(MorphoBlue), Morpho.repay(params)]
+     *
+     * @param amount - loan token amount to repay (e.g. '50' or 'all' for full repayment)
+     * @param tokenSymbol - collateral symbol to identify which market (optional)
+     * @param marketParams - explicit market params (optional)
+     * @param loanTokenSymbol - loan token to filter market (optional)
      */
-    repay(usdcAmount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams): Promise<RepayResult>;
+    repay(amount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams, loanTokenSymbol?: string): Promise<RepayResult>;
     /**
      * Withdraw collateral from Morpho Blue.
      *
@@ -752,6 +891,15 @@ declare class MorphoClient {
     private _findActiveMarket;
     /** Find the first market where the agent has a supply (lending) position. */
     private _findActiveSupplyMarket;
+    /**
+     * Resolve loan token decimals from market params.
+     * Uses the `_tokenCache` populated by `getMarkets()`.
+     */
+    private _getLoanTokenDecimals;
+    /**
+     * Apply client-side filter to discovered markets.
+     */
+    private _applyMarketFilter;
     /**
      * Resolve a token symbol or address to { address, symbol, decimals }.
      *
@@ -1370,4 +1518,4 @@ declare function getMorphoBlueAddress(chainId: ChainId): string;
  */
 declare function getContractAddresses(chainId: ChainId): ContractAddresses;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps };
+export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, type MarketFilter, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps };

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI9H,cAAc,SAAS,CAAC;AAIxB,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,qBAAqB,EAErB,wBAAwB,EACxB,kCAAkC,EAClC,4BAA4B,EAC5B,uBAAuB,EAEvB,sBAAsB,EACtB,mBAAmB,EACnB,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,EAEpB,uBAAuB,EACvB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}