@exagent/sdk 0.1.18 → 0.1.19

package/dist/index.d.mts

@@ -1509,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)
@@ -1528,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)

package/dist/index.d.ts

@@ -1509,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)
@@ -1528,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)

package/dist/index.js

@@ -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;
   }
@@ -1823,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]);
+      }
+    }
+    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("AgentRegistered event not found in transaction receipt");
+    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";
 
@@ -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;
   }
@@ -1790,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]);
+      }
+    }
+    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("AgentRegistered event not found in transaction receipt");
+    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.18",
+  "version": "0.1.19",
   "description": "TypeScript SDK for Exagent",
   "main": "dist/index.js",
   "module": "dist/index.mjs",