@agether/sdk 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -729,6 +729,10 @@ interface X402Config {
     backendUrl: string;
     agentId?: string;
     accountAddress?: string;
+    /** Auto-borrow from Morpho credit line when USDC balance is insufficient for payment */
+    autoDraw?: boolean;
+    /** MorphoCredit contract address (required for autoDraw) */
+    morphoCreditAddress?: string;
 }
 interface X402Response<T = unknown> {
     success: boolean;
@@ -761,9 +765,209 @@ declare class X402Client {
     private request;
     private parsePaymentRequired;
     private buildPaymentPayload;
+    private static readonly MORPHO_DRAW_ABI;
+    private static readonly AGENT_ACCOUNT_EXEC_ABI;
+    private static readonly ERC20_BALANCE_ABI;
+    private static readonly AUTO_DRAW_COLLATERALS;
+    private ensureBalance;
     private riskCheck;
 }
 
+/**
+ * MorphoCreditClient — SDK client for Morpho-backed overcollateralized credit
+ *
+ * Covers all 9 flows:
+ *   1. Registration (via AgentIdentityClient) + existing 8004 detection
+ *   2. Deposit collateral + borrow in one call
+ *   3. Deposit collateral only (no borrow)
+ *   4. Sponsor agent by agentId + borrow
+ *   5. Sponsor agent by agentId, no borrow
+ *   6. Sponsor agent by address + borrow
+ *   7. Sponsor agent by address, no borrow
+ *   8. Borrow against existing collateral (for x402 payments)
+ *   9. (Handled by X402Client.autoDraw)
+ */
+interface MorphoCreditConfig {
+    /** Private key for signing */
+    privateKey: string;
+    /** Base RPC URL */
+    rpcUrl: string;
+    /** Agent's ERC-8004 ID */
+    agentId: string | bigint;
+    /** Contract addresses */
+    contracts: {
+        morphoCredit: string;
+        accountFactory: string;
+        usdc: string;
+    };
+}
+interface CollateralToken {
+    symbol: string;
+    address: string;
+    decimals: number;
+}
+interface MorphoPosition {
+    token: string;
+    collateralAmount: bigint;
+    borrowedAmount: bigint;
+    borrowShares: bigint;
+    isActive: boolean;
+}
+interface DepositResult {
+    tx: string;
+    amount: bigint;
+    token: string;
+    agentAccount: string;
+    totalCollateral: bigint;
+}
+interface BorrowResult {
+    tx: string;
+    amount: bigint;
+    agentAccount: string;
+    totalDebt: bigint;
+    collateralToken: string;
+}
+interface DepositAndBorrowResult {
+    depositTx: string;
+    borrowTx: string;
+    collateral: {
+        amount: bigint;
+        token: string;
+    };
+    borrowed: bigint;
+    agentAccount: string;
+    totalDebt: bigint;
+}
+interface SponsorResult {
+    depositTx: string;
+    borrowTx?: string;
+    targetAccount: string;
+    targetAgentId?: string;
+    collateral: {
+        amount: bigint;
+        token: string;
+    };
+    borrowed?: bigint;
+    totalCollateral: bigint;
+    totalDebt: bigint;
+}
+interface RepayResult {
+    tx: string;
+    amount: bigint;
+    remainingDebt: bigint;
+}
+interface WithdrawResult {
+    tx: string;
+    amount: bigint;
+    token: string;
+    destination: string;
+    remainingCollateral: bigint;
+}
+declare class MorphoCreditClient {
+    private signer;
+    private config;
+    private morpho;
+    private factory;
+    private accountAddress?;
+    private collaterals;
+    constructor(config: MorphoCreditConfig, collaterals?: Record<string, CollateralToken>);
+    private resolveToken;
+    /**
+     * Get the AgentAccount address for the configured agentId.
+     */
+    getAccountAddress(): Promise<string>;
+    /**
+     * Get the AgentAccount address for any agentId.
+     */
+    getAccountForAgent(agentId: string | bigint): Promise<string>;
+    private ensureCreditProvider;
+    /**
+     * Approve ERC-20 token from EOA → MorphoCredit, then deposit for account.
+     * This is 2 EOA txs (approve + depositCollateralFor) — cannot be batched
+     * because both are called from EOA, not from AgentAccount.
+     */
+    private approveAndDeposit;
+    private morphoIface;
+    private erc20Iface;
+    /**
+     * Execute multiple calls via AgentAccount.executeBatch() in a single tx.
+     * Each call is { target, value, data }.
+     */
+    private batch;
+    /**
+     * Deposit collateral from EOA into Morpho for own AgentAccount.
+     * Does NOT borrow — use `borrow()` or `depositAndBorrow()` for that.
+     *
+     * @param tokenSymbol - Collateral token (WETH, wstETH, cbETH)
+     * @param amount - Human-readable amount (e.g. "0.05")
+     */
+    deposit(tokenSymbol: string, amount: string): Promise<DepositResult>;
+    /**
+     * Deposit collateral AND borrow USDC in a single SDK call.
+     * USDC lands in the AgentAccount.
+     *
+     * @param tokenSymbol - Collateral token (WETH, wstETH, cbETH)
+     * @param collateralAmount - Human-readable collateral amount (e.g. "0.05")
+     * @param borrowAmount - Human-readable USDC amount to borrow (e.g. "50")
+     */
+    depositAndBorrow(tokenSymbol: string, collateralAmount: string, borrowAmount: string): Promise<DepositAndBorrowResult>;
+    /**
+     * Borrow USDC against already-deposited collateral.
+     * Auto-detects which collateral token has a position.
+     * USDC lands in AgentAccount — ready for x402 payments.
+     *
+     * @param amount - Human-readable USDC amount (e.g. "100")
+     */
+    borrow(amount: string): Promise<BorrowResult>;
+    /**
+     * Deposit collateral for another agent. Caller pays from their wallet.
+     * Optionally borrow USDC for the agent (only works if caller owns the AgentAccount).
+     *
+     * Supports both agentId lookup and direct address.
+     *
+     * @param target - `{ agentId: "17676" }` or `{ address: "0x..." }`
+     * @param tokenSymbol - Collateral token
+     * @param amount - Human-readable collateral amount
+     * @param borrowAmount - Optional: USDC to borrow (only if caller is owner)
+     */
+    sponsor(target: {
+        agentId: string | bigint;
+    } | {
+        address: string;
+    }, tokenSymbol: string, amount: string, borrowAmount?: string): Promise<SponsorResult>;
+    /**
+     * Repay borrowed USDC from AgentAccount back to Morpho.
+     *
+     * @param amount - Human-readable USDC amount (e.g. "50")
+     */
+    repay(amount: string): Promise<RepayResult>;
+    /**
+     * Withdraw collateral from Morpho back to EOA.
+     *
+     * @param tokenSymbol - Collateral token
+     * @param amount - Human-readable amount or "all"
+     */
+    withdraw(tokenSymbol: string, amount: string): Promise<WithdrawResult>;
+    /**
+     * Get position for a specific collateral token.
+     */
+    getPosition(tokenSymbol: string): Promise<MorphoPosition>;
+    /**
+     * Get all active positions across all collateral tokens.
+     */
+    getAllPositions(): Promise<MorphoPosition[]>;
+    /**
+     * Get total debt across all positions.
+     */
+    getTotalDebt(): Promise<bigint>;
+    /**
+     * Get USDC balance in the AgentAccount.
+     */
+    getAccountUSDC(): Promise<bigint>;
+    /** Get the wallet (signer) address */
+    getAddress(): string;
+}
+
 /**
  * WalletClient - SDK for AgentAccount (smart wallet) operations (v2)
  *
@@ -930,4 +1134,4 @@ declare const VALIDATION_REGISTRY_ABI: string[];
 declare const MORPHO_CREDIT_ABI: string[];
 declare const ERC20_ABI: string[];
 
-export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, type AgentReputation, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BayesianScore, CREDIT_PROVIDER_ABI, ChainId, type ContractAddresses, type CreditApplication, type CreditAppliedEvent, type CreditApprovedEvent, type CreditDrawnEvent, type CreditInfo, type CreditLine, CreditNotActiveError, type CreditRejectedEvent, type CreditRepaidEvent, CreditStatus, type DrawRequest, ERC20_ABI, type GraduationStatus, IDENTITY_REGISTRY_ABI, InsufficientCreditError, type LPPosition, LP_VAULT_ABI, type LoanPosition, MORPHO_CREDIT_ABI, type MorphoMarketParams, type PaymentProof, type PaymentRequirements, type ProviderStatus, REPUTATION_CREDIT_ABI, type RepayRequest, type RiskCheckResponse, type RiskFactor, type ScoreExplanation, type ScoredLimitPreview, ScoringClient, type ScoringContext, ScoringRejectedError, type ScoringRequest, type ScoringResult, type TransactionResult, VALIDATION_REGISTRY_ABI, VaultClient, type VaultClientOptions, type VaultStats, WalletClient, type WalletClientConfig, type WalletInfo, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, getUSDCAddress, parseUnits, rateToBps };
+export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, type AgentReputation, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BayesianScore, type BorrowResult, CREDIT_PROVIDER_ABI, ChainId, type CollateralToken, type ContractAddresses, type CreditApplication, type CreditAppliedEvent, type CreditApprovedEvent, type CreditDrawnEvent, type CreditInfo, type CreditLine, CreditNotActiveError, type CreditRejectedEvent, type CreditRepaidEvent, CreditStatus, type DepositAndBorrowResult, type DepositResult, type DrawRequest, ERC20_ABI, type GraduationStatus, IDENTITY_REGISTRY_ABI, InsufficientCreditError, type LPPosition, LP_VAULT_ABI, type LoanPosition, MORPHO_CREDIT_ABI, MorphoCreditClient, type MorphoCreditConfig, type MorphoMarketParams, type MorphoPosition, type PaymentProof, type PaymentRequirements, type ProviderStatus, REPUTATION_CREDIT_ABI, type RepayRequest, type RepayResult, type RiskCheckResponse, type RiskFactor, type ScoreExplanation, type ScoredLimitPreview, ScoringClient, type ScoringContext, ScoringRejectedError, type ScoringRequest, type ScoringResult, type SponsorResult, type TransactionResult, VALIDATION_REGISTRY_ABI, VaultClient, type VaultClientOptions, type VaultStats, WalletClient, type WalletClientConfig, type WalletInfo, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, getUSDCAddress, parseUnits, rateToBps };