@raintree-technology/perps 0.1.0

package/dist/server/subscriptions.js

@@ -0,0 +1,114 @@
+import { WebSocketTransport, SubscriptionClient, InfoClient, HttpTransport, } from "@nktkas/hyperliquid";
+import WebSocket from "ws";
+export class SubscriptionManager {
+    wsTransport;
+    subscriptionClient;
+    infoClient;
+    cache;
+    subscriptions = [];
+    perpMetaInterval = null;
+    spotMetaInterval = null;
+    isTestnet;
+    log;
+    constructor(cache, isTestnet, log) {
+        this.cache = cache;
+        this.isTestnet = isTestnet;
+        this.log = log;
+        // Create WebSocket transport for subscriptions
+        // Need to provide WebSocket constructor for Node.js environment
+        this.wsTransport = new WebSocketTransport({
+            isTestnet,
+            reconnect: { WebSocket: WebSocket },
+        });
+        this.subscriptionClient = new SubscriptionClient({ transport: this.wsTransport });
+        // Create HTTP transport for polling perpMeta
+        const httpTransport = new HttpTransport({ isTestnet });
+        this.infoClient = new InfoClient({ transport: httpTransport });
+    }
+    async start() {
+        this.log("Waiting for WebSocket connection...");
+        await this.wsTransport.ready();
+        this.log("WebSocket connected");
+        // Subscribe to allMids
+        this.log("Subscribing to allMids...");
+        const midsSub = await this.subscriptionClient.allMids({ dex: "ALL_DEXS" }, (event) => {
+            this.cache.setAllMids(event.mids);
+        });
+        this.subscriptions.push(midsSub);
+        this.log("Subscribed to allMids");
+        // Subscribe to allDexsAssetCtxs
+        this.log("Subscribing to allDexsAssetCtxs...");
+        const ctxsSub = await this.subscriptionClient.allDexsAssetCtxs((event) => {
+            this.cache.setAllDexsAssetCtxs(event);
+        });
+        this.subscriptions.push(ctxsSub);
+        this.log("Subscribed to allDexsAssetCtxs");
+        // Subscribe to spotAssetCtxs
+        this.log("Subscribing to spotAssetCtxs...");
+        const spotCtxsSub = await this.subscriptionClient.spotAssetCtxs((event) => {
+            this.cache.setSpotAssetCtxs(event);
+        });
+        this.subscriptions.push(spotCtxsSub);
+        this.log("Subscribed to spotAssetCtxs");
+        // Poll allPerpMetas every 60 seconds (it doesn't change often)
+        await this.fetchPerpMetas();
+        this.perpMetaInterval = setInterval(() => {
+            this.fetchPerpMetas().catch((err) => {
+                this.log(`Error fetching perpMetas: ${err}`);
+            });
+        }, 60_000);
+        this.log("Started perpMetas polling (60s interval)");
+        // Poll spotMeta every 60 seconds (it doesn't change often)
+        await this.fetchSpotMeta();
+        this.spotMetaInterval = setInterval(() => {
+            this.fetchSpotMeta().catch((err) => {
+                this.log(`Error fetching spotMeta: ${err}`);
+            });
+        }, 60_000);
+        this.log("Started spotMeta polling (60s interval)");
+    }
+    async fetchPerpMetas() {
+        const meta = await this.infoClient.allPerpMetas();
+        this.cache.setAllPerpMetas(meta);
+        this.log("Updated perpMetas cache");
+    }
+    async fetchSpotMeta() {
+        const meta = await this.infoClient.spotMeta();
+        this.cache.setSpotMeta(meta);
+        this.log("Updated spotMeta cache");
+    }
+    async stop() {
+        // Stop perpMeta polling
+        if (this.perpMetaInterval) {
+            clearInterval(this.perpMetaInterval);
+            this.perpMetaInterval = null;
+        }
+        // Stop spotMeta polling
+        if (this.spotMetaInterval) {
+            clearInterval(this.spotMetaInterval);
+            this.spotMetaInterval = null;
+        }
+        // Unsubscribe from all WebSocket subscriptions
+        for (const sub of this.subscriptions) {
+            try {
+                await sub.unsubscribe();
+            }
+            catch {
+                // Ignore errors during unsubscribe
+            }
+        }
+        this.subscriptions = [];
+        // Close WebSocket transport
+        try {
+            await this.wsTransport.close();
+        }
+        catch {
+            // Ignore errors during close
+        }
+        this.log("Subscriptions stopped");
+    }
+    isConnected() {
+        // ReconnectingWebSocket.OPEN = 1
+        return this.wsTransport.socket.readyState === 1;
+    }
+}

