Yellowstone gRPC - API Reference
API reference for Yellowstone gRPC on FluxRPC, including SubscribeRequest and SubscribeUpdate message shapes.
Request Structure
SubscribeRequest Protobuf
message SubscribeRequest {
map<string, SubscribeRequestFilterAccounts> accounts = 1;
map<string, SubscribeRequestFilterSlots> slots = 2;
map<string, SubscribeRequestFilterTransactions> transactions = 3;
map<string, SubscribeRequestFilterTransactions> transactions_status = 10;
map<string, SubscribeRequestFilterBlocks> blocks = 4;
map<string, SubscribeRequestFilterBlocksMeta> blocks_meta = 5;
map<string, SubscribeRequestFilterEntry> entry = 8;
optional CommitmentLevel commitment = 6;
repeated SubscribeRequestAccountsDataSlice accounts_data_slice = 7;
optional SubscribeRequestPing ping = 9;
optional uint64 from_slot = 11;
}
Commitment Levels
Controls when updates are sent based on Solana's confirmation status.
PROCESSED 0
Fastest updates, can be rolled back
CONFIRMED 1
Supermajority vote received
FINALIZED 2
Fully finalized, cannot be rolled back
from_slot is not supported
FluxRPC does not currently support historical replay using from_slot.
Response Structure
The server responds with a stream of SubscribeUpdate messages. The filters field contains the identifiers of the filters that matched each update.
SubscribeUpdate Protobuf
message SubscribeUpdate {
repeated string filters = 1;
oneof update_oneof {
SubscribeUpdateAccount account = 2;
SubscribeUpdateSlot slot = 3;
SubscribeUpdateTransaction transaction = 4;
SubscribeUpdateTransactionStatus transaction_status = 10;
SubscribeUpdateBlock block = 5;
SubscribeUpdatePing ping = 6;
SubscribeUpdatePong pong = 9;
SubscribeUpdateBlockMeta block_meta = 7;
SubscribeUpdateEntry entry = 8;
}
google.protobuf.Timestamp created_at = 11;
}
Open the section overview for the broader context, live navigation, and interactive code examples.
Continue in this section
- Yellowstone gRPC - Subscriptions — Learn about Yellowstone gRPC subscription types for accounts, transactions, blocks, and slots on FluxRPC.
- Yellowstone gRPC - Account Subscriptions — Monitor account changes in real time with Yellowstone gRPC account subscriptions for balances, token accounts, and program state.
- Yellowstone gRPC - Compressed Filters — Update Yellowstone account subscriptions without re-sending the full key list using a compressed Cuckoo filter on FluxRPC.
- Yellowstone gRPC - Transaction Subscriptions — Stream confirmed transactions filtered by accounts, signatures, or program involvement using Yellowstone gRPC on FluxRPC.
- Yellowstone gRPC - Block Subscriptions — Receive full block data including transactions, rewards, and metadata with Yellowstone gRPC block subscriptions.
- Yellowstone gRPC - Slot Subscriptions — Track slot progression and chain state with Yellowstone gRPC slot subscriptions for confirmation-aware applications.