@exagent/sdk 0.1.17 → 0.1.19

package/dist/index.d.mts

@@ -192,6 +192,10 @@ interface RouterTradeResponse {
         agentId: number;
     };
     mock?: boolean;
+    /** Present when API's pre-flight simulation failed (for sells) */
+    simulationSkipped?: boolean;
+    /** Warning message when simulation failed */
+    simulationWarning?: string;
 }
 /**
  * Trade execution result
@@ -1083,7 +1087,7 @@ declare class ExagentVault {
 }
 
 /** SDK version — sent to API for version gating */
-declare const SDK_VERSION = "0.1.14";
+declare const SDK_VERSION = "0.1.18";
 /**
  * Default RPC URL for Base mainnet.
  * Coinbase's official Base RPC — reliable for reads and transactions.
@@ -1505,7 +1509,16 @@ declare class ExagentClient {
     /** Standard headers for all API requests (includes SDK version for gating) */
     private apiHeaders;
     /**
-     * Register as a new agent on Exagent
+     * Register as a new agent on Exagent.
+     *
+     * RECOMMENDED: Register your agent at https://exagent.io instead of using this method.
+     * The website handles the full registration flow including risk universe selection,
+     * position size limits, daily loss limits, and metadata upload — all in one step.
+     * After registering on the website, use your agent ID in agent-config.json.
+     *
+     * This SDK method is available for programmatic registration but uses default
+     * risk parameters (universe=1, maxPositionSize=10%, maxDailyLoss=5%).
+     *
      * @param metadata Agent metadata (will be uploaded to IPFS)
      * @returns The assigned agent ID
      * @throws Error if wallet already owns an agent (one agent per wallet rule)
@@ -1524,9 +1537,19 @@ declare class ExagentClient {
      */
     getAgentByName(name: string): Promise<bigint>;
     /**
-     * Get the current agent's ID (if registered)
+     * Get the current agent's ID (if registered).
+     *
+     * Resolution order:
+     * 1. Cached value (from prior register() or getAgentId() call)
+     * 2. walletToAgent mapping (linked wallets)
+     * 3. Owner lookup (unlinked owner wallet)
+     *
+     * If the agent was just registered, public RPCs may return stale data (0).
+     * Use `retries` to wait for the on-chain state to propagate.
+     *
+     * @param retries Number of retries with 2s delay for stale RPC reads (default: 0)
      */
-    getAgentId(): Promise<bigint | undefined>;
+    getAgentId(retries?: number): Promise<bigint | undefined>;
     /**
      * Get agent profile
      * @param agentId Optional agent ID (defaults to current agent)
@@ -1575,6 +1598,10 @@ declare class ExagentClient {
      * Useful for simulation or multi-step workflows
      */
     buildRouterTrade(intent: Omit<TradeIntent, 'action'>, agentId?: bigint): Promise<RouterTradeResponse>;
+    /**
+     * Check if an address is the ETH sentinel or WETH
+     */
+    private isETHAddress;
     /**
      * Read current ERC-20 allowance for a (token, spender) pair
      */

package/dist/index.d.ts

@@ -192,6 +192,10 @@ interface RouterTradeResponse {
         agentId: number;
     };
     mock?: boolean;
+    /** Present when API's pre-flight simulation failed (for sells) */
+    simulationSkipped?: boolean;
+    /** Warning message when simulation failed */
+    simulationWarning?: string;
 }
 /**
  * Trade execution result
@@ -1083,7 +1087,7 @@ declare class ExagentVault {
 }
 
 /** SDK version — sent to API for version gating */
