@agether/sdk 1.6.0 → 1.6.2

package/dist/index.d.mts

@@ -318,6 +318,71 @@ declare class MorphoClient {
      * Full status: positions across all discovered markets.
      */
     getStatus(): Promise<StatusResult>;
+    /**
+     * Get the USDC balance of the AgentAccount.
+     * @returns USDC balance in raw units (6 decimals)
+     */
+    getUsdcBalance(): Promise<bigint>;
+    /**
+     * Calculate the maximum additional USDC that can be borrowed
+     * given the agent's current collateral and debt across all markets.
+     *
+     * For each market with collateral deposited:
+     *   maxBorrow = (collateralValue * LLTV) - currentDebt
+     *
+     * Uses the Morpho oracle to price collateral → loan token.
+     *
+     * @returns Maximum additional USDC borrowable (6 decimals)
+     */
+    getMaxBorrowable(): Promise<{
+        total: bigint;
+        byMarket: Array<{
+            collateralToken: string;
+            maxAdditional: bigint;
+            currentDebt: bigint;
+            collateralValue: bigint;
+        }>;
+    }>;
+    /**
+     * Fetch current supply/borrow APY for a collateral market 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.
+     */
+    getMarketRates(collateralSymbolOrAddress?: string): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        supplyApy: number;
+        borrowApy: number;
+        utilization: number;
+        totalSupplyUsd: number;
+        totalBorrowUsd: number;
+        lltv: string;
+        marketId: string;
+    }>>;
+    /**
+     * Estimate theoretical yield for a given collateral amount over a period.
+     *
+     * ⚠️ IMPORTANT: On Morpho Blue, collateral does NOT earn yield directly.
+     * This estimates what the collateral WOULD earn if it were instead supplied
+     * as a lender (not used as collateral). This is a theoretical upper bound
+     * useful for setting spending caps.
+     *
+     * @param collateralSymbol - e.g. 'WETH'
+     * @param amount - collateral amount in human-readable (e.g. '1.5')
+     * @param periodDays - estimation period in days (default: 1)
+     * @param ethPriceUsd - ETH price in USD for value conversion (if not provided, uses oracle)
+     * @returns Estimated yield in USD for the period
+     */
+    getYieldEstimate(collateralSymbol: string, amount: string, periodDays?: number, ethPriceUsd?: number): Promise<{
+        collateralToken: string;
+        amount: string;
+        periodDays: number;
+        theoreticalSupplyApy: number;
+        estimatedYieldUsd: number;
+        collateralValueUsd: number;
+        disclaimer: string;
+    }>;
     /**
      * Deposit collateral into Morpho Blue.
      *
@@ -409,6 +474,13 @@ declare class MorphoClient {
  *   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).
  */
 interface X402Config {
@@ -417,6 +489,27 @@ interface X402Config {
     backendUrl: string;
     agentId?: string;
     accountAddress?: string;
+    /**
+     * Auto-draw: automatically borrow from Morpho Blue when USDC balance
+     * is insufficient for x402 payment. Requires agentId to be set.
+     * Default: false
+     */
+    autoDraw?: boolean;
+    /**
+     * Daily spending limit in USDC (e.g. '100' for $100/day).
+     * Tracks cumulative daily borrows and rejects auto-draw if exceeded.
+     */
+    dailySpendLimitUsdc?: string;
+    /**
+     * When true, auto-calculates the daily spending limit based on
+     * theoretical yield of deposited collateral. Overrides dailySpendLimitUsdc.
+     */
+    yieldLimitedSpending?: boolean;
+    /**
+     * Safety margin: borrow this much extra beyond what's needed (in USDC, e.g. '1').
+     * Helps avoid rounding issues. Default: '0.5'
+     */
+    autoDrawBuffer?: string;
 }
 interface X402Response<T = unknown> {
     success: boolean;
@@ -428,6 +521,11 @@ interface X402Response<T = unknown> {
         network: string;
         txHash?: string;
     };
+    autoDrawInfo?: {
+        borrowed: string;
+        borrowTx: string;
+        reason: string;
+    };
 }
 /** One item inside the `accepts` array returned by the resource server */
 interface PaymentRequirements {
@@ -439,15 +537,58 @@ interface PaymentRequirements {
     maxTimeoutSeconds: number;
     extra?: Record<string, unknown>;
 }
+/** Spending tracker — tracks cumulative daily borrows */
+interface SpendingTracker {
+    /** Date string (YYYY-MM-DD UTC) */
+    date: string;
+    /** Cumulative USDC borrowed today (6 decimal raw units) */
+    totalBorrowed: bigint;
+    /** Daily limit in raw units (6 decimals), 0 = unlimited */
+    dailyLimit: bigint;
+}
 declare class X402Client {
     private config;
     private paidFetch;
     private address;
+    private _spendingTracker;
     constructor(config: X402Config);
     get<T = unknown>(url: string, opts?: RequestInit): Promise<X402Response<T>>;
     post<T = unknown>(url: string, body?: unknown, opts?: RequestInit): Promise<X402Response<T>>;
     getAddress(): string;
+    /** Get the current spending tracker state */
+    getSpendingTracker(): SpendingTracker;
+    /** Get remaining daily spending allowance in USDC (human-readable) */
+    getRemainingDailyAllowance(): string;
+    /**
+     * 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
+     */
+    payWithAutoDraw<T = unknown>(url: string, opts?: RequestInit & {
+        morphoClient?: any;
+    }): Promise<X402Response<T>>;
     private request;
+    /**
+     * 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.
+     */
+    private _probePaymentAmount;
+    /** Reset spending tracker if it's a new day */
+    private _resetTrackerIfNewDay;
+    /** Track a new spending amount */
+    private _trackSpending;
+    /**
+     * Check if a borrow amount is within spending limits.
+     * Considers both fixed daily limits and yield-limited spending.
+     */
+    private _checkSpendingLimit;
 }
 
 /**
@@ -805,4 +946,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, 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_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, 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 };

package/dist/index.d.ts

@@ -318,6 +318,71 @@ declare class MorphoClient {
      * Full status: positions across all discovered markets.
      */
     getStatus(): Promise<StatusResult>;
+    /**
+     * Get the USDC balance of the AgentAccount.
+     * @returns USDC balance in raw units (6 decimals)
+     */
+    getUsdcBalance(): Promise<bigint>;
+    /**
+     * Calculate the maximum additional USDC that can be borrowed
+     * given the agent's current collateral and debt across all markets.
+     *
+     * For each market with collateral deposited:
+     *   maxBorrow = (collateralValue * LLTV) - currentDebt
+     *
+     * Uses the Morpho oracle to price collateral → loan token.
+     *
+     * @returns Maximum additional USDC borrowable (6 decimals)
+     */
+    getMaxBorrowable(): Promise<{
+        total: bigint;
+        byMarket: Array<{
+            collateralToken: string;
+            maxAdditional: bigint;
+            currentDebt: bigint;
+            collateralValue: bigint;
+        }>;
+    }>;
+    /**
+     * Fetch current supply/borrow APY for a collateral market 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.
+     */
+    getMarketRates(collateralSymbolOrAddress?: string): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        supplyApy: number;
+        borrowApy: number;
+        utilization: number;
+        totalSupplyUsd: number;
+        totalBorrowUsd: number;
+        lltv: string;
+        marketId: string;
+    }>>;
+    /**
+     * Estimate theoretical yield for a given collateral amount over a period.
+     *
+     * ⚠️ IMPORTANT: On Morpho Blue, collateral does NOT earn yield directly.
+     * This estimates what the collateral WOULD earn if it were instead supplied
+     * as a lender (not used as collateral). This is a theoretical upper bound
+     * useful for setting spending caps.
+     *
+     * @param collateralSymbol - e.g. 'WETH'
+     * @param amount - collateral amount in human-readable (e.g. '1.5')
+     * @param periodDays - estimation period in days (default: 1)
+     * @param ethPriceUsd - ETH price in USD for value conversion (if not provided, uses oracle)
+     * @returns Estimated yield in USD for the period
+     */
+    getYieldEstimate(collateralSymbol: string, amount: string, periodDays?: number, ethPriceUsd?: number): Promise<{
+        collateralToken: string;
+        amount: string;
+        periodDays: number;
+        theoreticalSupplyApy: number;
+        estimatedYieldUsd: number;
+        collateralValueUsd: number;
+        disclaimer: string;
+    }>;
     /**
      * Deposit collateral into Morpho Blue.
      *
@@ -409,6 +474,13 @@ declare class MorphoClient {
  *   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).
  */
 interface X402Config {
@@ -417,6 +489,27 @@ interface X402Config {
     backendUrl: string;
     agentId?: string;
     accountAddress?: string;
+    /**
+     * Auto-draw: automatically borrow from Morpho Blue when USDC balance
+     * is insufficient for x402 payment. Requires agentId to be set.
+     * Default: false
+     */
+    autoDraw?: boolean;
+    /**
+     * Daily spending limit in USDC (e.g. '100' for $100/day).
+     * Tracks cumulative daily borrows and rejects auto-draw if exceeded.
+     */
+    dailySpendLimitUsdc?: string;
+    /**
+     * When true, auto-calculates the daily spending limit based on
+     * theoretical yield of deposited collateral. Overrides dailySpendLimitUsdc.
+     */
+    yieldLimitedSpending?: boolean;
+    /**
+     * Safety margin: borrow this much extra beyond what's needed (in USDC, e.g. '1').
+     * Helps avoid rounding issues. Default: '0.5'
+     */
+    autoDrawBuffer?: string;
 }
 interface X402Response<T = unknown> {
     success: boolean;
@@ -428,6 +521,11 @@ interface X402Response<T = unknown> {
         network: string;
         txHash?: string;
     };
+    autoDrawInfo?: {
+        borrowed: string;
+        borrowTx: string;
+        reason: string;
+    };
 }
 /** One item inside the `accepts` array returned by the resource server */
 interface PaymentRequirements {
@@ -439,15 +537,58 @@ interface PaymentRequirements {
     maxTimeoutSeconds: number;
     extra?: Record<string, unknown>;
 }
+/** Spending tracker — tracks cumulative daily borrows */
+interface SpendingTracker {
+    /** Date string (YYYY-MM-DD UTC) */
+    date: string;
+    /** Cumulative USDC borrowed today (6 decimal raw units) */
+    totalBorrowed: bigint;
+    /** Daily limit in raw units (6 decimals), 0 = unlimited */
+    dailyLimit: bigint;
+}
 declare class X402Client {
     private config;
     private paidFetch;
     private address;
+    private _spendingTracker;
     constructor(config: X402Config);
     get<T = unknown>(url: string, opts?: RequestInit): Promise<X402Response<T>>;
     post<T = unknown>(url: string, body?: unknown, opts?: RequestInit): Promise<X402Response<T>>;
     getAddress(): string;
+    /** Get the current spending tracker state */
+    getSpendingTracker(): SpendingTracker;
+    /** Get remaining daily spending allowance in USDC (human-readable) */
+    getRemainingDailyAllowance(): string;
+    /**
+     * 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
+     */
+    payWithAutoDraw<T = unknown>(url: string, opts?: RequestInit & {
+        morphoClient?: any;
+    }): Promise<X402Response<T>>;
     private request;
+    /**
+     * 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.
+     */
+    private _probePaymentAmount;
+    /** Reset spending tracker if it's a new day */
+    private _resetTrackerIfNewDay;
+    /** Track a new spending amount */
+    private _trackSpending;
+    /**
+     * Check if a borrow amount is within spending limits.
+     * Considers both fixed daily limits and yield-limited spending.
+     */
+    private _checkSpendingLimit;
 }
 
 /**
@@ -805,4 +946,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, 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_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, 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 };

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,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,UAAU,GACX,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,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI3G,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,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,SAAS,GACV,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}