sol-parser-sdk 0.5.15 → 0.5.17

package/dist/grpc/protocol/geyser.d.ts

@@ -0,0 +1,342 @@
+import type { BlockHeight, Rewards, Transaction, TransactionError, TransactionStatusMeta, UnixTimestamp } from "./solana-storage.js";
+export declare enum CommitmentLevel {
+    PROCESSED = 0,
+    CONFIRMED = 1,
+    FINALIZED = 2,
+    UNRECOGNIZED = -1
+}
+export declare enum SlotStatus {
+    SLOT_PROCESSED = 0,
+    SLOT_CONFIRMED = 1,
+    SLOT_FINALIZED = 2,
+    SLOT_FIRST_SHRED_RECEIVED = 3,
+    SLOT_COMPLETED = 4,
+    SLOT_CREATED_BANK = 5,
+    SLOT_DEAD = 6,
+    UNRECOGNIZED = -1
+}
+export declare enum CuckooHashAlgorithm {
+    SIP_HASH = 0,
+    UNRECOGNIZED = -1
+}
+export declare enum TokenAccountExpansionControlFlag {
+    /** ALL - Match an owner if it owns a pre OR post token balance on the tx. */
+    ALL = 0,
+    /**
+     * BALANCE_CHANGED - Match an owner whose token balance changed in amount (per
+     * `account_index`) or whose token account was closed.
+     */
+    BALANCE_CHANGED = 1,
+    UNRECOGNIZED = -1
+}
+export interface SubscribeRequest {
+    accounts: {
+        [key: string]: SubscribeRequestFilterAccounts;
+    };
+    slots: {
+        [key: string]: SubscribeRequestFilterSlots;
+    };
+    transactions: {
+        [key: string]: SubscribeRequestFilterTransactions;
+    };
+    transactionsStatus: {
+        [key: string]: SubscribeRequestFilterTransactions;
+    };
+    blocks: {
+        [key: string]: SubscribeRequestFilterBlocks;
+    };
+    blocksMeta: {
+        [key: string]: SubscribeRequestFilterBlocksMeta;
+    };
+    entry: {
+        [key: string]: SubscribeRequestFilterEntry;
+    };
+    commitment?: CommitmentLevel | undefined;
+    accountsDataSlice: SubscribeRequestAccountsDataSlice[];
+    ping?: SubscribeRequestPing | undefined;
+    fromSlot?: string | undefined;
+}
+export interface SubscribeRequest_AccountsEntry {
+    key: string;
+    value: SubscribeRequestFilterAccounts | undefined;
+}
+export interface SubscribeRequest_SlotsEntry {
+    key: string;
+    value: SubscribeRequestFilterSlots | undefined;
+}
+export interface SubscribeRequest_TransactionsEntry {
+    key: string;
+    value: SubscribeRequestFilterTransactions | undefined;
+}
+export interface SubscribeRequest_TransactionsStatusEntry {
+    key: string;
+    value: SubscribeRequestFilterTransactions | undefined;
+}
+export interface SubscribeRequest_BlocksEntry {
+    key: string;
+    value: SubscribeRequestFilterBlocks | undefined;
+}
+export interface SubscribeRequest_BlocksMetaEntry {
+    key: string;
+    value: SubscribeRequestFilterBlocksMeta | undefined;
+}
+export interface SubscribeRequest_EntryEntry {
+    key: string;
+    value: SubscribeRequestFilterEntry | undefined;
+}
+export interface CuckooFilter {
+    /** bucket data */
+    data: Uint8Array;
+    /** number of buckets */
+    bucketCount: number;
+    /** slots per bucket (typically 4) */
+    entriesPerBucket: number;
+    /** fingerprint size (8, 12, or 16) */
+    fingerprintBits: number;
+    /** seed for deterministic hashing */
+    hashSeed: string;
+    hashAlgorithm: CuckooHashAlgorithm;
+}
+export interface SubscribeRequestFilterAccounts {
+    account: string[];
+    owner: string[];
+    filters: SubscribeRequestFilterAccountsFilter[];
+    nonemptyTxnSignature?: boolean | undefined;
+    cuckooAccountsFilter?: CuckooFilter | undefined;
+}
+export interface SubscribeRequestFilterAccountsFilter {
+    memcmp?: SubscribeRequestFilterAccountsFilterMemcmp | undefined;
+    datasize?: string | undefined;
+    tokenAccountState?: boolean | undefined;
+    lamports?: SubscribeRequestFilterAccountsFilterLamports | undefined;
+}
+export interface SubscribeRequestFilterAccountsFilterMemcmp {
+    offset: string;
+    bytes?: Uint8Array | undefined;
+    base58?: string | undefined;
+    base64?: string | undefined;
+}
+export interface SubscribeRequestFilterAccountsFilterLamports {
+    eq?: string | undefined;
+    ne?: string | undefined;
+    lt?: string | undefined;
+    gt?: string | undefined;
+}
+export interface SubscribeRequestFilterSlots {
+    filterByCommitment?: boolean | undefined;
+    interslotUpdates?: boolean | undefined;
+}
+export interface SubscribeRequestFilterTransactions {
+    vote?: boolean | undefined;
+    failed?: boolean | undefined;
+    signature?: string | undefined;
+    accountInclude: string[];
+    accountExclude: string[];
+    accountRequired: string[];
+    cuckooAccountInclude?: CuckooFilter | undefined;
+    /**
+     * 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.
+     */
+    tokenAccounts?: TokenAccountExpansionControlFlag | undefined;
+}
+export interface SubscribeRequestFilterBlocks {
+    accountInclude: string[];
+    includeTransactions?: boolean | undefined;
+    includeAccounts?: boolean | undefined;
+    includeEntries?: boolean | undefined;
+    cuckooAccountInclude?: CuckooFilter | undefined;
+}
+export interface SubscribeRequestFilterBlocksMeta {
+}
+export interface SubscribeRequestFilterEntry {
+}
+export interface SubscribeRequestFilterDeshredTransactions {
+    vote?: boolean | undefined;
+    accountInclude: string[];
+    accountExclude: string[];
+    accountRequired: string[];
+}
+export interface SubscribeRequestAccountsDataSlice {
+    offset: string;
+    length: string;
+}
+export interface SubscribeRequestPing {
+    id: number;
+}
+export interface SubscribeDeshredRequest {
+    deshredTransactions: {
+        [key: string]: SubscribeRequestFilterDeshredTransactions;
+    };
+    ping?: SubscribeRequestPing | undefined;
+    slots: {
+        [key: string]: SubscribeRequestFilterSlots;
+    };
+}
+export interface SubscribeDeshredRequest_DeshredTransactionsEntry {
+    key: string;
+    value: SubscribeRequestFilterDeshredTransactions | undefined;
+}
+export interface SubscribeDeshredRequest_SlotsEntry {
+    key: string;
+    value: SubscribeRequestFilterSlots | undefined;
+}
+export interface SubscribeUpdate {
+    filters: string[];
+    account?: SubscribeUpdateAccount | undefined;
+    slot?: SubscribeUpdateSlot | undefined;
+    transaction?: SubscribeUpdateTransaction | undefined;
+    transactionStatus?: SubscribeUpdateTransactionStatus | undefined;
+    block?: SubscribeUpdateBlock | undefined;
+    ping?: SubscribeUpdatePing | undefined;
+    pong?: SubscribeUpdatePong | undefined;
+    blockMeta?: SubscribeUpdateBlockMeta | undefined;
+    entry?: SubscribeUpdateEntry | undefined;
+    createdAt: Date | undefined;
+}
+export interface SubscribeUpdateAccount {
+    account: SubscribeUpdateAccountInfo | undefined;
+    slot: string;
+    isStartup: boolean;
+}
+export interface SubscribeUpdateAccountInfo {
+    pubkey: Uint8Array;
+    lamports: string;
+    owner: Uint8Array;
+    executable: boolean;
+    rentEpoch: string;
+    data: Uint8Array;
+    writeVersion: string;
+    txnSignature?: Uint8Array | undefined;
+}
+export interface SubscribeUpdateSlot {
+    slot: string;
+    parent?: string | undefined;
+    status: SlotStatus;
+    deadError?: string | undefined;
+}
+export interface SubscribeUpdateTransaction {
+    transaction: SubscribeUpdateTransactionInfo | undefined;
+    slot: string;
+}
+export interface SubscribeUpdateTransactionInfo {
+    signature: Uint8Array;
+    isVote: boolean;
+    transaction: Transaction | undefined;
+    meta: TransactionStatusMeta | undefined;
+    index: string;
+}
+export interface SubscribeUpdateTransactionStatus {
+    slot: string;
+    signature: Uint8Array;
+    isVote: boolean;
+    index: string;
+    err: TransactionError | undefined;
+}
+export interface SubscribeUpdateBlock {
+    slot: string;
+    blockhash: string;
+    rewards: Rewards | undefined;
+    blockTime: UnixTimestamp | undefined;
+    blockHeight: BlockHeight | undefined;
+    parentSlot: string;
+    parentBlockhash: string;
+    executedTransactionCount: string;
+    transactions: SubscribeUpdateTransactionInfo[];
+    updatedAccountCount: string;
+    accounts: SubscribeUpdateAccountInfo[];
+    entriesCount: string;
+    entries: SubscribeUpdateEntry[];
+}
+export interface SubscribeUpdateBlockMeta {
+    slot: string;
+    blockhash: string;
+    rewards: Rewards | undefined;
+    blockTime: UnixTimestamp | undefined;
+    blockHeight: BlockHeight | undefined;
+    parentSlot: string;
+    parentBlockhash: string;
+    executedTransactionCount: string;
+    entriesCount: string;
+}
+export interface SubscribeUpdateEntry {
+    slot: string;
+    index: string;
+    numHashes: string;
+    hash: Uint8Array;
+    executedTransactionCount: string;
+    /** added in v1.18, for solana 1.17 value is always 0 */
+    startingTransactionIndex: string;
+}
+export interface SubscribeUpdateDeshredTransaction {
+    transaction: SubscribeUpdateDeshredTransactionInfo | undefined;
+    slot: string;
+}
+export interface SubscribeUpdateDeshredTransactionInfo {
+    signature: Uint8Array;
+    isVote: boolean;
+    transaction: Transaction | undefined;
+    loadedWritableAddresses: Uint8Array[];
+    loadedReadonlyAddresses: Uint8Array[];
+    completedDataSetStartingShredIndex: number;
+    completedDataSetEndingShredIndexExclusive: number;
+}
+export interface SubscribeUpdatePing {
+}
+export interface SubscribeUpdatePong {
+    id: number;
+}
+export interface SubscribeUpdateDeshred {
+    filters: string[];
+    deshredTransaction?: SubscribeUpdateDeshredTransaction | undefined;
+    ping?: SubscribeUpdatePing | undefined;
+    pong?: SubscribeUpdatePong | undefined;
+    /** field 5 is reserved for created_at (below the oneof) */
+    slot?: SubscribeUpdateSlot | undefined;
+    createdAt: Date | undefined;
+}
+export interface SubscribeReplayInfoRequest {
+}
+export interface SubscribeReplayInfoResponse {
+    firstAvailable?: string | undefined;
+}
+export interface PingRequest {
+    count: number;
+}
+export interface PongResponse {
+    count: number;
+}
+export interface GetLatestBlockhashRequest {
+    commitment?: CommitmentLevel | undefined;
+}
+export interface GetLatestBlockhashResponse {
+    slot: string;
+    blockhash: string;
+    lastValidBlockHeight: string;
+}
+export interface GetBlockHeightRequest {
+    commitment?: CommitmentLevel | undefined;
+}
+export interface GetBlockHeightResponse {
+    blockHeight: string;
+}
+export interface GetSlotRequest {
+    commitment?: CommitmentLevel | undefined;
+}
+export interface GetSlotResponse {
+    slot: string;
+}
+export interface GetVersionRequest {
+}
+export interface GetVersionResponse {
+    version: string;
+}
+export interface IsBlockhashValidRequest {
+    blockhash: string;
+    commitment?: CommitmentLevel | undefined;
+}
+export interface IsBlockhashValidResponse {
+    slot: string;
+    valid: boolean;
+}