-declare const SDK_VERSION = "0.1.14";
+declare const SDK_VERSION = "0.1.18";
 /**
  * Default RPC URL for Base mainnet.
  * Coinbase's official Base RPC — reliable for reads and transactions.
@@ -1505,7 +1509,16 @@ declare class ExagentClient {
     /** Standard headers for all API requests (includes SDK version for gating) */
     private apiHeaders;
     /**
-     * Register as a new agent on Exagent
+     * Register as a new agent on Exagent.
+     *
+     * RECOMMENDED: Register your agent at https://exagent.io instead of using this method.
+     * The website handles the full registration flow including risk universe selection,
+     * position size limits, daily loss limits, and metadata upload — all in one step.
+     * After registering on the website, use your agent ID in agent-config.json.
+     *
+     * This SDK method is available for programmatic registration but uses default
+     * risk parameters (universe=1, maxPositionSize=10%, maxDailyLoss=5%).
+     *
      * @param metadata Agent metadata (will be uploaded to IPFS)
      * @returns The assigned agent ID
      * @throws Error if wallet already owns an agent (one agent per wallet rule)
@@ -1524,9 +1537,19 @@ declare class ExagentClient {
      */
     getAgentByName(name: string): Promise<bigint>;
     /**
-     * Get the current agent's ID (if registered)
+     * Get the current agent's ID (if registered).
+     *
+     * Resolution order:
+     * 1. Cached value (from prior register() or getAgentId() call)
+     * 2. walletToAgent mapping (linked wallets)
+     * 3. Owner lookup (unlinked owner wallet)
+     *
+     * If the agent was just registered, public RPCs may return stale data (0).
+     * Use `retries` to wait for the on-chain state to propagate.
+     *
+     * @param retries Number of retries with 2s delay for stale RPC reads (default: 0)
      */
-    getAgentId(): Promise<bigint | undefined>;
+    getAgentId(retries?: number): Promise<bigint | undefined>;
     /**
      * Get agent profile
      * @param agentId Optional agent ID (defaults to current agent)
@@ -1575,6 +1598,10 @@ declare class ExagentClient {
      * Useful for simulation or multi-step workflows
      */
     buildRouterTrade(intent: Omit<TradeIntent, 'action'>, agentId?: bigint): Promise<RouterTradeResponse>;
+    /**
+     * Check if an address is the ETH sentinel or WETH
+     */
+    private isETHAddress;
     /**
      * Read current ERC-20 allowance for a (token, spender) pair
      */

package/dist/index.js

