@agether/sdk 1.6.1 → 1.6.3

package/dist/index.mjs

@@ -135,9 +135,9 @@ var CONTRACT_ADDRESSES = {
     morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
   },
   [8453 /* Base */]: {
-    accountFactory: "0x7D5D56416bAEA06a9DCBe3092eF335724C6320a0",
-    validationRegistry: "0xd196C32D2149270F56E209ba7aEE67CE9ceD2001",
-    agentReputation: "0x65c9cA1211809D3CF3A2707558198eb2b2bE623c",
+    accountFactory: "0x871eb6b07964bc308bf68b18ca5824AFE5Cb0c8b",
+    validationRegistry: "0x5a2FF014C68a2498554B5786ED92483E6d56D06f",
+    agentReputation: "0x47adEA82a8975a60D81483CD39C377F905988DF1",
     usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
     morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
@@ -696,6 +696,179 @@ var MorphoClient = class {
     };
   }
   // ════════════════════════════════════════════════════════
+  //  Balance & Borrowing Capacity
+  // ════════════════════════════════════════════════════════
+  /**
+   * Get the USDC balance of the AgentAccount.
+   * @returns USDC balance in raw units (6 decimals)
+   */
+  async getUsdcBalance() {
+    const acctAddr = await this.getAccountAddress();
+    const usdc = new Contract2(this.config.contracts.usdc, ERC20_ABI, this.provider);
+    return usdc.balanceOf(acctAddr);
+  }
+  /**
+   * Calculate the maximum additional USDC that can be borrowed
+   * given the agent's current collateral and debt across all markets.
+   *
+   * For each market with collateral deposited:
+   *   maxBorrow = (collateralValue * LLTV) - currentDebt
+   *
+   * Uses the Morpho oracle to price collateral → loan token.
+   *
+   * @returns Maximum additional USDC borrowable (6 decimals)
+   */
+  async getMaxBorrowable() {
+    const acctAddr = await this.getAccountAddress();
+    const markets = await this.getMarkets();
+    let totalAdditional = 0n;
+    const byMarket = [];
+    for (const m of markets) {
+      if (!m.collateralAsset || m.collateralAsset.address === ethers2.ZeroAddress) continue;
+      try {
+        const pos = await this.morphoBlue.position(m.uniqueKey, acctAddr);
+        if (pos.collateral === 0n) continue;
+        const mktState = await this.morphoBlue.market(m.uniqueKey);
+        const totalBorrowShares = BigInt(mktState.totalBorrowShares);
+        const totalBorrowAssets = BigInt(mktState.totalBorrowAssets);
+        const currentDebt = totalBorrowShares > 0n ? BigInt(pos.borrowShares) * totalBorrowAssets / totalBorrowShares : 0n;
+        let collateralValueInLoan;
+        try {
+          const oracleContract = new Contract2(m.oracle, [
+            "function price() view returns (uint256)"
+          ], this.provider);
+          const oraclePrice = await oracleContract.price();
+          const ORACLE_PRICE_SCALE = 10n ** 36n;
+          collateralValueInLoan = BigInt(pos.collateral) * oraclePrice / ORACLE_PRICE_SCALE;
+        } catch {
+          continue;
+        }
+        const maxBorrowTotal = collateralValueInLoan * m.lltv / 10n ** 18n;
+        const maxAdditional = maxBorrowTotal > currentDebt ? maxBorrowTotal - currentDebt : 0n;
+        totalAdditional += maxAdditional;
+        byMarket.push({
+          collateralToken: m.collateralAsset.symbol,
+          maxAdditional,
+          currentDebt,
+          collateralValue: collateralValueInLoan
+        });
+      } catch {
+        continue;
+      }
+    }
+    return { total: totalAdditional, byMarket };
+  }
+  // ════════════════════════════════════════════════════════
+  //  Market Rates & Yield Estimation
+  // ════════════════════════════════════════════════════════
+  /**
+   * Fetch current supply/borrow APY for a collateral market from Morpho GraphQL API.
+   *
+   * Note: On Morpho Blue, collateral does NOT earn yield directly. Supply APY
+   * is what lenders earn; borrow APY is what borrowers pay.
+   */
+  async getMarketRates(collateralSymbolOrAddress) {
+    const chainId = this.config.chainId;
+    const usdcAddr = this.config.contracts.usdc.toLowerCase();
+    let collateralFilter = "";
+    if (collateralSymbolOrAddress) {
+      const colInfo = BASE_COLLATERALS[collateralSymbolOrAddress];
+      const colAddr = (colInfo?.address ?? collateralSymbolOrAddress).toLowerCase();
+      collateralFilter = `, collateralAssetAddress_in: ["${colAddr}"]`;
+    }
+    const query = `{
+      markets(
+        first: 50
+        orderBy: SupplyAssetsUsd
+        orderDirection: Desc
+        where: { chainId_in: [${chainId}], loanAssetAddress_in: ["${usdcAddr}"]${collateralFilter} }
+      ) {
+        items {
+          uniqueKey
+          lltv
+          loanAsset { address symbol decimals }
+          collateralAsset { address symbol decimals }
+          state {
+            borrowAssets
+            supplyAssets
+            utilization
+            supplyApy
+            borrowApy
+          }
+        }
+      }
+    }`;
+    try {
+      const resp = await axios.post(MORPHO_API_URL, { query }, { timeout: 1e4 });
+      const items = resp.data?.data?.markets?.items ?? [];
+      return items.filter((m) => m.collateralAsset?.address && m.collateralAsset.address !== ethers2.ZeroAddress).map((m) => ({
+        collateralToken: m.collateralAsset.symbol,
+        loanToken: m.loanAsset.symbol,
+        supplyApy: m.state?.supplyApy ? Number(m.state.supplyApy) : 0,
+        borrowApy: m.state?.borrowApy ? Number(m.state.borrowApy) : 0,
+        utilization: m.state?.utilization ? Number(m.state.utilization) : 0,
+        totalSupplyUsd: m.state?.supplyAssets ? Number(m.state.supplyAssets) / 1e6 : 0,
+        totalBorrowUsd: m.state?.borrowAssets ? Number(m.state.borrowAssets) / 1e6 : 0,
+        lltv: `${(Number(m.lltv) / 1e16).toFixed(0)}%`,
+        marketId: m.uniqueKey
+      }));
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Estimate theoretical yield for a given collateral amount over a period.
+   *
+   * ⚠️ IMPORTANT: On Morpho Blue, collateral does NOT earn yield directly.
+   * This estimates what the collateral WOULD earn if it were instead supplied
+   * as a lender (not used as collateral). This is a theoretical upper bound
+   * useful for setting spending caps.
+   *
+   * @param collateralSymbol - e.g. 'WETH'
+   * @param amount - collateral amount in human-readable (e.g. '1.5')
+   * @param periodDays - estimation period in days (default: 1)
+   * @param ethPriceUsd - ETH price in USD for value conversion (if not provided, uses oracle)
+   * @returns Estimated yield in USD for the period
+   */
+  async getYieldEstimate(collateralSymbol, amount, periodDays = 1, ethPriceUsd) {
+    const colInfo = BASE_COLLATERALS[collateralSymbol];
+    if (!colInfo) throw new AgetherError(`Unknown collateral: ${collateralSymbol}`, "UNKNOWN_COLLATERAL");
+    const rates = await this.getMarketRates(collateralSymbol);
+    if (rates.length === 0) {
+      throw new AgetherError(`No market found for ${collateralSymbol}`, "MARKET_NOT_FOUND");
+    }
+    const market = rates[0];
+    const supplyApy = market.supplyApy;
+    let collateralValueUsd;
+    if (ethPriceUsd) {
+      collateralValueUsd = parseFloat(amount) * ethPriceUsd;
+    } else {
+      try {
+        const params = await this.findMarketForCollateral(collateralSymbol);
+        const oracleContract = new Contract2(params.oracle, [
+          "function price() view returns (uint256)"
+        ], this.provider);
+        const oraclePrice = await oracleContract.price();
+        const ORACLE_PRICE_SCALE = 10n ** 36n;
+        const amountWei = ethers2.parseUnits(amount, colInfo.decimals);
+        const valueInUsdc = amountWei * oraclePrice / ORACLE_PRICE_SCALE;
+        collateralValueUsd = Number(valueInUsdc) / 1e6;
+      } catch {
+        throw new AgetherError("Cannot determine collateral value. Provide ethPriceUsd.", "PRICE_UNAVAILABLE");
+      }
+    }
+    const estimatedYieldUsd = collateralValueUsd * supplyApy * (periodDays / 365);
+    return {
+      collateralToken: collateralSymbol,
+      amount,
+      periodDays,
+      theoreticalSupplyApy: supplyApy,
+      estimatedYieldUsd,
+      collateralValueUsd,
+      disclaimer: "Collateral on Morpho Blue does NOT earn yield directly. This estimates what it WOULD earn if supplied as a lender instead. Use as a theoretical spending cap."
+    };
+  }
+  // ════════════════════════════════════════════════════════
   //  Lending Operations (all via AgentAccount.executeBatch)
   // ════════════════════════════════════════════════════════
   /**
@@ -1088,6 +1261,9 @@ var X402Client = class {
     const client = new x402Client();
     registerExactEvmScheme(client, { signer });
     this.paidFetch = wrapFetchWithPayment(fetch, client);
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const dailyLimit = config.dailySpendLimitUsdc ? BigInt(Math.round(parseFloat(config.dailySpendLimitUsdc) * 1e6)) : 0n;
+    this._spendingTracker = { date: today, totalBorrowed: 0n, dailyLimit };
   }
   async get(url, opts) {
     return this.request(url, { ...opts, method: "GET" });
@@ -1103,6 +1279,82 @@ var X402Client = class {
   getAddress() {
     return this.address;
   }
+  /** Get the current spending tracker state */
+  getSpendingTracker() {
+    this._resetTrackerIfNewDay();
+    return { ...this._spendingTracker };
+  }
+  /** Get remaining daily spending allowance in USDC (human-readable) */
+  getRemainingDailyAllowance() {
+    this._resetTrackerIfNewDay();
+    if (this._spendingTracker.dailyLimit === 0n) return "unlimited";
+    const remaining = this._spendingTracker.dailyLimit - this._spendingTracker.totalBorrowed;
+    return (Number(remaining > 0n ? remaining : 0n) / 1e6).toFixed(2);
+  }
+  /**
+   * Pay with auto-draw: Make an x402 request with automatic Morpho borrowing.
+   *
+   * Flow:
+   * 1. Check USDC balance on AgentAccount
+   * 2. Probe the URL to discover payment amount (if 402)
+   * 3. If insufficient USDC, calculate deficit
+   * 4. Check spending limit
+   * 5. Borrow from Morpho via MorphoClient
+   * 6. Proceed with x402 payment
+   */
+  async payWithAutoDraw(url, opts) {
+    const { morphoClient, ...fetchOpts } = opts || {};
+    if (!this.config.autoDraw || !morphoClient) {
+      return this.request(url, fetchOpts);
+    }
+    try {
+      const usdcBalance = await morphoClient.getUsdcBalance();
+      console.log(`   [auto-draw] AgentAccount USDC balance: ${(Number(usdcBalance) / 1e6).toFixed(2)}`);
+      const paymentAmount = await this._probePaymentAmount(url, fetchOpts);
+      if (paymentAmount !== null) {
+        console.log(`   [auto-draw] Payment required: ${(Number(paymentAmount) / 1e6).toFixed(6)} USDC`);
+        const bufferStr = this.config.autoDrawBuffer || "0.5";
+        const buffer = BigInt(Math.round(parseFloat(bufferStr) * 1e6));
+        const needed = paymentAmount + buffer;
+        if (usdcBalance < needed) {
+          const deficit = needed - usdcBalance;
+          console.log(`   [auto-draw] Insufficient balance. Need to borrow ${(Number(deficit) / 1e6).toFixed(2)} USDC`);
+          const limitCheck = await this._checkSpendingLimit(deficit, morphoClient);
+          if (!limitCheck.allowed) {
+            return {
+              success: false,
+              error: `Auto-draw blocked: ${limitCheck.reason}`
+            };
+          }
+          const maxBorrowable = await morphoClient.getMaxBorrowable();
+          if (maxBorrowable.total < deficit) {
+            return {
+              success: false,
+              error: `Auto-draw failed: insufficient collateral. Need ${(Number(deficit) / 1e6).toFixed(2)} USDC but can only borrow ${(Number(maxBorrowable.total) / 1e6).toFixed(2)} USDC more.`
+            };
+          }
+          const borrowAmount = (Number(deficit) / 1e6).toFixed(6);
+          console.log(`   [auto-draw] Borrowing ${borrowAmount} USDC from Morpho...`);
+          const borrowResult = await morphoClient.borrow(borrowAmount);
+          console.log(`   [auto-draw] Borrow tx: ${borrowResult.tx}`);
+          this._trackSpending(deficit);
+          const result = await this.request(url, fetchOpts);
+          return {
+            ...result,
+            autoDrawInfo: {
+              borrowed: borrowAmount,
+              borrowTx: borrowResult.tx,
+              reason: `USDC balance insufficient (had ${(Number(usdcBalance) / 1e6).toFixed(2)}, needed ${(Number(needed) / 1e6).toFixed(2)})`
+            }
+          };
+        }
+      }
+      return this.request(url, fetchOpts);
+    } catch (error) {
+      console.log(`   [auto-draw] Auto-draw check failed: ${error instanceof Error ? error.message : String(error)}. Proceeding with normal request.`);
+      return this.request(url, fetchOpts);
+    }
+  }
   // ──────────── Core request — @x402/fetch handles 402 automatically ────────────
   async request(url, options) {
     try {
@@ -1152,6 +1404,102 @@ var X402Client = class {
       };
     }
   }
+  // ──────────── Auto-Draw Helpers ────────────
+  /**
+   * Probe a URL to discover payment requirements without paying.
+   * Makes a request and parses the 402 PAYMENT-REQUIRED header.
+   * @returns Payment amount in raw USDC units (6 decimals), or null if not a 402.
+   */
+  async _probePaymentAmount(url, options) {
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          ...options?.headers,
+          "X-Agent-Id": this.config.agentId || ""
+        }
+      });
+      if (response.status !== 402) return null;
+      const paymentHeader = response.headers.get("X-PAYMENT") || response.headers.get("PAYMENT-REQUIRED");
+      if (!paymentHeader) return null;
+      try {
+        const decoded = JSON.parse(Buffer.from(paymentHeader, "base64").toString("utf-8"));
+        const requirements = Array.isArray(decoded) ? decoded : decoded.accepts || [decoded];
+        if (requirements.length > 0) {
+          const amount = requirements[0].maxAmountRequired || requirements[0].amount;
+          if (amount) {
+            return BigInt(amount);
+          }
+        }
+      } catch {
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  /** Reset spending tracker if it's a new day */
+  _resetTrackerIfNewDay() {
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    if (this._spendingTracker.date !== today) {
+      this._spendingTracker = {
+        date: today,
+        totalBorrowed: 0n,
+        dailyLimit: this._spendingTracker.dailyLimit
+      };
+    }
+  }
+  /** Track a new spending amount */
+  _trackSpending(amount) {
+    this._resetTrackerIfNewDay();
+    this._spendingTracker.totalBorrowed += amount;
+  }
+  /**
+   * Check if a borrow amount is within spending limits.
+   * Considers both fixed daily limits and yield-limited spending.
+   */
+  async _checkSpendingLimit(amount, morphoClient) {
+    this._resetTrackerIfNewDay();
+    if (this.config.yieldLimitedSpending) {
+      try {
+        const status = await morphoClient.getStatus();
+        let totalDailyYieldUsdc = 0;
+        for (const pos of status.positions) {
+          if (parseFloat(pos.collateral) > 0) {
+            try {
+              const estimate = await morphoClient.getYieldEstimate(
+                pos.collateralToken,
+                pos.collateral,
+                1
+                // 1 day
+              );
+              totalDailyYieldUsdc += estimate.estimatedYieldUsd;
+            } catch {
+            }
+          }
+        }
+        const yieldLimit = BigInt(Math.round(totalDailyYieldUsdc * 1e6));
+        const newTotal = this._spendingTracker.totalBorrowed + amount;
+        if (yieldLimit > 0n && newTotal > yieldLimit) {
+          return {
+            allowed: false,
+            reason: `Yield-limited spending exceeded. Daily yield cap: $${(Number(yieldLimit) / 1e6).toFixed(2)}, already spent: $${(Number(this._spendingTracker.totalBorrowed) / 1e6).toFixed(2)}, requested: $${(Number(amount) / 1e6).toFixed(2)}`
+          };
+        }
+      } catch {
+      }
+    }
+    if (this._spendingTracker.dailyLimit > 0n) {
+      const newTotal = this._spendingTracker.totalBorrowed + amount;
+      if (newTotal > this._spendingTracker.dailyLimit) {
+        return {
+          allowed: false,
+          reason: `Daily spending limit exceeded. Limit: $${(Number(this._spendingTracker.dailyLimit) / 1e6).toFixed(2)}, already spent: $${(Number(this._spendingTracker.totalBorrowed) / 1e6).toFixed(2)}, requested: $${(Number(amount) / 1e6).toFixed(2)}`
+        };
+      }
+    }
+    return { allowed: true };
+  }
 };
 
 // src/clients/ScoringClient.ts

