git404hub

what is cloudbreak fr?

solana-rpc/cloudbreak — explained in plain English

Analysis updated 2026-05-18

33RustAudience · developerComplexity · 5/5Setup · hard

tl;dr

A Postgres backed Solana RPC service that answers program account, token balance, and account lookup queries from a live indexed copy of blockchain state.

vibe map

mindmap
  root((cloudbreak))
    What it does
      Index Solana accounts
      Serve RPC queries
      Postgres backed
    Tech stack
      Rust
      PostgreSQL
      Solana
      gRPC
    Use cases
      Program account lookup
      Token account queries
      Balance checks
    Audience
      Solana developers
      Infra operators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Look up every account owned by a specific Solana program without querying a full validator node.

VIBE 2

Find all SPL token accounts owned by or delegated to a particular wallet address.

VIBE 3

Fetch and batch account balances and token holdings for many addresses at once.

VIBE 4

Run a self hosted, indexed RPC endpoint focused on getProgramAccounts style queries.

what's the stack?

RustPostgreSQLSolanagRPC

how it stacks up fr

solana-rpc/cloudbreakbibekbhusal0/focusdironic-org/ironic
Stars333434
LanguageRustRustRust
Setup difficultyhardeasymoderate
Complexity5/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1day+

Requires a PostgreSQL database, a Yellowstone gRPC data source, and a cluster tracker component for snapshots.

in plain english

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.

prompts (copy fr)

prompt 1
Explain how Cloudbreak keeps its PostgreSQL database in sync with live Solana account data.
prompt 2
Walk me through the difference between confirmed, finalized, and processed commitment levels here.
prompt 3
Help me set up the local development environment including the cluster tracker component.
prompt 4
Show me how to query getTokenAccountsByOwner using this service's JSON-RPC API.

Frequently asked questions

what is cloudbreak fr?

A Postgres backed Solana RPC service that answers program account, token balance, and account lookup queries from a live indexed copy of blockchain state.

What language is cloudbreak written in?

Mainly Rust. The stack also includes Rust, PostgreSQL, Solana.

How hard is cloudbreak to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is cloudbreak for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.