@@ -1199,7 +1199,7 @@ var ExagentVault = class {
 
 // src/constants.ts
 var import_chains = require("viem/chains");
-var SDK_VERSION = "0.1.14";
+var SDK_VERSION = "0.1.18";
 var DEFAULT_RPC_URL = "https://mainnet.base.org";
 function getRpcUrl() {
   if (typeof process !== "undefined" && process.env) {
@@ -1213,7 +1213,7 @@ var CHAIN_CONFIG = {
 var CONTRACT_ADDRESSES = {
   mainnet: {
     agentRegistry: "0x2261706C751F8ac5cdDb481B7b56EA2137d4A723",
-    router: "0x1BCFa13f677fDCf697D8b7d5120f544817F1de1A",
+    router: "0x20feB3054750970773Fe7370c391732EE0559743",
     vaultFactory: "0x1E0e4E445A9fda2e7aBBfFEcA80392ABb0921554",
     feeCollector: "0x00Ab9847049b5496619dFDd1A7bd36FA49eB7195",
     serviceEscrow: "0x63A4d1dA774422EFC2cc57d71F948231BD812516"
@@ -1321,7 +1321,16 @@ var ExagentClient = class {
   }
   // ============ Agent Registration ============
   /**
-   * Register as a new agent on Exagent
+   * Register as a new agent on Exagent.
+   *
+   * RECOMMENDED: Register your agent at https://exagent.io instead of using this method.
+   * The website handles the full registration flow including risk universe selection,
+   * position size limits, daily loss limits, and metadata upload — all in one step.
+   * After registering on the website, use your agent ID in agent-config.json.
+   *
+   * This SDK method is available for programmatic registration but uses default
+   * risk parameters (universe=1, maxPositionSize=10%, maxDailyLoss=5%).
+   *
    * @param metadata Agent metadata (will be uploaded to IPFS)
    * @returns The assigned agent ID
    * @throws Error if wallet already owns an agent (one agent per wallet rule)
@@ -1363,19 +1372,34 @@ var ExagentClient = class {
     return this.registry.getAgentByName(name);
   }
   /**
-   * Get the current agent's ID (if registered)
+   * Get the current agent's ID (if registered).
+   *
+   * Resolution order:
+   * 1. Cached value (from prior register() or getAgentId() call)
+   * 2. walletToAgent mapping (linked wallets)
+   * 3. Owner lookup (unlinked owner wallet)
+   *
+   * If the agent was just registered, public RPCs may return stale data (0).
+   * Use `retries` to wait for the on-chain state to propagate.
+   *
+   * @param retries Number of retries with 2s delay for stale RPC reads (default: 0)
    */
-  async getAgentId() {
+  async getAgentId(retries = 0) {
     if (this._agentId) return this._agentId;
-    const agentId = await this.registry.getAgentForWallet(this.account.address);
-    if (agentId > 0n) {
-      this._agentId = agentId;
-      return agentId;
-    }
-    const ownedAgentId = await this.registry.getAgentByOwner(this.account.address);
-    if (ownedAgentId > 0n) {
-      this._agentId = ownedAgentId;
-      return ownedAgentId;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      if (attempt > 0) {
+        await new Promise((r) => setTimeout(r, 2e3));
+      }
+      const agentId = await this.registry.getAgentForWallet(this.account.address);
+      if (agentId > 0n) {
+        this._agentId = agentId;
+        return agentId;
+      }
+      const ownedAgentId = await this.registry.getAgentByOwner(this.account.address);
+      if (ownedAgentId > 0n) {
+        this._agentId = ownedAgentId;
+        return ownedAgentId;
+      }
     }
     return void 0;
   }
@@ -1468,6 +1492,7 @@ var ExagentClient = class {
       data: routerTrade.transaction.data,
       value: BigInt(routerTrade.transaction.value)
     };
+    const isETHInput = this.isETHAddress(intent.tokenIn);
     try {
       const estimated = await this.publicClient.estimateGas({
         account: this.account,
@@ -1478,20 +1503,34 @@ var ExagentClient = class {
       txParams.gas = estimated * 150n / 100n;
     } catch (err) {
       const errorData = err?.data;
-      if (errorData && errorData.length > 2) {
-        console.error(`Gas estimation revert data: ${errorData}`);
-        try {
-          const decoded = (0, import_viem2.decodeErrorResult)({
-            abi: [...EXAGENT_ROUTER_ABI, ...EXAGENT_REGISTRY_ABI],
-            data: errorData
-          });
-          throw new Error(`Trade will revert: ${decoded.errorName}${decoded.args ? ` (${decoded.args.join(", ")})` : ""}`);
-        } catch (decodeErr) {
-          if (decodeErr instanceof Error && decodeErr.message.startsWith("Trade will revert:")) throw decodeErr;
-          throw new Error(`Trade will revert: unknown error selector ${errorData.slice(0, 10)} (raw: ${errorData.slice(0, 66)})`);
+      if (isETHInput) {
+        if (errorData && errorData.length > 2) {
+          console.error(`Gas estimation revert data: ${errorData}`);
+          try {
+            const decoded = (0, import_viem2.decodeErrorResult)({
+              abi: [...EXAGENT_ROUTER_ABI, ...EXAGENT_REGISTRY_ABI],
+              data: errorData
+            });
+            throw new Error(`Trade will revert: ${decoded.errorName}${decoded.args ? ` (${decoded.args.join(", ")})` : ""}`);
+          } catch (decodeErr) {
+            if (decodeErr instanceof Error && decodeErr.message.startsWith("Trade will revert:")) throw decodeErr;
+            throw new Error(`Trade will revert: unknown error selector ${errorData.slice(0, 10)} (raw: ${errorData.slice(0, 66)})`);
+          }
         }
+        throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
+      }
+      if (routerTrade.gasEstimate) {
+        const apiGas = BigInt(routerTrade.gasEstimate);
+        txParams.gas = apiGas * 200n / 100n;
+        console.warn(
+          `[SDK] Local gas estimation failed for sell, using API estimate with 100% buffer: ${txParams.gas}. This is expected for some DEX routes. Warning: ${routerTrade.simulationWarning || "none"}`
+        );
+      } else {
+        txParams.gas = 800000n;
+        console.warn(
+          `[SDK] Local gas estimation failed for sell and no API estimate available. Using safe default: 800000. This may result in wasted gas if the transaction reverts.`
+        );
       }
-      throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
     }
     const hash = await this.walletClient.sendTransaction(txParams);
     return {
@@ -1537,6 +1576,13 @@ var ExagentClient = class {
     }
     return response.json();
   }
+  /**
+   * Check if an address is the ETH sentinel or WETH
+   */
+  isETHAddress(addr) {
+    const lower = addr.toLowerCase();
+    return lower === "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" || lower === "0x0000000000000000000000000000000000000000" || lower === "0x4200000000000000000000000000000000000006";
+  }
   /**
    * Read current ERC-20 allowance for a (token, spender) pair
    */
@@ -1801,14 +1847,28 @@ var ExagentClient = class {
   }
   parseAgentIdFromReceipt(receipt) {
     const registryAddress = this.registry.address.toLowerCase();
+    const AGENT_REGISTERED_TOPIC = (0, import_viem2.keccak256)(
+      (0, import_viem2.toHex)("AgentRegistered(uint256,address,string,string)")
+    );
+    const TRANSFER_TOPIC = (0, import_viem2.keccak256)(
+      (0, import_viem2.toHex)("Transfer(address,address,uint256)")
+    );
+    const ZERO_ADDRESS2 = "0x0000000000000000000000000000000000000000000000000000000000000000";
     for (const log of receipt.logs) {
       if (log.address.toLowerCase() !== registryAddress) continue;
-      if (log.topics.length >= 2 && log.topics[1]) {
-        const agentId = BigInt(log.topics[1]);
-        return agentId;
+      if (log.topics[0] === AGENT_REGISTERED_TOPIC && log.topics[1]) {
+        return BigInt(log.topics[1]);
       }
     }
-    throw new Error("AgentRegistered event not found in transaction receipt");
+    for (const log of receipt.logs) {
+      if (log.address.toLowerCase() !== registryAddress) continue;
+      if (log.topics[0] === TRANSFER_TOPIC && log.topics[1] === ZERO_ADDRESS2 && log.topics[3]) {
+        return BigInt(log.topics[3]);
+      }
+    }
+    throw new Error(
+      "Could not extract agent ID from transaction receipt.\nNeither AgentRegistered nor ERC721 Transfer event found in logs.\nCheck the transaction on BaseScan to verify registration succeeded."
+    );
   }
 };
 

package/dist/index.mjs

@@ -4,7 +4,9 @@ import {
   createWalletClient,
   http,
   decodeErrorResult,
-  maxUint256
+  maxUint256,
+  keccak256 as keccak2562,
+  toHex
 } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 
@@ -1166,7 +1168,7 @@ var ExagentVault = class {
 
 // src/constants.ts
 import { base } from "viem/chains";
-var SDK_VERSION = "0.1.14";
+var SDK_VERSION = "0.1.18";
 var DEFAULT_RPC_URL = "https://mainnet.base.org";
 function getRpcUrl() {
   if (typeof process !== "undefined" && process.env) {
@@ -1180,7 +1182,7 @@ var CHAIN_CONFIG = {
 var CONTRACT_ADDRESSES = {
   mainnet: {
     agentRegistry: "0x2261706C751F8ac5cdDb481B7b56EA2137d4A723",
-    router: "0x1BCFa13f677fDCf697D8b7d5120f544817F1de1A",
+    router: "0x20feB3054750970773Fe7370c391732EE0559743",
     vaultFactory: "0x1E0e4E445A9fda2e7aBBfFEcA80392ABb0921554",
     feeCollector: "0x00Ab9847049b5496619dFDd1A7bd36FA49eB7195",
     serviceEscrow: "0x63A4d1dA774422EFC2cc57d71F948231BD812516"
@@ -1288,7 +1290,16 @@ var ExagentClient = class {
   }
   // ============ Agent Registration ============
   /**
-   * Register as a new agent on Exagent
+   * Register as a new agent on Exagent.
+   *
+   * RECOMMENDED: Register your agent at https://exagent.io instead of using this method.
+   * The website handles the full registration flow including risk universe selection,
+   * position size limits, daily loss limits, and metadata upload — all in one step.
+   * After registering on the website, use your agent ID in agent-config.json.
+   *
+   * This SDK method is available for programmatic registration but uses default
+   * risk parameters (universe=1, maxPositionSize=10%, maxDailyLoss=5%).
+   *
    * @param metadata Agent metadata (will be uploaded to IPFS)
    * @returns The assigned agent ID
    * @throws Error if wallet already owns an agent (one agent per wallet rule)
@@ -1330,19 +1341,34 @@ var ExagentClient = class {
     return this.registry.getAgentByName(name);
   }
   /**
-   * Get the current agent's ID (if registered)
+   * Get the current agent's ID (if registered).
+   *
+   * Resolution order:
+   * 1. Cached value (from prior register() or getAgentId() call)
+   * 2. walletToAgent mapping (linked wallets)
+   * 3. Owner lookup (unlinked owner wallet)
+   *
+   * If the agent was just registered, public RPCs may return stale data (0).
+   * Use `retries` to wait for the on-chain state to propagate.
+   *
+   * @param retries Number of retries with 2s delay for stale RPC reads (default: 0)
    */
-  async getAgentId() {
+  async getAgentId(retries = 0) {
     if (this._agentId) return this._agentId;
-    const agentId = await this.registry.getAgentForWallet(this.account.address);
-    if (agentId > 0n) {
-      this._agentId = agentId;
-      return agentId;
-    }
-    const ownedAgentId = await this.registry.getAgentByOwner(this.account.address);
-    if (ownedAgentId > 0n) {
-      this._agentId = ownedAgentId;
-      return ownedAgentId;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      if (attempt > 0) {
+        await new Promise((r) => setTimeout(r, 2e3));
+      }
+      const agentId = await this.registry.getAgentForWallet(this.account.address);
+      if (agentId > 0n) {
+        this._agentId = agentId;
+        return agentId;
+      }
+      const ownedAgentId = await this.registry.getAgentByOwner(this.account.address);
+      if (ownedAgentId > 0n) {
+        this._agentId = ownedAgentId;
+        return ownedAgentId;
+      }
     }
     return void 0;
   }
@@ -1435,6 +1461,7 @@ var ExagentClient = class {
       data: routerTrade.transaction.data,
       value: BigInt(routerTrade.transaction.value)
     };
+    const isETHInput = this.isETHAddress(intent.tokenIn);
     try {
       const estimated = await this.publicClient.estimateGas({
         account: this.account,
@@ -1445,20 +1472,34 @@ var ExagentClient = class {
       txParams.gas = estimated * 150n / 100n;
     } catch (err) {
       const errorData = err?.data;
-      if (errorData && errorData.length > 2) {
-        console.error(`Gas estimation revert data: ${errorData}`);
-        try {
-          const decoded = decodeErrorResult({
-            abi: [...EXAGENT_ROUTER_ABI, ...EXAGENT_REGISTRY_ABI],
-            data: errorData
-          });
-          throw new Error(`Trade will revert: ${decoded.errorName}${decoded.args ? ` (${decoded.args.join(", ")})` : ""}`);
-        } catch (decodeErr) {
-          if (decodeErr instanceof Error && decodeErr.message.startsWith("Trade will revert:")) throw decodeErr;
-          throw new Error(`Trade will revert: unknown error selector ${errorData.slice(0, 10)} (raw: ${errorData.slice(0, 66)})`);
+      if (isETHInput) {
+        if (errorData && errorData.length > 2) {
+          console.error(`Gas estimation revert data: ${errorData}`);
+          try {
+            const decoded = decodeErrorResult({
+              abi: [...EXAGENT_ROUTER_ABI, ...EXAGENT_REGISTRY_ABI],
+              data: errorData
+            });
+            throw new Error(`Trade will revert: ${decoded.errorName}${decoded.args ? ` (${decoded.args.join(", ")})` : ""}`);
+          } catch (decodeErr) {
+            if (decodeErr instanceof Error && decodeErr.message.startsWith("Trade will revert:")) throw decodeErr;
+            throw new Error(`Trade will revert: unknown error selector ${errorData.slice(0, 10)} (raw: ${errorData.slice(0, 66)})`);
+          }
         }
+        throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
+      }
+      if (routerTrade.gasEstimate) {
+        const apiGas = BigInt(routerTrade.gasEstimate);
+        txParams.gas = apiGas * 200n / 100n;
+        console.warn(
+          `[SDK] Local gas estimation failed for sell, using API estimate with 100% buffer: ${txParams.gas}. This is expected for some DEX routes. Warning: ${routerTrade.simulationWarning || "none"}`
+        );
+      } else {
+        txParams.gas = 800000n;
+        console.warn(
+          `[SDK] Local gas estimation failed for sell and no API estimate available. Using safe default: 800000. This may result in wasted gas if the transaction reverts.`
+        );
       }
-      throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
     }
     const hash = await this.walletClient.sendTransaction(txParams);
     return {
@@ -1504,6 +1545,13 @@ var ExagentClient = class {
     }
     return response.json();
   }
+  /**
+   * Check if an address is the ETH sentinel or WETH
+   */
+  isETHAddress(addr) {
+    const lower = addr.toLowerCase();
+    return lower === "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" || lower === "0x0000000000000000000000000000000000000000" || lower === "0x4200000000000000000000000000000000000006";
+  }
   /**
    * Read current ERC-20 allowance for a (token, spender) pair
    */
@@ -1768,14 +1816,28 @@ var ExagentClient = class {
   }
   parseAgentIdFromReceipt(receipt) {
     const registryAddress = this.registry.address.toLowerCase();
+    const AGENT_REGISTERED_TOPIC = keccak2562(
+      toHex("AgentRegistered(uint256,address,string,string)")
+    );
+    const TRANSFER_TOPIC = keccak2562(
+      toHex("Transfer(address,address,uint256)")
+    );
+    const ZERO_ADDRESS2 = "0x0000000000000000000000000000000000000000000000000000000000000000";
     for (const log of receipt.logs) {
       if (log.address.toLowerCase() !== registryAddress) continue;
-      if (log.topics.length >= 2 && log.topics[1]) {
-        const agentId = BigInt(log.topics[1]);
-        return agentId;
+      if (log.topics[0] === AGENT_REGISTERED_TOPIC && log.topics[1]) {
+        return BigInt(log.topics[1]);
       }
     }
-    throw new Error("AgentRegistered event not found in transaction receipt");
+    for (const log of receipt.logs) {
+      if (log.address.toLowerCase() !== registryAddress) continue;
+      if (log.topics[0] === TRANSFER_TOPIC && log.topics[1] === ZERO_ADDRESS2 && log.topics[3]) {
+        return BigInt(log.topics[3]);
+      }
+    }
+    throw new Error(
+      "Could not extract agent ID from transaction receipt.\nNeither AgentRegistered nor ERC721 Transfer event found in logs.\nCheck the transaction on BaseScan to verify registration succeeded."
+    );
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exagent/sdk",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "TypeScript SDK for Exagent",
   "main": "dist/index.js",
   "module": "dist/index.mjs",