package/dist/types/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Agether SDK Types
+ *
+ * Architecture:
+ * - Agent registers via ERC-8004 → gets agentId
+ * - AccountFactory creates AgentAccount (KYA-gated smart wallet) per agent
+ * - AgentReputation: oracle-based credit scoring
+ * - Morpho Blue: direct overcollateralized lending (agents interact directly)
+ * - x402: HTTP payment protocol for scoring API
+ */
+export declare enum ChainId {
+    Ethereum = 1,
+    Base = 8453,
+    BaseSepolia = 84532,
+    Sepolia = 11155111,
+    Hardhat = 31337
+}
+/** Morpho Blue MarketParams struct */
+export interface MorphoMarketParams {
+    loanToken: string;
+    collateralToken: string;
+    oracle: string;
+    irm: string;
+    lltv: bigint;
+}
+/** Morpho Blue on-chain position for an account */
+export interface MorphoPosition {
+    supplyShares: bigint;
+    borrowShares: bigint;
+    collateral: bigint;
+}
+/** Morpho market info (from GraphQL API or on-chain) */
+export interface MorphoMarketInfo {
+    uniqueKey: string;
+    loanAsset: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    collateralAsset: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    oracle: string;
+    irm: string;
+    lltv: bigint;
+    totalSupplyAssets: bigint;
+    totalBorrowAssets: bigint;
+    utilization: number;
+}
+/** On-chain score attestation from AgentReputation contract */
+export interface ScoreAttestation {
+    score: bigint;
+    timestamp: bigint;
+    signer: string;
+}
+/** Score result from backend scoring API */
+export interface ScoreResult {
+    agentId: string;
+    score: number;
+    timestamp: number;
+    breakdown: {
+        kyaBonus: number;
+        accountBonus: number;
+        balanceBonus: number;
+        historyBonus: number;
+        baseScore: number;
+    };
+    txHash?: string;
+}
+export interface TransactionResult {
+    txHash: string;
+    blockNumber: number;
+    status: 'success' | 'failed';
+    gasUsed: bigint;
+}
+export interface X402PaymentRequest {
+    service: string;
+    amount: bigint;
+    asset: string;
+    chain: ChainId;
+    recipient: string;
+}
+export interface X402PaymentResult {
+    paymentId: string;
+    txHash: string;
+    amount: bigint;
+    chain: ChainId;
+    status: 'pending' | 'confirmed' | 'failed';
+}
+export interface AgetherConfig {
+    chainId: ChainId;
+    rpcUrl: string;
+    contracts: ContractAddresses;
+    scoringEndpoint?: string;
+    kyaEndpoint?: string;
+}
+export interface ContractAddresses {
+    accountFactory: string;
+    validationRegistry: string;
+    agentReputation: string;
+    usdc: string;
+    identityRegistry: string;
+    morphoBlue: string;
+}
+export declare class AgetherError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class InsufficientBalanceError extends AgetherError {
+    constructor(available: bigint, required: bigint);
+}
+export declare class ScoringRejectedError extends AgetherError {
+    constructor(riskScore: number, reason?: string);
+}
+export declare class AgentNotApprovedError extends AgetherError {
+    constructor(agentId: bigint);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,43 @@
+/**
+ * Agether SDK Types
+ *
+ * Architecture:
+ * - Agent registers via ERC-8004 → gets agentId
+ * - AccountFactory creates AgentAccount (KYA-gated smart wallet) per agent
+ * - AgentReputation: oracle-based credit scoring
+ * - Morpho Blue: direct overcollateralized lending (agents interact directly)
+ * - x402: HTTP payment protocol for scoring API
+ */
+// ============ Enums ============
+export var ChainId;
+(function (ChainId) {
+    ChainId[ChainId["Ethereum"] = 1] = "Ethereum";
+    ChainId[ChainId["Base"] = 8453] = "Base";
+    ChainId[ChainId["BaseSepolia"] = 84532] = "BaseSepolia";
+    ChainId[ChainId["Sepolia"] = 11155111] = "Sepolia";
+    ChainId[ChainId["Hardhat"] = 31337] = "Hardhat";
+})(ChainId || (ChainId = {}));
+// ============ Error Types ============
+export class AgetherError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'AgetherError';
+    }
+}
+export class InsufficientBalanceError extends AgetherError {
+    constructor(available, required) {
+        super(`Insufficient balance: available ${available}, required ${required}`, 'INSUFFICIENT_BALANCE', { available: available.toString(), required: required.toString() });
+    }
+}
+export class ScoringRejectedError extends AgetherError {
+    constructor(riskScore, reason) {
+        super(`Scoring rejected: risk score ${riskScore}${reason ? `, ${reason}` : ''}`, 'SCORING_REJECTED', { riskScore, reason });
+    }
+}
+export class AgentNotApprovedError extends AgetherError {
+    constructor(agentId) {
+        super(`Agent ${agentId} is not KYA-approved. Submit code for validation first.`, 'AGENT_NOT_APPROVED', { agentId: agentId.toString() });
+    }
+}

