@exagent/sdk 0.1.12 → 0.1.13

package/dist/index.js

@@ -25,6 +25,8 @@ __export(index_exports, {
   DEFAULT_RPC_URL: () => DEFAULT_RPC_URL,
   DEX_ADDRESSES: () => DEX_ADDRESSES,
   EXAGENT_API_CONFIG: () => EXAGENT_API_CONFIG,
+  EXAGENT_REGISTRY_ABI: () => EXAGENT_REGISTRY_ABI,
+  EXAGENT_ROUTER_ABI: () => EXAGENT_ROUTER_ABI,
   EXAGENT_STAKING_ABI: () => EXAGENT_STAKING_ABI,
   EXAGENT_VAULT_FACTORY_ABI: () => EXAGENT_VAULT_FACTORY_ABI,
   ExagentClient: () => ExagentClient,
@@ -154,13 +156,6 @@ var EXAGENT_REGISTRY_ABI = [
     outputs: [{ name: "", type: "uint256" }],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "nextAgentId",
-    inputs: [],
-    outputs: [{ name: "", type: "uint256" }],
-    stateMutability: "view"
-  },
   {
     type: "function",
     name: "ownerOf",
@@ -226,13 +221,6 @@ var EXAGENT_REGISTRY_ABI = [
     ],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "version",
-    inputs: [],
-    outputs: [{ name: "", type: "string" }],
-    stateMutability: "pure"
-  },
   // Config Epochs
   {
     type: "function",
@@ -251,40 +239,6 @@ var EXAGENT_REGISTRY_ABI = [
     outputs: [{ name: "", type: "bytes32" }],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "getCurrentEpoch",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [{ name: "", type: "uint256" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "getAgentConfig",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [
-      {
-        name: "",
-        type: "tuple",
-        components: [
-          { name: "configHash", type: "bytes32" },
-          { name: "epochId", type: "uint256" },
-          { name: "epochStartBlock", type: "uint256" }
-        ]
-      }
-    ],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "getEpochConfigHash",
-    inputs: [
-      { name: "agentId", type: "uint256" },
-      { name: "epochId", type: "uint256" }
-    ],
-    outputs: [{ name: "", type: "bytes32" }],
-    stateMutability: "view"
-  },
   // Mainnet: Agent retirement
   {
     type: "function",
@@ -352,15 +306,23 @@ var EXAGENT_REGISTRY_ABI = [
       { name: "blockNumber", type: "uint256", indexed: false }
     ]
   },
-  // Custom errors
-  { type: "error", name: "OwnerAlreadyHasAgent", inputs: [{ name: "existingAgentId", type: "uint256" }] },
+  // Custom errors — must match ExagentRegistry.sol for viem to decode reverts
+  { type: "error", name: "AgentNotOwner", inputs: [] },
+  { type: "error", name: "WalletAlreadyLinked", inputs: [] },
+  { type: "error", name: "WalletNotLinked", inputs: [] },
+  { type: "error", name: "InvalidSignature", inputs: [] },
+  { type: "error", name: "TransferDisabled", inputs: [] },
   { type: "error", name: "InvalidMetadataURI", inputs: [] },
+  { type: "error", name: "AgentDoesNotExist", inputs: [] },
+  { type: "error", name: "NameAlreadyTaken", inputs: [] },
   { type: "error", name: "InvalidName", inputs: [] },
+  { type: "error", name: "OwnerAlreadyHasAgent", inputs: [{ name: "existingAgentId", type: "uint256" }] },
   { type: "error", name: "InvalidRiskUniverse", inputs: [] },
   { type: "error", name: "InvalidTradingConfig", inputs: [] },
-  { type: "error", name: "NameAlreadyTaken", inputs: [] },
-  { type: "error", name: "AgentNotOwner", inputs: [] },
-  { type: "error", name: "AgentIsRetired", inputs: [] }
+  { type: "error", name: "NotAuthorizedCaller", inputs: [] },
+  { type: "error", name: "MetadataValueTooLarge", inputs: [] },
+  { type: "error", name: "AgentIsRetired", inputs: [] },
+  { type: "error", name: "InvalidRiskUniverseForWhitelist", inputs: [] }
 ];
 var ExagentRegistry = class {
   address;
@@ -572,18 +534,6 @@ var ExagentRegistry = class {
     });
     return nonce;
   }
-  /**
-   * Get the next agent ID that will be assigned
-   * @returns Next agent ID
-   */
-  async getNextAgentId() {
-    const nextId = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "nextAgentId"
-    });
-    return nextId;
-  }
   /**
    * Generate the message hash for wallet linking.
    * Matches the contract's keccak256(abi.encodePacked(...)) exactly.
@@ -629,18 +579,6 @@ var ExagentRegistry = class {
     const [canRegister, existingAgentId] = result;
     return { canRegister, existingAgentId };
   }
-  /**
-   * Get the registry contract version
-   * @returns Version string (e.g., "4.0.0")
-   */
-  async getVersion() {
-    const version = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "version"
-    });
-    return version;
-  }
   // ============ Config Epochs ============
   /**
    * Update the agent's LLM config hash on-chain
@@ -674,54 +612,6 @@ var ExagentRegistry = class {
     });
     return configHash;
   }
-  /**
-   * Get the current epoch ID for an agent
-   * @param agentId The agent's ID
-   * @returns Current epoch (0 if never configured)
-   */
-  async getCurrentEpoch(agentId) {
-    const epochId = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getCurrentEpoch",
-      args: [agentId]
-    });
-    return epochId;
-  }
-  /**
-   * Get full config info for an agent
-   * @param agentId The agent's ID
-   * @returns AgentConfig struct (configHash, epochId, epochStartBlock)
-   */
-  async getAgentConfig(agentId) {
-    const config = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getAgentConfig",
-      args: [agentId]
-    });
-    const result = config;
-    return {
-      configHash: result.configHash,
-      epochId: result.epochId,
-      epochStartBlock: result.epochStartBlock
-    };
-  }
-  /**
-   * Get the config hash for a specific epoch
-   * @param agentId The agent's ID
-   * @param epochId The epoch to look up
-   * @returns Config hash for that epoch
-   */
-  async getEpochConfigHash(agentId, epochId) {
-    const configHash = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getEpochConfigHash",
-      args: [agentId, epochId]
-    });
-    return configHash;
-  }
   /**
    * Calculate the config hash for a provider and model
    * @param provider The LLM provider name (e.g., "openai", "anthropic")
@@ -810,6 +700,27 @@ var ExagentRegistry = class {
   }
 };
 
+// src/contracts/router.ts
+var EXAGENT_ROUTER_ABI = [
+  // Custom errors — must match ExagentRouterV2.sol for viem to decode reverts
+  { type: "error", name: "InvalidAgentId", inputs: [] },
+  { type: "error", name: "SwapFailed", inputs: [] },
+  { type: "error", name: "InsufficientOutput", inputs: [] },
+  { type: "error", name: "ZeroAddress", inputs: [] },
+  { type: "error", name: "ZeroAmount", inputs: [] },
+  { type: "error", name: "AggregatorNotWhitelisted", inputs: [] },
+  { type: "error", name: "ETHTransferFailed", inputs: [] },
+  { type: "error", name: "FeeBpsTooHigh", inputs: [] },
+  { type: "error", name: "NotAuthorizedForAgent", inputs: [{ name: "agentId", type: "uint256" }, { name: "caller", type: "address" }] },
+  { type: "error", name: "ConfigMismatch", inputs: [{ name: "provided", type: "bytes32" }, { name: "onChain", type: "bytes32" }] },
+  { type: "error", name: "MsgValueMismatch", inputs: [] },
+  { type: "error", name: "FeeCollectorNotSet", inputs: [] },
+  { type: "error", name: "TokenNotAllowedForAgent", inputs: [{ name: "agentId", type: "uint256" }, { name: "token", type: "address" }] },
+  { type: "error", name: "NotAuthorized", inputs: [] },
+  { type: "error", name: "RiskUniverseTooLow", inputs: [{ name: "agentId", type: "uint256" }, { name: "riskUniverse", type: "uint256" }] },
+  { type: "error", name: "FillAlreadyProcessed", inputs: [{ name: "fillId", type: "bytes32" }] }
+];
+
 // src/contracts/vault.ts
 var EXAGENT_VAULT_ABI = [
   // ERC-4626 Standard
@@ -2105,7 +2016,7 @@ var ExagentStaking = class {
 
 // src/constants.ts
 var import_chains = require("viem/chains");
-var SDK_VERSION = "0.1.12";
+var SDK_VERSION = "0.1.13";
 var DEFAULT_RPC_URL = "https://base-rpc.publicnode.com";
 function getRpcUrl() {
   if (typeof process !== "undefined" && process.env) {
@@ -2120,7 +2031,7 @@ var CONTRACT_ADDRESSES = {
   mainnet: {
     agentRegistry: "0x2261706C751F8ac5cdDb481B7b56EA2137d4A723",
     exaToken: "0x13403Fb738C97cF7564F279288468c140AaEd05c",
-    staking: "0xAF1729D1519A72f7d9b87aa23a305b775e2849DA",
+    staking: "0xe925727B21f1B86008f291E8f3102345A57B6c17",
     router: "0x1BCFa13f677fDCf697D8b7d5120f544817F1de1A",
     vaultFactory: "0x5b90C7F9F02F9130a92481360E9aa5Be4fcc9500",
     feeCollector: "0xe66328a964AF93bEF2eDB226D039C35aE6e66De1",
@@ -2265,7 +2176,8 @@ var ExagentClient = class {
     const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
     const agentId = this.parseAgentIdFromReceipt(receipt);
     this._agentId = agentId;
-    await this.registry.linkOwnWallet(agentId);
+    const linkHash = await this.registry.linkOwnWallet(agentId);
+    await this.publicClient.waitForTransactionReceipt({ hash: linkHash });
     return agentId;
   }
   /**
@@ -2294,6 +2206,11 @@ var ExagentClient = class {
       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;
   }
   /**
@@ -2389,7 +2306,20 @@ var ExagentClient = class {
         value: BigInt(routerTrade.transaction.value)
       });
       txParams.gas = estimated * 150n / 100n;
-    } catch {
+    } 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;
+        }
+      }
+      throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
     }
     const hash = await this.walletClient.sendTransaction(txParams);
     return {
@@ -2409,6 +2339,13 @@ var ExagentClient = class {
     const id = agentId ?? await this.getAgentId();
     if (!id) throw new Error("Agent not registered");
     const apiUrl = EXAGENT_API_CONFIG[this.network];
+    let configHash = intent.configHash;
+    if (!configHash) {
+      const onChainHash = await this.registry.getConfigHash(id);
+      if (onChainHash && onChainHash !== "0x0000000000000000000000000000000000000000000000000000000000000000") {
+        configHash = onChainHash;
+      }
+    }
     const response = await fetch(`${apiUrl}/v1/router/trade`, {
       method: "POST",
       headers: this.apiHeaders("application/json"),
@@ -2419,7 +2356,7 @@ var ExagentClient = class {
         amountIn: intent.amountIn.toString(),
         slippageBps: intent.maxSlippageBps ?? 50,
         taker: this.account.address,
-        ...intent.configHash && { configHash: intent.configHash }
+        ...configHash && { configHash }
       })
     });
     if (!response.ok) {
@@ -2512,7 +2449,8 @@ var ExagentClient = class {
     const response = await fetch(`${apiUrl}/v1/rankings/leaderboard?${params}`, {
       headers: this.apiHeaders()
     });
-    return response.json();
+    const data = await response.json();
+    return data.agents ?? [];
   }
   // ============ Vault Functions (Phase 4: Copy Trading) ============
   /**
@@ -3107,6 +3045,8 @@ var ExagentVaultFactory = class {
   DEFAULT_RPC_URL,
   DEX_ADDRESSES,
   EXAGENT_API_CONFIG,
+  EXAGENT_REGISTRY_ABI,
+  EXAGENT_ROUTER_ABI,
   EXAGENT_STAKING_ABI,
   EXAGENT_VAULT_FACTORY_ABI,
   ExagentClient,

package/dist/index.mjs

@@ -2,7 +2,8 @@
 import {
   createPublicClient,
   createWalletClient,
-  http
+  http,
+  decodeErrorResult
 } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 
@@ -119,13 +120,6 @@ var EXAGENT_REGISTRY_ABI = [
     outputs: [{ name: "", type: "uint256" }],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "nextAgentId",
-    inputs: [],
-    outputs: [{ name: "", type: "uint256" }],
-    stateMutability: "view"
-  },
   {
     type: "function",
     name: "ownerOf",
@@ -191,13 +185,6 @@ var EXAGENT_REGISTRY_ABI = [
     ],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "version",
-    inputs: [],
-    outputs: [{ name: "", type: "string" }],
-    stateMutability: "pure"
-  },
   // Config Epochs
   {
     type: "function",
@@ -216,40 +203,6 @@ var EXAGENT_REGISTRY_ABI = [
     outputs: [{ name: "", type: "bytes32" }],
     stateMutability: "view"
   },
-  {
-    type: "function",
-    name: "getCurrentEpoch",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [{ name: "", type: "uint256" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "getAgentConfig",
-    inputs: [{ name: "agentId", type: "uint256" }],
-    outputs: [
-      {
-        name: "",
-        type: "tuple",
-        components: [
-          { name: "configHash", type: "bytes32" },
-          { name: "epochId", type: "uint256" },
-          { name: "epochStartBlock", type: "uint256" }
-        ]
-      }
-    ],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "getEpochConfigHash",
-    inputs: [
-      { name: "agentId", type: "uint256" },
-      { name: "epochId", type: "uint256" }
-    ],
-    outputs: [{ name: "", type: "bytes32" }],
-    stateMutability: "view"
-  },
   // Mainnet: Agent retirement
   {
     type: "function",
@@ -317,15 +270,23 @@ var EXAGENT_REGISTRY_ABI = [
       { name: "blockNumber", type: "uint256", indexed: false }
     ]
   },
-  // Custom errors
-  { type: "error", name: "OwnerAlreadyHasAgent", inputs: [{ name: "existingAgentId", type: "uint256" }] },
+  // Custom errors — must match ExagentRegistry.sol for viem to decode reverts
+  { type: "error", name: "AgentNotOwner", inputs: [] },
+  { type: "error", name: "WalletAlreadyLinked", inputs: [] },
+  { type: "error", name: "WalletNotLinked", inputs: [] },
+  { type: "error", name: "InvalidSignature", inputs: [] },
+  { type: "error", name: "TransferDisabled", inputs: [] },
   { type: "error", name: "InvalidMetadataURI", inputs: [] },
+  { type: "error", name: "AgentDoesNotExist", inputs: [] },
+  { type: "error", name: "NameAlreadyTaken", inputs: [] },
   { type: "error", name: "InvalidName", inputs: [] },
+  { type: "error", name: "OwnerAlreadyHasAgent", inputs: [{ name: "existingAgentId", type: "uint256" }] },
   { type: "error", name: "InvalidRiskUniverse", inputs: [] },
   { type: "error", name: "InvalidTradingConfig", inputs: [] },
-  { type: "error", name: "NameAlreadyTaken", inputs: [] },
-  { type: "error", name: "AgentNotOwner", inputs: [] },
-  { type: "error", name: "AgentIsRetired", inputs: [] }
+  { type: "error", name: "NotAuthorizedCaller", inputs: [] },
+  { type: "error", name: "MetadataValueTooLarge", inputs: [] },
+  { type: "error", name: "AgentIsRetired", inputs: [] },
+  { type: "error", name: "InvalidRiskUniverseForWhitelist", inputs: [] }
 ];
 var ExagentRegistry = class {
   address;
@@ -537,18 +498,6 @@ var ExagentRegistry = class {
     });
     return nonce;
   }
-  /**
-   * Get the next agent ID that will be assigned
-   * @returns Next agent ID
-   */
-  async getNextAgentId() {
-    const nextId = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "nextAgentId"
-    });
-    return nextId;
-  }
   /**
    * Generate the message hash for wallet linking.
    * Matches the contract's keccak256(abi.encodePacked(...)) exactly.
@@ -594,18 +543,6 @@ var ExagentRegistry = class {
     const [canRegister, existingAgentId] = result;
     return { canRegister, existingAgentId };
   }
-  /**
-   * Get the registry contract version
-   * @returns Version string (e.g., "4.0.0")
-   */
-  async getVersion() {
-    const version = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "version"
-    });
-    return version;
-  }
   // ============ Config Epochs ============
   /**
    * Update the agent's LLM config hash on-chain
@@ -639,54 +576,6 @@ var ExagentRegistry = class {
     });
     return configHash;
   }
-  /**
-   * Get the current epoch ID for an agent
-   * @param agentId The agent's ID
-   * @returns Current epoch (0 if never configured)
-   */
-  async getCurrentEpoch(agentId) {
-    const epochId = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getCurrentEpoch",
-      args: [agentId]
-    });
-    return epochId;
-  }
-  /**
-   * Get full config info for an agent
-   * @param agentId The agent's ID
-   * @returns AgentConfig struct (configHash, epochId, epochStartBlock)
-   */
-  async getAgentConfig(agentId) {
-    const config = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getAgentConfig",
-      args: [agentId]
-    });
-    const result = config;
-    return {
-      configHash: result.configHash,
-      epochId: result.epochId,
-      epochStartBlock: result.epochStartBlock
-    };
-  }
-  /**
-   * Get the config hash for a specific epoch
-   * @param agentId The agent's ID
-   * @param epochId The epoch to look up
-   * @returns Config hash for that epoch
-   */
-  async getEpochConfigHash(agentId, epochId) {
-    const configHash = await this.publicClient.readContract({
-      address: this.address,
-      abi: EXAGENT_REGISTRY_ABI,
-      functionName: "getEpochConfigHash",
-      args: [agentId, epochId]
-    });
-    return configHash;
-  }
   /**
    * Calculate the config hash for a provider and model
    * @param provider The LLM provider name (e.g., "openai", "anthropic")
@@ -775,6 +664,27 @@ var ExagentRegistry = class {
   }
 };
 
+// src/contracts/router.ts
+var EXAGENT_ROUTER_ABI = [
+  // Custom errors — must match ExagentRouterV2.sol for viem to decode reverts
+  { type: "error", name: "InvalidAgentId", inputs: [] },
+  { type: "error", name: "SwapFailed", inputs: [] },
+  { type: "error", name: "InsufficientOutput", inputs: [] },
+  { type: "error", name: "ZeroAddress", inputs: [] },
+  { type: "error", name: "ZeroAmount", inputs: [] },
+  { type: "error", name: "AggregatorNotWhitelisted", inputs: [] },
+  { type: "error", name: "ETHTransferFailed", inputs: [] },
+  { type: "error", name: "FeeBpsTooHigh", inputs: [] },
+  { type: "error", name: "NotAuthorizedForAgent", inputs: [{ name: "agentId", type: "uint256" }, { name: "caller", type: "address" }] },
+  { type: "error", name: "ConfigMismatch", inputs: [{ name: "provided", type: "bytes32" }, { name: "onChain", type: "bytes32" }] },
+  { type: "error", name: "MsgValueMismatch", inputs: [] },
+  { type: "error", name: "FeeCollectorNotSet", inputs: [] },
+  { type: "error", name: "TokenNotAllowedForAgent", inputs: [{ name: "agentId", type: "uint256" }, { name: "token", type: "address" }] },
+  { type: "error", name: "NotAuthorized", inputs: [] },
+  { type: "error", name: "RiskUniverseTooLow", inputs: [{ name: "agentId", type: "uint256" }, { name: "riskUniverse", type: "uint256" }] },
+  { type: "error", name: "FillAlreadyProcessed", inputs: [{ name: "fillId", type: "bytes32" }] }
+];
+
 // src/contracts/vault.ts
 var EXAGENT_VAULT_ABI = [
   // ERC-4626 Standard
@@ -2070,7 +1980,7 @@ var ExagentStaking = class {
 
 // src/constants.ts
 import { base } from "viem/chains";
-var SDK_VERSION = "0.1.12";
+var SDK_VERSION = "0.1.13";
 var DEFAULT_RPC_URL = "https://base-rpc.publicnode.com";
 function getRpcUrl() {
   if (typeof process !== "undefined" && process.env) {
@@ -2085,7 +1995,7 @@ var CONTRACT_ADDRESSES = {
   mainnet: {
     agentRegistry: "0x2261706C751F8ac5cdDb481B7b56EA2137d4A723",
     exaToken: "0x13403Fb738C97cF7564F279288468c140AaEd05c",
-    staking: "0xAF1729D1519A72f7d9b87aa23a305b775e2849DA",
+    staking: "0xe925727B21f1B86008f291E8f3102345A57B6c17",
     router: "0x1BCFa13f677fDCf697D8b7d5120f544817F1de1A",
     vaultFactory: "0x5b90C7F9F02F9130a92481360E9aa5Be4fcc9500",
     feeCollector: "0xe66328a964AF93bEF2eDB226D039C35aE6e66De1",
@@ -2230,7 +2140,8 @@ var ExagentClient = class {
     const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
     const agentId = this.parseAgentIdFromReceipt(receipt);
     this._agentId = agentId;
-    await this.registry.linkOwnWallet(agentId);
+    const linkHash = await this.registry.linkOwnWallet(agentId);
+    await this.publicClient.waitForTransactionReceipt({ hash: linkHash });
     return agentId;
   }
   /**
@@ -2259,6 +2170,11 @@ var ExagentClient = class {
       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;
   }
   /**
@@ -2354,7 +2270,20 @@ var ExagentClient = class {
         value: BigInt(routerTrade.transaction.value)
       });
       txParams.gas = estimated * 150n / 100n;
-    } catch {
+    } 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;
+        }
+      }
+      throw new Error(`Trade will revert: gas estimation failed. ${err?.message || "Unknown reason"}`);
     }
     const hash = await this.walletClient.sendTransaction(txParams);
     return {
@@ -2374,6 +2303,13 @@ var ExagentClient = class {
     const id = agentId ?? await this.getAgentId();
     if (!id) throw new Error("Agent not registered");
     const apiUrl = EXAGENT_API_CONFIG[this.network];
+    let configHash = intent.configHash;
+    if (!configHash) {
+      const onChainHash = await this.registry.getConfigHash(id);
+      if (onChainHash && onChainHash !== "0x0000000000000000000000000000000000000000000000000000000000000000") {
+        configHash = onChainHash;
+      }
+    }
     const response = await fetch(`${apiUrl}/v1/router/trade`, {
       method: "POST",
       headers: this.apiHeaders("application/json"),
@@ -2384,7 +2320,7 @@ var ExagentClient = class {
         amountIn: intent.amountIn.toString(),
         slippageBps: intent.maxSlippageBps ?? 50,
         taker: this.account.address,
-        ...intent.configHash && { configHash: intent.configHash }
+        ...configHash && { configHash }
       })
     });
     if (!response.ok) {
@@ -2477,7 +2413,8 @@ var ExagentClient = class {
     const response = await fetch(`${apiUrl}/v1/rankings/leaderboard?${params}`, {
       headers: this.apiHeaders()
     });
-    return response.json();
+    const data = await response.json();
+    return data.agents ?? [];
   }
   // ============ Vault Functions (Phase 4: Copy Trading) ============
   /**
@@ -3071,6 +3008,8 @@ export {
   DEFAULT_RPC_URL,
   DEX_ADDRESSES,
   EXAGENT_API_CONFIG,
+  EXAGENT_REGISTRY_ABI,
+  EXAGENT_ROUTER_ABI,
   EXAGENT_STAKING_ABI,
   EXAGENT_VAULT_FACTORY_ABI,
   ExagentClient,

package/package.json

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