@agether/sdk 2.3.4 → 2.5.0

package/dist/clients/X402Client.js

@@ -0,0 +1,378 @@
+/**
+ * x402 HTTP Client — Make paid API calls via the x402 protocol (v2)
+ *
+ * Built on top of the official @x402/fetch + @x402/evm SDK.
+ * https://docs.x402.org/getting-started/quickstart-for-buyers
+ *
+ * Flow:
+ *   1. Client → Resource Server (normal request)
+ *   2. Resource Server → 402 with PAYMENT-REQUIRED header (base64 JSON)
+ *   3. @x402/fetch auto-picks PaymentRequirements, signs EIP-3009 via EVM scheme
+ *   4. Client → Resource Server (retries with PAYMENT-SIGNATURE header)
+ *   5. Resource Server → verifies via facilitator → settles → 200 + data
+ *
+ * Auto-Draw: When autoDraw is enabled and USDC balance is insufficient,
+ * the client automatically borrows from Morpho Blue before paying.
+ *
+ * Spending Limits: Optional daily spending cap (dailySpendLimitUsdc) and
+ * yield-limited spending (yieldLimitedSpending) to keep borrows within
+ * theoretical collateral yield.
+ *
+ * Chain support: Base (8453), Base Sepolia (84532), Ethereum (1).
+ */
+import { wrapFetchWithPayment } from '@x402/fetch';
+import { x402Client } from '@x402/core/client';
+import { registerExactEvmScheme } from '@x402/evm/exact/client';
+import { privateKeyToAccount, toAccount } from 'viem/accounts';
+// ──────────────────── Client ────────────────────
+export class X402Client {
+    constructor(config) {
+        this.config = config;
+        // ── Step 1: Resolve base signer from privateKey or walletClient ──
+        let baseSigner;
+        if ('walletClient' in config && config.walletClient) {
+            // External WalletClient mode (Privy, Turnkey, MetaMask, etc.)
+            const wc = config.walletClient;
+            const account = wc.account;
+            if (!account) {
+                throw new Error('X402Client: walletClient must have an attached account. ' +
+                    'Pass an account when creating the WalletClient or use privateKey mode instead.');
+            }
+            this.address = account.address;
+            // Adapt WalletClient to the signer interface expected by @x402/evm
+            baseSigner = {
+                address: account.address,
+                signTypedData: (msg) => wc.signTypedData({
+                    account,
+                    domain: msg.domain,
+                    types: msg.types,
+                    primaryType: msg.primaryType,
+                    message: msg.message,
+                }),
+            };
+        }
+        else if ('privateKey' in config && config.privateKey) {
+            // Private key mode (existing behavior — SDK manages wallet)
+            const privateKey = config.privateKey.startsWith('0x')
+                ? config.privateKey
+                : `0x${config.privateKey}`;
+            const account = privateKeyToAccount(privateKey);
+            this.address = account.address;
+            baseSigner = account;
+        }
+        else {
+            throw new Error('X402Client: provide either privateKey or walletClient in config.');
+        }
+        // ── Step 2: Wrap signer for smart-wallet (AgentAccount) if accountAddress is set ──
+        // When accountAddress is provided, EIP-3009 `from` must be the contract, and
+        // the signature must be >65 bytes so the x402 facilitator routes through USDC's
+        // `bytes signature` overload of transferWithAuthorization — triggering EIP-1271
+        // `isValidSignature` on the AgentAccount contract.
+        let signer;
+        if (config.accountAddress) {
+            const accountAddr = config.accountAddress;
+            const inner = baseSigner;
+            signer = toAccount({
+                address: accountAddr,
+                async signMessage({ message }) {
+                    if ('signMessage' in inner && typeof inner.signMessage === 'function') {
+                        return inner.signMessage({ message });
+                    }
+                    throw new Error('signMessage not supported by underlying signer');
+                },
+                async signTransaction(tx) {
+                    if ('signTransaction' in inner && typeof inner.signTransaction === 'function') {
+                        return inner.signTransaction(tx);
+                    }
+                    throw new Error('signTransaction not supported by underlying signer');
+                },
+                async signTypedData(typedData) {
+                    const sig = await inner.signTypedData(typedData);
+                    // For Safe7579: prepend validator module address so isValidSignature
+                    // routes through Safe7579 → validator.isValidSignatureWithSender()
+                    if (config.validatorModule) {
+                        const validatorHex = config.validatorModule.replace('0x', '').toLowerCase();
+                        const sigHex = sig.replace('0x', '');
+                        return `0x${validatorHex}${sigHex}`;
+                    }
+                    // Fallback: append 00 to trigger EIP-1271 via >65 byte sig
+                    return `${sig}00`;
+                },
+            });
+            this.address = accountAddr;
+        }
+        else {
+            signer = baseSigner;
+        }
+        // Create x402 client and register EVM scheme (handles EIP-3009 signing)
+        const client = new x402Client();
+        registerExactEvmScheme(client, { signer });
+        // Wrap native fetch with automatic 402 payment handling
+        this.paidFetch = wrapFetchWithPayment(fetch, client);
+        // Initialize spending tracker
+        const today = new Date().toISOString().split('T')[0];
+        const dailyLimit = config.dailySpendLimitUsdc
+            ? BigInt(Math.round(parseFloat(config.dailySpendLimitUsdc) * 1e6))
+            : 0n;
+        this._spendingTracker = { date: today, totalBorrowed: 0n, dailyLimit };
+    }
+    async get(url, opts) {
+        return this.request(url, { ...opts, method: 'GET' });
+    }
+    async post(url, body, opts) {
+        return this.request(url, {
+            ...opts,
+            method: 'POST',
+            body: body ? JSON.stringify(body) : undefined,
+            headers: { 'Content-Type': 'application/json', ...opts?.headers },
+        });
+    }
+    getAddress() {
+        return this.address;
+    }
+    /** Get the current spending tracker state */
+    getSpendingTracker() {
+        this._resetTrackerIfNewDay();
+        return { ...this._spendingTracker };
+    }
+    /** Get remaining daily spending allowance in USDC (human-readable) */
+    getRemainingDailyAllowance() {
+        this._resetTrackerIfNewDay();
+        if (this._spendingTracker.dailyLimit === 0n)
+            return 'unlimited';
+        const remaining = this._spendingTracker.dailyLimit - this._spendingTracker.totalBorrowed;
+        return (Number(remaining > 0n ? remaining : 0n) / 1e6).toFixed(2);
+    }
+    /**
+     * Pay with auto-draw: Make an x402 request with automatic Morpho borrowing.
+     *
+     * Flow:
+     * 1. Check USDC balance on AgentAccount
+     * 2. Probe the URL to discover payment amount (if 402)
+     * 3. If insufficient USDC, calculate deficit
+     * 4. Check spending limit
+     * 5. Borrow from Morpho via MorphoClient
+     * 6. Proceed with x402 payment
+     */
+    async payWithAutoDraw(url, opts) {
+        const { morphoClient, ...fetchOpts } = opts || {};
+        // If auto-draw is not enabled or no morphoClient, fall back to normal request
+        if (!this.config.autoDraw || !morphoClient) {
+            return this.request(url, fetchOpts);
+        }
+        try {
+            // Step 1: Check current USDC balance on AgentAccount
+            const usdcBalance = await morphoClient.getUsdcBalance();
+            console.log(`   [auto-draw] AgentAccount USDC balance: ${(Number(usdcBalance) / 1e6).toFixed(2)}`);
+            // Step 2: Probe the URL to discover payment amount
+            const paymentAmount = await this._probePaymentAmount(url, fetchOpts);
+            if (paymentAmount !== null) {
+                console.log(`   [auto-draw] Payment required: ${(Number(paymentAmount) / 1e6).toFixed(6)} USDC`);
+                // Step 3: Check if we need to borrow
+                const bufferStr = this.config.autoDrawBuffer || '0.5';
+                const buffer = BigInt(Math.round(parseFloat(bufferStr) * 1e6));
+                const needed = paymentAmount + buffer;
+                if (usdcBalance < needed) {
+                    const deficit = needed - usdcBalance;
+                    console.log(`   [auto-draw] Insufficient balance. Need to borrow ${(Number(deficit) / 1e6).toFixed(2)} USDC`);
+                    // Step 4: Check spending limits
+                    const limitCheck = await this._checkSpendingLimit(deficit, morphoClient);
+                    if (!limitCheck.allowed) {
+                        return {
+                            success: false,
+                            error: `Auto-draw blocked: ${limitCheck.reason}`,
+                        };
+                    }
+                    // Step 5: Check if borrowing is possible (collateral check)
+                    const maxBorrowable = await morphoClient.getMaxBorrowable();
+                    if (maxBorrowable.total < deficit) {
+                        return {
+                            success: false,
+                            error: `Auto-draw failed: insufficient collateral. Need ${(Number(deficit) / 1e6).toFixed(2)} USDC but can only borrow ${(Number(maxBorrowable.total) / 1e6).toFixed(2)} USDC more.`,
+                        };
+                    }
+                    // Step 6: Borrow the deficit
+                    const borrowAmount = (Number(deficit) / 1e6).toFixed(6);
+                    console.log(`   [auto-draw] Borrowing ${borrowAmount} USDC from Morpho...`);
+                    const borrowResult = await morphoClient.borrow(borrowAmount);
+                    console.log(`   [auto-draw] Borrow tx: ${borrowResult.tx}`);
+                    // Track spending
+                    this._trackSpending(deficit);
+                    // Step 7: Now proceed with the x402 payment
+                    const result = await this.request(url, fetchOpts);
+                    return {
+                        ...result,
+                        autoDrawInfo: {
+                            borrowed: borrowAmount,
+                            borrowTx: borrowResult.tx,
+                            reason: `USDC balance insufficient (had ${(Number(usdcBalance) / 1e6).toFixed(2)}, needed ${(Number(needed) / 1e6).toFixed(2)})`,
+                        },
+                    };
+                }
+            }
+            // Balance sufficient or couldn't determine amount — proceed normally
+            return this.request(url, fetchOpts);
+        }
+        catch (error) {
+            // If auto-draw fails, still try the normal request
+            console.log(`   [auto-draw] Auto-draw check failed: ${error instanceof Error ? error.message : String(error)}. Proceeding with normal request.`);
+            return this.request(url, fetchOpts);
+        }
+    }
+    // ──────────── Core request — @x402/fetch handles 402 automatically ────────────
+    async request(url, options) {
+        try {
+            console.log(`   [x402] ${options?.method || 'GET'} ${url}`);
+            const response = await this.paidFetch(url, {
+                ...options,
+                headers: {
+                    ...options?.headers,
+                    'X-Agent-Id': this.config.agentId || '',
+                },
+            });
+            if (response.ok) {
+                const data = await response.json();
+                // Check for settlement response header
+                const paymentResponse = response.headers.get('PAYMENT-RESPONSE');
+                let txHash;
+                if (paymentResponse) {
+                    try {
+                        const settlement = JSON.parse(Buffer.from(paymentResponse, 'base64').toString('utf-8'));
+                        txHash = settlement.transaction;
+                    }
+                    catch (e) {
+                        console.warn('[agether] x402 payment response parse failed:', e instanceof Error ? e.message : e);
+                    }
+                }
+                return {
+                    success: true,
+                    data,
+                    ...(txHash ? {
+                        paymentInfo: {
+                            amount: '',
+                            asset: 'USDC',
+                            network: 'eip155:8453',
+                            txHash,
+                        },
+                    } : {}),
+                };
+            }
+            // If we get here, @x402/fetch already tried to pay but the server rejected
+            const errBody = await response.text();
+            return {
+                success: false,
+                error: `HTTP ${response.status}: ${errBody}`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Request failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    // ──────────── Auto-Draw Helpers ────────────
+    /**
+     * Probe a URL to discover payment requirements without paying.
+     * Makes a request and parses the 402 PAYMENT-REQUIRED header.
+     * @returns Payment amount in raw USDC units (6 decimals), or null if not a 402.
+     */
+    async _probePaymentAmount(url, options) {
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers: {
+                    ...options?.headers,
+                    'X-Agent-Id': this.config.agentId || '',
+                },
+            });
+            if (response.status !== 402)
+                return null;
+            // Parse PAYMENT-REQUIRED header (base64 JSON)
+            const paymentHeader = response.headers.get('X-PAYMENT') || response.headers.get('PAYMENT-REQUIRED');
+            if (!paymentHeader)
+                return null;
+            try {
+                const decoded = JSON.parse(Buffer.from(paymentHeader, 'base64').toString('utf-8'));
+                const requirements = Array.isArray(decoded) ? decoded : decoded.accepts || [decoded];
+                if (requirements.length > 0) {
+                    const amount = requirements[0].maxAmountRequired || requirements[0].amount;
+                    if (amount) {
+                        return BigInt(amount);
+                    }
+                }
+            }
+            catch (e) {
+                console.warn('[agether] x402 payment header parse failed:', e instanceof Error ? e.message : e);
+            }
+            return null;
+        }
+        catch (e) {
+            console.warn('[agether] x402 getPaymentRequired failed:', e instanceof Error ? e.message : e);
+            return null;
+        }
+    }
+    /** Reset spending tracker if it's a new day */
+    _resetTrackerIfNewDay() {
+        const today = new Date().toISOString().split('T')[0];
+        if (this._spendingTracker.date !== today) {
+            this._spendingTracker = {
+                date: today,
+                totalBorrowed: 0n,
+                dailyLimit: this._spendingTracker.dailyLimit,
+            };
+        }
+    }
+    /** Track a new spending amount */
+    _trackSpending(amount) {
+        this._resetTrackerIfNewDay();
+        this._spendingTracker.totalBorrowed += amount;
+    }
+    /**
+     * Check if a borrow amount is within spending limits.
+     * Considers both fixed daily limits and yield-limited spending.
+     */
+    async _checkSpendingLimit(amount, morphoClient) {
+        this._resetTrackerIfNewDay();
+        // If yield-limited spending is enabled, calculate dynamic limit
+        if (this.config.yieldLimitedSpending) {
+            try {
+                const status = await morphoClient.getStatus();
+                let totalDailyYieldUsdc = 0;
+                for (const pos of status.positions) {
+                    if (parseFloat(pos.collateral) > 0) {
+                        try {
+                            const estimate = await morphoClient.getYieldEstimate(pos.collateralToken, pos.collateral, 1);
+                            totalDailyYieldUsdc += estimate.estimatedYieldUsd;
+                        }
+                        catch (e) {
+                            console.warn(`[agether] yield calc failed for ${pos.collateralToken}:`, e instanceof Error ? e.message : e);
+                        }
+                    }
+                }
+                const yieldLimit = BigInt(Math.round(totalDailyYieldUsdc * 1e6));
+                const newTotal = this._spendingTracker.totalBorrowed + amount;
+                if (yieldLimit > 0n && newTotal > yieldLimit) {
+                    return {
+                        allowed: false,
+                        reason: `Yield-limited spending exceeded. Daily yield cap: $${(Number(yieldLimit) / 1e6).toFixed(2)}, already spent: $${(Number(this._spendingTracker.totalBorrowed) / 1e6).toFixed(2)}, requested: $${(Number(amount) / 1e6).toFixed(2)}`,
+                    };
+                }
+            }
+            catch (e) {
+                console.warn('[agether] yield-limited spending check failed, falling through to fixed limit:', e instanceof Error ? e.message : e);
+            }
+        }
+        // Check fixed daily limit
+        if (this._spendingTracker.dailyLimit > 0n) {
+            const newTotal = this._spendingTracker.totalBorrowed + amount;
+            if (newTotal > this._spendingTracker.dailyLimit) {
+                return {
+                    allowed: false,
+                    reason: `Daily spending limit exceeded. Limit: $${(Number(this._spendingTracker.dailyLimit) / 1e6).toFixed(2)}, already spent: $${(Number(this._spendingTracker.totalBorrowed) / 1e6).toFixed(2)}, requested: $${(Number(amount) / 1e6).toFixed(2)}`,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+}

package/dist/index.d.mts

@@ -347,6 +347,36 @@ interface FundResult {
     amount: string;
     agentAccount: string;
 }
+interface SupplyAssetResult {
+    tx: string;
+    amount: string;
+    marketId: string;
+    collateralToken: string;
+    agentAccount: string;
+}
+interface SupplyPositionResult {
+    marketId: string;
+    loanToken: string;
+    collateralToken: string;
+    supplyShares: string;
+    suppliedAssets: string;
+    netDeposited: string;
+    earnedYield: string;
+    supplyApy: number;
+}
+interface WithdrawSupplyResult {
+    tx: string;
+    amount: string;
+    remainingSupply: string;
+    destination: string;
+}
+interface PayFromYieldResult {
+    tx: string;
+    yieldWithdrawn: string;
+    recipient: string;
+    remainingYield: string;
+    remainingSupply: string;
+}
 declare class MorphoClient {
     private _signer;
     private provider;
@@ -364,6 +394,8 @@ declare class MorphoClient {
     private validationModule;
     private _accountAddress?;
     private _marketCache;
+    /** Dynamic token registry: symbol (uppercase) → { address, symbol, decimals } */
+    private _tokenCache;
     private _discoveredMarkets?;
     private _discoveredAt;
     constructor(config: MorphoClientConfig);
@@ -483,6 +515,48 @@ declare class MorphoClient {
         collateralValueUsd: number;
         disclaimer: string;
     }>;
+    /**
+     * Supply USDC 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
+     * interest paid by borrowers.
+     *
+     * @param usdcAmount - Amount of USDC to supply (e.g. '500')
+     * @param collateralSymbol - Market collateral token to identify which market (e.g. 'WETH')
+     *                           Optional — defaults to highest-APY market
+     */
+    supplyAsset(usdcAmount: string, collateralSymbol?: string): Promise<SupplyAssetResult>;
+    /**
+     * Withdraw supplied USDC (+ earned interest) from a Morpho Blue market.
+     *
+     * @param usdcAmount - 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)
+     */
+    withdrawSupply(usdcAmount: string, collateralSymbol?: string, receiver?: string): Promise<WithdrawSupplyResult>;
+    /**
+     * Get supply (lending) positions with yield tracking.
+     *
+     * Uses Morpho GraphQL API (no eth_getLogs / no DB / no indexer):
+     *   1. `userByAddress` → all market positions with current supplyAssets, supplyApy
+     *   2. `transactions` → all MarketSupply/MarketWithdraw history for net deposited
+     *   3. earnedYield = currentSupplyAssets − netDeposited
+     *
+     * @param collateralSymbol - Market collateral token (optional, returns all if omitted)
+     */
+    getSupplyPositions(collateralSymbol?: string): Promise<SupplyPositionResult[]>;
+    /**
+     * Pay a recipient using ONLY earned yield from a supply position.
+     *
+     * 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 collateralSymbol - Market collateral to identify which supply position
+     */
+    payFromYield(recipient: string, usdcAmount: string, collateralSymbol?: string): Promise<PayFromYieldResult>;
     /**
      * Deposit collateral into Morpho Blue.
      *
@@ -588,6 +662,34 @@ declare class MorphoClient {
     private _toTuple;
     /** Find the first market where the agent has collateral deposited. */
     private _findActiveMarket;
+    /** Find the first market where the agent has a supply (lending) position. */
+    private _findActiveSupplyMarket;
+    /**
+     * Resolve a token symbol or address to { address, symbol, decimals }.
+     *
+     * Uses the dynamic `_tokenCache` populated by `getMarkets()` from the
+     * Morpho GraphQL API — no hardcoded token list needed.
+     *
+     * @param symbolOrAddress - e.g. 'WETH', 'wstETH', or '0x4200...'
+     */
+    private _resolveToken;
+    /**
+     * Get all discovered collateral tokens (for balance iteration, etc.).
+     * Returns unique tokens from the Morpho API market discovery.
+     */
+    private _getDiscoveredTokens;
+    /**
+     * Compute net deposited amounts per market using Morpho GraphQL API.
+     *
+     * Fetches all MarketSupply and MarketWithdraw transactions for the account,
+     * then computes: netDeposited[marketId] = Σ Supply.assets − Σ Withdraw.assets
+     *
+     * Returns a Map<marketId (lowercase), bigint>.
+     *
+     * Uses pagination (100 per page) for completeness, though agent accounts
+     * typically have single-digit transaction counts.
+     */
+    private _computeNetDepositedAll;
 }
 
 /**
@@ -1125,4 +1227,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-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, type FundResult, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, 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 TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, 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, type FundResult, 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 WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, parseUnits, rateToBps };

package/dist/index.d.ts

@@ -347,6 +347,36 @@ interface FundResult {
     amount: string;
     agentAccount: string;
 }
+interface SupplyAssetResult {
+    tx: string;
+    amount: string;
+    marketId: string;
+    collateralToken: string;
+    agentAccount: string;
+}
+interface SupplyPositionResult {
+    marketId: string;
+    loanToken: string;
+    collateralToken: string;
+    supplyShares: string;
+    suppliedAssets: string;
+    netDeposited: string;
+    earnedYield: string;
+    supplyApy: number;
+}
+interface WithdrawSupplyResult {
+    tx: string;
+    amount: string;
+    remainingSupply: string;
+    destination: string;
+}
+interface PayFromYieldResult {
+    tx: string;
+    yieldWithdrawn: string;
+    recipient: string;
+    remainingYield: string;
+    remainingSupply: string;
+}
 declare class MorphoClient {
     private _signer;
     private provider;
@@ -364,6 +394,8 @@ declare class MorphoClient {
     private validationModule;
     private _accountAddress?;
     private _marketCache;
+    /** Dynamic token registry: symbol (uppercase) → { address, symbol, decimals } */
+    private _tokenCache;
     private _discoveredMarkets?;
     private _discoveredAt;
     constructor(config: MorphoClientConfig);
@@ -483,6 +515,48 @@ declare class MorphoClient {
         collateralValueUsd: number;
         disclaimer: string;
     }>;
+    /**
+     * Supply USDC 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
+     * interest paid by borrowers.
+     *
+     * @param usdcAmount - Amount of USDC to supply (e.g. '500')
+     * @param collateralSymbol - Market collateral token to identify which market (e.g. 'WETH')
+     *                           Optional — defaults to highest-APY market
+     */
+    supplyAsset(usdcAmount: string, collateralSymbol?: string): Promise<SupplyAssetResult>;
+    /**
+     * Withdraw supplied USDC (+ earned interest) from a Morpho Blue market.
+     *
+     * @param usdcAmount - 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)
+     */
+    withdrawSupply(usdcAmount: string, collateralSymbol?: string, receiver?: string): Promise<WithdrawSupplyResult>;
+    /**
+     * Get supply (lending) positions with yield tracking.
+     *
+     * Uses Morpho GraphQL API (no eth_getLogs / no DB / no indexer):
+     *   1. `userByAddress` → all market positions with current supplyAssets, supplyApy
+     *   2. `transactions` → all MarketSupply/MarketWithdraw history for net deposited
+     *   3. earnedYield = currentSupplyAssets − netDeposited
+     *
+     * @param collateralSymbol - Market collateral token (optional, returns all if omitted)
+     */
+    getSupplyPositions(collateralSymbol?: string): Promise<SupplyPositionResult[]>;
+    /**
+     * Pay a recipient using ONLY earned yield from a supply position.
+     *
+     * 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 collateralSymbol - Market collateral to identify which supply position
+     */
+    payFromYield(recipient: string, usdcAmount: string, collateralSymbol?: string): Promise<PayFromYieldResult>;
     /**
      * Deposit collateral into Morpho Blue.
      *
@@ -588,6 +662,34 @@ declare class MorphoClient {
     private _toTuple;
     /** Find the first market where the agent has collateral deposited. */
     private _findActiveMarket;
+    /** Find the first market where the agent has a supply (lending) position. */
+    private _findActiveSupplyMarket;
+    /**
+     * Resolve a token symbol or address to { address, symbol, decimals }.
+     *
+     * Uses the dynamic `_tokenCache` populated by `getMarkets()` from the
+     * Morpho GraphQL API — no hardcoded token list needed.
+     *
+     * @param symbolOrAddress - e.g. 'WETH', 'wstETH', or '0x4200...'
+     */
+    private _resolveToken;
+    /**
+     * Get all discovered collateral tokens (for balance iteration, etc.).
+     * Returns unique tokens from the Morpho API market discovery.
+     */
+    private _getDiscoveredTokens;
+    /**
+     * Compute net deposited amounts per market using Morpho GraphQL API.
+     *
+     * Fetches all MarketSupply and MarketWithdraw transactions for the account,
+     * then computes: netDeposited[marketId] = Σ Supply.assets − Σ Withdraw.assets
+     *
+     * Returns a Map<marketId (lowercase), bigint>.
+     *
+     * Uses pagination (100 per page) for completeness, though agent accounts
+     * typically have single-digit transaction counts.
+     */
+    private _computeNetDepositedAll;
 }
 
 /**
@@ -1125,4 +1227,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-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, type FundResult, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, 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 TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, 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, type FundResult, 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 WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, 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;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,UAAU,EACV,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,MAAM,gBAAgB,CAAC"}