@agether/sdk 1.2.1 → 1.4.0

package/dist/index.d.mts

@@ -776,29 +776,28 @@ declare class X402Client {
 /**
  * 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)
+ * Full lifecycle for AI agents:
+ *   - Register (ERC-8004 + AccountFactory)
+ *   - Check balances and status
+ *   - Deposit collateral + borrow USDC
+ *   - Repay debt + withdraw collateral
+ *   - Sponsor another agent
+ *   - Fund AgentAccount
  */
 interface MorphoCreditConfig {
     /** Private key for signing */
     privateKey: string;
     /** Base RPC URL */
     rpcUrl: string;
-    /** Agent's ERC-8004 ID */
-    agentId: string | bigint;
+    /** Agent's ERC-8004 ID (optional — auto-resolved from chain if omitted) */
+    agentId?: string | bigint;
     /** Contract addresses */
     contracts: {
         morphoCredit: string;
         accountFactory: string;
         usdc: string;
+        /** ERC-8004 identity registry (needed for register()) */
+        agentRegistry?: string;
     };
 }
 interface CollateralToken {
@@ -863,15 +862,64 @@ interface WithdrawResult {
     destination: string;
     remainingCollateral: bigint;
 }
+interface RegisterResult {
+    tx: string;
+    agentId: string;
+    address: string;
+    agentAccount: string;
+    alreadyRegistered: boolean;
+}
+interface BalancesResult {
+    address: string;
+    agentId: string;
+    eth: string;
+    usdc: string;
+    agentAccount?: {
+        address: string;
+        eth: string;
+        usdc: string;
+    };
+}
+interface StatusResult {
+    agentAccount: string;
+    totalDebt: string;
+    positions: Array<{
+        token: string;
+        collateral: string;
+        debt: string;
+        active: boolean;
+    }>;
+}
+interface FundResult {
+    tx: string;
+    amount: string;
+    agentAccount: string;
+}
+interface LtvCheckResult {
+    ok: boolean;
+    currentLtv: number;
+    newLtv: number;
+    maxLtv: number;
+    collateralUsd: number;
+    currentDebt: number;
+    maxBorrow: number;
+    message?: string;
+}
 declare class MorphoCreditClient {
     private signer;
     private config;
     private morpho;
     private factory;
     private accountAddress?;
+    private resolvedAgentId?;
     private collaterals;
+    private static readonly ERC8004_ABI;
     constructor(config: MorphoCreditConfig, collaterals?: Record<string, CollateralToken>);
     private resolveToken;
+    /**
+     * Resolve agentId — from config, cache, or on-chain lookup.
+     */
+    getAgentId(): Promise<string>;
     /**
      * Get the AgentAccount address for the configured agentId.
      */
@@ -881,8 +929,50 @@ declare class MorphoCreditClient {
      */
     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 executeBorrow;
+    private morphoIface;
+    private erc20Iface;
+    /**
+     * Execute multiple calls via AgentAccount.executeBatch() in a single tx.
+     * Each call is { target, value, data }.
+     */
+    private batch;
+    /**
+     * Register a new ERC-8004 agent identity and create an AgentAccount.
+     * If already registered (agentId in config or on-chain), returns existing info.
+     *
+     * @param name - Agent display name
+     */
+    register(name: string): Promise<RegisterResult>;
+    /**
+     * Get ETH and USDC balances for EOA wallet and AgentAccount.
+     */
+    getBalances(): Promise<BalancesResult>;
+    /**
+     * Get full Morpho credit status — all positions + total debt.
+     */
+    getStatus(): Promise<StatusResult>;
+    /**
+     * Transfer USDC from EOA wallet into AgentAccount.
+     *
+     * @param amount - Human-readable USDC amount (e.g. "50")
+     */
+    fundAccount(amount: string): Promise<FundResult>;
+    private static readonly ORACLE_ABI;
+    /**
+     * Check whether a borrow would exceed max LTV.
+     * Call before borrow() or depositAndBorrow() to get a clear error instead of on-chain revert.
+     *
+     * @param tokenSymbol - Collateral token
+     * @param additionalCollateral - Additional collateral being deposited ("0" if just borrowing)
+     * @param borrowAmount - USDC to borrow
+     */
+    checkLtv(tokenSymbol: string, additionalCollateral: string, borrowAmount: string): Promise<LtvCheckResult>;
     /**
      * Deposit collateral from EOA into Morpho for own AgentAccount.
      * Does NOT borrow — use `borrow()` or `depositAndBorrow()` for that.
@@ -1123,4 +1213,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, 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 };
+export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, type AgentReputation, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, 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 FundResult, type GraduationStatus, IDENTITY_REGISTRY_ABI, InsufficientCreditError, type LPPosition, LP_VAULT_ABI, type LoanPosition, type LtvCheckResult, MORPHO_CREDIT_ABI, MorphoCreditClient, type MorphoCreditConfig, type MorphoMarketParams, type MorphoPosition, type PaymentProof, type PaymentRequirements, type ProviderStatus, REPUTATION_CREDIT_ABI, type RegisterResult, type RepayRequest, type RepayResult, type RiskCheckResponse, type RiskFactor, type ScoreExplanation, type ScoredLimitPreview, ScoringClient, type ScoringContext, ScoringRejectedError, type ScoringRequest, type ScoringResult, type SponsorResult, type StatusResult, 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 };

package/dist/index.d.ts

@@ -776,29 +776,28 @@ declare class X402Client {
 /**
  * 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)
+ * Full lifecycle for AI agents:
+ *   - Register (ERC-8004 + AccountFactory)
+ *   - Check balances and status
+ *   - Deposit collateral + borrow USDC
+ *   - Repay debt + withdraw collateral
+ *   - Sponsor another agent
+ *   - Fund AgentAccount
  */
 interface MorphoCreditConfig {
     /** Private key for signing */
     privateKey: string;
     /** Base RPC URL */
     rpcUrl: string;
-    /** Agent's ERC-8004 ID */
-    agentId: string | bigint;
+    /** Agent's ERC-8004 ID (optional — auto-resolved from chain if omitted) */
+    agentId?: string | bigint;
     /** Contract addresses */
     contracts: {
         morphoCredit: string;
         accountFactory: string;
         usdc: string;
+        /** ERC-8004 identity registry (needed for register()) */
+        agentRegistry?: string;
     };
 }
 interface CollateralToken {
@@ -863,15 +862,64 @@ interface WithdrawResult {
     destination: string;
     remainingCollateral: bigint;
 }
+interface RegisterResult {
+    tx: string;
+    agentId: string;
+    address: string;
+    agentAccount: string;
+    alreadyRegistered: boolean;
+}
+interface BalancesResult {
+    address: string;
+    agentId: string;
+    eth: string;
+    usdc: string;
+    agentAccount?: {
+        address: string;
+        eth: string;
+        usdc: string;
+    };
+}
+interface StatusResult {
+    agentAccount: string;
+    totalDebt: string;
+    positions: Array<{
+        token: string;
+        collateral: string;
+        debt: string;
+        active: boolean;
+    }>;
+}
+interface FundResult {
+    tx: string;
+    amount: string;
+    agentAccount: string;
+}
+interface LtvCheckResult {
+    ok: boolean;
+    currentLtv: number;
+    newLtv: number;
+    maxLtv: number;
+    collateralUsd: number;
+    currentDebt: number;
+    maxBorrow: number;
+    message?: string;
+}
 declare class MorphoCreditClient {
     private signer;
     private config;
     private morpho;
     private factory;
     private accountAddress?;
+    private resolvedAgentId?;
     private collaterals;
+    private static readonly ERC8004_ABI;
     constructor(config: MorphoCreditConfig, collaterals?: Record<string, CollateralToken>);
     private resolveToken;
+    /**
+     * Resolve agentId — from config, cache, or on-chain lookup.
+     */
+    getAgentId(): Promise<string>;
     /**
      * Get the AgentAccount address for the configured agentId.
      */
@@ -881,8 +929,50 @@ declare class MorphoCreditClient {
      */
     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 executeBorrow;
+    private morphoIface;
+    private erc20Iface;
+    /**
+     * Execute multiple calls via AgentAccount.executeBatch() in a single tx.
+     * Each call is { target, value, data }.
+     */
+    private batch;
+    /**
+     * Register a new ERC-8004 agent identity and create an AgentAccount.
+     * If already registered (agentId in config or on-chain), returns existing info.
+     *
+     * @param name - Agent display name
+     */
+    register(name: string): Promise<RegisterResult>;
+    /**
+     * Get ETH and USDC balances for EOA wallet and AgentAccount.
+     */
+    getBalances(): Promise<BalancesResult>;
+    /**
+     * Get full Morpho credit status — all positions + total debt.
+     */
+    getStatus(): Promise<StatusResult>;
+    /**
+     * Transfer USDC from EOA wallet into AgentAccount.
+     *
+     * @param amount - Human-readable USDC amount (e.g. "50")
+     */
+    fundAccount(amount: string): Promise<FundResult>;
+    private static readonly ORACLE_ABI;
+    /**
+     * Check whether a borrow would exceed max LTV.
+     * Call before borrow() or depositAndBorrow() to get a clear error instead of on-chain revert.
+     *
+     * @param tokenSymbol - Collateral token
+     * @param additionalCollateral - Additional collateral being deposited ("0" if just borrowing)
+     * @param borrowAmount - USDC to borrow
+     */
+    checkLtv(tokenSymbol: string, additionalCollateral: string, borrowAmount: string): Promise<LtvCheckResult>;
     /**
      * Deposit collateral from EOA into Morpho for own AgentAccount.
      * Does NOT borrow — use `borrow()` or `depositAndBorrow()` for that.
@@ -1123,4 +1213,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, 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 };
+export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, type AgentReputation, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type BalancesResult, 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 FundResult, type GraduationStatus, IDENTITY_REGISTRY_ABI, InsufficientCreditError, type LPPosition, LP_VAULT_ABI, type LoanPosition, type LtvCheckResult, MORPHO_CREDIT_ABI, MorphoCreditClient, type MorphoCreditConfig, type MorphoMarketParams, type MorphoPosition, type PaymentProof, type PaymentRequirements, type ProviderStatus, REPUTATION_CREDIT_ABI, type RegisterResult, type RepayRequest, type RepayResult, type RiskCheckResponse, type RiskFactor, type ScoreExplanation, type ScoredLimitPreview, ScoringClient, type ScoringContext, ScoringRejectedError, type ScoringRequest, type ScoringResult, type SponsorResult, type StatusResult, 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 };

package/dist/index.js

@@ -150,6 +150,7 @@ var AGENT_ACCOUNT_ABI = [
   "function balanceOf(address token) view returns (uint256)",
   "function ethBalance() view returns (uint256)",
   "function execute(address target, uint256 value, bytes data) payable returns (bytes)",
+  "function executeBatch(address[] targets, uint256[] values, bytes[] datas) payable returns (bytes[])",
   "function drawCredit(address creditProvider, uint256 amount)",
   "function repayCredit(address creditProvider, uint256 amount)",
   "function fund(address token, uint256 amount)",
@@ -1509,14 +1510,18 @@ var BASE_COLLATERALS = {
   wstETH: { symbol: "wstETH", address: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452", decimals: 18 },
   cbETH: { symbol: "cbETH", address: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22", decimals: 18 }
 };
-var MorphoCreditClient = class {
+var _MorphoCreditClient = class _MorphoCreditClient {
   constructor(config, collaterals) {
+    // ── Batch helper ──
+    this.morphoIface = new import_ethers5.ethers.Interface(MORPHO_CREDIT_ABI);
+    this.erc20Iface = new import_ethers5.ethers.Interface(ERC20_ABI);
     this.config = config;
     const provider = new import_ethers5.ethers.JsonRpcProvider(config.rpcUrl);
     this.signer = new import_ethers5.ethers.Wallet(config.privateKey, provider);
     this.morpho = new import_ethers5.Contract(config.contracts.morphoCredit, MORPHO_CREDIT_ABI, this.signer);
     this.factory = new import_ethers5.Contract(config.contracts.accountFactory, ACCOUNT_FACTORY_ABI, this.signer);
     this.collaterals = collaterals || BASE_COLLATERALS;
+    if (config.agentId) this.resolvedAgentId = config.agentId.toString();
   }
   // ── Helpers ──
   resolveToken(tokenSymbol) {
@@ -1526,12 +1531,30 @@ var MorphoCreditClient = class {
     }
     return token;
   }
+  /**
+   * Resolve agentId — from config, cache, or on-chain lookup.
+   */
+  async getAgentId() {
+    if (this.resolvedAgentId) return this.resolvedAgentId;
+    if (!this.config.contracts.agentRegistry) {
+      throw new Error("No agentId configured and no agentRegistry address to auto-resolve. Register first.");
+    }
+    const registry = new import_ethers5.Contract(this.config.contracts.agentRegistry, _MorphoCreditClient.ERC8004_ABI, this.signer.provider);
+    const balance = await registry.balanceOf(this.signer.address);
+    if (balance === 0n) {
+      throw new Error("No agent registered. Use register() first.");
+    }
+    const tokenId = await registry.tokenOfOwnerByIndex(this.signer.address, 0);
+    this.resolvedAgentId = tokenId.toString();
+    return this.resolvedAgentId;
+  }
   /**
    * Get the AgentAccount address for the configured agentId.
    */
   async getAccountAddress() {
     if (this.accountAddress) return this.accountAddress;
-    const addr = await this.factory.getAccount(this.config.agentId.toString());
+    const agentId = await this.getAgentId();
+    const addr = await this.factory.getAccount(agentId);
     if (addr === import_ethers5.ethers.ZeroAddress) {
       throw new Error("No AgentAccount found. Register first.");
     }
@@ -1556,6 +1579,11 @@ var MorphoCreditClient = class {
     } catch {
     }
   }
+  /**
+   * 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.
+   */
   async approveAndDeposit(accountAddr, tokenInfo, amount) {
     const token = new import_ethers5.Contract(tokenInfo.address, ERC20_ABI, this.signer);
     const balance = await token.balanceOf(this.signer.address);
@@ -1570,15 +1598,220 @@ var MorphoCreditClient = class {
     await depositTx.wait();
     return depositTx.hash;
   }
-  async executeBorrow(accountAddr, collateralAddr, borrowAmount) {
+  /**
+   * Execute multiple calls via AgentAccount.executeBatch() in a single tx.
+   * Each call is { target, value, data }.
+   */
+  async batch(accountAddr, calls) {
     const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const iface = new import_ethers5.ethers.Interface(MORPHO_CREDIT_ABI);
-    const calldata = iface.encodeFunctionData("drawWithCollateral", [collateralAddr, borrowAmount]);
-    const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    const tx = await account.executeBatch(
+      calls.map((c) => c.target),
+      calls.map((c) => c.value),
+      calls.map((c) => c.data)
+    );
     await tx.wait();
     return tx.hash;
   }
   // ══════════════════════════════════════════
+  //  Register
+  // ══════════════════════════════════════════
+  /**
+   * Register a new ERC-8004 agent identity and create an AgentAccount.
+   * If already registered (agentId in config or on-chain), returns existing info.
+   *
+   * @param name - Agent display name
+   */
+  async register(name) {
+    if (!this.config.contracts.agentRegistry) {
+      throw new Error("agentRegistry address required for register()");
+    }
+    const registry = new import_ethers5.Contract(
+      this.config.contracts.agentRegistry,
+      _MorphoCreditClient.ERC8004_ABI,
+      this.signer
+    );
+    if (this.resolvedAgentId) {
+      const agentId2 = BigInt(this.resolvedAgentId);
+      const owner = await registry.ownerOf(agentId2);
+      if (owner.toLowerCase() !== this.signer.address.toLowerCase()) {
+        throw new Error("agentId in config does not belong to this wallet");
+      }
+      const exists2 = await this.factory.accountExists(agentId2);
+      if (!exists2) {
+        const tx2 = await this.factory.createAccount(agentId2);
+        await tx2.wait();
+      }
+      const accountAddr2 = await this.factory.getAccount(this.resolvedAgentId);
+      return {
+        tx: "",
+        agentId: this.resolvedAgentId,
+        address: this.signer.address,
+        agentAccount: accountAddr2,
+        alreadyRegistered: true
+      };
+    }
+    const balance = await registry.balanceOf(this.signer.address);
+    if (balance > 0n) {
+      const tokenId = await registry.tokenOfOwnerByIndex(this.signer.address, 0);
+      this.resolvedAgentId = tokenId.toString();
+      const accountAddr2 = await this.factory.getAccount(this.resolvedAgentId);
+      return {
+        tx: "",
+        agentId: this.resolvedAgentId,
+        address: this.signer.address,
+        agentAccount: accountAddr2,
+        alreadyRegistered: true
+      };
+    }
+    const registrationFile = JSON.stringify({
+      type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+      name,
+      description: "AI agent registered via @agether/sdk",
+      active: true,
+      registrations: [{
+        agentId: 0,
+        agentRegistry: `eip155:8453:${this.config.contracts.agentRegistry}`
+      }]
+    });
+    const agentURI = `data:application/json;base64,${Buffer.from(registrationFile).toString("base64")}`;
+    const tx = await registry["register(string)"](agentURI);
+    const receipt = await tx.wait();
+    const transferTopic = import_ethers5.ethers.id("Transfer(address,address,uint256)");
+    const transferLog = receipt.logs.find((l) => l.topics[0] === transferTopic);
+    if (!transferLog?.topics?.[3]) {
+      throw new Error("Could not parse agentId from receipt");
+    }
+    const agentId = BigInt(transferLog.topics[3]);
+    this.resolvedAgentId = agentId.toString();
+    const exists = await this.factory.accountExists(agentId);
+    if (!exists) {
+      const accTx = await this.factory.createAccount(agentId);
+      await accTx.wait();
+    }
+    const accountAddr = await this.factory.getAccount(this.resolvedAgentId);
+    this.accountAddress = accountAddr;
+    return {
+      tx: tx.hash,
+      agentId: this.resolvedAgentId,
+      address: this.signer.address,
+      agentAccount: accountAddr,
+      alreadyRegistered: false
+    };
+  }
+  // ══════════════════════════════════════════
+  //  Balances & Status
+  // ══════════════════════════════════════════
+  /**
+   * Get ETH and USDC balances for EOA wallet and AgentAccount.
+   */
+  async getBalances() {
+    const provider = this.signer.provider;
+    const ethBal = await provider.getBalance(this.signer.address);
+    const usdc = new import_ethers5.Contract(this.config.contracts.usdc, ERC20_ABI, provider);
+    const usdcBal = await usdc.balanceOf(this.signer.address);
+    const result = {
+      address: this.signer.address,
+      agentId: this.resolvedAgentId || "not registered",
+      eth: import_ethers5.ethers.formatEther(ethBal),
+      usdc: import_ethers5.ethers.formatUnits(usdcBal, 6)
+    };
+    try {
+      const accountAddr = await this.getAccountAddress();
+      const accEth = await provider.getBalance(accountAddr);
+      const accUsdc = await usdc.balanceOf(accountAddr);
+      result.agentAccount = {
+        address: accountAddr,
+        eth: import_ethers5.ethers.formatEther(accEth),
+        usdc: import_ethers5.ethers.formatUnits(accUsdc, 6)
+      };
+    } catch {
+    }
+    return result;
+  }
+  /**
+   * Get full Morpho credit status — all positions + total debt.
+   */
+  async getStatus() {
+    const accountAddr = await this.getAccountAddress();
+    const positions = [];
+    for (const [symbol, info] of Object.entries(this.collaterals)) {
+      const pos = await this.morpho.getPosition(accountAddr, info.address);
+      if (pos.isActive || pos.collateralAmount > 0n || pos.borrowedAmount > 0n) {
+        positions.push({
+          token: symbol,
+          collateral: import_ethers5.ethers.formatUnits(pos.collateralAmount, info.decimals),
+          debt: `$${import_ethers5.ethers.formatUnits(pos.borrowedAmount, 6)}`,
+          active: pos.isActive
+        });
+      }
+    }
+    const totalDebt = await this.morpho.getTotalDebt(accountAddr);
+    return {
+      agentAccount: accountAddr,
+      totalDebt: `$${import_ethers5.ethers.formatUnits(totalDebt, 6)}`,
+      positions
+    };
+  }
+  // ══════════════════════════════════════════
+  //  Fund AgentAccount
+  // ══════════════════════════════════════════
+  /**
+   * Transfer USDC from EOA wallet into AgentAccount.
+   *
+   * @param amount - Human-readable USDC amount (e.g. "50")
+   */
+  async fundAccount(amount) {
+    const amountWei = import_ethers5.ethers.parseUnits(amount, 6);
+    const accountAddr = await this.getAccountAddress();
+    const usdc = new import_ethers5.Contract(this.config.contracts.usdc, ERC20_ABI, this.signer);
+    const balance = await usdc.balanceOf(this.signer.address);
+    if (balance < amountWei) {
+      throw new Error(`Insufficient USDC: have $${import_ethers5.ethers.formatUnits(balance, 6)}, need $${amount}`);
+    }
+    const tx = await usdc.transfer(accountAddr, amountWei);
+    await tx.wait();
+    return { tx: tx.hash, amount, agentAccount: accountAddr };
+  }
+  /**
+   * Check whether a borrow would exceed max LTV.
+   * Call before borrow() or depositAndBorrow() to get a clear error instead of on-chain revert.
+   *
+   * @param tokenSymbol - Collateral token
+   * @param additionalCollateral - Additional collateral being deposited ("0" if just borrowing)
+   * @param borrowAmount - USDC to borrow
+   */
+  async checkLtv(tokenSymbol, additionalCollateral, borrowAmount) {
+    const tokenInfo = this.resolveToken(tokenSymbol);
+    const accountAddr = await this.getAccountAddress();
+    const pos = await this.morpho.getPosition(accountAddr, tokenInfo.address);
+    const marketInfo = await this.morpho.markets(tokenInfo.address);
+    const oracle = new import_ethers5.Contract(marketInfo.params.oracle, _MorphoCreditClient.ORACLE_ABI, this.signer.provider);
+    const oraclePrice = await oracle.price();
+    const addCollateralWei = import_ethers5.ethers.parseUnits(additionalCollateral, tokenInfo.decimals);
+    const borrowWei = import_ethers5.ethers.parseUnits(borrowAmount, 6);
+    const totalCollateral = pos.collateralAmount + addCollateralWei;
+    const totalDebt = pos.borrowedAmount + borrowWei;
+    const collateralValue = totalCollateral * oraclePrice / BigInt("1000000000000000000000000000000000000");
+    const collateralUsd = Number(collateralValue) / 1e6;
+    const currentDebtUsd = Number(pos.borrowedAmount) / 1e6;
+    const maxLtvBps = Number(marketInfo.maxLtvBps);
+    const currentLtv = collateralValue > 0n ? Number(pos.borrowedAmount * 10000n / collateralValue) / 100 : 0;
+    const newLtv = collateralValue > 0n ? Number(totalDebt * 10000n / collateralValue) / 100 : totalDebt > 0n ? Infinity : 0;
+    const maxLtv = maxLtvBps / 100;
+    const maxBorrow = collateralUsd * maxLtvBps / 1e4;
+    const ok = newLtv <= maxLtv;
+    return {
+      ok,
+      currentLtv,
+      newLtv,
+      maxLtv,
+      collateralUsd,
+      currentDebt: currentDebtUsd,
+      maxBorrow,
+      message: ok ? void 0 : `ExceedsMaxLtv: borrowing $${borrowAmount} would push LTV to ${newLtv.toFixed(1)}% (max ${maxLtv}%). Collateral: $${collateralUsd.toFixed(2)}. Current debt: $${currentDebtUsd.toFixed(3)}. Max additional borrow: $${(maxBorrow - currentDebtUsd).toFixed(2)}. Deposit more collateral or borrow less.`
+    };
+  }
+  // ══════════════════════════════════════════
   //  Flow 3: Deposit collateral only
   // ══════════════════════════════════════════
   /**
@@ -1619,13 +1852,18 @@ var MorphoCreditClient = class {
     const collateralWei = import_ethers5.ethers.parseUnits(collateralAmount, tokenInfo.decimals);
     const borrowWei = import_ethers5.ethers.parseUnits(borrowAmount, 6);
     const accountAddr = await this.getAccountAddress();
+    const ltvCheck = await this.checkLtv(tokenSymbol, collateralAmount, borrowAmount);
+    if (!ltvCheck.ok) throw new Error(ltvCheck.message);
     const depositTxHash = await this.approveAndDeposit(accountAddr, tokenInfo, collateralWei);
     await this.ensureCreditProvider(accountAddr);
-    const borrowTxHash = await this.executeBorrow(accountAddr, tokenInfo.address, borrowWei);
+    const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+    const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [tokenInfo.address, borrowWei]);
+    const borrowTx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    await borrowTx.wait();
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
     return {
       depositTx: depositTxHash,
-      borrowTx: borrowTxHash,
+      borrowTx: borrowTx.hash,
       collateral: { amount: collateralWei, token: tokenSymbol },
       borrowed: borrowWei,
       agentAccount: accountAddr,
@@ -1656,10 +1894,16 @@ var MorphoCreditClient = class {
     if (!activeToken) {
       throw new Error("No collateral deposited. Use deposit() or depositAndBorrow() first.");
     }
-    const txHash = await this.executeBorrow(accountAddr, activeToken.address, borrowWei);
+    const ltvCheck = await this.checkLtv(activeToken.symbol, "0", amount);
+    if (!ltvCheck.ok) throw new Error(ltvCheck.message);
+    await this.ensureCreditProvider(accountAddr);
+    const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+    const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [activeToken.address, borrowWei]);
+    const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    await tx.wait();
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
     return {
-      tx: txHash,
+      tx: tx.hash,
       amount: borrowWei,
       agentAccount: accountAddr,
       totalDebt,
@@ -1704,8 +1948,11 @@ var MorphoCreditClient = class {
       const borrowWei = import_ethers5.ethers.parseUnits(borrowAmount, 6);
       try {
         await this.ensureCreditProvider(accountAddr);
-        const borrowTxHash = await this.executeBorrow(accountAddr, tokenInfo.address, borrowWei);
-        result.borrowTx = borrowTxHash;
+        const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+        const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [tokenInfo.address, borrowWei]);
+        const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+        await tx.wait();
+        result.borrowTx = tx.hash;
         result.borrowed = borrowWei;
       } catch (e) {
         throw new Error(`Borrow failed (caller may not own this AgentAccount): ${e.message}`);
@@ -1741,17 +1988,20 @@ var MorphoCreditClient = class {
     if (balance < amountWei) {
       throw new Error(`Insufficient USDC in AgentAccount: $${import_ethers5.ethers.formatUnits(balance, 6)}`);
     }
-    const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const erc20Iface = new import_ethers5.ethers.Interface(ERC20_ABI);
-    const morphoIface = new import_ethers5.ethers.Interface(MORPHO_CREDIT_ABI);
-    const approveData = erc20Iface.encodeFunctionData("approve", [this.config.contracts.morphoCredit, amountWei]);
-    const approveTx = await account.execute(this.config.contracts.usdc, 0, approveData);
-    await approveTx.wait();
-    const repayData = morphoIface.encodeFunctionData("repayWithCollateral", [collateralAddr, amountWei]);
-    const tx = await account.execute(this.config.contracts.morphoCredit, 0, repayData);
-    await tx.wait();
+    const txHash = await this.batch(accountAddr, [
+      {
+        target: this.config.contracts.usdc,
+        value: 0n,
+        data: this.erc20Iface.encodeFunctionData("approve", [this.config.contracts.morphoCredit, amountWei])
+      },
+      {
+        target: this.config.contracts.morphoCredit,
+        value: 0n,
+        data: this.morphoIface.encodeFunctionData("repayWithCollateral", [collateralAddr, amountWei])
+      }
+    ]);
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
-    return { tx: tx.hash, amount: amountWei, remainingDebt: totalDebt };
+    return { tx: txHash, amount: amountWei, remainingDebt: totalDebt };
   }
   /**
    * Withdraw collateral from Morpho back to EOA.
@@ -1772,18 +2022,21 @@ var MorphoCreditClient = class {
         `Cannot withdraw more than deposited: max ${import_ethers5.ethers.formatUnits(pos.collateralAmount, tokenInfo.decimals)} ${tokenSymbol}`
       );
     }
-    const account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const morphoIface = new import_ethers5.ethers.Interface(MORPHO_CREDIT_ABI);
-    const withdrawData = morphoIface.encodeFunctionData("withdrawCollateral", [tokenInfo.address, withdrawAmount]);
-    const tx1 = await account.execute(this.config.contracts.morphoCredit, 0, withdrawData);
-    await tx1.wait();
-    const erc20Iface = new import_ethers5.ethers.Interface(ERC20_ABI);
-    const transferData = erc20Iface.encodeFunctionData("transfer", [this.signer.address, withdrawAmount]);
-    const tx2 = await account.execute(tokenInfo.address, 0, transferData);
-    await tx2.wait();
+    const txHash = await this.batch(accountAddr, [
+      {
+        target: this.config.contracts.morphoCredit,
+        value: 0n,
+        data: this.morphoIface.encodeFunctionData("withdrawCollateral", [tokenInfo.address, withdrawAmount])
+      },
+      {
+        target: tokenInfo.address,
+        value: 0n,
+        data: this.erc20Iface.encodeFunctionData("transfer", [this.signer.address, withdrawAmount])
+      }
+    ]);
     const newPos = await this.morpho.getPosition(accountAddr, tokenInfo.address);
     return {
-      tx: tx1.hash,
+      tx: txHash,
       amount: withdrawAmount,
       token: tokenSymbol,
       destination: this.signer.address,
@@ -1848,6 +2101,17 @@ var MorphoCreditClient = class {
     return this.signer.address;
   }
 };
+_MorphoCreditClient.ERC8004_ABI = [
+  "function register(string agentURI) returns (uint256)",
+  "function ownerOf(uint256 tokenId) view returns (address)",
+  "function balanceOf(address owner) view returns (uint256)",
+  "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)"
+];
+// ══════════════════════════════════════════
+//  LTV Pre-check
+// ══════════════════════════════════════════
+_MorphoCreditClient.ORACLE_ABI = ["function price() view returns (uint256)"];
+var MorphoCreditClient = _MorphoCreditClient;
 
 // src/clients/WalletClient.ts
 var import_ethers6 = require("ethers");

package/dist/index.mjs

@@ -79,6 +79,7 @@ var AGENT_ACCOUNT_ABI = [
   "function balanceOf(address token) view returns (uint256)",
   "function ethBalance() view returns (uint256)",
   "function execute(address target, uint256 value, bytes data) payable returns (bytes)",
+  "function executeBatch(address[] targets, uint256[] values, bytes[] datas) payable returns (bytes[])",
   "function drawCredit(address creditProvider, uint256 amount)",
   "function repayCredit(address creditProvider, uint256 amount)",
   "function fund(address token, uint256 amount)",
@@ -1438,14 +1439,18 @@ var BASE_COLLATERALS = {
   wstETH: { symbol: "wstETH", address: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452", decimals: 18 },
   cbETH: { symbol: "cbETH", address: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22", decimals: 18 }
 };
-var MorphoCreditClient = class {
+var _MorphoCreditClient = class _MorphoCreditClient {
   constructor(config, collaterals) {
+    // ── Batch helper ──
+    this.morphoIface = new ethers4.Interface(MORPHO_CREDIT_ABI);
+    this.erc20Iface = new ethers4.Interface(ERC20_ABI);
     this.config = config;
     const provider = new ethers4.JsonRpcProvider(config.rpcUrl);
     this.signer = new ethers4.Wallet(config.privateKey, provider);
     this.morpho = new Contract3(config.contracts.morphoCredit, MORPHO_CREDIT_ABI, this.signer);
     this.factory = new Contract3(config.contracts.accountFactory, ACCOUNT_FACTORY_ABI, this.signer);
     this.collaterals = collaterals || BASE_COLLATERALS;
+    if (config.agentId) this.resolvedAgentId = config.agentId.toString();
   }
   // ── Helpers ──
   resolveToken(tokenSymbol) {
@@ -1455,12 +1460,30 @@ var MorphoCreditClient = class {
     }
     return token;
   }
+  /**
+   * Resolve agentId — from config, cache, or on-chain lookup.
+   */
+  async getAgentId() {
+    if (this.resolvedAgentId) return this.resolvedAgentId;
+    if (!this.config.contracts.agentRegistry) {
+      throw new Error("No agentId configured and no agentRegistry address to auto-resolve. Register first.");
+    }
+    const registry = new Contract3(this.config.contracts.agentRegistry, _MorphoCreditClient.ERC8004_ABI, this.signer.provider);
+    const balance = await registry.balanceOf(this.signer.address);
+    if (balance === 0n) {
+      throw new Error("No agent registered. Use register() first.");
+    }
+    const tokenId = await registry.tokenOfOwnerByIndex(this.signer.address, 0);
+    this.resolvedAgentId = tokenId.toString();
+    return this.resolvedAgentId;
+  }
   /**
    * Get the AgentAccount address for the configured agentId.
    */
   async getAccountAddress() {
     if (this.accountAddress) return this.accountAddress;
-    const addr = await this.factory.getAccount(this.config.agentId.toString());
+    const agentId = await this.getAgentId();
+    const addr = await this.factory.getAccount(agentId);
     if (addr === ethers4.ZeroAddress) {
       throw new Error("No AgentAccount found. Register first.");
     }
@@ -1485,6 +1508,11 @@ var MorphoCreditClient = class {
     } catch {
     }
   }
+  /**
+   * 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.
+   */
   async approveAndDeposit(accountAddr, tokenInfo, amount) {
     const token = new Contract3(tokenInfo.address, ERC20_ABI, this.signer);
     const balance = await token.balanceOf(this.signer.address);
@@ -1499,15 +1527,220 @@ var MorphoCreditClient = class {
     await depositTx.wait();
     return depositTx.hash;
   }
-  async executeBorrow(accountAddr, collateralAddr, borrowAmount) {
+  /**
+   * Execute multiple calls via AgentAccount.executeBatch() in a single tx.
+   * Each call is { target, value, data }.
+   */
+  async batch(accountAddr, calls) {
     const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const iface = new ethers4.Interface(MORPHO_CREDIT_ABI);
-    const calldata = iface.encodeFunctionData("drawWithCollateral", [collateralAddr, borrowAmount]);
-    const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    const tx = await account.executeBatch(
+      calls.map((c) => c.target),
+      calls.map((c) => c.value),
+      calls.map((c) => c.data)
+    );
     await tx.wait();
     return tx.hash;
   }
   // ══════════════════════════════════════════
+  //  Register
+  // ══════════════════════════════════════════
+  /**
+   * Register a new ERC-8004 agent identity and create an AgentAccount.
+   * If already registered (agentId in config or on-chain), returns existing info.
+   *
+   * @param name - Agent display name
+   */
+  async register(name) {
+    if (!this.config.contracts.agentRegistry) {
+      throw new Error("agentRegistry address required for register()");
+    }
+    const registry = new Contract3(
+      this.config.contracts.agentRegistry,
+      _MorphoCreditClient.ERC8004_ABI,
+      this.signer
+    );
+    if (this.resolvedAgentId) {
+      const agentId2 = BigInt(this.resolvedAgentId);
+      const owner = await registry.ownerOf(agentId2);
+      if (owner.toLowerCase() !== this.signer.address.toLowerCase()) {
+        throw new Error("agentId in config does not belong to this wallet");
+      }
+      const exists2 = await this.factory.accountExists(agentId2);
+      if (!exists2) {
+        const tx2 = await this.factory.createAccount(agentId2);
+        await tx2.wait();
+      }
+      const accountAddr2 = await this.factory.getAccount(this.resolvedAgentId);
+      return {
+        tx: "",
+        agentId: this.resolvedAgentId,
+        address: this.signer.address,
+        agentAccount: accountAddr2,
+        alreadyRegistered: true
+      };
+    }
+    const balance = await registry.balanceOf(this.signer.address);
+    if (balance > 0n) {
+      const tokenId = await registry.tokenOfOwnerByIndex(this.signer.address, 0);
+      this.resolvedAgentId = tokenId.toString();
+      const accountAddr2 = await this.factory.getAccount(this.resolvedAgentId);
+      return {
+        tx: "",
+        agentId: this.resolvedAgentId,
+        address: this.signer.address,
+        agentAccount: accountAddr2,
+        alreadyRegistered: true
+      };
+    }
+    const registrationFile = JSON.stringify({
+      type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
+      name,
+      description: "AI agent registered via @agether/sdk",
+      active: true,
+      registrations: [{
+        agentId: 0,
+        agentRegistry: `eip155:8453:${this.config.contracts.agentRegistry}`
+      }]
+    });
+    const agentURI = `data:application/json;base64,${Buffer.from(registrationFile).toString("base64")}`;
+    const tx = await registry["register(string)"](agentURI);
+    const receipt = await tx.wait();
+    const transferTopic = ethers4.id("Transfer(address,address,uint256)");
+    const transferLog = receipt.logs.find((l) => l.topics[0] === transferTopic);
+    if (!transferLog?.topics?.[3]) {
+      throw new Error("Could not parse agentId from receipt");
+    }
+    const agentId = BigInt(transferLog.topics[3]);
+    this.resolvedAgentId = agentId.toString();
+    const exists = await this.factory.accountExists(agentId);
+    if (!exists) {
+      const accTx = await this.factory.createAccount(agentId);
+      await accTx.wait();
+    }
+    const accountAddr = await this.factory.getAccount(this.resolvedAgentId);
+    this.accountAddress = accountAddr;
+    return {
+      tx: tx.hash,
+      agentId: this.resolvedAgentId,
+      address: this.signer.address,
+      agentAccount: accountAddr,
+      alreadyRegistered: false
+    };
+  }
+  // ══════════════════════════════════════════
+  //  Balances & Status
+  // ══════════════════════════════════════════
+  /**
+   * Get ETH and USDC balances for EOA wallet and AgentAccount.
+   */
+  async getBalances() {
+    const provider = this.signer.provider;
+    const ethBal = await provider.getBalance(this.signer.address);
+    const usdc = new Contract3(this.config.contracts.usdc, ERC20_ABI, provider);
+    const usdcBal = await usdc.balanceOf(this.signer.address);
+    const result = {
+      address: this.signer.address,
+      agentId: this.resolvedAgentId || "not registered",
+      eth: ethers4.formatEther(ethBal),
+      usdc: ethers4.formatUnits(usdcBal, 6)
+    };
+    try {
+      const accountAddr = await this.getAccountAddress();
+      const accEth = await provider.getBalance(accountAddr);
+      const accUsdc = await usdc.balanceOf(accountAddr);
+      result.agentAccount = {
+        address: accountAddr,
+        eth: ethers4.formatEther(accEth),
+        usdc: ethers4.formatUnits(accUsdc, 6)
+      };
+    } catch {
+    }
+    return result;
+  }
+  /**
+   * Get full Morpho credit status — all positions + total debt.
+   */
+  async getStatus() {
+    const accountAddr = await this.getAccountAddress();
+    const positions = [];
+    for (const [symbol, info] of Object.entries(this.collaterals)) {
+      const pos = await this.morpho.getPosition(accountAddr, info.address);
+      if (pos.isActive || pos.collateralAmount > 0n || pos.borrowedAmount > 0n) {
+        positions.push({
+          token: symbol,
+          collateral: ethers4.formatUnits(pos.collateralAmount, info.decimals),
+          debt: `$${ethers4.formatUnits(pos.borrowedAmount, 6)}`,
+          active: pos.isActive
+        });
+      }
+    }
+    const totalDebt = await this.morpho.getTotalDebt(accountAddr);
+    return {
+      agentAccount: accountAddr,
+      totalDebt: `$${ethers4.formatUnits(totalDebt, 6)}`,
+      positions
+    };
+  }
+  // ══════════════════════════════════════════
+  //  Fund AgentAccount
+  // ══════════════════════════════════════════
+  /**
+   * Transfer USDC from EOA wallet into AgentAccount.
+   *
+   * @param amount - Human-readable USDC amount (e.g. "50")
+   */
+  async fundAccount(amount) {
+    const amountWei = ethers4.parseUnits(amount, 6);
+    const accountAddr = await this.getAccountAddress();
+    const usdc = new Contract3(this.config.contracts.usdc, ERC20_ABI, this.signer);
+    const balance = await usdc.balanceOf(this.signer.address);
+    if (balance < amountWei) {
+      throw new Error(`Insufficient USDC: have $${ethers4.formatUnits(balance, 6)}, need $${amount}`);
+    }
+    const tx = await usdc.transfer(accountAddr, amountWei);
+    await tx.wait();
+    return { tx: tx.hash, amount, agentAccount: accountAddr };
+  }
+  /**
+   * Check whether a borrow would exceed max LTV.
+   * Call before borrow() or depositAndBorrow() to get a clear error instead of on-chain revert.
+   *
+   * @param tokenSymbol - Collateral token
+   * @param additionalCollateral - Additional collateral being deposited ("0" if just borrowing)
+   * @param borrowAmount - USDC to borrow
+   */
+  async checkLtv(tokenSymbol, additionalCollateral, borrowAmount) {
+    const tokenInfo = this.resolveToken(tokenSymbol);
+    const accountAddr = await this.getAccountAddress();
+    const pos = await this.morpho.getPosition(accountAddr, tokenInfo.address);
+    const marketInfo = await this.morpho.markets(tokenInfo.address);
+    const oracle = new Contract3(marketInfo.params.oracle, _MorphoCreditClient.ORACLE_ABI, this.signer.provider);
+    const oraclePrice = await oracle.price();
+    const addCollateralWei = ethers4.parseUnits(additionalCollateral, tokenInfo.decimals);
+    const borrowWei = ethers4.parseUnits(borrowAmount, 6);
+    const totalCollateral = pos.collateralAmount + addCollateralWei;
+    const totalDebt = pos.borrowedAmount + borrowWei;
+    const collateralValue = totalCollateral * oraclePrice / BigInt("1000000000000000000000000000000000000");
+    const collateralUsd = Number(collateralValue) / 1e6;
+    const currentDebtUsd = Number(pos.borrowedAmount) / 1e6;
+    const maxLtvBps = Number(marketInfo.maxLtvBps);
+    const currentLtv = collateralValue > 0n ? Number(pos.borrowedAmount * 10000n / collateralValue) / 100 : 0;
+    const newLtv = collateralValue > 0n ? Number(totalDebt * 10000n / collateralValue) / 100 : totalDebt > 0n ? Infinity : 0;
+    const maxLtv = maxLtvBps / 100;
+    const maxBorrow = collateralUsd * maxLtvBps / 1e4;
+    const ok = newLtv <= maxLtv;
+    return {
+      ok,
+      currentLtv,
+      newLtv,
+      maxLtv,
+      collateralUsd,
+      currentDebt: currentDebtUsd,
+      maxBorrow,
+      message: ok ? void 0 : `ExceedsMaxLtv: borrowing $${borrowAmount} would push LTV to ${newLtv.toFixed(1)}% (max ${maxLtv}%). Collateral: $${collateralUsd.toFixed(2)}. Current debt: $${currentDebtUsd.toFixed(3)}. Max additional borrow: $${(maxBorrow - currentDebtUsd).toFixed(2)}. Deposit more collateral or borrow less.`
+    };
+  }
+  // ══════════════════════════════════════════
   //  Flow 3: Deposit collateral only
   // ══════════════════════════════════════════
   /**
@@ -1548,13 +1781,18 @@ var MorphoCreditClient = class {
     const collateralWei = ethers4.parseUnits(collateralAmount, tokenInfo.decimals);
     const borrowWei = ethers4.parseUnits(borrowAmount, 6);
     const accountAddr = await this.getAccountAddress();
+    const ltvCheck = await this.checkLtv(tokenSymbol, collateralAmount, borrowAmount);
+    if (!ltvCheck.ok) throw new Error(ltvCheck.message);
     const depositTxHash = await this.approveAndDeposit(accountAddr, tokenInfo, collateralWei);
     await this.ensureCreditProvider(accountAddr);
-    const borrowTxHash = await this.executeBorrow(accountAddr, tokenInfo.address, borrowWei);
+    const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+    const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [tokenInfo.address, borrowWei]);
+    const borrowTx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    await borrowTx.wait();
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
     return {
       depositTx: depositTxHash,
-      borrowTx: borrowTxHash,
+      borrowTx: borrowTx.hash,
       collateral: { amount: collateralWei, token: tokenSymbol },
       borrowed: borrowWei,
       agentAccount: accountAddr,
@@ -1585,10 +1823,16 @@ var MorphoCreditClient = class {
     if (!activeToken) {
       throw new Error("No collateral deposited. Use deposit() or depositAndBorrow() first.");
     }
-    const txHash = await this.executeBorrow(accountAddr, activeToken.address, borrowWei);
+    const ltvCheck = await this.checkLtv(activeToken.symbol, "0", amount);
+    if (!ltvCheck.ok) throw new Error(ltvCheck.message);
+    await this.ensureCreditProvider(accountAddr);
+    const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+    const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [activeToken.address, borrowWei]);
+    const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+    await tx.wait();
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
     return {
-      tx: txHash,
+      tx: tx.hash,
       amount: borrowWei,
       agentAccount: accountAddr,
       totalDebt,
@@ -1633,8 +1877,11 @@ var MorphoCreditClient = class {
       const borrowWei = ethers4.parseUnits(borrowAmount, 6);
       try {
         await this.ensureCreditProvider(accountAddr);
-        const borrowTxHash = await this.executeBorrow(accountAddr, tokenInfo.address, borrowWei);
-        result.borrowTx = borrowTxHash;
+        const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
+        const calldata = this.morphoIface.encodeFunctionData("drawWithCollateral", [tokenInfo.address, borrowWei]);
+        const tx = await account.execute(this.config.contracts.morphoCredit, 0, calldata);
+        await tx.wait();
+        result.borrowTx = tx.hash;
         result.borrowed = borrowWei;
       } catch (e) {
         throw new Error(`Borrow failed (caller may not own this AgentAccount): ${e.message}`);
@@ -1670,17 +1917,20 @@ var MorphoCreditClient = class {
     if (balance < amountWei) {
       throw new Error(`Insufficient USDC in AgentAccount: $${ethers4.formatUnits(balance, 6)}`);
     }
-    const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const erc20Iface = new ethers4.Interface(ERC20_ABI);
-    const morphoIface = new ethers4.Interface(MORPHO_CREDIT_ABI);
-    const approveData = erc20Iface.encodeFunctionData("approve", [this.config.contracts.morphoCredit, amountWei]);
-    const approveTx = await account.execute(this.config.contracts.usdc, 0, approveData);
-    await approveTx.wait();
-    const repayData = morphoIface.encodeFunctionData("repayWithCollateral", [collateralAddr, amountWei]);
-    const tx = await account.execute(this.config.contracts.morphoCredit, 0, repayData);
-    await tx.wait();
+    const txHash = await this.batch(accountAddr, [
+      {
+        target: this.config.contracts.usdc,
+        value: 0n,
+        data: this.erc20Iface.encodeFunctionData("approve", [this.config.contracts.morphoCredit, amountWei])
+      },
+      {
+        target: this.config.contracts.morphoCredit,
+        value: 0n,
+        data: this.morphoIface.encodeFunctionData("repayWithCollateral", [collateralAddr, amountWei])
+      }
+    ]);
     const totalDebt = await this.morpho.getTotalDebt(accountAddr);
-    return { tx: tx.hash, amount: amountWei, remainingDebt: totalDebt };
+    return { tx: txHash, amount: amountWei, remainingDebt: totalDebt };
   }
   /**
    * Withdraw collateral from Morpho back to EOA.
@@ -1701,18 +1951,21 @@ var MorphoCreditClient = class {
         `Cannot withdraw more than deposited: max ${ethers4.formatUnits(pos.collateralAmount, tokenInfo.decimals)} ${tokenSymbol}`
       );
     }
-    const account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
-    const morphoIface = new ethers4.Interface(MORPHO_CREDIT_ABI);
-    const withdrawData = morphoIface.encodeFunctionData("withdrawCollateral", [tokenInfo.address, withdrawAmount]);
-    const tx1 = await account.execute(this.config.contracts.morphoCredit, 0, withdrawData);
-    await tx1.wait();
-    const erc20Iface = new ethers4.Interface(ERC20_ABI);
-    const transferData = erc20Iface.encodeFunctionData("transfer", [this.signer.address, withdrawAmount]);
-    const tx2 = await account.execute(tokenInfo.address, 0, transferData);
-    await tx2.wait();
+    const txHash = await this.batch(accountAddr, [
+      {
+        target: this.config.contracts.morphoCredit,
+        value: 0n,
+        data: this.morphoIface.encodeFunctionData("withdrawCollateral", [tokenInfo.address, withdrawAmount])
+      },
+      {
+        target: tokenInfo.address,
+        value: 0n,
+        data: this.erc20Iface.encodeFunctionData("transfer", [this.signer.address, withdrawAmount])
+      }
+    ]);
     const newPos = await this.morpho.getPosition(accountAddr, tokenInfo.address);
     return {
-      tx: tx1.hash,
+      tx: txHash,
       amount: withdrawAmount,
       token: tokenSymbol,
       destination: this.signer.address,
@@ -1777,6 +2030,17 @@ var MorphoCreditClient = class {
     return this.signer.address;
   }
 };
+_MorphoCreditClient.ERC8004_ABI = [
+  "function register(string agentURI) returns (uint256)",
+  "function ownerOf(uint256 tokenId) view returns (address)",
+  "function balanceOf(address owner) view returns (uint256)",
+  "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)"
+];
+// ══════════════════════════════════════════
+//  LTV Pre-check
+// ══════════════════════════════════════════
+_MorphoCreditClient.ORACLE_ABI = ["function price() view returns (uint256)"];
+var MorphoCreditClient = _MorphoCreditClient;
 
 // src/clients/WalletClient.ts
 import { ethers as ethers5, Contract as Contract4, Wallet } from "ethers";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/sdk",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "TypeScript SDK for Agether - autonomous credit for AI agents on Base",
   "main": "dist/index.js",
   "module": "dist/index.mjs",