Skip to main content

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.