package/dist/grpc/protocol/geyser.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenAccountExpansionControlFlag = exports.CuckooHashAlgorithm = exports.SlotStatus = exports.CommitmentLevel = void 0;
+var CommitmentLevel;
+(function (CommitmentLevel) {
+    CommitmentLevel[CommitmentLevel["PROCESSED"] = 0] = "PROCESSED";
+    CommitmentLevel[CommitmentLevel["CONFIRMED"] = 1] = "CONFIRMED";
+    CommitmentLevel[CommitmentLevel["FINALIZED"] = 2] = "FINALIZED";
+    CommitmentLevel[CommitmentLevel["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(CommitmentLevel || (exports.CommitmentLevel = CommitmentLevel = {}));
+var SlotStatus;
+(function (SlotStatus) {
+    SlotStatus[SlotStatus["SLOT_PROCESSED"] = 0] = "SLOT_PROCESSED";
+    SlotStatus[SlotStatus["SLOT_CONFIRMED"] = 1] = "SLOT_CONFIRMED";
+    SlotStatus[SlotStatus["SLOT_FINALIZED"] = 2] = "SLOT_FINALIZED";
+    SlotStatus[SlotStatus["SLOT_FIRST_SHRED_RECEIVED"] = 3] = "SLOT_FIRST_SHRED_RECEIVED";
+    SlotStatus[SlotStatus["SLOT_COMPLETED"] = 4] = "SLOT_COMPLETED";
+    SlotStatus[SlotStatus["SLOT_CREATED_BANK"] = 5] = "SLOT_CREATED_BANK";
+    SlotStatus[SlotStatus["SLOT_DEAD"] = 6] = "SLOT_DEAD";
+    SlotStatus[SlotStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(SlotStatus || (exports.SlotStatus = SlotStatus = {}));
+var CuckooHashAlgorithm;
+(function (CuckooHashAlgorithm) {
+    CuckooHashAlgorithm[CuckooHashAlgorithm["SIP_HASH"] = 0] = "SIP_HASH";
+    CuckooHashAlgorithm[CuckooHashAlgorithm["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(CuckooHashAlgorithm || (exports.CuckooHashAlgorithm = CuckooHashAlgorithm = {}));
+var TokenAccountExpansionControlFlag;
+(function (TokenAccountExpansionControlFlag) {
+    /** ALL - Match an owner if it owns a pre OR post token balance on the tx. */
+    TokenAccountExpansionControlFlag[TokenAccountExpansionControlFlag["ALL"] = 0] = "ALL";
+    /**
+     * BALANCE_CHANGED - Match an owner whose token balance changed in amount (per
+     * `account_index`) or whose token account was closed.
+     */
+    TokenAccountExpansionControlFlag[TokenAccountExpansionControlFlag["BALANCE_CHANGED"] = 1] = "BALANCE_CHANGED";
+    TokenAccountExpansionControlFlag[TokenAccountExpansionControlFlag["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(TokenAccountExpansionControlFlag || (exports.TokenAccountExpansionControlFlag = TokenAccountExpansionControlFlag = {}));

package/dist/grpc/protocol/geyser.proto

@@ -0,0 +1,326 @@
+syntax = "proto3";
+
+import "google/protobuf/timestamp.proto";
+import public "solana-storage.proto";
+
+option go_package = "github.com/rpcpool/yellowstone-grpc/examples/golang/proto";
+
+package geyser;
+
+service Geyser {
+  rpc Subscribe(stream SubscribeRequest) returns (stream SubscribeUpdate) {}
+  rpc SubscribeDeshred(stream SubscribeDeshredRequest) returns (stream SubscribeUpdateDeshred) {}
+  rpc SubscribeReplayInfo(SubscribeReplayInfoRequest) returns (SubscribeReplayInfoResponse) {}
+  rpc Ping(PingRequest) returns (PongResponse) {}
+  rpc GetLatestBlockhash(GetLatestBlockhashRequest) returns (GetLatestBlockhashResponse) {}
+  rpc GetBlockHeight(GetBlockHeightRequest) returns (GetBlockHeightResponse) {}
+  rpc GetSlot(GetSlotRequest) returns (GetSlotResponse) {}
+  rpc IsBlockhashValid(IsBlockhashValidRequest) returns (IsBlockhashValidResponse) {}
+  rpc GetVersion(GetVersionRequest) returns (GetVersionResponse) {}
+}
+
+enum CommitmentLevel {
+  PROCESSED = 0;
+  CONFIRMED = 1;
+  FINALIZED = 2;
+}
+
+enum SlotStatus {
+  SLOT_PROCESSED = 0;
+  SLOT_CONFIRMED = 1;
+  SLOT_FINALIZED = 2;
+  SLOT_FIRST_SHRED_RECEIVED = 3;
+  SLOT_COMPLETED = 4;
+  SLOT_CREATED_BANK = 5;
+  SLOT_DEAD = 6;
+}
+
+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;
+}
+
+message SubscribeRequestFilterAccounts {
+  repeated string account = 2;
+  repeated string owner = 3;
+  repeated SubscribeRequestFilterAccountsFilter filters = 4;
+  optional bool nonempty_txn_signature = 5;
+}
+
+message SubscribeRequestFilterAccountsFilter {
+  oneof filter {
+    SubscribeRequestFilterAccountsFilterMemcmp memcmp = 1;
+    uint64 datasize = 2;
+    bool token_account_state = 3;
+    SubscribeRequestFilterAccountsFilterLamports lamports = 4;
+  }
+}
+
+message SubscribeRequestFilterAccountsFilterMemcmp {
+  uint64 offset = 1;
+  oneof data {
+    bytes bytes = 2;
+    string base58 = 3;
+    string base64 = 4;
+  }
+}
+
+message SubscribeRequestFilterAccountsFilterLamports {
+  oneof cmp {
+    uint64 eq = 1;
+    uint64 ne = 2;
+    uint64 lt = 3;
+    uint64 gt = 4;
+  }
+}
+
+message SubscribeRequestFilterSlots {
+  optional bool filter_by_commitment = 1;
+  optional bool interslot_updates = 2;
+}
+
+message SubscribeRequestFilterTransactions {
+  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;
+}
+
+message SubscribeRequestFilterBlocks {
+  repeated string account_include = 1;
+  optional bool include_transactions = 2;
+  optional bool include_accounts = 3;
+  optional bool include_entries = 4;
+}
+
+message SubscribeRequestFilterBlocksMeta {}
+
+message SubscribeRequestFilterEntry {}
+
+// 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.
+message SubscribeRequestFilterDeshredTransactions {
+  optional bool vote = 1;
+  repeated string account_include = 2;
+  repeated string account_exclude = 3;
+  repeated string account_required = 4;
+}
+
+message SubscribeRequestAccountsDataSlice {
+  uint64 offset = 1;
+  uint64 length = 2;
+}
+
+message SubscribeRequestPing {
+  int32 id = 1;
+}
+
+// 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.
+message SubscribeDeshredRequest {
+  map<string, SubscribeRequestFilterDeshredTransactions> deshred_transactions = 1;
+  optional SubscribeRequestPing ping = 2;
+}
+
+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;
+}
+
+message SubscribeUpdateAccount {
+  SubscribeUpdateAccountInfo account = 1;
+  uint64 slot = 2;
+  bool is_startup = 3;
+}
+
+message SubscribeUpdateAccountInfo {
+  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;
+}
+
+message SubscribeUpdateSlot {
+  uint64 slot = 1;
+  optional uint64 parent = 2;
+  SlotStatus status = 3;
+  optional string dead_error = 4;
+}
+
+message SubscribeUpdateTransaction {
+  SubscribeUpdateTransactionInfo transaction = 1;
+  uint64 slot = 2;
+}
+
+message SubscribeUpdateTransactionInfo {
+  bytes signature = 1;
+  bool is_vote = 2;
+  solana.storage.ConfirmedBlock.Transaction transaction = 3;
+  solana.storage.ConfirmedBlock.TransactionStatusMeta meta = 4;
+  uint64 index = 5;
+}
+
+message SubscribeUpdateTransactionStatus {
+  uint64 slot = 1;
+  bytes signature = 2;
+  bool is_vote = 3;
+  uint64 index = 4;
+  solana.storage.ConfirmedBlock.TransactionError err = 5;
+}
+
+message SubscribeUpdateBlock {
+  uint64 slot = 1;
+  string blockhash = 2;
+  solana.storage.ConfirmedBlock.Rewards rewards = 3;
+  solana.storage.ConfirmedBlock.UnixTimestamp block_time = 4;
+  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;
+}
+
+message SubscribeUpdateBlockMeta {
+  uint64 slot = 1;
+  string blockhash = 2;
+  solana.storage.ConfirmedBlock.Rewards rewards = 3;
+  solana.storage.ConfirmedBlock.UnixTimestamp block_time = 4;
+  solana.storage.ConfirmedBlock.BlockHeight block_height = 5;
+  uint64 parent_slot = 6;
+  string parent_blockhash = 7;
+  uint64 executed_transaction_count = 8;
+  uint64 entries_count = 9;
+}
+
+message SubscribeUpdateEntry {
+  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
+}
+
+message SubscribeUpdateDeshredTransaction {
+  SubscribeUpdateDeshredTransactionInfo transaction = 1;
+  uint64 slot = 2;
+}
+
+message SubscribeUpdateDeshredTransactionInfo {
+  bytes signature = 1;
+  bool is_vote = 2;
+  solana.storage.ConfirmedBlock.Transaction transaction = 3;
+  repeated bytes loaded_writable_addresses = 4;
+  repeated bytes loaded_readonly_addresses = 5;
+}
+
+message SubscribeUpdatePing {}
+
+message SubscribeUpdatePong {
+  int32 id = 1;
+}
+
+message SubscribeUpdateDeshred {
+  repeated string filters = 1;
+  oneof update_oneof {
+    SubscribeUpdateDeshredTransaction deshred_transaction = 2;
+    SubscribeUpdatePing ping = 3;
+    SubscribeUpdatePong pong = 4;
+  }
+  google.protobuf.Timestamp created_at = 5;
+}
+
+// non-streaming methods
+
+message SubscribeReplayInfoRequest {}
+
+message SubscribeReplayInfoResponse {
+  optional uint64 first_available = 1;
+}
+
+message PingRequest {
+  int32 count = 1;
+}
+
+message PongResponse {
+  int32 count = 1;
+}
+
+message GetLatestBlockhashRequest {
+  optional CommitmentLevel commitment = 1;
+}
+
+message GetLatestBlockhashResponse {
+  uint64 slot = 1;
+  string blockhash = 2;
+  uint64 last_valid_block_height = 3;
+}
+
+message GetBlockHeightRequest {
+  optional CommitmentLevel commitment = 1;
+}
+
+message GetBlockHeightResponse {
+  uint64 block_height = 1;
+}
+
+message GetSlotRequest {
+  optional CommitmentLevel commitment = 1;
+}
+
+message GetSlotResponse {
+  uint64 slot = 1;
+}
+
+message GetVersionRequest {}
+
+message GetVersionResponse {
+  string version = 1;
+}
+
+message IsBlockhashValidRequest {
+  string blockhash = 1;
+  optional CommitmentLevel commitment = 2;
+}
+
+message IsBlockhashValidResponse {
+  uint64 slot = 1;
+  bool valid = 2;
+}