solana-rpc/cloudbreak

Solana is a fast blockchain network, and applications built on it often need to ask questions like which accounts belong to a certain program or how much of a token a wallet holds. Cloudbreak is a service that answers those kinds of questions. It works by keeping a filtered, up to date copy of relevant Solana account data inside a PostgreSQL database, fed by a live data stream called Yellowstone gRPC, along with optional snapshots to catch up quickly. Once running, Cloudbreak exposes a set of standard Solana RPC methods that other software can call, such as looking up every account owned by a specific program, finding token accounts owned by a wallet or delegated to an address, fetching a single account's latest data, checking an account's balance, and reporting the current state and health of the service. Some of these support filtering options so a caller only gets back the specific accounts they care about, and results can be returned as batches instead of one at a time. By default, Cloudbreak only fully supports two levels of data confidence called confirmed and finalized, meaning it will not serve the very newest, not yet confirmed data unless an operator explicitly configures it to substitute confirmed data instead. Two additional features are planned but not yet finished: a way to read that newest, unconfirmed data through an optional add on, and the ability to split large result sets into pages instead of returning everything in one response. Under the hood, the system has several moving parts: a component that tracks the overall Solana cluster and finds available data snapshots, an indexer that consumes the live data stream and writes into PostgreSQL, and the API server itself that answers incoming requests using that stored data. A local development setup for the cluster tracking piece is included so the whole system can be run and tested on one machine. The project is written in Rust. The full README is longer than what was shown.