package/dist/utils/abis.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Contract ABIs (minimal for SDK)
+ *
+ * Architecture:
+ * - AccountFactory + AgentAccount (KYA-gated smart wallets)
+ * - AgentReputation (oracle-based credit scores)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ */
+export declare const IDENTITY_REGISTRY_ABI: string[];
+export declare const ACCOUNT_FACTORY_ABI: string[];
+export declare const AGENT_ACCOUNT_ABI: string[];
+export declare const AGENT_REPUTATION_ABI: string[];
+export declare const VALIDATION_REGISTRY_ABI: string[];
+export declare const MORPHO_BLUE_ABI: string[];
+export declare const ERC20_ABI: string[];
+//# sourceMappingURL=abis.d.ts.map

package/dist/utils/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../../src/utils/abis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,qBAAqB,UAOjC,CAAC;AAIF,eAAO,MAAM,mBAAmB,UAQ/B,CAAC;AAIF,eAAO,MAAM,iBAAiB,UAc7B,CAAC;AAIF,eAAO,MAAM,oBAAoB,UAShC,CAAC;AAIF,eAAO,MAAM,uBAAuB,UAKnC,CAAC;AAIF,eAAO,MAAM,eAAe,UAiB3B,CAAC;AAIF,eAAO,MAAM,SAAS,UASrB,CAAC"}

