@exagent/agent 0.1.21 → 0.1.23

package/dist/index.d.ts

@@ -339,9 +339,9 @@ declare const AgentConfigSchema: z.ZodObject<{
     }>>;
     allowedTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
+    agentId: string | number;
     name: string;
     network: "mainnet";
-    agentId: string | number;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -388,8 +388,8 @@ declare const AgentConfigSchema: z.ZodObject<{
     } | undefined;
     allowedTokens?: string[] | undefined;
 }, {
-    name: string;
     agentId: string | number;
+    name: string;
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         model?: string | undefined;
@@ -739,6 +739,10 @@ interface AgentStatusPayload {
         recentTrades: number;
         totalRealizedPnL: number;
     };
+    /** Current on-chain config hash (for epoch tracking) */
+    configHash?: string;
+    /** Config hash awaiting owner approval — null/undefined means no pending verification */
+    pendingConfigHash?: string | null;
 }
 interface RelayConfig {
     enabled: boolean;
@@ -770,6 +774,8 @@ declare class AgentRuntime {
     private isRunning;
     private mode;
     private configHash;
+    private pendingConfigHash;
+    private lastConfigCheckAt;
     private cycleCount;
     private lastCycleAt;
     private lastPortfolioValue;
@@ -790,6 +796,11 @@ declare class AgentRuntime {
     private perpStrategy;
     private perpConnected;
     private perpTradingActive;
+    private cachedPerpEquity;
+    private cachedPerpUnrealizedPnl;
+    private cachedPerpMarginUsed;
+    private cachedPerpLeverage;
+    private cachedPerpOpenPositions;
     constructor(config: RuntimeConfig);
     /**
      * Initialize the agent runtime
@@ -821,8 +832,14 @@ declare class AgentRuntime {
     private loadTradingRestrictions;
     /**
      * Sync the LLM config hash to chain for epoch tracking.
-     * If the wallet has insufficient gas, enters a recovery loop
-     * that waits for the user to fund the wallet.
+     *
+     * If the trading wallet is NOT the agent owner, the on-chain setConfig
+     * call would revert with AgentNotOwner. Instead, we set a pending state
+     * and send a message to the command center so the owner can approve it
+     * from the website with one click.
+     *
+     * Until the config is verified on-chain, the agent won't appear on the
+     * leaderboard (trades still execute normally).
      */
     private syncConfigHash;
     /**
@@ -841,6 +858,11 @@ declare class AgentRuntime {
      * Handle a command from the command center
      */
     private handleCommand;
+    /**
+     * Periodically check if the owner has approved the pending config hash.
+     * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
+     */
+    private checkPendingConfigApproval;
     /**
      * Send current status to the relay
      */
@@ -2081,6 +2103,6 @@ declare function decryptEnvFile(encPath: string, passphrase: string): Record<str
 declare function loadSecureEnv(basePath: string, passphrase?: string): boolean;
 
 /** @exagent/agent package version — update alongside package.json */
-declare const AGENT_VERSION = "0.1.21";
+declare const AGENT_VERSION = "0.1.23";
 
 export { AGENT_VERSION, type AccountSummary, type AgentConfig, AgentConfigSchema, type AgentMode, AgentRuntime, type AgentStatusPayload, AnthropicAdapter, BaseLLMAdapter, type CommandType, DeepSeekAdapter, FileStore, type FillCallback, type FundingCallback, type FundingPayment, GoogleAdapter, GroqAdapter, HYPERLIQUID_DOMAIN, HyperliquidClient, HyperliquidSigner, HyperliquidWebSocket, type LLMAdapter, type LLMConfig, LLMConfigSchema, type LLMMessage, type LLMMetadata, type LLMProvider, LLMProviderSchema, type LLMResponse, type LiquidationCallback, type MarketData, MarketDataService, type MessageLevel, type MessageType, MistralAdapter, OllamaAdapter, type OnboardingStatus, OpenAIAdapter, OrderManager, type OrderResult, type PerpAction, type PerpConfig$1 as PerpConfig, PerpConfigSchema, type PerpFill, type PerpMarketData, PerpOnboarding, type PerpPosition, type PerpStrategyFunction, PerpTradeRecorder, type PerpTradeSignal, type PerpConfig as PerpTradingConfig, PositionManager, type PositionSummary, PositionTracker, type RecordPerpTradeParams, RelayClient, type RelayCommand, type RelayConfig$1 as RelayConfig, RelayConfigSchema, RiskManager, type RiskState, type RiskUniverse, RiskUniverseSchema, type RuntimeConfig, STRATEGY_TEMPLATES, type StrategyContext, type StrategyFunction, type StrategyStore, type StrategyTemplate, TogetherAdapter, type TrackedPosition, TradeExecutor, type TradeRecord, type TradeSignal, type TradingConfig, TradingConfigSchema, type VaultConfig, VaultConfigSchema, VaultManager, type VaultManagerConfig, type VaultPolicy, VaultPolicySchema, type VaultStatus, createLLMAdapter, createSampleConfig, decryptEnvFile, encryptEnvFile, fillHashToBytes32, fillOidToBytes32, getAllStrategyTemplates, getNextNonce, getStrategyTemplate, loadConfig, loadSecureEnv, loadStrategy, validateConfig, validateStrategy };

package/dist/index.js

@@ -1747,7 +1747,7 @@ function classifyTradeError(message) {
   if (lower.includes("notauthorizedforagent") || lower.includes("not authorized")) {
     return {
       category: "not_authorized",
-      userMessage: "Wallet not authorized for this agent. Ensure your wallet is linked via the registry."
+      userMessage: 'Wallet not authorized for this agent. This wallet is not linked to your agent on-chain, so the router rejected the trade. To fix: (1) Open your command center at exagent.io, (2) Use the Wallet Management panel to check linked wallets, (3) If you lost your old wallet, unlink it first then re-run the agent to link the new one. Run "npx @exagent/agent export-key" to verify which wallet this agent is using.'
     };
   }
   if (lower.includes("aggregatornotwhitelisted")) {
@@ -3886,6 +3886,9 @@ var AgentRuntime = class {
   isRunning = false;
   mode = "idle";
   configHash;
+  pendingConfigHash = null;
+  lastConfigCheckAt = 0;
+  // Timestamp of last pending config RPC check
   cycleCount = 0;
   lastCycleAt = 0;
   lastPortfolioValue = 0;
@@ -3912,6 +3915,12 @@ var AgentRuntime = class {
   // When perpConnected && perpTradingActive: dedicated runPerpCycle() runs every interval
   perpConnected = false;
   perpTradingActive = false;
+  // Cached perp account data for synchronous heartbeat inclusion (refreshed async)
+  cachedPerpEquity = 0;
+  cachedPerpUnrealizedPnl = 0;
+  cachedPerpMarginUsed = 0;
+  cachedPerpLeverage = 0;
+  cachedPerpOpenPositions = 0;
   constructor(config) {
     this.config = config;
   }
@@ -4222,8 +4231,14 @@ var AgentRuntime = class {
   }
   /**
    * Sync the LLM config hash to chain for epoch tracking.
-   * If the wallet has insufficient gas, enters a recovery loop
-   * that waits for the user to fund the wallet.
+   *
+   * If the trading wallet is NOT the agent owner, the on-chain setConfig
+   * call would revert with AgentNotOwner. Instead, we set a pending state
+   * and send a message to the command center so the owner can approve it
+   * from the website with one click.
+   *
+   * Until the config is verified on-chain, the agent won't appear on the
+   * leaderboard (trades still execute normally).
    */
   async syncConfigHash() {
     const agentId = BigInt(this.config.agentId);
@@ -4231,53 +4246,89 @@ var AgentRuntime = class {
     this.configHash = import_sdk.ExagentRegistry.calculateConfigHash(llmMeta.provider, llmMeta.model);
     console.log(`Config hash: ${this.configHash}`);
     const onChainHash = await this.client.registry.getConfigHash(agentId);
-    if (onChainHash !== this.configHash) {
-      console.log("Config changed, updating on-chain...");
-      try {
-        await this.client.registry.updateConfig(agentId, this.configHash);
-        console.log(`Config updated on-chain`);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (message.includes("insufficient funds") || message.includes("intrinsic gas too low") || message.includes("exceeds the balance")) {
-          const ccUrl = `https://exagent.io/agents/${encodeURIComponent(this.config.name)}/command-center`;
-          const chain = import_chains4.base;
-          const publicClientInstance = (0, import_viem6.createPublicClient)({
-            chain,
-            transport: (0, import_viem6.http)(this.getRpcUrl())
+    if (onChainHash === this.configHash) {
+      console.log("Config hash matches on-chain");
+      this.pendingConfigHash = null;
+      return;
+    }
+    console.log("Config changed, updating on-chain...");
+    const agent = await this.client.registry.getAgent(agentId);
+    const isOwner = agent?.owner.toLowerCase() === this.client.address.toLowerCase();
+    if (!isOwner) {
+      this.pendingConfigHash = this.configHash;
+      this.configHash = onChainHash;
+      console.log("");
+      console.log("=== CONFIG VERIFICATION NEEDED ===");
+      console.log("");
+      console.log("  Your trading wallet cannot update the LLM config on-chain.");
+      console.log("  The owner must approve this from the command center.");
+      console.log("");
+      console.log(`  LLM:  ${llmMeta.provider} / ${llmMeta.model}`);
+      console.log(`  Hash: ${this.pendingConfigHash}`);
+      console.log("");
+      console.log("  Until approved:");
+      console.log("    - New agents will not appear on the leaderboard");
+      console.log("    - Trades will still execute normally");
+      console.log("");
+      this.relay?.sendMessage(
+        "system",
+        "warning",
+        "Config Verification Needed",
+        `Your agent is using ${llmMeta.provider}/${llmMeta.model} but this hasn't been recorded on-chain. Open the command center and click "Approve Config" to verify. Until then, your agent won't appear on the leaderboard.`,
+        { configHash: this.pendingConfigHash, provider: llmMeta.provider, model: llmMeta.model }
+      );
+      return;
+    }
+    try {
+      await this.client.registry.updateConfig(agentId, this.configHash);
+      console.log(`Config updated on-chain`);
+      this.pendingConfigHash = null;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (message.includes("insufficient funds") || message.includes("intrinsic gas too low") || message.includes("exceeds the balance")) {
+        const ccUrl = `https://exagent.io/agents/${encodeURIComponent(this.config.name)}/command-center`;
+        const publicClientInstance = (0, import_viem6.createPublicClient)({
+          chain: import_chains4.base,
+          transport: (0, import_viem6.http)(this.getRpcUrl())
+        });
+        console.log("");
+        console.log("=== ETH NEEDED FOR GAS ===");
+        console.log("");
+        console.log(`  Wallet: ${this.client.address}`);
+        console.log("  Your wallet needs ETH to pay for transaction gas.");
+        console.log("  Opening the command center to fund your wallet...");
+        console.log(`  ${ccUrl}`);
+        console.log("");
+        openBrowser(ccUrl);
+        console.log("  Waiting for ETH... (checking every 15s)");
+        console.log("  Press Ctrl+C to exit.");
+        console.log("");
+        while (true) {
+          await this.sleep(15e3);
+          const balance = await publicClientInstance.getBalance({
+            address: this.client.address
           });
-          console.log("");
-          console.log("=== ETH NEEDED FOR GAS ===");
-          console.log("");
-          console.log(`  Wallet: ${this.client.address}`);
-          console.log("  Your wallet needs ETH to pay for transaction gas.");
-          console.log("  Opening the command center to fund your wallet...");
-          console.log(`  ${ccUrl}`);
-          console.log("");
-          openBrowser(ccUrl);
-          console.log("  Waiting for ETH... (checking every 15s)");
-          console.log("  Press Ctrl+C to exit.");
-          console.log("");
-          while (true) {
-            await this.sleep(15e3);
-            const balance = await publicClientInstance.getBalance({
-              address: this.client.address
-            });
-            if (balance > BigInt(0)) {
-              console.log("  ETH detected! Retrying config update...");
-              console.log("");
+          if (balance > BigInt(0)) {
+            console.log("  ETH detected! Retrying config update...");
+            console.log("");
+            try {
               await this.client.registry.updateConfig(agentId, this.configHash);
               console.log(`Config updated on-chain`);
-              return;
+              this.pendingConfigHash = null;
+            } catch (retryError) {
+              const retryMsg = retryError instanceof Error ? retryError.message : String(retryError);
+              console.warn(`Config update failed after funding: ${retryMsg}`);
+              console.warn("Continuing with on-chain config.");
+              this.configHash = onChainHash;
             }
-            process.stdout.write(".");
+            return;
           }
-        } else {
-          console.warn(`Config update skipped (continuing with on-chain config): ${message}`);
-          this.configHash = onChainHash;
+          process.stdout.write(".");
         }
+      } else {
+        console.warn(`Config update skipped (continuing with on-chain config): ${message}`);
+        this.configHash = onChainHash;
       }
-    } else {
-      console.log("Config hash matches on-chain");
     }
   }
   /**
@@ -4608,11 +4659,38 @@ var AgentRuntime = class {
       this.relay?.sendCommandResult(cmd.id, false, message);
     }
   }
+  /**
+   * Periodically check if the owner has approved the pending config hash.
+   * Called from sendRelayStatus at most every 2.5 minutes (timestamp-throttled).
+   */
+  async checkPendingConfigApproval() {
+    if (!this.pendingConfigHash) return;
+    try {
+      const onChain = await this.client.registry.getConfigHash(BigInt(this.config.agentId));
+      if (onChain === this.pendingConfigHash) {
+        this.configHash = this.pendingConfigHash;
+        this.pendingConfigHash = null;
+        console.log("Config verified on-chain! Your agent will now appear on the leaderboard.");
+        this.relay?.sendMessage(
+          "config_updated",
+          "success",
+          "Config Verified",
+          "Your LLM config has been verified on-chain. Your agent will now appear on the leaderboard."
+        );
+      }
+    } catch {
+    }
+  }
   /**
    * Send current status to the relay
    */
   sendRelayStatus() {
     if (!this.relay) return;
+    const CONFIG_CHECK_INTERVAL_MS = 15e4;
+    if (this.pendingConfigHash && Date.now() - this.lastConfigCheckAt >= CONFIG_CHECK_INTERVAL_MS) {
+      this.lastConfigCheckAt = Date.now();
+      this.checkPendingConfigApproval();
+    }
     const vaultConfig = this.config.vault || { policy: "disabled" };
     const status = {
       mode: this.mode,
@@ -4641,31 +4719,32 @@ var AgentRuntime = class {
       perp: this.perpConnected ? {
         enabled: true,
         trading: this.perpTradingActive,
-        equity: 0,
-        unrealizedPnl: 0,
-        marginUsed: 0,
-        openPositions: 0,
-        effectiveLeverage: 0,
+        equity: this.cachedPerpEquity,
+        unrealizedPnl: this.cachedPerpUnrealizedPnl,
+        marginUsed: this.cachedPerpMarginUsed,
+        openPositions: this.cachedPerpOpenPositions,
+        effectiveLeverage: this.cachedPerpLeverage,
         pendingRecords: this.perpRecorder?.pendingRetries ?? 0
       } : void 0,
-      positions: this.positionTracker ? this.positionTracker.getPositionSummary(this.lastPrices) : void 0
+      positions: this.positionTracker ? this.positionTracker.getPositionSummary(this.lastPrices) : void 0,
+      configHash: this.configHash || void 0,
+      pendingConfigHash: this.pendingConfigHash
+      // null preserved by JSON.stringify for clearing
     };
-    if (this.perpConnected && this.perpPositions && status.perp) {
+    this.relay.sendHeartbeat(status);
+    if (this.perpConnected && this.perpPositions) {
       this.perpPositions.getAccountSummary().then((account) => {
-        if (status.perp) {
-          status.perp.equity = account.totalEquity;
-          status.perp.unrealizedPnl = account.totalUnrealizedPnl;
-          status.perp.marginUsed = account.totalMarginUsed;
-          status.perp.effectiveLeverage = account.effectiveLeverage;
-        }
+        this.cachedPerpEquity = account.totalEquity;
+        this.cachedPerpUnrealizedPnl = account.totalUnrealizedPnl;
+        this.cachedPerpMarginUsed = account.totalMarginUsed;
+        this.cachedPerpLeverage = account.effectiveLeverage;
       }).catch(() => {
       });
       this.perpPositions.getPositionCount().then((count) => {
-        if (status.perp) status.perp.openPositions = count;
+        this.cachedPerpOpenPositions = count;
       }).catch(() => {
       });
     }
-    this.relay.sendHeartbeat(status);
   }
   /**
    * Run a single trading cycle
@@ -5238,7 +5317,7 @@ function loadSecureEnv(basePath, passphrase) {
 }
 
 // src/index.ts
-var AGENT_VERSION = "0.1.21";
+var AGENT_VERSION = "0.1.23";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_VERSION,

package/dist/index.mjs

@@ -49,7 +49,7 @@ import {
   loadStrategy,
   validateConfig,
   validateStrategy
-} from "./chunk-U6YJHCO3.mjs";
+} from "./chunk-NENK6U55.mjs";
 export {
   AGENT_VERSION,
   AgentConfigSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exagent/agent",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Autonomous trading agent runtime for Exagent",
   "main": "dist/index.js",
   "module": "dist/index.mjs",