luckyisrael/geyserbridge

GeyserBridge is a server that speaks the same protocol as Yellowstone Geyser gRPC, a standard way to receive real-time streaming data from the Solana blockchain, but backs it with free WebSocket connections instead of expensive validator infrastructure. Tools built for Yellowstone (trading bots, indexers, dashboards) can switch to GeyserBridge by changing one URL, with no other code changes required. The motivation is cost. Hosted Yellowstone providers charge between $49 and $299 per month for access to a single stream. GeyserBridge runs on any $5 per month server or your own laptop, requires no Solana validator hardware, and uses the public Solana RPC WebSocket endpoints that are freely available. The trade-off is that WebSocket-sourced data has some latency and coverage differences compared to direct validator access, but for many use cases the cost saving is substantial. The server implements the full Yellowstone protobuf interface, covering subscription streams for accounts, slots, transactions, blocks, and block metadata. It also implements several unary (request-response) calls such as GetSlot, GetBlockHeight, GetLatestBlockhash, and IsBlockhashValid. Authentication is handled via an x-token header. A built-in Prometheus metrics endpoint is included for monitoring. The project also supports replaying buffered recent slot history on connect. GeyserBridge is written in TypeScript and runs on Node.js. Setup involves cloning the repository, copying an environment file, setting an admin key, and running npm install followed by a start command. The README includes example code for connecting using the standard Yellowstone client library, raw gRPC-js, and grpcurl. The test suite covers 59 tests including end-to-end tests against real Solana mainnet. The README does not specify a license.