package geyser

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc GetBlockHeight (GetBlockHeightRequest, GetBlockHeightResponse)

  geyser.proto:16

  message GetBlockHeightRequest

  geyser.proto:333

  • optional CommitmentLevel commitment = 1

  message GetBlockHeightResponse

  geyser.proto:337

  • uint64 block_height = 1

• rpc GetLatestBlockhash (GetLatestBlockhashRequest, GetLatestBlockhashResponse)

  geyser.proto:15

  message GetLatestBlockhashRequest

  geyser.proto:323

  • optional CommitmentLevel commitment = 1

  message GetLatestBlockhashResponse

  geyser.proto:327

  • uint64 slot = 1

  • string blockhash = 2

  • uint64 last_valid_block_height = 3

• rpc GetSlot (GetSlotRequest, GetSlotResponse)

  geyser.proto:17

  message GetSlotRequest

  geyser.proto:341

  • optional CommitmentLevel commitment = 1

  message GetSlotResponse

  geyser.proto:345

  • uint64 slot = 1

• rpc GetVersion (GetVersionRequest, GetVersionResponse)

  geyser.proto:19

  message GetVersionRequest

  geyser.proto:349

  (message has no fields)

  message GetVersionResponse

  geyser.proto:351

  • string version = 1

• rpc IsBlockhashValid (IsBlockhashValidRequest, IsBlockhashValidResponse)

  geyser.proto:18

  message IsBlockhashValidRequest

  geyser.proto:355

  • string blockhash = 1

  • optional CommitmentLevel commitment = 2

  message IsBlockhashValidResponse

  geyser.proto:360

  • uint64 slot = 1

  • bool valid = 2

• rpc Ping (PingRequest, PongResponse)

  geyser.proto:14

  message PingRequest

  geyser.proto:315

  • int32 count = 1

  message PongResponse

  geyser.proto:319

  • int32 count = 1

• rpc Subscribe (stream SubscribeRequest, stream SubscribeUpdate)

  geyser.proto:11

  message SubscribeRequest

  geyser.proto:38

  • 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

  message SubscribeUpdate

  geyser.proto:176

  • 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

  • optional google.protobuf.Timestamp created_at = 11

• rpc SubscribeDeshred (stream SubscribeDeshredRequest, stream SubscribeUpdateDeshred)

  geyser.proto:12

  message SubscribeDeshredRequest

  geyser.proto:170

  Request message for the SubscribeDeshred RPC. Subscribes to deshred transactions (transactions received before execution). Deshred transactions are received when entries are formed from shreds, BEFORE any execution occurs. No TransactionStatusMeta is available. Address lookup tables are resolved, so both static and loaded addresses are available for filtering.

  • map<string, SubscribeRequestFilterDeshredTransactions> deshred_transactions = 1

  • optional SubscribeRequestPing ping = 2

  • map<string, SubscribeRequestFilterSlots> slots = 3

  message SubscribeUpdateDeshred

  geyser.proto:295

  • repeated string filters = 1

  • oneof update_oneof

    • SubscribeUpdateDeshredTransaction deshred_transaction = 2

    • SubscribeUpdatePing ping = 3

    • SubscribeUpdatePong pong = 4

    • SubscribeUpdateSlot slot = 6

      field 5 is reserved for created_at (below the oneof)

  • optional google.protobuf.Timestamp created_at = 5

• rpc SubscribeReplayInfo (SubscribeReplayInfoRequest, SubscribeReplayInfoResponse)

  geyser.proto:13

  message SubscribeReplayInfoRequest

  geyser.proto:309

  (message has no fields)

  message SubscribeReplayInfoResponse

  geyser.proto:311

  • optional uint64 first_available = 1

Used in: GetBlockHeightRequest, GetLatestBlockhashRequest, GetSlotRequest, IsBlockhashValidRequest, SubscribeRequest

• PROCESSED = 0

• CONFIRMED = 1

• FINALIZED = 2

Used in: SubscribeRequestFilterAccounts, SubscribeRequestFilterBlocks

• bytes data = 1

  bucket data

• uint32 bucket_count = 2

  number of buckets

• uint32 entries_per_bucket = 3

  slots per bucket (typically 4)

• uint32 fingerprint_bits = 4

  fingerprint size (8, 12, or 16)

• uint64 hash_seed = 5

  seed for deterministic hashing

• CuckooHashAlgorithm hash_algorithm = 6

Hash algorithm used to build the filter. Carried on the wire so future releases can add alternative algorithms (e.g., xxh3) without breaking existing clients. Readers should verify this matches a supported algorithm before deserializing.

Used in: CuckooFilter

• SIP_HASH = 0

Used in: SubscribeUpdateSlot

• SLOT_PROCESSED = 0

• SLOT_CONFIRMED = 1

• SLOT_FINALIZED = 2

• SLOT_FIRST_SHRED_RECEIVED = 3

• SLOT_COMPLETED = 4

• SLOT_CREATED_BANK = 5

• SLOT_DEAD = 6

Used in: SubscribeRequest

• uint64 offset = 1

• uint64 length = 2

Used in: SubscribeRequest

• repeated string account = 2

• repeated string owner = 3

• repeated SubscribeRequestFilterAccountsFilter filters = 4

• optional bool nonempty_txn_signature = 5

• optional CuckooFilter cuckoo_accounts_filter = 6

Used in: SubscribeRequestFilterAccounts

• oneof filter

  • SubscribeRequestFilterAccountsFilterMemcmp memcmp = 1

  • uint64 datasize = 2

  • bool token_account_state = 3

  • SubscribeRequestFilterAccountsFilterLamports lamports = 4

