solana-traderclaw 1.0.139 → 1.0.141

package/dist/{chunk-6GSGHMUH.js → chunk-E7QOPXSU.js}

@@ -1,5 +1,38 @@
 // src/http-client.ts
 import kayba, { SpanType } from "@kayba_ai/tracing";
+var OrchestratorRateLimitError = class extends Error {
+  code = "RATE_LIMIT_EXCEEDED";
+  retryAfterMs;
+  status;
+  constructor(message, retryAfterMs, status) {
+    super(message);
+    this.name = "OrchestratorRateLimitError";
+    this.retryAfterMs = retryAfterMs;
+    this.status = status;
+  }
+};
+function parseRetryAfterMs(headerValue, maxMs) {
+  if (!headerValue) return null;
+  const trimmed = headerValue.trim();
+  if (trimmed === "") return null;
+  const asSeconds = Number(trimmed);
+  if (Number.isFinite(asSeconds) && asSeconds >= 0) {
+    return Math.min(Math.round(asSeconds * 1e3), maxMs);
+  }
+  const asDate = Date.parse(trimmed);
+  if (Number.isFinite(asDate)) {
+    return Math.max(0, Math.min(asDate - Date.now(), maxMs));
+  }
+  return null;
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    const t = setTimeout(resolve, ms);
+    if (t && typeof t === "object" && "unref" in t) {
+      t.unref();
+    }
+  });
+}
 async function orchestratorRequest(opts) {
   if (!kayba.isConfigured()) {
     return doRequest(opts);
@@ -21,7 +54,7 @@ async function orchestratorRequest(opts) {
     throw err;
   }
 }
-async function doRequest(opts, isRetry = false) {
+async function doRequest(opts, isRetry = false, rateLimitAttempt = 0) {
   const url = `${opts.baseUrl.replace(/\/$/, "")}${opts.path}`;
   const controller = new AbortController();
   const timeoutId = setTimeout(
@@ -64,7 +97,25 @@ async function doRequest(opts, isRetry = false) {
     if ((res.status === 401 || res.status === 403) && !isRetry && opts.onUnauthorized) {
       clearTimeout(timeoutId);
       const newToken = await opts.onUnauthorized();
-      return doRequest({ ...opts, accessToken: newToken }, true);
+      return doRequest({ ...opts, accessToken: newToken }, true, rateLimitAttempt);
+    }
+    const bodyCodeIsRateLimit = typeof dataObj?.code === "string" && /\bRATE_LIMIT\b/i.test(dataObj.code);
+    const isRateLimited = res.status === 429 || !res.ok && bodyCodeIsRateLimit;
+    if (isRateLimited) {
+      clearTimeout(timeoutId);
+      const maxWait = opts.rateLimitMaxRetryWaitMs ?? 3e4;
+      const maxRetries = opts.rateLimitMaxRetries ?? 1;
+      const retryAfter = parseRetryAfterMs(res.headers.get("Retry-After"), maxWait) ?? Math.min(maxWait, 1e3 * Math.pow(2, rateLimitAttempt));
+      const bodyMessage = typeof dataObj?.message === "string" ? dataObj.message : typeof dataObj?.error === "string" ? dataObj.error : `HTTP ${res.status}`;
+      if (rateLimitAttempt < maxRetries) {
+        await sleep(retryAfter);
+        return doRequest(opts, isRetry, rateLimitAttempt + 1);
+      }
+      throw new OrchestratorRateLimitError(
+        `RATE_LIMIT_EXCEEDED: ${bodyMessage}`,
+        retryAfter,
+        res.status
+      );
     }
     if (!res.ok) {
       const errBody = data && typeof data === "object" && !Array.isArray(data) ? data : null;
@@ -87,5 +138,6 @@ async function doRequest(opts, isRetry = false) {
 }
 
 export {
+  OrchestratorRateLimitError,
   orchestratorRequest
 };

package/dist/{chunk-NEMH5KB5.js → chunk-OKBHBUZ7.js}

@@ -1,5 +1,7 @@
 // src/session-manager.ts
 var TRADERCLAW_SESSION_TROUBLESHOOTING = "https://docs.traderclaw.ai/docs/installation#troubleshooting-session-expired-auth-errors-or-the-agent-logged-out";
+var TRADERCLAW_MANAGED_INSTALL_CONSOLE_PANEL_URL = "https://install.traderclaw.ai/panel";
+var TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT = `If you installed via install.traderclaw.ai's managed VPS console, re-authenticate in Panel \u2192 TraderClaw login (${TRADERCLAW_MANAGED_INSTALL_CONSOLE_PANEL_URL}), then openclaw gateway restart when convenient.`;
 var BS58_CHARS = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
 function b58Decode(str) {
   let num = BigInt(0);
@@ -357,7 +359,7 @@ var SessionManager = class _SessionManager {
       const walletPrivateKey = (await this.walletPrivateKeyProvider?.())?.trim();
       if (!walletPrivateKey) {
         throw new Error(
-          `Wallet proof required but the gateway cannot sign interactively \u2014 no wallet key is wired into this process. This account already has a wallet. On the host that runs OpenClaw (with a normal terminal / TTY), run: traderclaw login \u2014 complete wallet proof when prompted \u2014 then openclaw gateway restart. That persists new session tokens without putting a private key in the gateway configuration. Do not paste private keys into openclaw.json. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING}`
+          `Wallet proof required but the gateway cannot sign interactively \u2014 no wallet key is wired into this process. This account already has a wallet. On the host that runs OpenClaw (with a normal terminal / TTY), run: traderclaw login \u2014 complete wallet proof when prompted \u2014 then openclaw gateway restart. That persists new session tokens without putting a private key in the gateway configuration. Do not paste private keys into openclaw.json. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING} ${TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT}`
         );
       }
       walletPubKey = challenge.walletPublicKey || this.walletPublicKey || void 0;
@@ -387,7 +389,7 @@ var SessionManager = class _SessionManager {
     await this.unifiedRefresh();
     if (!this.accessToken) {
       throw new Error(
-        `Session expired and could not be refreshed. Re-authentication required. On the gateway host try: traderclaw login \u2014 then openclaw gateway restart. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING}`
+        `Session expired and could not be refreshed. Re-authentication required. On the gateway host try: traderclaw login \u2014 then openclaw gateway restart. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING} ${TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT}`
       );
     }
     return this.accessToken;
@@ -398,7 +400,7 @@ var SessionManager = class _SessionManager {
     await this.unifiedRefresh();
     if (!this.accessToken) {
       throw new Error(
-        `Session expired and could not be refreshed. Re-authentication required. On the gateway host try: traderclaw login \u2014 then openclaw gateway restart. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING}`
+        `Session expired and could not be refreshed. Re-authentication required. On the gateway host try: traderclaw login \u2014 then openclaw gateway restart. Troubleshooting: ${TRADERCLAW_SESSION_TROUBLESHOOTING} ${TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT}`
       );
     }
     return this.accessToken;
@@ -541,5 +543,7 @@ var SessionManager = class _SessionManager {
 };
 
 export {
+  TRADERCLAW_MANAGED_INSTALL_CONSOLE_PANEL_URL,
+  TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT,
   SessionManager
 };

package/dist/index.js

@@ -4,8 +4,9 @@ import {
   writeRefreshTokenToOpenclawAtomic
 } from "./chunk-IAQC34O7.js";
 import {
-  SessionManager
-} from "./chunk-NEMH5KB5.js";
+  SessionManager,
+  TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT
+} from "./chunk-OKBHBUZ7.js";
 import {
   looksLikeTelegramChatId,
   resolveTelegramRecipientToChatId
@@ -29,7 +30,7 @@ import {
 } from "./chunk-R24UDHQG.js";
 import {
   orchestratorRequest
-} from "./chunk-6GSGHMUH.js";
+} from "./chunk-E7QOPXSU.js";
 import {
   IntelligenceLab
 } from "./chunk-FBS5FGW2.js";
@@ -774,6 +775,26 @@ function registerWebFetchTool(api, Type2, logPrefix, options) {
 }
 
 // index.ts
+var SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY = Symbol.for(
+  "openclaw.solana-trader.lifecycle.v1"
+);
+var __solanaTraderGlobalSingletonHolder = globalThis;
+function __solanaTraderDisposePreviousLifecycle(logger) {
+  const prev = __solanaTraderGlobalSingletonHolder[SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY];
+  if (!prev) return;
+  __solanaTraderGlobalSingletonHolder[SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY] = void 0;
+  try {
+    logger?.info("[solana-trader] Disposing previous plugin lifecycle before re-register");
+    prev.dispose();
+  } catch (err) {
+    logger?.warn(
+      `[solana-trader] Previous lifecycle dispose error: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function __solanaTraderSetCurrentLifecycle(lc) {
+  __solanaTraderGlobalSingletonHolder[SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY] = lc;
+}
 var TRADERCLAW_WALLET_PRIVATE_KEY_ENV = "TRADERCLAW_WALLET_PRIVATE_KEY";
 function walletPrivateKeyFromPluginConfigRecord(obj) {
   const w = typeof obj.walletPrivateKey === "string" ? obj.walletPrivateKey.trim() : "";
@@ -922,6 +943,8 @@ var solanaTraderPlugin = {
   name: "Solana Trader",
   description: "Autonomous Solana memecoin trading agent \u2014 V1-Upgraded with intelligence lab, tool envelopes, prompt scrubbing, and split skill architecture",
   register(api) {
+    __solanaTraderDisposePreviousLifecycle(api.logger);
+    const __solanaTraderDisposers = [];
     const pluginConfigRaw = api.pluginConfig && typeof api.pluginConfig === "object" && !Array.isArray(api.pluginConfig) ? api.pluginConfig : {};
     const walletPrivateKeyFromPluginJsonOnly = walletPrivateKeyFromPluginConfigRecord(pluginConfigRaw);
     const config = parseConfig(api.pluginConfig);
@@ -932,7 +955,7 @@ var solanaTraderPlugin = {
     }
     if (!apiKey && !config.refreshToken) {
       api.logger.error(
-        "[solana-trader] apiKey or refreshToken is required. Tell the user to run on their machine: traderclaw setup --signup (or traderclaw signup) for a new account, or traderclaw setup / traderclaw login if they already have an API key. The agent cannot sign up or edit credentials."
+        `[solana-trader] apiKey or refreshToken is required. Tell the user to run on their machine: traderclaw setup --signup (or traderclaw signup) for a new account, or traderclaw setup / traderclaw login if they already have an API key. The agent cannot sign up or edit credentials. ${TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT}`
       );
       return;
     }
@@ -1049,6 +1072,12 @@ var solanaTraderPlugin = {
         error: (msg) => api.logger.error(`[solana-trader] ${msg}`)
       }
     });
+    __solanaTraderDisposers.push(() => {
+      try {
+        sessionManager.destroy();
+      } catch {
+      }
+    });
     const onUnauthorized = async () => {
       api.logger.warn("[solana-trader] Received 401 \u2014 refreshing session...");
       return sessionManager.handleUnauthorized();
@@ -2434,6 +2463,12 @@ ${notes}
         error: (msg) => api.logger.error(`[solana-trader] ${msg}`)
       }
     });
+    __solanaTraderDisposers.push(() => {
+      try {
+        bitqueryStreamManager.close();
+      } catch {
+      }
+    });
     api.registerTool({
       name: "solana_bitquery_subscribe",
       description: "Subscribe to a managed real-time Bitquery data stream. The orchestrator manages the WebSocket connection and broadcasts events. Available templates: realtimeTokenPricesSolana, ohlc1s, dexPoolLiquidityChanges, pumpFunTokenCreation, pumpFunTrades, pumpSwapTrades, raydiumNewPools. Returns a subscriptionId for tracking. Pass agentId to enable event-to-agent forwarding \u2014 orchestrator delivers each event to your Gateway via /v1/responses in addition to normal WS delivery. Subscriptions expire after 24h and emit subscription_expiring/subscription_expired events. See websocket-streaming.md in the solana-trader skill for the full message contract and usage patterns.",
@@ -2567,6 +2602,12 @@ ${notes}
         error: (msg) => api.logger.error(`[solana-trader] ${msg}`)
       }
     });
+    __solanaTraderDisposers.push(() => {
+      try {
+        void alphaStreamManager.unsubscribe().catch(() => void 0);
+      } catch {
+      }
+    });
     let startupGateRunning = null;
     let startupGateState = { ok: false, ts: 0, steps: [] };
     let lastForwardProbeState = null;
@@ -4296,6 +4337,12 @@ Context compaction triggered. STATE.md synced from last persisted state. Decisio
       }
     );
     let solanaTraderSessionWatchdogTimer = null;
+    __solanaTraderDisposers.push(() => {
+      if (solanaTraderSessionWatchdogTimer !== null) {
+        clearInterval(solanaTraderSessionWatchdogTimer);
+        solanaTraderSessionWatchdogTimer = null;
+      }
+    });
     api.registerService({
       id: "solana-trader-session",
       start: async () => {
@@ -4310,7 +4357,7 @@ Context compaction triggered. STATE.md synced from last persisted state. Decisio
             `[solana-trader] Session initialization failed: ${err instanceof Error ? err.message : String(err)}`
           );
           api.logger.error(
-            "[solana-trader] Trading tools will fail until session is established. User should run on this machine: traderclaw login (after logout) or traderclaw setup / traderclaw signup for a new account. Wallet proof uses local signing only \u2014 private key never leaves this system."
+            `[solana-trader] Trading tools will fail until session is established. User should run on this machine: traderclaw login (after logout) or traderclaw setup / traderclaw signup for a new account. Wallet proof uses local signing only \u2014 private key never leaves this system. ${TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT}`
           );
           return;
         }
@@ -4546,6 +4593,16 @@ Context compaction triggered. STATE.md synced from last persisted state. Decisio
     api.logger.info(
       `[solana-trader] V1-Upgraded-Public: Registered ${totalToolCount} tools (${baseToolCount} base + ${intelligenceToolCount} intelligence + ${webFetchCount} web_fetch = ${totalRegistered} Solana + ${xToolCount} X/Twitter read-only) for walletId ${walletId} (session auth mode)`
     );
+    __solanaTraderSetCurrentLifecycle({
+      dispose: () => {
+        for (let i = __solanaTraderDisposers.length - 1; i >= 0; i--) {
+          try {
+            __solanaTraderDisposers[i]();
+          } catch {
+          }
+        }
+      }
+    });
   }
 };
 var index_default = solanaTraderPlugin;

package/dist/src/http-client.js

@@ -1,6 +1,8 @@
 import {
+  OrchestratorRateLimitError,
   orchestratorRequest
-} from "../chunk-6GSGHMUH.js";
+} from "../chunk-E7QOPXSU.js";
 export {
+  OrchestratorRateLimitError,
   orchestratorRequest
 };

package/dist/src/session-manager.js

@@ -1,6 +1,10 @@
 import {
-  SessionManager
-} from "../chunk-NEMH5KB5.js";
+  SessionManager,
+  TRADERCLAW_MANAGED_INSTALL_CONSOLE_PANEL_URL,
+  TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT
+} from "../chunk-OKBHBUZ7.js";
 export {
-  SessionManager
+  SessionManager,
+  TRADERCLAW_MANAGED_INSTALL_CONSOLE_PANEL_URL,
+  TRADERCLAW_MANAGED_INSTALL_LOGIN_HINT
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-traderclaw",
-  "version": "1.0.139",
+  "version": "1.0.141",
   "description": "TraderClaw V1-Upgraded — Solana trading for OpenClaw with intelligence lab, tool envelopes, prompt scrubbing, read-only X social intel, and split skill docs",
   "type": "module",
   "main": "./dist/index.js",