robinhood-chain-sdk 0.1.0

package/dist/stream.js

@@ -0,0 +1,225 @@
+/**
+ * Real-time WebSocket streaming client for Robinhood Chain (chain id 4663).
+ *
+ * Wraps the connect → token → subscribe → event loop with auto-reconnect,
+ * 24h-token auto-refresh, heartbeat liveness, and typed events, so consumers
+ * never hand-roll connection management. Obtain one via `client.stream.connect()`.
+ *
+ * Works in Node (global `WebSocket` on Node 22+, else lazily imports the
+ * optional `ws` package) and the browser (native WebSocket). Zero required deps.
+ */
+async function resolveWebSocket(override) {
+    if (override)
+        return override;
+    // Prefer the `ws` package in Node: it exposes terminate() for an immediate
+    // socket teardown, so close() lets short-lived processes exit. The global
+    // (undici) WebSocket on Node 22+ keeps its TLS socket open after close() —
+    // it has no terminate() and no reachable socket handle — which hangs the
+    // event loop. In the browser this import rejects and we fall back to the
+    // platform's native WebSocket.
+    try {
+        const mod = (await import("ws"));
+        const impl = mod.default ?? mod.WebSocket;
+        if (impl)
+            return impl;
+    }
+    catch {
+        /* not Node, or `ws` not installed — fall back to the platform WebSocket */
+    }
+    const g = globalThis.WebSocket;
+    if (g)
+        return g;
+    throw new Error("No WebSocket implementation available. On Node < 22, install `ws` (npm i ws) or pass { WebSocketImpl }.");
+}
+const OPEN = 1;
+export class RobinhoodStream {
+    constructor(opts) {
+        this.ws = null;
+        this.listeners = new Map();
+        this.desired = { channels: new Set(), filters: {} };
+        this.closedByUser = false;
+        this.attempt = 0;
+        this.hbTimer = null;
+        this.reconnectTimer = null;
+        this.connecting = false;
+        this.opts = {
+            getToken: opts.getToken,
+            autoReconnect: opts.autoReconnect ?? true,
+            maxBackoffMs: opts.maxBackoffMs ?? 30000,
+            heartbeatTimeoutMs: opts.heartbeatTimeoutMs ?? 90000,
+            WebSocketImpl: opts.WebSocketImpl,
+        };
+    }
+    /** Register a handler. Use an event name, `"*"` for every event, or a lifecycle event. */
+    on(event, fn) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        this.listeners.get(event).add(fn);
+        return this;
+    }
+    /** Remove a handler (or all handlers for an event when `fn` is omitted). */
+    off(event, fn) {
+        if (!fn)
+            this.listeners.delete(event);
+        else
+            this.listeners.get(event)?.delete(fn);
+        return this;
+    }
+    emit(event, data, evt) {
+        const set = this.listeners.get(event);
+        if (set)
+            for (const fn of set) {
+                try {
+                    fn(data, evt);
+                }
+                catch { /* user handler */ }
+            }
+    }
+    /** Subscribe to one or more channels (connects on first call). Optional server-side filters. */
+    subscribe(channels, filters) {
+        for (const c of channels)
+            this.desired.channels.add(c);
+        if (filters)
+            this.desired.filters = { ...this.desired.filters, ...filters };
+        if (this.ws && this.ws.readyState === OPEN)
+            this.sendSubscribe();
+        else
+            void this.connect();
+        return this;
+    }
+    /** Stop receiving the given channels. */
+    unsubscribe(channels) {
+        for (const c of channels)
+            this.desired.channels.delete(c);
+        if (this.ws && this.ws.readyState === OPEN) {
+            this.ws.send(JSON.stringify({ type: "unsubscribe", channels }));
+        }
+        return this;
+    }
+    /** Open the connection (also called implicitly by subscribe). */
+    async connect() {
+        if (this.connecting || (this.ws && this.ws.readyState === OPEN))
+            return;
+        this.closedByUser = false;
+        this.connecting = true;
+        try {
+            const [WS, token] = await Promise.all([
+                resolveWebSocket(this.opts.WebSocketImpl),
+                this.opts.getToken(),
+            ]);
+            const url = `${token.ws_url}?token=${encodeURIComponent(token.token)}`;
+            const ws = new WS(url);
+            this.ws = ws;
+            ws.onopen = () => {
+                this.attempt = 0;
+                this.resetHeartbeat();
+                if (this.desired.channels.size > 0)
+                    this.sendSubscribe();
+                this.emit("open", undefined);
+            };
+            ws.onmessage = (ev) => this.handleMessage(ev.data);
+            ws.onerror = (err) => this.emit("error", err instanceof Error ? err : new Error("WebSocket error"));
+            ws.onclose = (ev) => {
+                this.clearHeartbeat();
+                this.ws = null;
+                this.emit("close", { code: ev?.code, reason: ev?.reason });
+                if (!this.closedByUser && this.opts.autoReconnect)
+                    this.scheduleReconnect();
+            };
+        }
+        catch (err) {
+            this.emit("error", err);
+            if (!this.closedByUser && this.opts.autoReconnect)
+                this.scheduleReconnect();
+        }
+        finally {
+            this.connecting = false;
+        }
+    }
+    /** Close the connection and stop reconnecting. */
+    close() {
+        this.closedByUser = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.clearHeartbeat();
+        const sock = this.ws;
+        this.ws = null;
+        try {
+            // `ws` package: terminate() destroys the underlying socket immediately so
+            // the process can exit. Native/undici WebSocket has no terminate() — fall
+            // back to a graceful close().
+            if (typeof sock?.terminate === "function")
+                sock.terminate();
+            else
+                sock?.close(1000, "client closed");
+        }
+        catch { /* ignore */ }
+    }
+    sendSubscribe() {
+        const channels = Array.from(this.desired.channels);
+        if (channels.length === 0)
+            return;
+        const msg = { type: "subscribe", channels };
+        if (Object.keys(this.desired.filters).length > 0)
+            msg.filters = this.desired.filters;
+        this.ws?.send(JSON.stringify(msg));
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            const text = typeof raw === "string" ? raw : String(raw);
+            msg = JSON.parse(text);
+        }
+        catch {
+            this.emit("error", new Error("Failed to parse stream message"));
+            return;
+        }
+        if (msg.type === "heartbeat") {
+            this.resetHeartbeat();
+            this.emit("heartbeat", msg.ts);
+            return;
+        }
+        if (msg.type === "connected") {
+            return;
+        }
+        if (msg.type === "subscribed") {
+            this.emit("subscribed", msg.channels);
+            return;
+        }
+        if (msg.channel && msg.event) {
+            const evt = msg;
+            this.emit(evt.event, evt.data, evt);
+            this.emit("*", evt.data, evt);
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const base = Math.min(1000 * 2 ** this.attempt, this.opts.maxBackoffMs);
+        const delay = base / 2 + Math.floor((base / 2) * Math.random());
+        this.attempt++;
+        this.emit("reconnect", { attempt: this.attempt, delayMs: delay });
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.connect();
+        }, delay);
+    }
+    resetHeartbeat() {
+        this.clearHeartbeat();
+        this.hbTimer = setTimeout(() => {
+            try {
+                this.ws?.close(4000, "heartbeat timeout");
+            }
+            catch { /* ignore */ }
+        }, this.opts.heartbeatTimeoutMs);
+    }
+    clearHeartbeat() {
+        if (this.hbTimer) {
+            clearTimeout(this.hbTimer);
+            this.hbTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+// AUTO-GENERATED by scripts/gen-version.mjs — do not edit by hand.
+// Regenerated from package.json on every `npm run build` (prebuild hook).
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/llms.txt

@@ -0,0 +1,71 @@
+# robinhood-chain-sdk
+
+> Official TypeScript SDK for the Robinhood Chain (chain id 4663) API — EVM-native on-chain trading intelligence.
+
+## What is Robinhood Chain?
+
+Robinhood Chain (RHC) is an Arbitrum Orbit L2, chain id 4663. MadeOnSol (https://madeonsol.com/robinhood) runs a self-hosted node and exposes EVM-native intelligence over the same paid v1 API and the same `msk_` API key as the Solana product — bundled into every tier at no extra cost. All addresses are lowercase `0x`, amounts are `eth_amount`, transactions are `tx_hash`, and blocks are `block_number`.
+
+- **KOL Trades**: live buy/sell feed from tracked Solana KOLs' verified EVM wallets, a KOL activity leaderboard, consensus "hot tokens" (2+ KOLs), and per-KOL profiles.
+- **Tokens**: token discovery, per-token snapshot (price/MC/FDV/peak/drawdown, deployer reputation, KOL activity, pools), 1-minute OHLC candles, KOL consensus (`net_flow_eth`), early-buyer quality (0–100), and same-block launch-bundle detection.
+- **DEX Trade Tape**: every Uniswap v2/v3/v4 swap with the real trader EOA (tx.from), gas/ordering for MEV analysis, and KOL/deployer flags.
+- **Deployer Hunter**: reputation leaderboard + per-deployer profiles (graduation = $40K peak MC, runner = $100K).
+- **Alpha Wallets**: smart-money ranking by realized on-chain performance (net ETH, win rate, memecoin share), with bot-fleet flagging.
+- **Streaming**: managed WebSocket for `rhc:kol_trades` and `rhc:trades`.
+
+## Installation
+
+```
+npm install robinhood-chain-sdk
+```
+
+## Authentication
+
+Get a free API key at https://madeonsol.com/developer (starts with `msk_`).
+
+```typescript
+import { RobinhoodClient } from "robinhood-chain-sdk";
+const client = new RobinhoodClient({ apiKey: "msk_your_api_key_here" });
+```
+
+## Methods (all 14 endpoints)
+
+### KOL (client.kol) — BASIC
+- `client.kol.feed(params?)` — GET /rhc/kol/feed — live KOL trade feed
+- `client.kol.leaderboard(params?)` — GET /rhc/kol/leaderboard — KOL activity leaderboard
+- `client.kol.hotTokens(params?)` — GET /rhc/kol/hot-tokens — tokens bought by 2+ KOLs
+- `client.kol.wallet(wallet)` — GET /rhc/kol/{wallet} — single KOL profile
+
+### DEX tape (client.trades) — PRO+
+- `client.trades(params?)` — GET /rhc/trades — Uniswap v2/v3/v4 trade tape
+
+### Tokens (client.tokens)
+- `client.tokens.list(params?)` — GET /rhc/tokens — token discovery (PRO+)
+- `client.tokens.get(address)` — GET /rhc/tokens/{address} — token snapshot (BASIC)
+- `client.tokens.candles(address, params?)` — GET /rhc/tokens/{address}/candles — 1m OHLC (PRO+)
+- `client.tokens.kolConsensus(address)` — GET /rhc/tokens/{address}/kol-consensus (PRO+)
+- `client.tokens.buyerQuality(address)` — GET /rhc/tokens/{address}/buyer-quality (BASIC)
+- `client.tokens.bundle(address)` — GET /rhc/tokens/{address}/bundle — launch-bundle detection (BASIC)
+
+### Deployer Hunter (client.deployerHunter) — BASIC
+- `client.deployerHunter.leaderboard(params?)` — GET /rhc/deployer-hunter/leaderboard
+- `client.deployerHunter.profile(address)` — GET /rhc/deployer-hunter/{address}
+
+### Alpha Wallets (client.alphaWallets) — PRO+
+- `client.alphaWallets(params?)` — GET /rhc/alpha-wallets — smart-money ranking
+
+### Streaming (client.stream) — PRO+
+- `client.stream.getToken()` — POST /stream/token — 24h WS token
+- `client.stream.connect()` — managed WebSocket (channels: rhc:kol_trades, rhc:trades)
+
+## Error handling
+
+All methods throw `RobinhoodError` with `.message`, `.status`, `.body`, and `.requestId` (`_rid`). 429 and 5xx responses are retried automatically with backoff.
+
+## Links
+
+- Robinhood Chain: https://madeonsol.com/robinhood
+- Pricing: https://madeonsol.com/pricing
+- API docs: https://madeonsol.com/api-docs
+- npm: https://www.npmjs.com/package/robinhood-chain-sdk
+- GitHub: https://github.com/madeonsol/robinhood-chain-sdk

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "robinhood-chain-sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the Robinhood Chain (chain id 4663) API — EVM-native on-chain trading intelligence: live KOL trades, token discovery & bundles, the DEX trade tape, OHLC candles, deployer reputation, and smart-money wallets. Zero dependencies.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "llms.txt"
+  ],
+  "scripts": {
+    "gen-version": "node scripts/gen-version.mjs",
+    "prebuild": "node scripts/gen-version.mjs",
+    "build": "tsc",
+    "test": "tsc -p examples/tsconfig.json",
+    "route-parity": "node scripts/route-parity-check.mjs",
+    "preflight": "bash ./scripts/preflight-publish.sh",
+    "prepublishOnly": "npm run preflight && npm run build"
+  },
+  "keywords": [
+    "robinhood chain",
+    "robinhood-chain",
+    "rhc",
+    "robinhood chain api",
+    "robinhood chain sdk",
+    "robinhood-chain-sdk",
+    "chain-4663",
+    "chain-id-4663",
+    "evm",
+    "arbitrum-orbit",
+    "kol",
+    "kol-tracker",
+    "deployer-hunter",
+    "smart-money",
+    "alpha-wallets",
+    "memecoin",
+    "memecoin-tracker",
+    "defi",
+    "web3",
+    "trading",
+    "trade-stream",
+    "dex",
+    "sdk",
+    "api",
+    "madeonsol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/madeonsol/robinhood-chain-sdk.git"
+  },
+  "homepage": "https://madeonsol.com/robinhood",
+  "bugs": {
+    "url": "https://github.com/madeonsol/robinhood-chain-sdk/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "ws": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "funding": "https://madeonsol.com"
+}