package/dist/utils/abis.js

@@ -0,0 +1,93 @@
+/**
+ * Contract ABIs (minimal for SDK)
+ *
+ * Architecture:
+ * - AccountFactory + AgentAccount (KYA-gated smart wallets)
+ * - AgentReputation (oracle-based credit scores)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ */
+// ── ERC-8004 Identity Registry ──
+export const IDENTITY_REGISTRY_ABI = [
+    'function ownerOf(uint256 agentId) view returns (address)',
+    'function balanceOf(address owner) view returns (uint256)',
+    'function totalSupply() view returns (uint256)',
+    'function exists(uint256 agentId) view returns (bool)',
+    'function register() returns (uint256 agentId)',
+    'event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)',
+];
+// ── Account Factory ──
+export const ACCOUNT_FACTORY_ABI = [
+    'function getAccount(uint256 agentId) view returns (address)',
+    'function accountExists(uint256 agentId) view returns (bool)',
+    'function predictAddress(uint256 agentId) view returns (address)',
+    'function totalAccounts() view returns (uint256)',
+    'function getAgentId(address account) view returns (uint256)',
+    'function createAccount(uint256 agentId) returns (address account)',
+    'event AccountCreated(uint256 indexed agentId, address indexed account, address indexed owner)',
+];
+// ── Agent Account (KYA-gated smart wallet) ──
+export const AGENT_ACCOUNT_ABI = [
+    'function agentId() view returns (uint256)',
+    'function owner() view returns (address)',
+    'function factory() view returns (address)',
+    'function validationRegistry() view returns (address)',
+    'function identityRegistry() view returns (address)',
+    '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 fund(address token, uint256 amount)',
+    'function withdraw(address token, uint256 amount, address to)',
+    'function withdrawETH(uint256 amount, address to)',
+    'function isValidSignature(bytes32 hash, bytes signature) view returns (bytes4)',
+];
+// ── Agent Reputation (oracle-based scoring) ──
+export const AGENT_REPUTATION_ABI = [
+    'function getCreditScore(uint256 agentId) view returns (uint256)',
+    'function getAttestation(uint256 agentId) view returns (tuple(uint256 score, uint256 timestamp, address signer))',
+    'function isScoreFresh(uint256 agentId) view returns (bool fresh, uint256 age)',
+    'function isEligible(uint256 agentId, uint256 minScore) view returns (bool eligible, uint256 currentScore)',
+    'function oracleSigner() view returns (address)',
+    'function submitScore(uint256 agentId, uint256 score_, uint256 timestamp_, bytes signature)',
+    'function setOracleSigner(address signer_)',
+    'event ScoreUpdated(uint256 indexed agentId, uint256 score, uint256 timestamp, address signer)',
+];
+// ── Validation Registry (KYA) ──
+export const VALIDATION_REGISTRY_ABI = [
+    'function isAgentCodeApproved(uint256 agentId) view returns (bool)',
+    'function isAgentCodeApprovedForTag(uint256 agentId, string tag) view returns (bool)',
+    'function getAgentValidations(uint256 agentId) view returns (bytes32[])',
+    'function getValidation(bytes32 requestHash) view returns (tuple(address validatorAddress, uint256 agentId, string requestURI, uint8 response, string responseURI, bytes32 responseHash, string tag, uint256 requestedAt, uint256 respondedAt, bool hasResponse))',
+];
+// ── Morpho Blue (direct lending protocol) ──
+export const MORPHO_BLUE_ABI = [
+    // Supply & Withdraw (lending side)
+    'function supply(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, bytes data) returns (uint256 assetsSupplied, uint256 sharesSupplied)',
+    'function withdraw(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, address receiver) returns (uint256 assetsWithdrawn, uint256 sharesWithdrawn)',
+    // Collateral
+    'function supplyCollateral(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, address onBehalf, bytes data)',
+    'function withdrawCollateral(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, address onBehalf, address receiver)',
+    // Borrow & Repay
+    'function borrow(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, address receiver) returns (uint256 assetsBorrowed, uint256 sharesBorrowed)',
+    'function repay(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, bytes data) returns (uint256 assetsRepaid, uint256 sharesRepaid)',
+    // Authorization
+    'function setAuthorization(address authorized, bool newIsAuthorized)',
+    'function isAuthorized(address authorizer, address authorized) view returns (bool)',
+    // Views
+    'function position(bytes32 id, address user) view returns (uint256 supplyShares, uint128 borrowShares, uint128 collateral)',
+    'function market(bytes32 id) view returns (uint128 totalSupplyAssets, uint128 totalSupplyShares, uint128 totalBorrowAssets, uint128 totalBorrowShares, uint128 lastUpdate, uint128 fee)',
+    'function idToMarketParams(bytes32 id) view returns (tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv))',
+];
+// ── ERC-20 ──
+export const ERC20_ABI = [
+    'function balanceOf(address account) view returns (uint256)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function transferFrom(address from, address to, uint256 amount) returns (bool)',
+    'function decimals() view returns (uint8)',
+    'function symbol() view returns (string)',
+    'function name() view returns (string)',
+];