@agether/sdk 1.3.0 → 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.
      */
@@ -894,6 +942,37 @@ declare class MorphoCreditClient {
      * 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.
@@ -1134,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.
      */
@@ -894,6 +942,37 @@ declare class MorphoCreditClient {
      * 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.
@@ -1134,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

@@ -1510,7 +1510,7 @@ 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);
@@ -1521,6 +1521,7 @@ var MorphoCreditClient = class {
     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) {
@@ -1530,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.");
     }
@@ -1594,6 +1613,205 @@ var MorphoCreditClient = class {
     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
   // ══════════════════════════════════════════
   /**
@@ -1634,6 +1852,8 @@ 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 account = new import_ethers5.Contract(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
@@ -1674,6 +1894,8 @@ var MorphoCreditClient = class {
     if (!activeToken) {
       throw new Error("No collateral deposited. Use deposit() or depositAndBorrow() first.");
     }
+    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]);
@@ -1879,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

@@ -1439,7 +1439,7 @@ 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);
@@ -1450,6 +1450,7 @@ var MorphoCreditClient = class {
     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) {
@@ -1459,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.");
     }
@@ -1523,6 +1542,205 @@ var MorphoCreditClient = class {
     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
   // ══════════════════════════════════════════
   /**
@@ -1563,6 +1781,8 @@ 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 account = new Contract3(accountAddr, AGENT_ACCOUNT_ABI, this.signer);
@@ -1603,6 +1823,8 @@ var MorphoCreditClient = class {
     if (!activeToken) {
       throw new Error("No collateral deposited. Use deposit() or depositAndBorrow() first.");
     }
+    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]);
@@ -1808,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.3.0",
+  "version": "1.4.0",
   "description": "TypeScript SDK for Agether - autonomous credit for AI agents on Base",
   "main": "dist/index.js",
   "module": "dist/index.mjs",