Used in: SubscribeRequestFilterAccountsFilter

• oneof cmp

  • uint64 eq = 1

  • uint64 ne = 2

  • uint64 lt = 3

  • uint64 gt = 4

Used in: SubscribeRequestFilterAccountsFilter

• uint64 offset = 1

• oneof data

  • bytes bytes = 2

  • string base58 = 3

  • string base64 = 4

Used in: SubscribeRequest

• repeated string account_include = 1

• optional bool include_transactions = 2

• optional bool include_accounts = 3

• optional bool include_entries = 4

• optional CuckooFilter cuckoo_account_include = 5

Used in: SubscribeRequest

(message has no fields)

Filter for deshred transactions (transactions received before execution). Deshred transactions are received when entries are formed from shreds, BEFORE any execution occurs. No TransactionStatusMeta is available. Address lookup tables are resolved, so both static account keys and dynamically loaded addresses (from ALTs) are available for filtering.

Used in: SubscribeDeshredRequest

• optional bool vote = 1

• repeated string account_include = 2

• repeated string account_exclude = 3

• repeated string account_required = 4

Used in: SubscribeRequest

(message has no fields)

Used in: SubscribeDeshredRequest, SubscribeRequest

• optional bool filter_by_commitment = 1

• optional bool interslot_updates = 2

Used in: SubscribeRequest

• optional bool vote = 1

• optional bool failed = 2

• optional string signature = 5

• repeated string account_include = 3

• repeated string account_exclude = 4

• repeated string account_required = 6

• optional TokenAccountExpansionControlFlag token_accounts = 30

  ATA / token-account expansion control. When set, account_include / account_exclude / account_required also match against owners of pre/post token balances on each transaction. Absent = no expansion.

Used in: SubscribeDeshredRequest, SubscribeRequest

• int32 id = 1

Used in: SubscribeUpdate

• optional SubscribeUpdateAccountInfo account = 1

• uint64 slot = 2

• bool is_startup = 3

Used in: SubscribeUpdateAccount, SubscribeUpdateBlock

• bytes pubkey = 1

• uint64 lamports = 2

• bytes owner = 3

• bool executable = 4

• uint64 rent_epoch = 5

• bytes data = 6

• uint64 write_version = 7

• optional bytes txn_signature = 8

Used in: SubscribeUpdate

• uint64 slot = 1

• string blockhash = 2

• optional solana.storage.ConfirmedBlock.Rewards rewards = 3

• optional solana.storage.ConfirmedBlock.UnixTimestamp block_time = 4

• optional solana.storage.ConfirmedBlock.BlockHeight block_height = 5

• uint64 parent_slot = 7

• string parent_blockhash = 8

• uint64 executed_transaction_count = 9

• repeated SubscribeUpdateTransactionInfo transactions = 6

• uint64 updated_account_count = 10

• repeated SubscribeUpdateAccountInfo accounts = 11

• uint64 entries_count = 12

• repeated SubscribeUpdateEntry entries = 13

Used in: SubscribeUpdate

• uint64 slot = 1

• string blockhash = 2

• optional solana.storage.ConfirmedBlock.Rewards rewards = 3

• optional solana.storage.ConfirmedBlock.UnixTimestamp block_time = 4

• optional solana.storage.ConfirmedBlock.BlockHeight block_height = 5

• uint64 parent_slot = 6

• string parent_blockhash = 7

• uint64 executed_transaction_count = 8

• uint64 entries_count = 9

Used in: SubscribeUpdateDeshred

• optional SubscribeUpdateDeshredTransactionInfo transaction = 1

• uint64 slot = 2

Used in: SubscribeUpdateDeshredTransaction

• bytes signature = 1

• bool is_vote = 2

• optional solana.storage.ConfirmedBlock.Transaction transaction = 3

• repeated bytes loaded_writable_addresses = 4

• repeated bytes loaded_readonly_addresses = 5

• uint32 completed_data_set_starting_shred_index = 6

• uint32 completed_data_set_ending_shred_index_exclusive = 7

Used in: SubscribeUpdate, SubscribeUpdateBlock

• uint64 slot = 1

• uint64 index = 2

• uint64 num_hashes = 3

• bytes hash = 4

• uint64 executed_transaction_count = 5

• uint64 starting_transaction_index = 6

  added in v1.18, for solana 1.17 value is always 0

Used in: SubscribeUpdate, SubscribeUpdateDeshred

(message has no fields)

Used in: SubscribeUpdate, SubscribeUpdateDeshred

• int32 id = 1

Used in: SubscribeUpdate, SubscribeUpdateDeshred

• uint64 slot = 1

• optional uint64 parent = 2

• SlotStatus status = 3

• optional string dead_error = 4

Used in: SubscribeUpdate

• optional SubscribeUpdateTransactionInfo transaction = 1

• uint64 slot = 2

Used in: SubscribeUpdateBlock, SubscribeUpdateTransaction

• bytes signature = 1

• bool is_vote = 2

• optional solana.storage.ConfirmedBlock.Transaction transaction = 3

• optional solana.storage.ConfirmedBlock.TransactionStatusMeta meta = 4

• uint64 index = 5

Used in: SubscribeUpdate

• uint64 slot = 1

• bytes signature = 2

• bool is_vote = 3

• uint64 index = 4

• optional solana.storage.ConfirmedBlock.TransactionError err = 5

Used in: SubscribeRequestFilterTransactions

• ALL = 0

  Match an owner if it owns a pre OR post token balance on the tx.

• BALANCE_CHANGED = 1

  Match an owner whose token balance changed in amount (per `account_index`) or whose token account was closed.