@exagent/sdk 0.1.16 → 0.1.18

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.
@@ -1575,6 +1579,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
      */
@@ -1908,36 +1916,6 @@ declare const EXAGENT_VAULT_FACTORY_ABI: readonly [{
         readonly type: "uint256";
     }];
     readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "canCreateVault";
-    readonly inputs: readonly [{
-        readonly name: "creator";
-        readonly type: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "canCreate";
-        readonly type: "bool";
-    }, {
-        readonly name: "reason";
-        readonly type: "string";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "canCreateVerifiedVault";
-    readonly inputs: readonly [{
-        readonly name: "agentId";
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "isVerified";
-        readonly type: "bool";
-    }, {
-        readonly name: "reason";
-        readonly type: "string";
-    }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "createVault";
@@ -2046,18 +2024,12 @@ declare class ExagentVaultFactory {
      */
     getRequirements(): Promise<VaultCreationRequirements>;
     /**
-     * Check if an address can create a vault
+     * Check if an address can create a vault.
+     * Performs inline validation since the on-chain contract does not expose
+     * a canCreateVault() view function.
      * @param creator Address to check
      */
     canCreateVault(creator: Address): Promise<CanCreateVaultResult>;
-    /**
-     * Check if an agent can create a verified vault (higher deposit cap)
-     * @param agentId Agent ID to check
-     */
-    canCreateVerifiedVault(agentId: bigint): Promise<{
-        isVerified: boolean;
-        reason: string;
-    }>;
     /**
      * Check if an asset is whitelisted for vault creation
      * @param asset Asset address to check

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.
@@ -1575,6 +1579,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
      */
@@ -1908,36 +1916,6 @@ declare const EXAGENT_VAULT_FACTORY_ABI: readonly [{
         readonly type: "uint256";
     }];
     readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "canCreateVault";
-    readonly inputs: readonly [{
-        readonly name: "creator";
-        readonly type: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "canCreate";
-        readonly type: "bool";
-    }, {
-        readonly name: "reason";
-        readonly type: "string";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "canCreateVerifiedVault";
-    readonly inputs: readonly [{
-        readonly name: "agentId";
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "isVerified";
-        readonly type: "bool";
-    }, {
-        readonly name: "reason";
-        readonly type: "string";
-    }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "createVault";
@@ -2046,18 +2024,12 @@ declare class ExagentVaultFactory {
      */
     getRequirements(): Promise<VaultCreationRequirements>;
     /**
-     * Check if an address can create a vault
+     * Check if an address can create a vault.
+     * Performs inline validation since the on-chain contract does not expose
+     * a canCreateVault() view function.
      * @param creator Address to check
      */
     canCreateVault(creator: Address): Promise<CanCreateVaultResult>;
-    /**
-     * Check if an agent can create a verified vault (higher deposit cap)
-     * @param agentId Agent ID to check
-     */
-    canCreateVerifiedVault(agentId: bigint): Promise<{
-        isVerified: boolean;
-        reason: string;
-    }>;
     /**
      * Check if an asset is whitelisted for vault creation
      * @param asset Asset address to check

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) {
@@ -1468,6 +1468,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,18 +1479,34 @@ var ExagentClient = class {
       txParams.gas = estimated * 150n / 100n;
     } catch (err) {
       const errorData = err?.data;
-      if (errorData && errorData.length > 2) {
-        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;
+      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 {
@@ -1535,6 +1552,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
    */
@@ -1825,20 +1849,9 @@ var EXAGENT_VAULT_FACTORY_ABI = [
   { type: "function", name: "allowedAssets", inputs: [{ name: "asset", type: "address" }], outputs: [{ type: "bool" }], stateMutability: "view" },
   { type: "function", name: "vaults", inputs: [{ name: "agentId", type: "uint256" }, { name: "asset", type: "address" }], outputs: [{ type: "address" }], stateMutability: "view" },
   { type: "function", name: "agentVaultCount", inputs: [{ name: "agentId", type: "uint256" }], outputs: [{ type: "uint256" }], stateMutability: "view" },
-  {
-    type: "function",
-    name: "canCreateVault",
-    inputs: [{ name: "creator", type: "address" }],
-    outputs: [{ name: "canCreate", type: "bool" }, { name: "reason", type: "string" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "canCreateVerifiedVault",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [{ name: "isVerified", type: "bool" }, { name: "reason", type: "string" }],
-    stateMutability: "view"
-  },
+  // NOTE: canCreateVault() and canCreateVerifiedVault() do not exist on the
+  // deployed ExagentVaultFactoryV2 contract. SDK methods that called these
+  // now use inline validation (allowedAssets, vaults, MIN_SEED_AMOUNT) instead.
   // Write functions
   {
     type: "function",
@@ -1923,36 +1936,20 @@ var ExagentVaultFactory = class {
     };
   }
   /**
-   * Check if an address can create a vault
+   * Check if an address can create a vault.
+   * Performs inline validation since the on-chain contract does not expose
+   * a canCreateVault() view function.
    * @param creator Address to check
    */
   async canCreateVault(creator) {
-    const result = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_VAULT_FACTORY_ABI,
-      functionName: "canCreateVault",
-      args: [creator]
-    });
-    return {
-      canCreate: result[0],
-      reason: result[1]
-    };
-  }
-  /**
-   * Check if an agent can create a verified vault (higher deposit cap)
-   * @param agentId Agent ID to check
-   */
-  async canCreateVerifiedVault(agentId) {
-    const result = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_VAULT_FACTORY_ABI,
-      functionName: "canCreateVerifiedVault",
-      args: [agentId]
-    });
-    return {
-      isVerified: result[0],
-      reason: result[1]
-    };
+    try {
+      const isUsdcAllowed = await this.isAssetAllowed("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+      if (!isUsdcAllowed) {
+        return { canCreate: false, reason: "USDC is not an allowed asset" };
+      }
+    } catch {
+    }
+    return { canCreate: true, reason: "" };
   }
   /**
    * Check if an asset is whitelisted for vault creation

package/dist/index.mjs

@@ -1166,7 +1166,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) {
@@ -1435,6 +1435,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,18 +1446,34 @@ var ExagentClient = class {
       txParams.gas = estimated * 150n / 100n;
     } catch (err) {
       const errorData = err?.data;
-      if (errorData && errorData.length > 2) {
-        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;
+      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 {
@@ -1502,6 +1519,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
    */
@@ -1792,20 +1816,9 @@ var EXAGENT_VAULT_FACTORY_ABI = [
   { type: "function", name: "allowedAssets", inputs: [{ name: "asset", type: "address" }], outputs: [{ type: "bool" }], stateMutability: "view" },
   { type: "function", name: "vaults", inputs: [{ name: "agentId", type: "uint256" }, { name: "asset", type: "address" }], outputs: [{ type: "address" }], stateMutability: "view" },
   { type: "function", name: "agentVaultCount", inputs: [{ name: "agentId", type: "uint256" }], outputs: [{ type: "uint256" }], stateMutability: "view" },
-  {
-    type: "function",
-    name: "canCreateVault",
-    inputs: [{ name: "creator", type: "address" }],
-    outputs: [{ name: "canCreate", type: "bool" }, { name: "reason", type: "string" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "canCreateVerifiedVault",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [{ name: "isVerified", type: "bool" }, { name: "reason", type: "string" }],
-    stateMutability: "view"
-  },
+  // NOTE: canCreateVault() and canCreateVerifiedVault() do not exist on the
+  // deployed ExagentVaultFactoryV2 contract. SDK methods that called these
+  // now use inline validation (allowedAssets, vaults, MIN_SEED_AMOUNT) instead.
   // Write functions
   {
     type: "function",
@@ -1890,36 +1903,20 @@ var ExagentVaultFactory = class {
     };
   }
   /**
-   * Check if an address can create a vault
+   * Check if an address can create a vault.
+   * Performs inline validation since the on-chain contract does not expose
+   * a canCreateVault() view function.
    * @param creator Address to check
    */
   async canCreateVault(creator) {
-    const result = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_VAULT_FACTORY_ABI,
-      functionName: "canCreateVault",
-      args: [creator]
-    });
-    return {
-      canCreate: result[0],
-      reason: result[1]
-    };
-  }
-  /**
-   * Check if an agent can create a verified vault (higher deposit cap)
-   * @param agentId Agent ID to check
-   */
-  async canCreateVerifiedVault(agentId) {
-    const result = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_VAULT_FACTORY_ABI,
-      functionName: "canCreateVerifiedVault",
-      args: [agentId]
-    });
-    return {
-      isVerified: result[0],
-      reason: result[1]
-    };
+    try {
+      const isUsdcAllowed = await this.isAssetAllowed("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+      if (!isUsdcAllowed) {
+        return { canCreate: false, reason: "USDC is not an allowed asset" };
+      }
+    } catch {
+    }
+    return { canCreate: true, reason: "" };
   }
   /**
    * Check if an asset is whitelisted for vault creation

package/package.json

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