@agether/sdk 1.8.0 → 1.10.0

package/dist/index.mjs

@@ -62,7 +62,10 @@ var ACCOUNT_FACTORY_ABI = [
   "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)"
+  "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)"
 ];
 var AGENT_ACCOUNT_ABI = [
   "function agentId() view returns (uint256)",
@@ -135,9 +138,9 @@ var CONTRACT_ADDRESSES = {
     morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
   },
   [8453 /* Base */]: {
-    accountFactory: "0xb5b09213d0718f3FD56F1b111C8A83FDFcBdd5d8",
-    validationRegistry: "0x867F4F6f749Dc422aeFEcF4273cD22015d2CBCc2",
-    agentReputation: "0x352883c396bc7e88891a7D343ba550A7638256c0",
+    accountFactory: "0xFab8b924fb292a736BA05AF7b4AEC2c8d05cdcbF",
+    validationRegistry: "0x493f1551cbbC75afb2127CDBD5375ad8e8959f42",
+    agentReputation: "0x1fcb28eE3E8F3234E653b0A7a6fb56dE11E3c203",
     usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
     morphoBlue: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
@@ -399,14 +402,44 @@ var MorphoClient = class {
     this.config = defaultCfg;
     this.agentId = config.agentId;
     this._rpcUrl = config.rpcUrl || defaultCfg.rpcUrl;
-    this._privateKey = config.privateKey;
-    this.provider = new ethers2.JsonRpcProvider(this._rpcUrl);
-    this.wallet = new ethers2.Wallet(this._privateKey, this.provider);
+    if ("signer" in config && config.signer) {
+      this._useExternalSigner = true;
+      const signerProvider = config.signer.provider;
+      if (signerProvider) {
+        this.provider = signerProvider;
+        this._signer = config.signer;
+      } else {
+        this.provider = new ethers2.JsonRpcProvider(this._rpcUrl);
+        this._signer = config.signer.connect(this.provider);
+      }
+      if ("address" in config.signer && typeof config.signer.address === "string") {
+        this._eoaAddress = config.signer.address;
+      }
+    } else {
+      this._privateKey = config.privateKey;
+      this._useExternalSigner = false;
+      this.provider = new ethers2.JsonRpcProvider(this._rpcUrl);
+      const wallet = new ethers2.Wallet(this._privateKey, this.provider);
+      this._signer = wallet;
+      this._eoaAddress = wallet.address;
+    }
     const addrs = { ...defaultCfg.contracts, ...config.contracts };
-    this.accountFactory = new Contract2(addrs.accountFactory, ACCOUNT_FACTORY_ABI, this.wallet);
+    this.accountFactory = new Contract2(addrs.accountFactory, ACCOUNT_FACTORY_ABI, this._signer);
     this.morphoBlue = new Contract2(addrs.morphoBlue, MORPHO_BLUE_ABI, this.provider);
-    this.agentReputation = new Contract2(addrs.agentReputation, AGENT_REPUTATION_ABI, this.wallet);
-    this.identityRegistry = new Contract2(addrs.identityRegistry, IDENTITY_REGISTRY_ABI, this.wallet);
+    this.agentReputation = new Contract2(addrs.agentReputation, AGENT_REPUTATION_ABI, this._signer);
+    this.identityRegistry = new Contract2(addrs.identityRegistry, IDENTITY_REGISTRY_ABI, this._signer);
+  }
+  // ════════════════════════════════════════════════════════
+  //  KYA Gate Check
+  // ════════════════════════════════════════════════════════
+  /**
+   * 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.
+   */
+  async isKyaRequired() {
+    const registryAddr = await this.accountFactory.validationRegistry();
+    return registryAddr !== ethers2.ZeroAddress;
   }
   // ════════════════════════════════════════════════════════
   //  Account Management
@@ -426,8 +459,35 @@ var MorphoClient = class {
     if (!this.agentId) throw new AgetherError("agentId not set", "NO_AGENT_ID");
     return this.agentId;
   }
+  /**
+   * Get the EOA wallet address (synchronous, best-effort).
+   *
+   * For the `privateKey` path this always works. For the `signer` path
+   * it works if the signer exposes `.address` synchronously (e.g. ethers.Wallet).
+   * If the address has not been resolved yet, throws — call `getSignerAddress()` first.
+   */
   getWalletAddress() {
-    return this.wallet.address;
+    if (this._eoaAddress) return this._eoaAddress;
+    const signer = this._signer;
+    if (signer.address && typeof signer.address === "string") {
+      const addr = signer.address;
+      this._eoaAddress = addr;
+      return addr;
+    }
+    throw new AgetherError(
+      "EOA address not yet resolved. Call getSignerAddress() (async) first, or use a signer that exposes .address synchronously.",
+      "ADDRESS_NOT_RESOLVED"
+    );
+  }
+  /**
+   * Resolve the EOA signer address (async, works with all signer types).
+   * Result is cached after the first call.
+   */
+  async getSignerAddress() {
+    if (!this._eoaAddress) {
+      this._eoaAddress = await this._signer.getAddress();
+    }
+    return this._eoaAddress;
   }
   /** Mint a new ERC-8004 identity and return the agentId. */
   async _mintNewIdentity() {
@@ -454,13 +514,14 @@ var MorphoClient = class {
    * If already registered, returns existing state.
    */
   async register(_name) {
-    const eoaAddr = this.wallet.address;
+    const eoaAddr = await this.getSignerAddress();
     if (this.agentId) {
       const exists = await this.accountFactory.accountExists(BigInt(this.agentId));
       if (exists) {
         const acct = await this.accountFactory.getAccount(BigInt(this.agentId));
         this._accountAddress = acct;
-        return { agentId: this.agentId, address: eoaAddr, agentAccount: acct, alreadyRegistered: true };
+        const kyaRequired2 = await this.isKyaRequired();
+        return { agentId: this.agentId, address: eoaAddr, agentAccount: acct, alreadyRegistered: true, kyaRequired: kyaRequired2 };
       }
     }
     let agentId;
@@ -485,17 +546,19 @@ var MorphoClient = class {
     }
     const acctAddr = await this.accountFactory.getAccount(agentId);
     this._accountAddress = acctAddr;
+    const kyaRequired = await this.isKyaRequired();
     return {
       agentId: this.agentId,
       address: eoaAddr,
       agentAccount: acctAddr,
       alreadyRegistered: acctExists,
+      kyaRequired,
       tx: txHash
     };
   }
   /** Get ETH / USDC / collateral balances for EOA and AgentAccount. */
   async getBalances() {
-    const eoaAddr = this.wallet.address;
+    const eoaAddr = await this.getSignerAddress();
     const usdc = new Contract2(this.config.contracts.usdc, ERC20_ABI, this.provider);
     const ethBal = await this.provider.getBalance(eoaAddr);
     const usdcBal = await usdc.balanceOf(eoaAddr);
@@ -543,7 +606,7 @@ var MorphoClient = class {
   /** Transfer USDC from EOA to AgentAccount. */
   async fundAccount(usdcAmount) {
     const acctAddr = await this.getAccountAddress();
-    const usdc = new Contract2(this.config.contracts.usdc, ERC20_ABI, this.wallet);
+    const usdc = new Contract2(this.config.contracts.usdc, ERC20_ABI, this._signer);
     const amount = ethers2.parseUnits(usdcAmount, 6);
     const tx = await usdc.transfer(acctAddr, amount);
     const receipt = await tx.wait();
@@ -891,7 +954,7 @@ var MorphoClient = class {
     const params = marketParams ?? await this.findMarketForCollateral(tokenSymbol);
     const weiAmount = ethers2.parseUnits(amount, colInfo.decimals);
     const morphoAddr = this.config.contracts.morphoBlue;
-    const colToken = new Contract2(colInfo.address, ERC20_ABI, this.wallet);
+    const colToken = new Contract2(colInfo.address, ERC20_ABI, this._signer);
     const transferTx = await colToken.transfer(acctAddr, weiAmount);
     await transferTx.wait();
     this._refreshSigner();
@@ -968,7 +1031,7 @@ var MorphoClient = class {
     const colWei = ethers2.parseUnits(collateralAmount, colInfo.decimals);
     const borrowWei = ethers2.parseUnits(borrowUsdcAmount, 6);
     const morphoAddr = this.config.contracts.morphoBlue;
-    const colToken = new Contract2(colInfo.address, ERC20_ABI, this.wallet);
+    const colToken = new Contract2(colInfo.address, ERC20_ABI, this._signer);
     const transferTx = await colToken.transfer(acctAddr, colWei);
     await transferTx.wait();
     this._refreshSigner();
@@ -1098,7 +1161,7 @@ var MorphoClient = class {
     if (!colInfo) throw new AgetherError(`Unknown collateral: ${tokenSymbol}`, "UNKNOWN_COLLATERAL");
     const params = marketParams ?? await this.findMarketForCollateral(tokenSymbol);
     const morphoAddr = this.config.contracts.morphoBlue;
-    const dest = receiver || this.wallet.address;
+    const dest = receiver || await this.getSignerAddress();
     let weiAmount;
     if (amount === "all") {
       const markets = await this.getMarkets();
@@ -1156,7 +1219,7 @@ var MorphoClient = class {
       throw new AgetherError("Provide agentId or address", "INVALID_TARGET");
     }
     const weiAmount = ethers2.parseUnits(amount, colInfo.decimals);
-    const colToken = new Contract2(colInfo.address, ERC20_ABI, this.wallet);
+    const colToken = new Contract2(colInfo.address, ERC20_ABI, this._signer);
     const tx = await colToken.transfer(targetAddr, weiAmount);
     const receipt = await tx.wait();
     this._refreshSigner();
@@ -1188,24 +1251,41 @@ var MorphoClient = class {
   //  Internal Helpers
   // ════════════════════════════════════════════════════════
   /**
-   * Recreate provider + wallet so the next tx fetches a fresh nonce from chain.
-   * Anvil (and some RPC providers) return a stale `eth_getTransactionCount`
-   * right after a block is mined, causing "nonce too low" on the follow-up tx.
+   * Refresh the signer and re-bind contract instances.
+   *
+   * For the **privateKey** path: recreates provider + wallet so the next tx
+   * fetches a fresh nonce from chain. Anvil (and some RPC providers) return a
+   * stale `eth_getTransactionCount` right after a block is mined, causing
+   * "nonce too low" on the follow-up tx.
+   *
+   * For the **external signer** path: the signer is immutable and owned by the
+   * caller (e.g. custody provider). We only re-bind contract instances to
+   * ensure they reference the current signer. Nonce management is the caller's
+   * responsibility.
    */
   _refreshSigner() {
-    this.provider = new ethers2.JsonRpcProvider(this._rpcUrl);
-    this.wallet = new ethers2.Wallet(this._privateKey, this.provider);
-    const addrs = this.config.contracts;
-    this.accountFactory = new Contract2(addrs.accountFactory, ACCOUNT_FACTORY_ABI, this.wallet);
-    this.agentReputation = new Contract2(addrs.agentReputation, AGENT_REPUTATION_ABI, this.wallet);
-    this.identityRegistry = new Contract2(addrs.identityRegistry, IDENTITY_REGISTRY_ABI, this.wallet);
+    if (this._useExternalSigner) {
+      const addrs = this.config.contracts;
+      this.accountFactory = new Contract2(addrs.accountFactory, ACCOUNT_FACTORY_ABI, this._signer);
+      this.agentReputation = new Contract2(addrs.agentReputation, AGENT_REPUTATION_ABI, this._signer);
+      this.identityRegistry = new Contract2(addrs.identityRegistry, IDENTITY_REGISTRY_ABI, this._signer);
+    } else {
+      this.provider = new ethers2.JsonRpcProvider(this._rpcUrl);
+      const wallet = new ethers2.Wallet(this._privateKey, this.provider);
+      this._signer = wallet;
+      this._eoaAddress = wallet.address;
+      const addrs = this.config.contracts;
+      this.accountFactory = new Contract2(addrs.accountFactory, ACCOUNT_FACTORY_ABI, this._signer);
+      this.agentReputation = new Contract2(addrs.agentReputation, AGENT_REPUTATION_ABI, this._signer);
+      this.identityRegistry = new Contract2(addrs.identityRegistry, IDENTITY_REGISTRY_ABI, this._signer);
+    }
   }
   /**
    * Execute a single call via AgentAccount.execute.
    */
   async exec(target, data, value = 0n) {
     const acctAddr = await this.getAccountAddress();
-    const account = new Contract2(acctAddr, AGENT_ACCOUNT_ABI, this.wallet);
+    const account = new Contract2(acctAddr, AGENT_ACCOUNT_ABI, this._signer);
     let gasLimit;
     try {
       const estimate = await account.execute.estimateGas(target, value, data);
@@ -1223,7 +1303,7 @@ var MorphoClient = class {
    */
   async batch(targets, values, datas) {
     const acctAddr = await this.getAccountAddress();
-    const account = new Contract2(acctAddr, AGENT_ACCOUNT_ABI, this.wallet);
+    const account = new Contract2(acctAddr, AGENT_ACCOUNT_ABI, this._signer);
     let gasLimit;
     try {
       const estimate = await account.executeBatch.estimateGas(targets, values, datas);
@@ -1280,28 +1360,62 @@ import { privateKeyToAccount, toAccount } from "viem/accounts";
 var X402Client = class {
   constructor(config) {
     this.config = config;
-    const privateKey = config.privateKey.startsWith("0x") ? config.privateKey : `0x${config.privateKey}`;
-    const eoaSigner = privateKeyToAccount(privateKey);
+    let baseSigner;
+    if ("walletClient" in config && config.walletClient) {
+      const wc = config.walletClient;
+      const account = wc.account;
+      if (!account) {
+        throw new Error(
+          "X402Client: walletClient must have an attached account. Pass an account when creating the WalletClient or use privateKey mode instead."
+        );
+      }
+      this.address = account.address;
+      baseSigner = {
+        address: account.address,
+        signTypedData: (msg) => wc.signTypedData({
+          account,
+          domain: msg.domain,
+          types: msg.types,
+          primaryType: msg.primaryType,
+          message: msg.message
+        })
+      };
+    } else if ("privateKey" in config && config.privateKey) {
+      const privateKey = config.privateKey.startsWith("0x") ? config.privateKey : `0x${config.privateKey}`;
+      const account = privateKeyToAccount(privateKey);
+      this.address = account.address;
+      baseSigner = account;
+    } else {
+      throw new Error(
+        "X402Client: provide either privateKey or walletClient in config."
+      );
+    }
     let signer;
     if (config.accountAddress) {
       const accountAddr = config.accountAddress;
+      const inner = baseSigner;
       signer = toAccount({
         address: accountAddr,
         async signMessage({ message }) {
-          return eoaSigner.signMessage({ message });
+          if ("signMessage" in inner && typeof inner.signMessage === "function") {
+            return inner.signMessage({ message });
+          }
+          throw new Error("signMessage not supported by underlying signer");
         },
         async signTransaction(tx) {
-          return eoaSigner.signTransaction(tx);
+          if ("signTransaction" in inner && typeof inner.signTransaction === "function") {
+            return inner.signTransaction(tx);
+          }
+          throw new Error("signTransaction not supported by underlying signer");
         },
         async signTypedData(typedData) {
-          const sig = await eoaSigner.signTypedData(typedData);
+          const sig = await inner.signTypedData(typedData);
           return `${sig}00`;
         }
       });
       this.address = accountAddr;
     } else {
-      signer = eoaSigner;
-      this.address = eoaSigner.address;
+      signer = baseSigner;
     }
     const client = new x402Client();
     registerExactEvmScheme(client, { signer });

package/package.json

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