@agether/sdk 1.10.1 → 1.11.0

package/dist/cli.js

@@ -47,7 +47,7 @@ var init_types = __esm({
 });
 
 // src/utils/abis.ts
-var IDENTITY_REGISTRY_ABI, ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, MORPHO_BLUE_ABI, ERC20_ABI;
+var IDENTITY_REGISTRY_ABI, ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, MORPHO_BLUE_ABI, ERC20_ABI, KYA_HOOK_ABI;
 var init_abis = __esm({
   "src/utils/abis.ts"() {
     "use strict";
@@ -66,24 +66,30 @@ var init_abis = __esm({
       "function totalAccounts() view returns (uint256)",
       "function getAgentId(address account) view returns (uint256)",
       "function createAccount(uint256 agentId) returns (address account)",
-      "function validationRegistry() view returns (address)",
-      "function setValidationRegistry(address newRegistry)",
-      "event AccountCreated(uint256 indexed agentId, address indexed account, address indexed owner)",
-      "event ValidationRegistryUpdated(address indexed oldRegistry, address indexed newRegistry)"
+      "function protocolHook() view returns (address)",
+      "function identityRegistry() view returns (address)",
+      "event AccountCreated(uint256 indexed agentId, address indexed account, address indexed owner)"
     ];
     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[])",
+      // ERC-7579 execution
+      "function execute(bytes32 mode, bytes executionCalldata) payable",
+      "function executeFromExecutor(bytes32 mode, bytes executionCalldata) payable returns (bytes[])",
+      // ERC-7579 module management
+      "function installModule(uint256 moduleTypeId, address module, bytes initData) payable",
+      "function uninstallModule(uint256 moduleTypeId, address module, bytes deInitData) payable",
+      "function isModuleInstalled(uint256 moduleTypeId, address module, bytes additionalContext) view returns (bool)",
+      "function hook() view returns (address)",
+      // Funding (direct, no execution needed)
       "function fund(address token, uint256 amount)",
       "function withdraw(address token, uint256 amount, address to)",
       "function withdrawETH(uint256 amount, address to)",
+      // EIP-1271
       "function isValidSignature(bytes32 hash, bytes signature) view returns (bytes4)"
     ];
     AGENT_REPUTATION_ABI = [
@@ -124,6 +130,10 @@ var init_abis = __esm({
       "function symbol() view returns (string)",
       "function name() view returns (string)"
     ];
+    KYA_HOOK_ABI = [
+      "function validationRegistry() view returns (address)",
+      "function setValidationRegistry(address newRegistry)"
+    ];
   }
 });
 
@@ -146,14 +156,16 @@ var init_config = __esm({
         accountFactory: "0x0000000000000000000000000000000000000000",
         validationRegistry: "0x0000000000000000000000000000000000000000",
         agentReputation: "0x0000000000000000000000000000000000000000",
+        kyaHook: "0x0000000000000000000000000000000000000000",
         usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
         identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
         morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
       },
       [8453 /* Base */]: {
-        accountFactory: "0xFab8b924fb292a736BA05AF7b4AEC2c8d05cdcbF",
-        validationRegistry: "0x493f1551cbbC75afb2127CDBD5375ad8e8959f42",
-        agentReputation: "0x1fcb28eE3E8F3234E653b0A7a6fb56dE11E3c203",
+        accountFactory: "0x89a8758E60A56EcB47247D92E05447eFd450d6Bf",
+        validationRegistry: "0x6f76cF69B71Dc5F9A414BCEe4583b12738E47985",
+        agentReputation: "0xe88f3419a2dbac70e3aF6E487b0C63e8301C6A87",
+        kyaHook: "0x28e50Aa9eD517E369b2806928709B44062aD9821",
         usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
         identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
         morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
@@ -162,6 +174,7 @@ var init_config = __esm({
         accountFactory: "0x0000000000000000000000000000000000000000",
         validationRegistry: "0x0000000000000000000000000000000000000000",
         agentReputation: "0x0000000000000000000000000000000000000000",
+        kyaHook: "0x0000000000000000000000000000000000000000",
         usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
         identityRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
         morphoBlue: "0x0000000000000000000000000000000000000000"
@@ -170,6 +183,7 @@ var init_config = __esm({
         accountFactory: "0x0000000000000000000000000000000000000000",
         validationRegistry: "0x0000000000000000000000000000000000000000",
         agentReputation: "0x0000000000000000000000000000000000000000",
+        kyaHook: "0x0000000000000000000000000000000000000000",
         usdc: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
         identityRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
         morphoBlue: "0x0000000000000000000000000000000000000000"
@@ -178,6 +192,7 @@ var init_config = __esm({
         accountFactory: "0x0000000000000000000000000000000000000000",
         validationRegistry: "0x0000000000000000000000000000000000000000",
         agentReputation: "0x0000000000000000000000000000000000000000",
+        kyaHook: "0x0000000000000000000000000000000000000000",
         usdc: "0x56d4d6aEe0278c5Df2FA23Ecb32eC146C9446FDf",
         identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
         morphoBlue: "0x0000000000000000000000000000000000000000"
@@ -205,7 +220,7 @@ var MorphoClient_exports = {};
 __export(MorphoClient_exports, {
   MorphoClient: () => MorphoClient
 });
-var import_ethers, import_axios, BASE_COLLATERALS, MORPHO_API_URL, morphoIface, erc20Iface, MorphoClient;
+var import_ethers, import_axios, BASE_COLLATERALS, MORPHO_API_URL, MODE_SINGLE, MODE_BATCH, morphoIface, erc20Iface, MorphoClient;
 var init_MorphoClient = __esm({
   "src/clients/MorphoClient.ts"() {
     "use strict";
@@ -220,6 +235,8 @@ var init_MorphoClient = __esm({
       cbETH: { address: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22", symbol: "cbETH", decimals: 18 }
     };
     MORPHO_API_URL = "https://api.morpho.org/graphql";
+    MODE_SINGLE = "0x0000000000000000000000000000000000000000000000000000000000000000";
+    MODE_BATCH = "0x0100000000000000000000000000000000000000000000000000000000000000";
     morphoIface = new import_ethers.ethers.Interface(MORPHO_BLUE_ABI);
     erc20Iface = new import_ethers.ethers.Interface(ERC20_ABI);
     MorphoClient = class {
@@ -263,12 +280,21 @@ var init_MorphoClient = __esm({
       // ════════════════════════════════════════════════════════
       /**
        * Check whether the KYA (Know Your Agent) code verification gate is active.
-       * When validationRegistry is address(0), KYA is disabled — agents can use
-       * execute/executeBatch without prior code approval.
+       * Reads the account's installed hook and checks if it has a non-zero
+       * validationRegistry — when set, the hook enforces KYA code approval.
        */
       async isKyaRequired() {
-        const registryAddr = await this.accountFactory.validationRegistry();
-        return registryAddr !== import_ethers.ethers.ZeroAddress;
+        try {
+          const acctAddr = await this.getAccountAddress();
+          const account = new import_ethers.Contract(acctAddr, AGENT_ACCOUNT_ABI, this.provider);
+          const hookAddr = await account.hook();
+          if (hookAddr === import_ethers.ethers.ZeroAddress) return false;
+          const hook = new import_ethers.Contract(hookAddr, KYA_HOOK_ABI, this.provider);
+          const registryAddr = await hook.validationRegistry();
+          return registryAddr !== import_ethers.ethers.ZeroAddress;
+        } catch {
+          return false;
+        }
       }
       // ════════════════════════════════════════════════════════
       //  Account Management
@@ -344,7 +370,8 @@ var init_MorphoClient = __esm({
               agentId = parsed.args[2];
               break;
             }
-          } catch {
+          } catch (e) {
+            console.warn("[agether] parseLog skip:", e instanceof Error ? e.message : e);
             continue;
           }
         }
@@ -410,7 +437,8 @@ var init_MorphoClient = __esm({
             const token = new import_ethers.Contract(info.address, ERC20_ABI, this.provider);
             const bal = await token.balanceOf(eoaAddr);
             eoaCollateral[symbol] = import_ethers.ethers.formatUnits(bal, info.decimals);
-          } catch {
+          } catch (e) {
+            console.warn(`[agether] EOA collateral fetch failed for ${symbol}:`, e instanceof Error ? e.message : e);
             eoaCollateral[symbol] = "0";
           }
         }
@@ -431,7 +459,8 @@ var init_MorphoClient = __esm({
               const token = new import_ethers.Contract(info.address, ERC20_ABI, this.provider);
               const bal = await token.balanceOf(acctAddr);
               acctCollateral[symbol] = import_ethers.ethers.formatUnits(bal, info.decimals);
-            } catch {
+            } catch (e) {
+              console.warn(`[agether] AgentAccount collateral fetch failed for ${symbol}:`, e instanceof Error ? e.message : e);
               acctCollateral[symbol] = "0";
             }
           }
@@ -521,7 +550,8 @@ var init_MorphoClient = __esm({
             }
           }
           return this._discoveredMarkets;
-        } catch {
+        } catch (e) {
+          console.warn("[agether] getMarkets failed, using cache:", e instanceof Error ? e.message : e);
           return this._discoveredMarkets ?? [];
         }
       }
@@ -587,7 +617,8 @@ var init_MorphoClient = __esm({
                 const totalBorrowAssets = BigInt(mkt.totalBorrowAssets);
                 debt = totalBorrowShares > 0n ? BigInt(pos.borrowShares) * totalBorrowAssets / totalBorrowShares : 0n;
                 totalDebt += debt;
-              } catch {
+              } catch (e) {
+                console.warn(`[agether] debt calc failed for market ${m.uniqueKey}:`, e instanceof Error ? e.message : e);
               }
             }
             positions.push({
@@ -598,7 +629,8 @@ var init_MorphoClient = __esm({
               supplyShares: pos.supplyShares.toString(),
               debt: import_ethers.ethers.formatUnits(debt, 6)
             });
-          } catch {
+          } catch (e) {
+            console.warn(`[agether] position read failed for market:`, e instanceof Error ? e.message : e);
             continue;
           }
         }
@@ -654,7 +686,8 @@ var init_MorphoClient = __esm({
               const oraclePrice = await oracleContract.price();
               const ORACLE_PRICE_SCALE = 10n ** 36n;
               collateralValueInLoan = BigInt(pos.collateral) * oraclePrice / ORACLE_PRICE_SCALE;
-            } catch {
+            } catch (e) {
+              console.warn(`[agether] oracle price fetch failed:`, e instanceof Error ? e.message : e);
               continue;
             }
             const maxBorrowTotal = collateralValueInLoan * m.lltv / 10n ** 18n;
@@ -666,7 +699,8 @@ var init_MorphoClient = __esm({
               currentDebt,
               collateralValue: collateralValueInLoan
             });
-          } catch {
+          } catch (e) {
+            console.warn(`[agether] maxBorrow calc failed:`, e instanceof Error ? e.message : e);
             continue;
           }
         }
@@ -726,7 +760,8 @@ var init_MorphoClient = __esm({
             lltv: `${(Number(m.lltv) / 1e16).toFixed(0)}%`,
             marketId: m.uniqueKey
           }));
-        } catch {
+        } catch (e) {
+          console.warn("[agether] getMarketRates failed:", e instanceof Error ? e.message : e);
           return [];
         }
       }
@@ -767,7 +802,8 @@ var init_MorphoClient = __esm({
             const amountWei = import_ethers.ethers.parseUnits(amount, colInfo.decimals);
             const valueInUsdc = amountWei * oraclePrice / ORACLE_PRICE_SCALE;
             collateralValueUsd = Number(valueInUsdc) / 1e6;
-          } catch {
+          } catch (e) {
+            console.warn("[agether] oracle price fetch for yield estimation failed:", e instanceof Error ? e.message : e);
             throw new AgetherError("Cannot determine collateral value. Provide ethPriceUsd.", "PRICE_UNAVAILABLE");
           }
         }
@@ -970,7 +1006,8 @@ var init_MorphoClient = __esm({
                 approveAmount = currentDebt + 10n;
               }
             }
-          } catch {
+          } catch (e) {
+            console.warn("[agether] share-based repay detection failed, falling through to asset-based:", e instanceof Error ? e.message : e);
           }
         }
         const targets = [usdcAddr, morphoAddr];
@@ -990,7 +1027,8 @@ var init_MorphoClient = __esm({
         try {
           const status = await this.getStatus();
           remainingDebt = status.totalDebt;
-        } catch {
+        } catch (e) {
+          console.warn("[agether] failed to read remaining debt after repay:", e instanceof Error ? e.message : e);
         }
         return { tx: receipt.hash, amount: usdcAmount, remainingDebt };
       }
@@ -1038,7 +1076,8 @@ var init_MorphoClient = __esm({
             const pos = await this.morphoBlue.position(market.uniqueKey, acctAddr);
             remainingCollateral = import_ethers.ethers.formatUnits(pos.collateral, colInfo.decimals);
           }
-        } catch {
+        } catch (e) {
+          console.warn("[agether] failed to read remaining collateral after withdraw:", e instanceof Error ? e.message : e);
         }
         return {
           tx: receipt.hash,
@@ -1127,37 +1166,48 @@ var init_MorphoClient = __esm({
         }
       }
       /**
-       * Execute a single call via AgentAccount.execute.
+       * Execute a single call via AgentAccount.execute (ERC-7579 single mode).
        */
       async exec(target, data, value = 0n) {
         const acctAddr = await this.getAccountAddress();
         const account = new import_ethers.Contract(acctAddr, AGENT_ACCOUNT_ABI, this._signer);
+        const executionCalldata = import_ethers.ethers.AbiCoder.defaultAbiCoder().encode(
+          ["address", "uint256", "bytes"],
+          [target, value, data]
+        );
         let gasLimit;
         try {
-          const estimate = await account.execute.estimateGas(target, value, data);
+          const estimate = await account.execute.estimateGas(MODE_SINGLE, executionCalldata);
           gasLimit = estimate * 130n / 100n;
-        } catch {
+        } catch (e) {
+          console.warn("[agether] exec gas estimation failed, using default 500k:", e instanceof Error ? e.message : e);
           gasLimit = 500000n;
         }
-        const tx = await account.execute(target, value, data, { gasLimit });
+        const tx = await account.execute(MODE_SINGLE, executionCalldata, { gasLimit });
         const receipt = await tx.wait();
         this._refreshSigner();
         return receipt;
       }
       /**
-       * Execute multiple calls via AgentAccount.executeBatch.
+       * Execute multiple calls via AgentAccount.execute (ERC-7579 batch mode).
        */
       async batch(targets, values, datas) {
         const acctAddr = await this.getAccountAddress();
         const account = new import_ethers.Contract(acctAddr, AGENT_ACCOUNT_ABI, this._signer);
+        const executions = targets.map((t, i) => [t, values[i], datas[i]]);
+        const executionCalldata = import_ethers.ethers.AbiCoder.defaultAbiCoder().encode(
+          ["(address,uint256,bytes)[]"],
+          [executions]
+        );
         let gasLimit;
         try {
-          const estimate = await account.executeBatch.estimateGas(targets, values, datas);
+          const estimate = await account.execute.estimateGas(MODE_BATCH, executionCalldata);
           gasLimit = estimate * 130n / 100n;
-        } catch {
+        } catch (e) {
+          console.warn("[agether] batch gas estimation failed, using default 800k:", e instanceof Error ? e.message : e);
           gasLimit = 800000n;
         }
-        const tx = await account.executeBatch(targets, values, datas, { gasLimit });
+        const tx = await account.execute(MODE_BATCH, executionCalldata, { gasLimit });
         const receipt = await tx.wait();
         this._refreshSigner();
         return receipt;
@@ -1186,7 +1236,8 @@ var init_MorphoClient = __esm({
                 symbol: m.collateralAsset.symbol
               };
             }
-          } catch {
+          } catch (e) {
+            console.warn("[agether] _findActiveMarket position check failed:", e instanceof Error ? e.message : e);
             continue;
           }
         }
@@ -1388,7 +1439,8 @@ var init_X402Client = __esm({
                   Buffer.from(paymentResponse, "base64").toString("utf-8")
                 );
                 txHash = settlement.transaction;
-              } catch {
+              } catch (e) {
+                console.warn("[agether] x402 payment response parse failed:", e instanceof Error ? e.message : e);
               }
             }
             return {
@@ -1443,10 +1495,12 @@ var init_X402Client = __esm({
                 return BigInt(amount);
               }
             }
-          } catch {
+          } catch (e) {
+            console.warn("[agether] x402 payment header parse failed:", e instanceof Error ? e.message : e);
           }
           return null;
-        } catch {
+        } catch (e) {
+          console.warn("[agether] x402 getPaymentRequired failed:", e instanceof Error ? e.message : e);
           return null;
         }
       }
@@ -1486,7 +1540,8 @@ var init_X402Client = __esm({
                     // 1 day
                   );
                   totalDailyYieldUsdc += estimate.estimatedYieldUsd;
-                } catch {
+                } catch (e) {
+                  console.warn(`[agether] yield calc failed for ${pos.collateralToken}:`, e instanceof Error ? e.message : e);
                 }
               }
             }
@@ -1498,7 +1553,8 @@ var init_X402Client = __esm({
                 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 {
+          } catch (e) {
+            console.warn("[agether] yield-limited spending check failed, falling through to fixed limit:", e instanceof Error ? e.message : e);
           }
         }
         if (this._spendingTracker.dailyLimit > 0n) {

package/dist/index.d.mts

@@ -103,6 +103,7 @@ interface ContractAddresses {
     accountFactory: string;
     validationRegistry: string;
     agentReputation: string;
+    kyaHook: string;
     usdc: string;
     identityRegistry: string;
     morphoBlue: string;
@@ -176,10 +177,14 @@ declare class AgetherClient {
 }
 
 /**
- * MorphoClient — Direct Morpho Blue lending via AgentAccount.executeBatch
+ * MorphoClient — Direct Morpho Blue lending via AgentAccount (ERC-7579)
  *
  * Architecture (no intermediary contract):
- *   EOA → AgentAccount.executeBatch → Morpho Blue (direct)
+ *   EOA → AgentAccount.execute(MODE_BATCH, ...) → Morpho Blue (direct)
+ *
+ * ERC-7579 execution modes:
+ *   - Single: execute(MODE_SINGLE, abi.encode(target, value, callData))
+ *   - Batch:  execute(MODE_BATCH, abi.encode(Execution[]))
  *
  * Batched operations:
  *   - depositAndBorrow: [ERC20.approve, Morpho.supplyCollateral, Morpho.borrow]
@@ -342,8 +347,8 @@ declare class MorphoClient {
     constructor(config: MorphoClientConfig);
     /**
      * Check whether the KYA (Know Your Agent) code verification gate is active.
-     * When validationRegistry is address(0), KYA is disabled — agents can use
-     * execute/executeBatch without prior code approval.
+     * Reads the account's installed hook and checks if it has a non-zero
+     * validationRegistry — when set, the hook enforces KYA code approval.
      */
     isKyaRequired(): Promise<boolean>;
     /** Resolve the AgentAccount address (cached, with retry for flaky RPCs). */
@@ -535,11 +540,11 @@ declare class MorphoClient {
      */
     private _refreshSigner;
     /**
-     * Execute a single call via AgentAccount.execute.
+     * Execute a single call via AgentAccount.execute (ERC-7579 single mode).
      */
     private exec;
     /**
-     * Execute multiple calls via AgentAccount.executeBatch.
+     * Execute multiple calls via AgentAccount.execute (ERC-7579 batch mode).
      */
     private batch;
     /** Convert MorphoMarketParams to Solidity tuple. */
@@ -1040,6 +1045,7 @@ declare const AGENT_REPUTATION_ABI: string[];
 declare const VALIDATION_REGISTRY_ABI: string[];
 declare const MORPHO_BLUE_ABI: string[];
 declare const ERC20_ABI: string[];
+declare const KYA_HOOK_ABI: string[];
 
 /**
  * Network configurations
@@ -1063,4 +1069,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, parseUnits, rateToBps };
+export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, KYA_HOOK_ABI, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, parseUnits, rateToBps };

package/dist/index.d.ts

@@ -103,6 +103,7 @@ interface ContractAddresses {
     accountFactory: string;
     validationRegistry: string;
     agentReputation: string;
+    kyaHook: string;
     usdc: string;
     identityRegistry: string;
     morphoBlue: string;
@@ -176,10 +177,14 @@ declare class AgetherClient {
 }
 
 /**
- * MorphoClient — Direct Morpho Blue lending via AgentAccount.executeBatch
+ * MorphoClient — Direct Morpho Blue lending via AgentAccount (ERC-7579)
  *
  * Architecture (no intermediary contract):
- *   EOA → AgentAccount.executeBatch → Morpho Blue (direct)
+ *   EOA → AgentAccount.execute(MODE_BATCH, ...) → Morpho Blue (direct)
+ *
+ * ERC-7579 execution modes:
+ *   - Single: execute(MODE_SINGLE, abi.encode(target, value, callData))
+ *   - Batch:  execute(MODE_BATCH, abi.encode(Execution[]))
  *
  * Batched operations:
  *   - depositAndBorrow: [ERC20.approve, Morpho.supplyCollateral, Morpho.borrow]
@@ -342,8 +347,8 @@ declare class MorphoClient {
     constructor(config: MorphoClientConfig);
     /**
      * Check whether the KYA (Know Your Agent) code verification gate is active.
-     * When validationRegistry is address(0), KYA is disabled — agents can use
-     * execute/executeBatch without prior code approval.
+     * Reads the account's installed hook and checks if it has a non-zero
+     * validationRegistry — when set, the hook enforces KYA code approval.
      */
     isKyaRequired(): Promise<boolean>;
     /** Resolve the AgentAccount address (cached, with retry for flaky RPCs). */
@@ -535,11 +540,11 @@ declare class MorphoClient {
      */
     private _refreshSigner;
     /**
-     * Execute a single call via AgentAccount.execute.
+     * Execute a single call via AgentAccount.execute (ERC-7579 single mode).
      */
     private exec;
     /**
-     * Execute multiple calls via AgentAccount.executeBatch.
+     * Execute multiple calls via AgentAccount.execute (ERC-7579 batch mode).
      */
     private batch;
     /** Convert MorphoMarketParams to Solidity tuple. */
@@ -1040,6 +1045,7 @@ declare const AGENT_REPUTATION_ABI: string[];
 declare const VALIDATION_REGISTRY_ABI: string[];
 declare const MORPHO_BLUE_ABI: string[];
 declare const ERC20_ABI: string[];
+declare const KYA_HOOK_ABI: string[];
 
 /**
  * Network configurations
@@ -1063,4 +1069,4 @@ declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
  */
 declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, parseUnits, rateToBps };
+export { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, AGENT_REPUTATION_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ERC20_ABI, type FundResult, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, KYA_HOOK_ABI, MORPHO_BLUE_ABI, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getDefaultConfig, parseUnits, rateToBps };