@exagent/agent 0.1.21 → 0.1.23

package/dist/cli.js

@@ -1659,7 +1659,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")) {
@@ -3702,7 +3702,7 @@ function loadSecureEnv(basePath, passphrase) {
 }
 
 // src/index.ts
-var AGENT_VERSION = "0.1.21";
+var AGENT_VERSION = "0.1.23";
 
 // src/relay.ts
 var RelayClient = class {
@@ -3984,6 +3984,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;
@@ -4010,6 +4013,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;
   }
@@ -4320,8 +4329,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);
@@ -4329,53 +4344,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");
     }
   }
   /**
@@ -4706,11 +4757,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,
@@ -4739,31 +4817,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
@@ -5227,6 +5306,37 @@ async function checkFirstRunSetup(configPath) {
   let privateKey;
   let walletAddress;
   if (walletSetup === "generate") {
+    console.log("");
+    console.log("!".repeat(60));
+    console.log("  WALLET BACKUP \u2014 READ BEFORE CONTINUING");
+    console.log("!".repeat(60));
+    console.log("");
+    console.log("  WHY THIS MATTERS:");
+    console.log("  Exagent is non-custodial. Your trading wallet key is");
+    console.log("  generated here on your machine and never leaves it.");
+    console.log("  We do not store it. No one else has a copy.");
+    console.log("");
+    console.log("  WHAT THIS MEANS:");
+    console.log("  The private key will live ONLY in the .env file");
+    console.log("  in this folder. If you delete this folder, your");
+    console.log("  wallet and ALL FUNDS in it are permanently lost.");
+    console.log("  There is NO recovery \u2014 Exagent cannot help.");
+    console.log("");
+    console.log("  BEFORE CONTINUING:");
+    console.log("  - Know where this folder is on your computer");
+    console.log("  - Plan to back up .env (or .env.enc) after setup");
+    console.log("  - Store your passphrase in a password manager");
+    console.log("  - View your key anytime: npx @exagent/agent export-key");
+    console.log("");
+    console.log("!".repeat(60));
+    console.log("");
+    const ack = await prompt('  Type "I understand" to continue: ');
+    if (ack.trim().toLowerCase() !== "i understand") {
+      console.log("");
+      console.log("  Setup cancelled. Run the agent again when ready.");
+      process.exit(0);
+    }
+    console.log("");
     console.log("[WALLET] Generating a new wallet for your agent...");
     console.log("");
     const generatedKey = (0, import_accounts6.generatePrivateKey)();
@@ -5240,8 +5350,9 @@ async function checkFirstRunSetup(configPath) {
     console.log("  | " + walletAddress.padEnd(56) + " |");
     console.log("  +" + "-".repeat(58) + "+");
     console.log("");
-    console.log("  IMPORTANT: Your private key has been saved to .env");
-    console.log("  Back up this file securely. If lost, your funds are gone.");
+    console.log("  CRITICAL: Back up your .env file now.");
+    console.log("  Export your key anytime: npx @exagent/agent export-key");
+    console.log("  If you lose .env AND your backup, funds are unrecoverable.");
     console.log("");
     const confirmed = await prompt("  Press Enter to continue, or Ctrl+C to cancel...");
   } else {
@@ -5570,4 +5681,56 @@ program.command("encrypt").description("Encrypt .env file to .env.enc for secure
     process.exit(1);
   }
 });
+program.command("export-key").description("Display your trading wallet private key for backup").option("-d, --dir <path>", "Directory containing .env or .env.enc file", ".").option("-p, --passphrase <passphrase>", "Passphrase to decrypt .env.enc").action(async (options) => {
+  try {
+    const dir = options.dir.startsWith("/") ? options.dir : path2.join(process.cwd(), options.dir);
+    let passphrase = options.passphrase || process.env.EXAGENT_PASSPHRASE;
+    const encPath = path2.join(dir, ".env.enc");
+    const envPath = path2.join(dir, ".env");
+    if (fs2.existsSync(encPath) && !passphrase) {
+      console.log("");
+      console.log("  Encrypted config found (.env.enc)");
+      console.log("");
+      passphrase = await prompt("  Enter passphrase: ", true);
+      console.log("");
+    }
+    const usedEncrypted = loadSecureEnv(dir, passphrase);
+    if (!usedEncrypted && fs2.existsSync(envPath)) {
+      const { config: loadDotenv } = await import("dotenv");
+      loadDotenv({ path: envPath, override: true });
+    }
+    const privateKey = process.env.EXAGENT_PRIVATE_KEY;
+    if (!privateKey) {
+      console.error("");
+      console.error("  No private key found. Make sure .env or .env.enc exists in this directory.");
+      console.error("");
+      process.exit(1);
+    }
+    const { privateKeyToAccount: privateKeyToAccount7 } = await import("viem/accounts");
+    const account = privateKeyToAccount7(privateKey);
+    console.log("");
+    console.log("=".repeat(60));
+    console.log("  WALLET PRIVATE KEY EXPORT");
+    console.log("=".repeat(60));
+    console.log("");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("  | WALLET ADDRESS:                                          |");
+    console.log("  | " + account.address.padEnd(56) + " |");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("  | PRIVATE KEY:                                             |");
+    console.log("  | " + privateKey.padEnd(56) + " |");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("");
+    console.log("  WARNING: Anyone with this key controls your wallet.");
+    console.log("  Store it in a password manager. Never share it.");
+    console.log("  Never paste it in a browser, email, or chat.");
+    console.log("");
+    console.log("=".repeat(60));
+    console.log("");
+    process.exit(0);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.parse();

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import {
   loadConfig,
   loadSecureEnv,
   validateConfig
-} from "./chunk-U6YJHCO3.mjs";
+} from "./chunk-NENK6U55.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -89,6 +89,37 @@ async function checkFirstRunSetup(configPath) {
   let privateKey;
   let walletAddress;
   if (walletSetup === "generate") {
+    console.log("");
+    console.log("!".repeat(60));
+    console.log("  WALLET BACKUP \u2014 READ BEFORE CONTINUING");
+    console.log("!".repeat(60));
+    console.log("");
+    console.log("  WHY THIS MATTERS:");
+    console.log("  Exagent is non-custodial. Your trading wallet key is");
+    console.log("  generated here on your machine and never leaves it.");
+    console.log("  We do not store it. No one else has a copy.");
+    console.log("");
+    console.log("  WHAT THIS MEANS:");
+    console.log("  The private key will live ONLY in the .env file");
+    console.log("  in this folder. If you delete this folder, your");
+    console.log("  wallet and ALL FUNDS in it are permanently lost.");
+    console.log("  There is NO recovery \u2014 Exagent cannot help.");
+    console.log("");
+    console.log("  BEFORE CONTINUING:");
+    console.log("  - Know where this folder is on your computer");
+    console.log("  - Plan to back up .env (or .env.enc) after setup");
+    console.log("  - Store your passphrase in a password manager");
+    console.log("  - View your key anytime: npx @exagent/agent export-key");
+    console.log("");
+    console.log("!".repeat(60));
+    console.log("");
+    const ack = await prompt('  Type "I understand" to continue: ');
+    if (ack.trim().toLowerCase() !== "i understand") {
+      console.log("");
+      console.log("  Setup cancelled. Run the agent again when ready.");
+      process.exit(0);
+    }
+    console.log("");
     console.log("[WALLET] Generating a new wallet for your agent...");
     console.log("");
     const generatedKey = generatePrivateKey();
@@ -102,8 +133,9 @@ async function checkFirstRunSetup(configPath) {
     console.log("  | " + walletAddress.padEnd(56) + " |");
     console.log("  +" + "-".repeat(58) + "+");
     console.log("");
-    console.log("  IMPORTANT: Your private key has been saved to .env");
-    console.log("  Back up this file securely. If lost, your funds are gone.");
+    console.log("  CRITICAL: Back up your .env file now.");
+    console.log("  Export your key anytime: npx @exagent/agent export-key");
+    console.log("  If you lose .env AND your backup, funds are unrecoverable.");
     console.log("");
     const confirmed = await prompt("  Press Enter to continue, or Ctrl+C to cancel...");
   } else {
@@ -432,4 +464,56 @@ program.command("encrypt").description("Encrypt .env file to .env.enc for secure
     process.exit(1);
   }
 });
+program.command("export-key").description("Display your trading wallet private key for backup").option("-d, --dir <path>", "Directory containing .env or .env.enc file", ".").option("-p, --passphrase <passphrase>", "Passphrase to decrypt .env.enc").action(async (options) => {
+  try {
+    const dir = options.dir.startsWith("/") ? options.dir : path.join(process.cwd(), options.dir);
+    let passphrase = options.passphrase || process.env.EXAGENT_PASSPHRASE;
+    const encPath = path.join(dir, ".env.enc");
+    const envPath = path.join(dir, ".env");
+    if (fs.existsSync(encPath) && !passphrase) {
+      console.log("");
+      console.log("  Encrypted config found (.env.enc)");
+      console.log("");
+      passphrase = await prompt("  Enter passphrase: ", true);
+      console.log("");
+    }
+    const usedEncrypted = loadSecureEnv(dir, passphrase);
+    if (!usedEncrypted && fs.existsSync(envPath)) {
+      const { config: loadDotenv } = await import("dotenv");
+      loadDotenv({ path: envPath, override: true });
+    }
+    const privateKey = process.env.EXAGENT_PRIVATE_KEY;
+    if (!privateKey) {
+      console.error("");
+      console.error("  No private key found. Make sure .env or .env.enc exists in this directory.");
+      console.error("");
+      process.exit(1);
+    }
+    const { privateKeyToAccount: privateKeyToAccount2 } = await import("viem/accounts");
+    const account = privateKeyToAccount2(privateKey);
+    console.log("");
+    console.log("=".repeat(60));
+    console.log("  WALLET PRIVATE KEY EXPORT");
+    console.log("=".repeat(60));
+    console.log("");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("  | WALLET ADDRESS:                                          |");
+    console.log("  | " + account.address.padEnd(56) + " |");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("  | PRIVATE KEY:                                             |");
+    console.log("  | " + privateKey.padEnd(56) + " |");
+    console.log("  +" + "-".repeat(58) + "+");
+    console.log("");
+    console.log("  WARNING: Anyone with this key controls your wallet.");
+    console.log("  Store it in a password manager. Never share it.");
+    console.log("  Never paste it in a browser, email, or chat.");
+    console.log("");
+    console.log("=".repeat(60));
+    console.log("");
+    process.exit(0);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.parse();

package/dist/index.d.mts

@@ -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 };