package/package.json

@@ -0,0 +1,124 @@
+{
+  "name": "@raintree-technology/perps",
+  "version": "0.1.0",
+  "description": "Universal CLI for perpetual DEXes",
+  "author": "Raintree Technology (https://raintree.technology)",
+  "contributors": [
+    "Zachary Roth (https://zacharyr0th.com)"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raintree-technology/perps.git"
+  },
+  "homepage": "https://github.com/raintree-technology/perps#readme",
+  "bugs": {
+    "url": "https://github.com/raintree-technology/perps/issues"
+  },
+  "keywords": [
+    "perps",
+    "perpetuals",
+    "perpetual-dex",
+    "hyperliquid",
+    "aevo",
+    "orderly",
+    "paradex",
+    "decibel",
+    "cli",
+    "dex",
+    "defi",
+    "trading",
+    "crypto"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "default": "./dist/adapters/index.js"
+    },
+    "./adapters/*.js": {
+      "types": "./dist/adapters/*.d.ts",
+      "default": "./dist/adapters/*.js"
+    },
+    "./lib/*.js": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "bin": {
+    "perps": "dist/index.js",
+    "perps-server": "dist/server/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
+    "smoke:network": "node scripts/smoke.mjs --network",
+    "agent:telemetry:daily": "node scripts/agent/daily-telemetry-report.mjs",
+    "doctor": "node scripts/smoke.mjs --network",
+    "testnet:creds": "pnpm dev setup wizard --yes --mode both --chains evm,aptos,starknet --export-env --force",
+    "testnet:bootstrap": "pnpm dev setup wizard --yes --mode both --chains evm,aptos,starknet --fund --export-env --force",
+    "testnet:creds:print": "pnpm dev setup wizard --yes --mode both --chains evm,aptos,starknet --dry-run --json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "parity:gate": "vitest run src/adapters/parity-matrix.test.ts src/adapters/contracts.test.ts",
+    "parity:report": "tsx scripts/adapter-parity-report.ts",
+    "release:canary:plan": "node scripts/release-canary-plan.mjs",
+    "lint": "biome lint src scripts",
+    "lint:fix": "biome lint --write src scripts",
+    "publint": "publint",
+    "attw": "attw --pack . --profile esm-only",
+    "pack:check": "npm pack --dry-run",
+    "prepublishOnly": "npm run build && npm run publint && npm run attw"
+  },
+  "dependencies": {
+    "@aptos-labs/ts-sdk": "^1.33.1",
+    "@inquirer/prompts": "^8.2.0",
+    "@nktkas/hyperliquid": "^0.30.2",
+    "better-sqlite3": "^12.6.2",
+    "ccxt": "^4.5.39",
+    "commander": "^12.1.0",
+    "ink": "^5.0.1",
+    "ink-spinner": "^5.0.0",
+    "@noble/curves": "^1.9.1",
+    "@noble/hashes": "^1.8.0",
+    "near-api-js": "^7.1.1",
+    "pmxtjs": "^2.14.1",
+    "react": "^18.3.1",
+    "starknet": "^9.2.1",
+    "viem": "^2.21.0",
+    "ws": "^8.19.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@biomejs/biome": "^1.9.4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.3",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "publint": "^0.3.17",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@9.15.0+sha512.76e2379760a4328ec4415815bcd6628dee727af3779aaa4c914e3944156c4299921a89f976381ee107d41f12cfa4b66681ca9c718f0668fa0831ed4c6d8ba56c"
+}