@agether/sdk 1.6.1 → 1.6.2

package/dist/clients/MorphoClient.d.ts

@@ -0,0 +1,287 @@
+/**
+ * MorphoClient — Direct Morpho Blue lending via AgentAccount.executeBatch
+ *
+ * Architecture (no intermediary contract):
+ *   EOA → AgentAccount.executeBatch → Morpho Blue (direct)
+ *
+ * Batched operations:
+ *   - depositAndBorrow: [ERC20.approve, Morpho.supplyCollateral, Morpho.borrow]
+ *   - repay:            [ERC20.approve, Morpho.repay]
+ *   - supplyCollateral:  [ERC20.approve, Morpho.supplyCollateral]
+ *
+ * Market discovery via Morpho GraphQL API (https://api.morpho.org/graphql)
+ */
+import { MorphoMarketParams, MorphoMarketInfo, MorphoPosition, ScoreAttestation, ChainId } from '../types';
+export interface MorphoClientConfig {
+    privateKey: string;
+    rpcUrl: string;
+    agentId?: string;
+    chainId?: ChainId;
+    contracts?: Partial<{
+        accountFactory: string;
+        morphoBlue: string;
+        usdc: string;
+        agentReputation: string;
+        identityRegistry: string;
+    }>;
+}
+export interface BalancesResult {
+    agentId: string;
+    address: string;
+    eth: string;
+    usdc: string;
+    collateral: Record<string, string>;
+    agentAccount?: {
+        address: string;
+        eth: string;
+        usdc: string;
+        collateral: Record<string, string>;
+    };
+}
+export interface RegisterResult {
+    agentId: string;
+    address: string;
+    agentAccount: string;
+    alreadyRegistered: boolean;
+    tx?: string;
+}
+export interface PositionResult {
+    marketId: string;
+    collateralToken: string;
+    collateral: string;
+    borrowShares: string;
+    supplyShares: string;
+    debt: string;
+}
+export interface StatusResult {
+    agentId: string;
+    agentAccount: string;
+    totalDebt: string;
+    positions: PositionResult[];
+}
+export interface DepositResult {
+    tx: string;
+    collateralToken: string;
+    amount: string;
+    agentAccount: string;
+}
+export interface BorrowResult {
+    tx: string;
+    amount: string;
+    collateralToken: string;
+    agentAccount: string;
+}
+export interface DepositAndBorrowResult {
+    tx: string;
+    collateralToken: string;
+    collateralAmount: string;
+    borrowAmount: string;
+    agentAccount: string;
+}
+export interface RepayResult {
+    tx: string;
+    amount: string;
+    remainingDebt: string;
+}
+export interface WithdrawResult {
+    tx: string;
+    token: string;
+    amount: string;
+    remainingCollateral: string;
+    destination: string;
+}
+export interface FundResult {
+    tx: string;
+    amount: string;
+    agentAccount: string;
+}
+export declare class MorphoClient {
+    private wallet;
+    private provider;
+    private config;
+    private agentId;
+    private accountFactory;
+    private morphoBlue;
+    private agentReputation;
+    private identityRegistry;
+    private _accountAddress?;
+    private _marketCache;
+    private _discoveredMarkets?;
+    private _discoveredAt;
+    constructor(config: MorphoClientConfig);
+    /** Resolve the AgentAccount address (cached). */
+    getAccountAddress(): Promise<string>;
+    getAgentId(): string;
+    getWalletAddress(): string;
+    /** Mint a new ERC-8004 identity and return the agentId. */
+    private _mintNewIdentity;
+    /**
+     * Register: create ERC-8004 identity + AgentAccount in one flow.
+     * If already registered, returns existing state.
+     */
+    register(_name?: string): Promise<RegisterResult>;
+    /** Get ETH / USDC / collateral balances for EOA and AgentAccount. */
+    getBalances(): Promise<BalancesResult>;
+    /** Transfer USDC from EOA to AgentAccount. */
+    fundAccount(usdcAmount: string): Promise<FundResult>;
+    /**
+     * Fetch USDC borrow markets on Base from Morpho API.
+     * Caches results for 5 minutes.
+     */
+    getMarkets(forceRefresh?: boolean): Promise<MorphoMarketInfo[]>;
+    /**
+     * Get MarketParams for a collateral token.
+     * Tries cache → API → on-chain idToMarketParams.
+     */
+    findMarketForCollateral(collateralSymbolOrAddress: string): Promise<MorphoMarketParams>;
+    /** Read MarketParams on-chain by market ID (bytes32). */
+    getMarketParams(marketId: string): Promise<MorphoMarketParams>;
+    /** Read on-chain position for a specific market. */
+    getPosition(marketId: string): Promise<MorphoPosition>;
+    /**
+     * 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.
+     *
+     * Flow:
+     * 1. EOA transfers collateral to AgentAccount
+     * 2. AgentAccount.executeBatch:
+     *    [collateral.approve(MorphoBlue), Morpho.supplyCollateral(params)]
+     */
+    supplyCollateral(tokenSymbol: string, amount: string, marketParams?: MorphoMarketParams): Promise<DepositResult>;
+    /**
+     * Borrow USDC against existing collateral.
+     *
+     * AgentAccount.execute: Morpho.borrow(params, amount, 0, account, account)
+     *
+     * @param usdcAmount - USDC amount (e.g. '100')
+     * @param tokenSymbol - collateral symbol to identify which market (default: first with collateral)
+     */
+    borrow(usdcAmount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams): Promise<BorrowResult>;
+    /**
+     * Deposit collateral AND borrow USDC in one batched transaction.
+     *
+     * AgentAccount.executeBatch:
+     *   [collateral.approve, Morpho.supplyCollateral, Morpho.borrow]
+     *
+     * The collateral must be transferred to AgentAccount first.
+     */
+    depositAndBorrow(tokenSymbol: string, collateralAmount: string, borrowUsdcAmount: string, marketParams?: MorphoMarketParams): Promise<DepositAndBorrowResult>;
+    /**
+     * Repay borrowed USDC from AgentAccount.
+     *
+     * AgentAccount.executeBatch:
+     *   [USDC.approve(MorphoBlue), Morpho.repay(params)]
+     */
+    repay(usdcAmount: string, tokenSymbol?: string, marketParams?: MorphoMarketParams): Promise<RepayResult>;
+    /**
+     * Withdraw collateral from Morpho Blue.
+     *
+     * AgentAccount.execute: Morpho.withdrawCollateral(params, amount, account, receiver)
+     *
+     * @param receiver - defaults to EOA wallet
+     */
+    withdrawCollateral(tokenSymbol: string, amount: string, marketParams?: MorphoMarketParams, receiver?: string): Promise<WithdrawResult>;
+    /**
+     * Sponsor: transfer collateral to another agent's AgentAccount.
+     * (The agent must then supplyCollateral themselves via their own account.)
+     */
+    sponsor(target: {
+        agentId?: string;
+        address?: string;
+    }, tokenSymbol: string, amount: string): Promise<{
+        tx: string;
+        targetAccount: string;
+        targetAgentId?: string;
+    }>;
+    getCreditScore(): Promise<bigint>;
+    getAttestation(): Promise<ScoreAttestation>;
+    isEligible(minScore?: bigint): Promise<{
+        eligible: boolean;
+        currentScore: bigint;
+    }>;
+    isScoreFresh(): Promise<{
+        fresh: boolean;
+        age: bigint;
+    }>;
+    /**
+     * Execute a single call via AgentAccount.execute.
+     */
+    private exec;
+    /**
+     * Execute multiple calls via AgentAccount.executeBatch.
+     */
+    private batch;
+    /** Convert MorphoMarketParams to Solidity tuple. */
+    private _toTuple;
+    /** Find the first market where the agent has collateral deposited. */
+    private _findActiveMarket;
+}
+//# sourceMappingURL=MorphoClient.d.ts.map

package/dist/clients/MorphoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphoClient.d.ts","sourceRoot":"","sources":["../../src/clients/MorphoClient.ts"],"names":[],"mappings":"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"}