@agether/sdk 2.14.0 → 2.15.0

package/dist/index.d.ts

@@ -252,7 +252,7 @@ declare class AgetherClient {
     getBalances(): Promise<BalancesResult>;
     /**
      * Fund the Safe account with USDC from EOA.
-     * This is a simple ERC-20 transfer (does NOT require a UserOp).
+     * @deprecated Use `fundAccountToken('USDC', amount)` instead.
      */
     fundAccount(usdcAmount: string): Promise<TransactionResult>;
     /**
@@ -270,6 +270,54 @@ declare class AgetherClient {
      * @param amount - ETH amount (e.g. '0.01' or 'all')
      */
     withdrawEth(amount: string): Promise<WithdrawFromAccountResult>;
+    /**
+     * Fund the AgentAccount with any ERC-20 token from EOA.
+     * Simple ERC-20 transfer (does NOT require a UserOp).
+     *
+     * @param tokenSymbol - Token symbol (e.g. 'USDC', 'WETH') or 0x address
+     * @param amount - Amount to send (human-readable, e.g. '100')
+     */
+    fundAccountToken(tokenSymbol: string, amount: string): Promise<TransactionResult>;
+    /**
+     * Transfer any ERC-20 token from AgentAccount to any address or agent.
+     * Executes via Safe UserOp (ERC-7579 single execution).
+     *
+     * @param tokenSymbol - Token symbol (e.g. 'USDC', 'WETH') or 0x address
+     * @param amount - Amount to send (e.g. '100' or 'all')
+     * @param to - Destination: `{ address: '0x...' }` or `{ agentId: '42' }`
+     */
+    transferToken(tokenSymbol: string, amount: string, to: {
+        address?: string;
+        agentId?: string;
+    }): Promise<WithdrawFromAccountResult>;
+    /**
+     * Transfer ETH from AgentAccount to any address or agent.
+     * Executes via Safe UserOp.
+     *
+     * @param amount - ETH amount (e.g. '0.01' or 'all')
+     * @param to - Destination: `{ address: '0x...' }` or `{ agentId: '42' }`
+     */
+    transferEth(amount: string, to: {
+        address?: string;
+        agentId?: string;
+    }): Promise<WithdrawFromAccountResult>;
+    /**
+     * Approve a spender to use ERC-20 tokens from the AgentAccount.
+     * Executes via Safe UserOp (ERC-7579 single execution).
+     *
+     * @param tokenSymbol - Token symbol (e.g. 'USDC', 'WETH') or 0x address
+     * @param amount - Allowance amount (e.g. '1000' or 'max' for uint256 max)
+     * @param spender - Spender: `{ address: '0x...' }` or `{ agentId: '42' }`
+     */
+    approveToken(tokenSymbol: string, amount: string, spender: {
+        address?: string;
+        agentId?: string;
+    }): Promise<{
+        tx: string;
+        token: string;
+        amount: string;
+        spender: string;
+    }>;
     /**
      * Send tokens to another agent's Safe account (or any address).
      * Transfers from EOA (does NOT require a UserOp).
@@ -324,11 +372,14 @@ declare class AgetherClient {
     /**
      * Resolve a token symbol or address to { address, symbol, decimals }.
      *
-     * Supports:
-     * - `'USDC'` → from chain config
-     * - Well-known symbols (`'WETH'`, `'wstETH'`, `'cbETH'`) → built-in per-chain registry
-     * - `'0x...'` address → reads decimals and symbol onchain
+     * Resolution order:
+     * 1. `'USDC'` → from chain config (instant)
+     * 2. Well-known symbols (`'WETH'`, `'wstETH'`, `'cbETH'`) → built-in per-chain registry (instant)
+     * 3. Dynamic cache populated by previous Morpho API lookups (instant)
+     * 4. `'0x...'` address → reads decimals and symbol onchain
+     * 5. Morpho GraphQL `search` API → discovers any token across all Morpho markets
      */
+    private _dynamicTokenCache;
     private _resolveToken;
     /**
      * Refresh signer and rebind contracts for fresh nonce.
@@ -575,7 +626,10 @@ declare class MorphoClient {
     /** Read onchain position for a specific market. */
     getPosition(marketId: string): Promise<MorphoPosition>;
     /**
-     * Full status: positions across all discovered markets.
+     * Full status: positions across all markets the user has interacted with.
+     *
+     * Uses Morpho GraphQL `marketPositions` to find ALL positions (not limited
+     * to the top-500 markets), then reads onchain data for accurate debt.
      */
     getStatus(): Promise<StatusResult>;
     /**