solana-traderclaw 1.0.19

package/dist/src/alpha-buffer.js

@@ -0,0 +1,6 @@
+import {
+  AlphaBuffer
+} from "../chunk-3UQIQJPQ.js";
+export {
+  AlphaBuffer
+};

package/dist/src/alpha-ws.js

@@ -0,0 +1,6 @@
+import {
+  AlphaStreamManager
+} from "../chunk-3YPZOXWE.js";
+export {
+  AlphaStreamManager
+};

package/dist/src/http-client.js

@@ -0,0 +1,6 @@
+import {
+  orchestratorRequest
+} from "../chunk-T4YWGIIR.js";
+export {
+  orchestratorRequest
+};

package/dist/src/session-manager.js

@@ -0,0 +1,6 @@
+import {
+  SessionManager
+} from "../chunk-RQZVD6TH.js";
+export {
+  SessionManager
+};

package/openclaw.plugin.json

@@ -0,0 +1,104 @@
+{
+  "id": "solana-trader",
+  "name": "Solana Trader",
+  "description": "Autonomous Solana memecoin trading agent plugin — connects OpenClaw to a trading orchestrator for scanning, analysis, risk management, and execution.",
+  "skills": ["skills/solana-trader"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["orchestratorUrl"],
+    "properties": {
+      "orchestratorUrl": {
+        "type": "string",
+        "description": "Base URL of the trading orchestrator API"
+      },
+      "walletId": {
+        "type": "string",
+        "description": "Wallet ID for this agent's trading account (UUID string from the orchestrator API)"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "API key from traderclaw signup / setup or https://traderclaw.ai/register — set on this machine via CLI, not by the agent"
+      },
+      "externalUserId": {
+        "type": "string",
+        "description": "Optional external user ID for CLI signup (traderclaw signup); auto-generated if omitted"
+      },
+      "refreshToken": {
+        "type": "string",
+        "description": "Refresh token from last session (auto-populated after authentication)"
+      },
+      "walletPublicKey": {
+        "type": "string",
+        "description": "Solana wallet public key (auto-populated after session establishment)"
+      },
+      "apiTimeout": {
+        "type": "integer",
+        "minimum": 1000,
+        "maximum": 120000,
+        "default": 80000,
+        "description": "HTTP request timeout in milliseconds"
+      },
+      "agentId": {
+        "type": "string",
+        "description": "Agent ID for event-to-agent forwarding (e.g., 'main'). When set, subscriptions automatically include this agentId so the orchestrator forwards stream events to your Gateway via /v1/responses."
+      },
+      "gatewayBaseUrl": {
+        "type": "string",
+        "description": "Public HTTPS URL of your OpenClaw Gateway used by orchestrator event forwarding."
+      },
+      "gatewayToken": {
+        "type": "string",
+        "description": "Bearer token used by orchestrator when calling your Gateway /v1/responses."
+      }
+    }
+  },
+  "uiHints": {
+    "orchestratorUrl": {
+      "label": "Orchestrator URL",
+      "placeholder": "https://api.traderclaw.ai"
+    },
+    "walletId": {
+      "label": "Wallet ID",
+      "placeholder": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+    },
+    "apiKey": {
+      "label": "API Key",
+      "placeholder": "oc_xxx",
+      "sensitive": true
+    },
+    "externalUserId": {
+      "label": "External User ID",
+      "placeholder": "agent_user_123",
+      "advanced": true
+    },
+    "refreshToken": {
+      "label": "Refresh Token",
+      "sensitive": true,
+      "advanced": true
+    },
+    "walletPublicKey": {
+      "label": "Wallet Public Key",
+      "advanced": true
+    },
+    "apiTimeout": {
+      "label": "API Timeout (ms)",
+      "advanced": true
+    },
+    "agentId": {
+      "label": "Agent ID",
+      "placeholder": "main",
+      "advanced": true
+    },
+    "gatewayBaseUrl": {
+      "label": "Gateway Base URL",
+      "placeholder": "https://gateway.example.com",
+      "advanced": true
+    },
+    "gatewayToken": {
+      "label": "Gateway Token",
+      "sensitive": true,
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "solana-traderclaw",
+  "version": "1.0.19",
+  "description": "TraderClaw V1 — autonomous Solana memecoin trading agent plugin for OpenClaw",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "bin": {
+    "traderclaw": "bin/traderclaw.cjs"
+  },
+  "files": [
+    "dist/",
+    "bin/*.mjs",
+    "bin/*.cjs",
+    "skills/",
+    "config/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node build.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "traderclaw",
+    "openclaw",
+    "solana",
+    "memecoin",
+    "trading",
+    "agent",
+    "plugin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "0.34.48",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0",
+    "esbuild": "^0.24.0"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}

package/skills/solana-trader/HEARTBEAT.md

@@ -0,0 +1,51 @@
+# Trading Heartbeat
+
+**Installer:** `traderclaw install --wizard` and `traderclaw setup` copy this file into your OpenClaw **agent workspace root** (default `~/.openclaw/workspace/HEARTBEAT.md`). OpenClaw only loads `HEARTBEAT.md` from that directory (next to `AGENTS.md`), not from a nested `.openclaw` folder or from the plugin package alone. If you already have a non-empty `HEARTBEAT.md` there, the installer leaves it unchanged.
+
+Execute your full trading cycle from your solana-trader skill on every heartbeat. Never skip. Never reply HEARTBEAT_OK.
+
+## First: Check Startup State
+
+Read MEMORY.md (auto-loaded). If it is empty or missing your wallet/tier/strategy info, you have NOT completed the Mandatory Startup Sequence yet. Run it now before doing anything else (see SKILL.md § Mandatory Startup Sequence).
+
+If startup is already complete (MEMORY.md has your wallet, tier, mode, strategy version), proceed to the trading cycle below.
+
+## Memory Context Load (every cycle, before trading)
+
+1. **Layer 1 — MEMORY.md** (already in context): Read your durable state — tier, wallet, mode, strategy version, watchlist, regime canary, permanent learnings.
+2. **Layer 2 — Daily log**: Check today's `memory/YYYY-MM-DD.md` (auto-loaded) to know what scans, trades, and analysis already happened today. Do not repeat work already done this cycle.
+3. **Layer 3 — Server-side memory**: Call `solana_memory_search` for:
+   - `"source_reputation"` — know which alpha sources to trust before processing signals
+   - `"strategy_drift_warning"` — any recent drift alerts to be aware of
+   - `"pre_trade_rationale"` — your last few trade decisions for strategy integrity check
+   - `"meta_rotation"` — current hot vs cooling narratives
+
+## Trading Cycle
+
+Run the full fast loop from your skill:
+- Step 0: Interrupt check — positions, kill switch, capital, strategy integrity, dead money
+- Step 1: Scan for opportunities
+- Step 1.5: Poll alpha signals buffer, check subscriptions for new events
+- Step 2: Analyze candidates (token snapshot, holders, flows, liquidity, risk, social/community enrichment if X credentials configured)
+- Step 3: Risk assessment and scoring
+- Step 4: Decision — apply strategy weights, check memory for past outcomes on this token
+- Step 5: Execute trade (pre-trade journal FIRST, then execute)
+- Step 6: Monitor open positions for SL/TP triggers, social exhaustion check on held positions (if X configured)
+- Step 7: Exit management — execute exits, post-trade review
+
+## Memory Write-Back (after trading)
+
+1. **Layer 1**: `solana_state_save` if any durable state changed (strategy weights, watchlist, regime, counters)
+2. **Layer 2**: `solana_daily_log` with session summary (what you scanned, signals processed, trades made, positions monitored)
+3. **Layer 3**: `solana_memory_write` for any new lessons, reputation observations, pre-trade rationale, or trade reviews
+
+## Report to User
+
+After every cycle, send a brief summary to the user:
+- What you scanned and how many candidates were found
+- Any alpha signals processed and their scores
+- Trades executed (entries/exits) with token, size, and rationale
+- Open position status (PnL, any SL/TP approaching)
+- If nothing qualified for a trade, say what you checked and why nothing passed
+
+Never run a silent cycle. Always communicate what you did.