GoldRush Solana JSON-RPC Methods
Endpoint:https://rpc.goldrushdata.com/v1/solana-mainnet (HTTP); wss://rpc.goldrushdata.com/v1/solana-mainnet (subscriptions).
Auth: Authorization: Bearer <GOLDRUSH_API_KEY> header. Commitment levels: processed, confirmed, finalized. Balances in lamports (1 SOL = 1e9 lamports).
Blocks info
Transactions info
Node info
Account info
Network info
Slot info
Token info
Subscriptions
Network inflation info
Per-method details
getBlock
Summary: Returns identity and transaction information for a confirmed block.
Parameters:
Returns:
object | null. Block object with blockhash, previousBlockhash, parentSlot, transactions, rewards, blockTime, blockHeight; null if the block is not confirmed.
getBlocks
Summary: Returns a list of confirmed blocks between two slots.
Parameters:
Returns:
array<u64>. Array of confirmed block slots in ascending order.
getBlocksWithLimit
Summary: Returns a list of confirmed blocks starting at a slot, up to a limit.
Parameters:
Returns:
array<u64>. Array of confirmed block slots in ascending order.
getBlockHeight
Summary: Returns the current block height of the node.
Parameters:
Returns:
u64. Current block height.
getBlockTime
Summary: Returns the estimated production time of a block.
Parameters:
Returns:
i64 | null. Unix timestamp in seconds, or null if unavailable.
getBlockProduction
Summary: Returns recent block production information for the current or a previous epoch.
Parameters:
Returns:
object. {context, value: {byIdentity, range}} where byIdentity maps validator pubkey to [leaderSlots, blocksProduced].
getBlockCommitment
Summary: Returns the commitment (stake-weighted votes) for a block.
Parameters:
Returns:
object. {commitment: array<u64> | null, totalStake: u64}.
getLatestBlockhash
Summary: Returns the latest blockhash and its last valid block height.
Parameters:
Returns:
object. {context, value: {blockhash, lastValidBlockHeight}}.
isBlockhashValid
Summary: Returns whether a blockhash is still valid.
Parameters:
Returns:
object. {context, value: boolean}: true if the blockhash is still valid.
getRecentBlockhash
Deprecated. Use getLatestBlockhash instead.
Summary: Returns a recent blockhash and fee schedule (deprecated).
Parameters:
Returns:
object. {context, value: {blockhash, feeCalculator: {lamportsPerSignature}}}.
getConfirmedBlock
Deprecated. Use getBlock instead.
Summary: Returns the contents of a confirmed block (deprecated).
Parameters:
Returns:
object | null. Block object, or null if not confirmed.
getConfirmedBlocks
Deprecated. Use getBlocks instead.
Summary: Returns a list of confirmed blocks between two slots (deprecated).
Parameters:
Returns:
array<u64>. Array of confirmed block slots.
getTransaction
Summary: Returns details for a confirmed transaction by signature.
Parameters:
Returns:
object | null. Transaction object with slot, blockTime, transaction, meta; null if not found.
sendTransaction
Summary: Submits a signed transaction to the cluster.
Parameters:
Returns:
string. Base-58 encoded transaction signature (the first signature in the transaction).
simulateTransaction
Summary: Simulates sending a transaction without submitting it.
Parameters:
Returns:
object. {context, value: {err, logs, accounts, unitsConsumed, returnData}}.
getSignaturesForAddress
Summary: Returns confirmed transaction signatures involving an address.
Parameters:
Returns:
array<object>. Array of {signature, slot, err, memo, blockTime, confirmationStatus} newest first.
getSignatureStatuses
Summary: Returns the status of a list of transaction signatures.
Parameters:
Returns:
object. {context, value: array<{slot, confirmations, err, confirmationStatus} | null>}.
getTransactionCount
Summary: Returns the total number of transactions processed by the cluster.
Parameters:
Returns:
u64. Cumulative transaction count.
getConfirmedTransaction
Deprecated. Use getTransaction instead.
Summary: Returns details for a confirmed transaction (deprecated).
Parameters:
Returns:
object | null. Transaction object, or null if not found.
getConfirmedSignaturesForAddress2
Deprecated. Use getSignaturesForAddress instead.
Summary: Returns confirmed signatures for an address (deprecated).
Parameters:
Returns:
array<object>. Array of {signature, slot, err, memo, blockTime}.
getHealth
Summary: Returns the health status of the node.
Parameters: none
Returns: string. "ok" when healthy.
getVersion
Summary: Returns the Solana software version running on the node.
Parameters: none
Returns: object. {"solana-core": string, "feature-set": u32}.
getIdentity
Summary: Returns the identity pubkey of the node.
Parameters: none
Returns: object. {identity: string}: base-58 encoded validator identity pubkey.
getClusterNodes
Summary: Returns information about all nodes participating in the cluster.
Parameters: none
Returns: array<object>. Array of {pubkey, gossip, tpu, rpc, version, featureSet, shredVersion}.
getAccountInfo
Summary: Returns all information associated with an account.
Parameters:
Returns:
object | null. {context, value: {lamports, owner, data, executable, rentEpoch, space} | null}. value is null if the account does not exist.
getBalance
Summary: Returns the lamport balance of an account.
Parameters:
Returns:
object. {context, value: u64}: balance in lamports.
getMultipleAccounts
Summary: Returns account information for a list of addresses.
Parameters:
Returns:
object. {context, value: array<accountInfo | null>}.
getProgramAccounts
Summary: Returns all accounts owned by a program.
Parameters:
Returns:
array<object> | object. Array of {pubkey, account} objects (or a {context, value} envelope when withContext is set).
getLargestAccounts
Summary: Returns the 20 largest accounts by lamport balance.
Parameters:
Returns:
object. {context, value: array<{address, lamports}>}.
getVoteAccounts
Summary: Returns the current and delinquent vote accounts.
Parameters:
Returns:
object. {current: array<voteAccount>, delinquent: array<voteAccount>} with votePubkey, nodePubkey, activatedStake, commission, epochCredits, lastVote.
getStakeActivation
Deprecated. Use getAccountInfo instead.
Summary: Returns epoch activation information for a stake account (deprecated).
Parameters:
Returns:
object. {state, active, inactive}.
getEpochInfo
Summary: Returns information about the current epoch.
Parameters:
Returns:
object. {epoch, absoluteSlot, slotIndex, slotsInEpoch, blockHeight, transactionCount}.
getEpochSchedule
Summary: Returns the epoch schedule from the cluster genesis config.
Parameters: none
Returns: object. {slotsPerEpoch, leaderScheduleSlotOffset, warmup, firstNormalEpoch, firstNormalSlot}.
getFeeForMessage
Summary: Returns the fee the cluster will charge for a message.
Parameters:
Returns:
object. {context, value: u64 | null}: fee in lamports, or null if the blockhash has expired.
getRecentPrioritizationFees
Summary: Returns recent per-compute-unit prioritization fees.
Parameters:
Returns:
array<object>. Array of {slot, prioritizationFee} for recent slots.
getMinimumBalanceForRentExemption
Summary: Returns the minimum lamport balance for rent exemption.
Parameters:
Returns:
u64. Minimum rent-exempt balance in lamports.
getGenesisHash
Summary: Returns the genesis hash of the cluster.
Parameters: none
Returns: string. Base-58 encoded genesis hash.
getFirstAvailableBlock
Summary: Returns the slot of the lowest confirmed block still available.
Parameters: none
Returns: u64. Slot of the first available block.
getHighestSnapshotSlot
Summary: Returns the highest slot for which the node has snapshots.
Parameters: none
Returns: object. {full: u64, incremental: u64 | null}.
getRecentPerformanceSamples
Summary: Returns recent network performance samples.
Parameters:
Returns:
array<object>. Array of {slot, numTransactions, numSlots, samplePeriodSecs, numNonVoteTransactions}.
getFees
Deprecated. Use getFeeForMessage instead.
Summary: Returns a recent blockhash and fee schedule (deprecated).
Parameters:
Returns:
object. {context, value: {blockhash, feeCalculator, lastValidSlot, lastValidBlockHeight}}.
getFeeCalculatorForBlockhash
Deprecated. Use getFeeForMessage instead.
Summary: Returns the fee calculator for a blockhash (deprecated).
Parameters:
Returns:
object. {context, value: {feeCalculator: {lamportsPerSignature}} | null}.
getSlot
Summary: Returns the slot that has reached the given commitment level.
Parameters:
Returns:
u64. Current slot.
getSlotLeader
Summary: Returns the current slot leader.
Parameters:
Returns:
string. Base-58 encoded slot leader identity pubkey.
getSlotLeaders
Summary: Returns the slot leaders for a slot range.
Parameters:
Returns:
array<string>. Array of base-58 leader identity pubkeys, one per slot.
getLeaderSchedule
Summary: Returns the leader schedule for an epoch.
Parameters:
Returns:
object | null. Map of leader pubkey → array of slot indices, or null if the epoch has no schedule.
getMaxRetransmitSlot
Summary: Returns the highest slot seen by the retransmit stage.
Parameters: none
Returns: u64. Highest retransmit slot.
getMaxShredInsertSlot
Summary: Returns the highest slot for which shreds have been inserted.
Parameters: none
Returns: u64. Highest shred-insert slot.
minimumLedgerSlot
Summary: Returns the lowest slot the node has information about in its ledger.
Parameters: none
Returns: u64. Lowest retained ledger slot.
getTokenAccountsByOwner
Summary: Returns all SPL token accounts owned by an address.
Parameters:
Returns:
object. {context, value: array<{pubkey, account}>}: token accounts with parsed tokenAmount when jsonParsed.
getTokenAccountBalance
Summary: Returns the token balance of an SPL token account.
Parameters:
Returns:
object. {context, value: {amount, decimals, uiAmount, uiAmountString}}.
getTokenSupply
Summary: Returns the total supply of an SPL token.
Parameters:
Returns:
object. {context, value: {amount, decimals, uiAmount, uiAmountString}}.
getTokenLargestAccounts
Summary: Returns the 20 largest accounts for an SPL token mint.
Parameters:
Returns:
object. {context, value: array<{address, amount, decimals, uiAmount, uiAmountString}>}.
getTokenAccountsByDelegate
Summary: Returns all SPL token accounts delegated to an address.
Parameters:
Returns:
object. {context, value: array<{pubkey, account}>}.
requestAirdrop
Summary: Requests an airdrop of lamports to an account (devnet/testnet).
Parameters:
Returns:
string. Base-58 encoded airdrop transaction signature.
getInflationGovernor
Summary: Returns the current inflation governor parameters.
Parameters:
Returns:
object. {initial, terminal, taper, foundation, foundationTerm}.
getInflationRate
Summary: Returns the inflation rates for the current epoch.
Parameters: none
Returns: object. {total, validator, foundation, epoch}.
getInflationReward
Summary: Returns the inflation/staking reward for a list of addresses.
Parameters:
Returns:
array<object>. Array of {epoch, effectiveSlot, amount, postBalance, commission} | null, one per address.
getSupply
Summary: Returns information about the current supply of SOL.
Parameters:
Returns:
object. {context, value: {total, circulating, nonCirculating, nonCirculatingAccounts}}: values in lamports.
accountSubscribe
Summary: Subscribes to changes to an account.
Parameters:
Returns:
number. Subscription id (used with accountUnsubscribe). Notifications arrive as accountNotification messages.
accountUnsubscribe
Summary: Cancels an account subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.
logsSubscribe
Summary: Subscribes to transaction logging.
Parameters:
Returns:
number. Subscription id (used with logsUnsubscribe). Notifications arrive as logsNotification messages.
logsUnsubscribe
Summary: Cancels a logs subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.
programSubscribe
Summary: Subscribes to changes to all accounts owned by a program.
Parameters:
Returns:
number. Subscription id (used with programUnsubscribe). Notifications arrive as programNotification messages.
programUnsubscribe
Summary: Cancels a program subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.
signatureSubscribe
Summary: Subscribes to receive a notification when a transaction is confirmed.
Parameters:
Returns:
number. Subscription id (used with signatureUnsubscribe). Notifications arrive as signatureNotification messages.
signatureUnsubscribe
Summary: Cancels a signature subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.
slotSubscribe
Summary: Subscribes to receive notification when a slot is processed.
Parameters: none
Returns: number. Subscription id (used with slotUnsubscribe). Notifications arrive as slotNotification messages with {parent, root, slot}.
slotUnsubscribe
Summary: Cancels a slot subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.
blockSubscribe
Summary: Subscribes to receive notification when a new block is confirmed.
Parameters:
Returns:
number. Subscription id (used with blockUnsubscribe). Notifications arrive as blockNotification messages.
blockUnsubscribe
Summary: Cancels a block subscription.
Parameters:
Returns:
boolean. true if the subscription was successfully cancelled.