@solbuilder_io/rpc-health 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+# @solbuilder_io/rpc-health
+
+Lightweight RPC endpoint health checker for multiple blockchains.
+
+## Install
+```bash
+npm install @solbuilder_io/rpc-health
+```
+
+## Usage
+```javascript
+const rpc = require("@solbuilder_io/rpc-health");
+
+// Check all default RPCs
+rpc.checkAll().then(console.log);
+// { solana: { url: "...", status: 200, latency: 45, healthy: true }, ... }
+
+// Check a single endpoint
+rpc.checkRPC("https://api.mainnet-beta.solana.com").then(console.log);
+
+// Find fastest RPC for a chain
+rpc.findFastest("ethereum").then(console.log);
+```
+
+## Supported Chains
+Solana, Ethereum, BSC, Polygon, Avalanche
+
+## License
+MIT

package/index.js

@@ -0,0 +1,46 @@
+"use strict";
+
+const https = require("https");
+const http = require("http");
+
+const DEFAULT_RPCS = {
+  solana: "https://api.mainnet-beta.solana.com",
+  ethereum: "https://eth.llamarpc.com",
+  bsc: "https://bsc-dataseed.binance.org",
+  polygon: "https://polygon-rpc.com",
+  avalanche: "https://api.avax.network/ext/bc/C/rpc",
+};
+
+function checkRPC(url, timeout = 5000) {
+  return new Promise((resolve) => {
+    const start = Date.now();
+    const client = url.startsWith("https") ? https : http;
+    const req = client.get(url, { timeout }, (res) => {
+      resolve({
+        url,
+        status: res.statusCode,
+        latency: Date.now() - start,
+        healthy: res.statusCode === 200 || res.statusCode === 405,
+      });
+    });
+    req.on("error", () => resolve({ url, status: 0, latency: -1, healthy: false }));
+    req.on("timeout", () => { req.destroy(); resolve({ url, status: 0, latency: timeout, healthy: false }); });
+  });
+}
+
+async function checkAll(customRpcs = {}) {
+  const rpcs = { ...DEFAULT_RPCS, ...customRpcs };
+  const results = {};
+  for (const [chain, url] of Object.entries(rpcs)) {
+    results[chain] = await checkRPC(url);
+  }
+  return results;
+}
+
+async function findFastest(chain) {
+  if (!DEFAULT_RPCS[chain]) return null;
+  const result = await checkRPC(DEFAULT_RPCS[chain]);
+  return { chain, ...result };
+}
+
+module.exports = { checkRPC, checkAll, findFastest, DEFAULT_RPCS };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@solbuilder_io/rpc-health",
+  "version": "1.0.0",
+  "description": "Lightweight RPC endpoint health checker \u2014 check latency and availability for Solana, Ethereum, and EVM chain RPCs",
+  "main": "index.js",
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "rpc",
+    "health",
+    "latency",
+    "solana",
+    "ethereum",
+    "endpoint",
+    "web3",
+    "blockchain"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/solbuilder-io/rpc-health"
+  }
+}