slot integer. The slot number of the block to retrieve encoded as u64 (64-bit unsigned integer) integer.
object optional. Configuration object containing the following fields:
encoding string
The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
transactionDetails string
(default:full) The level of transaction detail to return. It could be full, accounts, signatures, or none.
rewards boolean
(default:false) A boolean flag that indicates whether to include reward information in the block response.
commitment string. The level of commitment required for the query. The options include:
finalized string
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string
The node will query its most recent block. Note that the block may not be complete.
maxSupportedTransactionVersion boolean
The maximum transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error.
legacy boolean. The older transaction format with no additional benefit.
0 boolean. The additional support for Address Lookup Tables.
Returns
result object. Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
blockHeight. The number of blocks beneath this block.
blockTime. The estimated production time, as Unix timestamp (seconds since the Unix epoch). It's null if not available.
blockhash. The hash of the block encoded as base-58 string.
parentSlot. The slot index of this block's parent.
previousBlockhash. The blockhash of this block's parent encoded as base-58 string; if the parent block is not available due to ledger cleanup, the field will return 11111111111111111111111111111111.
transactions. It is present if full transaction details are requested; an array of JSON objects with the following fields:
meta. The transaction status metadata object, which contains additional information about the block and its transactions. The meta object can be null, or it may contain the following fields:
err. Error code if the transaction failed or null if the transaction succeeds.
fee. The total fees paid by all transactions in the block encoded as u64 integer.
innerInstructions. An array of objects representing the inner instructions of all transactions in the block (omitted if inner instruction recording is not enabled). Each object has the following fields:
logMessages. An array of strings containing any log messages generated by the block's transactions (omitted if inner instruction recording is not enabled).
postBalances. An array of lamport balances for each account in the block after the transactions were processed.
postTokenBalances. An array of token balances for each token account in the block after the transactions were processed (omitted if inner instruction recording is not enabled).
preBalances. An array of lamport balances for each account in the block before the transactions were processed.
preTokenBalances. An array of token balances for each token account in the block before the transactions were processed (omitted if inner instruction recording is not enabled).
rewards. An object containing information about the rewards earned by the block's validators (only present if the rewards are requested). It has the following fields:
pubkey. The public key of the account that received the award encoded as base-58 string.
lamports. The number of reward lamports credited or debited by the account.
postBalance. The account balance in lamports after the reward was applied.
rewardType. The type of reward. It could be fee, rent, voting, staking.
commission. The vote account commission when the reward was credited, only present for voting and staking rewards.
status. The status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError.
transaction. The transaction object. It could be either JSON format or encoded binary data, depending on the encoding parameter. It contains the following fields:
message. An array of transactions included in the block.
accountKeys. An array of public keys associated with the accounts that were accessed during the execution of transactions in the block.
pubkey. The public key associated with the block producer who created the block.
signer. It is used to sign transactions in the block. It can also be used to identify the signers involved in the block's transactions and to verify the authenticity of the signatures.
source. It is used to identify the accounts that provided the funds for the block's transactions.
writable. A boolean value that indicates whether the accounts associated with the given public keys were modified by the transactions or not.
instructions. An array of instructions that were executed in the block's transactions.
parsed. An array of parsed instructions that were executed in the block's transactions.
info. An array of information objects that provide additional details about the transactions in the block.
clockSysvar. It provides information about the current state of the Solana blockchain.
slotHashesSysvar. It provides information about the hashes of recent slots.
vote. An array of vote accounts that were involved in the block's transactions.
hash. The hash of the block. It can be used to uniquely identify the block and to verify the authenticity of the block's contents.
slots. An array of slot numbers that correspond to the transactions in the block.
timestamp. The Unix timestamp of the block's creation.
voteAccount. A vote account to identify the validator who produced the block and to verify the validity of their vote.
voteAuthority. An authority associated with the vote account used to produce the block.
type. The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks.
program. The data associated with the program that was executed in the block's transactions.
programId. The public key of the program that was executed in the block's transactions.
stackHeight. The current depth of the execution stack.
recentBlockhash. The recent block hash for the account's cluster.
signatures. The list of transaction signatures contained within a particular block.
version. The transaction version. It's undefined if maxSupportedTransactionVersion is not set in the requested parameters.
addressstring Required. The Pubkey of the account to query encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
encoding string.
The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
dataSlice string.
The returned account data using the provided offset: <usize> and length: <usize> fields; only available for base58, base64, or base64+zstd encodings.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result object. Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
context
An object that contains metadata about the current state of the Solana network at the time the request was processed.
apiVersion - The version number.
slot - The current slot in the Solana cluster during which the transactions are processed and new blocks are added to the blockchain.
value -The balance of the account of provided Pubkey in lamports (1 billion lamports = 1 SOL).
addressstring Required. The Pubkey of the account to query encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
encoding string.
The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
dataSlice string.
The returned account data using the provided offset: <usize> and length: <usize> fields; only available for base58, base64, or base64+zstd encodings.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result object. Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
context
An object that contains metadata about the current state of the Solana network at the time the request was processed.
apiVersion - The version number.
slot - The current slot in the Solana cluster during which the transactions are processed and new blocks are added to the blockchain.
value
An object that contains information about the requested account
lamports - The number of lamports assigned to this account as u64 (64-bit unsigned integer).
owner - The base-58 encoded Pubkey of the program this account has been assigned to.
data - The data associated with the account, either as encoded binary data or JSON format {'program': 'state'}, depending on encoding parameter.
executable - A boolean indicating if the account contains a program (and is strictly read-only).
rentEpoch - The epoch at which this account will next owe rent, as u64 (64-bit unsigned integer).
space - The amount of storage space required to store the token account.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
range array. The slot range to return block production for. If parameter is not provided, the default value is current epoch.
firstSlot string. The first slot to return block production information for (inclusive).
lastSlot string. The last slot to return block production information for (inclusive). If the parameter is not provided, the default value is highest slot.
identity string. The results for this validator identity encoded in base-58.
Returns
result The custom object with the following fields:
context. The additional context to retrieve the block production information.
apiVersion. The API version.
slot. The slot number to retrieve block production information.
value. Information about the block production in the specified slot range.
byIdentity. A dictionary of validator identities, as base-58 encoded strings. Value is a two element array containing the number of leader slots and the number of blocks produced.
range. The block production slot range.
firstSlot. The first slot of the block production information (inclusive).
lastSlot. The last slot of the block production information (inclusive).
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The current block height encoded in u64 format.
// Result
{
"jsonrpc": "2.0",
"result": 298214571,
"id": 1
}
block number integer Required. The block number identified by the slot.
Returns
result object. A custom object with the following fields:
commitment. The commitment values for the block. It could be either:
null. Null if the block is unknown.
array. An array of u64 integers logging the amount of cluster stake in lamports that has voted on the block at each depth from 0 to MAX_LOCKOUT_HISTORY + 1
totalStake. The total number of lamports being used by validators to participate in the block production and voting process.
Returns a list of confirmed blocks between two slots.
This method will use 30 .
Parameters
start_slot string Required. The start slot encoded as an u64 integer.
end_slot string. The end slot encoded as an u64 integer.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
Returns
result An array of u64 integers listing confirmed blocks between the start_slot and either end_slot - if provided, or latest confirmed block, inclusive. The maximum range allowed is 500,000 slots.
Returns a list of confirmed blocks starting at the given slot.
This method will use 30 .
Parameters
start_slot string Required. The start slot encoded as an u64 integer.
limit string Required. The limit encoded as u64, 64-bit unsigned integer.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
Returns
result An array of u64 integers listing confirmed blocks between the start_slot and either end_slot - if provided, or latest confirmed block, inclusive. The maximum range allowed is 500,000 slots.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result An object with the following fields:
absoluteSlot. The current slot
blockHeight. The current block height
epoch. The current epoch.
slotIndex. The current slot relative to the start of the current epoch.
slotsInEpoch. The number of slots in this epoch.
transactionCount. The total number of transactions processed during the current epoch
result Ok, if the node is healthy or JSON RPC error response, if the node is unhealthy. Please note that the specifics of the error response are UNSTABLE and may change in the future.
// Result
{
"jsonrpc": "2.0",
"result": "ok",
"id": 1
}
Returns epoch schedule information from this cluster's genesis config.
This method will use 30 .
Parameters
messagestring Required. The transaction message encoded as base64.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
maxSupportedTransactionVersion number
The maximum supported transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error.
Returns
result Null if the transaction message is not found otherwise RpcResponse JSON object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value (u64 | null). The fee corresponding to the message at the specified blockhash.
u64 string optional. Fetchs the leader schedule for the epoch that corresponds to the provided slot. If unspecified, the leader schedule for the current epoch is fetched.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
identity string. Only returns the results for this validator identity encoded as base-58.
Returns
result Null if the requested epoch is not found otherwise the result field will be a dictionary of validator identities, as base-58 encoded strings, and their corresponding leader slot indices as values (indices are relative to the first slot in the requested epoch)
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
Returns
result The minimum lamports required in an account to remain rent free, which is encoded as u64, 64-bit unsigned integer.
// Result
{
"jsonrpc": "2.0",
"result": 1238880,
"id": 1
}
array string Required. An array of addresses to query, as base-58 encoded strings
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
epoch integer. An epoch for which the reward occurs. If omitted, the previous epoch will be used.
minContextSlot integer. The minimum slot that the request can be evaluated at.
Returns
result The result will be an object with the following fields:
epoch The epoch during which the reward was received.
effectiveSlot The slot at which the rewards become active.
amount The reward value in lamports.
postBalance The account balance after the transaction in lamports.
commission The commission rate of the vote account at the time the reward was credited.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
Returns
result The result will be an object with the following fields:
foundation The proportion of total inflation allocated to the foundation.
foundationTerm The time period in years during which the foundation allocation will be paid out.
initial The initial inflation percentage from time 0.
taper The time period in years during which the inflation rate will gradually decrease from the initial rate to the final rate.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
filter string. Filters results by account type; currently supported: circulating and nonCirculating.
Returns
result Null if the requested account doesn't exist otherwise RpcResponse JSON object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
address The address of the account encoded as base-58.
lamports The number of lamports in the account as u64, 64-bit unsigned integer.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The RpcResponse JSON object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
blockhash The block hash encoded as base-58 string.
lastValidBlockHeight The last block height at which the blockhash will be valid.
pubkey string. The Pubkey of program encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
withContext boolean. Wraps the result in a RpcResponse JSON object.
filters array. Filter results using up to 4 filter objects.
dataSlice string. The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings.
encoding string. (default: json) The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
Returns
result The result will be RpcResponse JSON object with the following fields:
pubkey The public key of the node encoded as base-58 string.
account A JSON object with the following fields:
lamports The number of lamports assigned to this account as u64 (64-bit unsigned integer).
owner The base-58 encoded Pubkey of the program this account has been assigned to.
data The data associated with the account, either as encoded binary data or JSON format {'program': 'state'}, depending on encoding parameter.
executable A boolean indicating if the account contains a program (and is strictly read-only).
rentEpoch The epoch at which this account will next owe rent, as u64 (64-bit unsigned integer).
space The amount of storage space required to store the token account.
Returns a list of recent performance samples, in reverse slot order. Performance samples are taken every 60 seconds and include the number of transactions and slots that occur in a given time window.
array string. An array of Pubkeys to query encoded as base-58 strings (up to a maximum of 100).
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
encoding string. (default: json) The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
dataSlice string. The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
context An object that contains metadata about the current state of the Solana network at the time the request was processed.
apiVersion The version of the Solana RPC API to use.
slot The current slot in the Solana cluster during which the transactions are processed and new blocks are added to the blockchain.
value An object that contains information about the requested account.
data The data associated with the account, either as encoded binary data or JSON format {'program': 'state'}, depending on encoding parameter.
executable A boolean value indicating whether the account holds a program and is therefore restricted to read-only access.
lamports The quantity of lamports allocated to this account as u64 (64-bit unsigned integer).
owner The base-58 encoded public key of the program to which this account has been assigned.
rentEpoch The epoch, represented as a 64-bit unsigned integer (u64), at which this account will next be due for rent.
space The amount of storage space required to store the token account.
The getParsedTransaction method is only supported with the @solana/web3.js SDK. To use cURL or solana.py, check out the getTransaction method examples where the encoding is set to jsonParsed.
Parameters
slot integer The slot number of the block to retrieve encoded as u64 (64-bit unsigned integer) integer.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
maxSupportedTransactionVersion boolean. The maximum transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error.
legacy boolean. The older transaction format with no additional benefit.
0 boolean. The additional support for Address Lookup Tables.
Returns
result The result will be null if the specified transaction is not confirmed otherwise an object with the following fields:
slot The slot number in which the transaction was processed.
parsedTransaction The parsed transaction object with the following fields:
signatures An array of signatures on the transaction.
parsedMessage The parsed message of the transaction.
accountKeys An array of public keys involved in the transaction.
instructions An array of instructions that were executed in the block's transactions.
recentBlockhash The recent blockhash from the transaction.
addressTableLookups An array of address lookups that were performed during the execution of transactions in the block.
blockTime The estimated production time, as Unix timestamp (seconds since the Unix epoch). It's null if not available.
meta The transaction status metadata object with the following fields:
err Error code if the transaction failed or null if the transaction succeeds.
fee The total fees paid by all transactions in the block encoded as u64 integer.
preBalances An array of lamport balances for each account in the block before the transactions were processed.
postBalances An array of lamport balances for each account in the block after the transactions were processed.
parsedInnerInstructions List of inner instructions or omitted if inner instruction recording was not yet enabled during this transaction.
preTokenBalances An array of token balances for each token account in the block before the transactions were processed (omitted if inner instruction recording is not enabled).
postTokenBalances An array of token balances for each token account in the block after the transactions were processed (omitted if inner instruction recording is not enabled).
logMessages An array of strings containing any log messages generated by the block's transactions (omitted if inner instruction recording is not enabled).
rewards An object containing information about the rewards earned by the block's validators (only present if the rewards are requested). It has the following fields:
pubkey The public key of the account that received the award encoded as base-58 string.
lamports The number of reward lamports credited or debited by the account.
postBalance The account balance in lamports after the reward was applied.
rewardType The type of reward. It could be fee, rent, voting, staking.
commission The vote account commission when the reward was credited, only present for voting and staking rewards.
loadedAddresses The list of loaded addresses objects.
readonly The ordered list of base-58 encoded addresses for readonly loaded accounts.
writable The ordered list of base-58 encoded addresses for writable loaded accounts.
version The transaction version. It's undefined if maxSupportedTransactionVersion is not set in the requested parameters.
The getParsedBlock method is only supported with the @solana/web3.js SDK. To use cURL or solana.py, check out the getBlock method examples where the encoding is set to jsonParsed.
Parameters
slot_number string. The slot number encoded as u64, 64-bit unsigned integer.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
encoding string. (default: json) The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
transactionDetails string (default: full). It specifies the level of transaction details to include in the response. The possible values are full, signatures, and none.
rewards boolean (default: true) It determines whether to populate the rewards array or not.
maxSupportedTransactionVersion boolean. The maximum transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error.
legacy boolean. The older transaction format with no additional benefit.
0 boolean. The additional support for Address Lookup Tables.
Returns
result object. Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
blockhash. The hash of the block encoded as base-58 string.
previousBlockhash. The blockhash of this block's parent encoded as base-58 string.
parentSlot. The slot number of this block's parent.
transactions. An array of transaction objects within the block. Each transaction object contains the following fields:
meta. The transaction status metadata object with the following fields:
err. Error code if the transaction failed or null if the transaction succeeds.
fee. The total fees paid by all transactions in the block encoded as u64 integer.
innerInstructions. The list of inner instructions and it's omitted or null if inner instruction recording was not yet enabled during the transaction.
loadedAddresses The list of loaded addresses objects.
readonly The ordered list of base-58 encoded addresses for readonly loaded accounts.
writable The ordered list of base-58 encoded addresses for writable loaded accounts.
logMessages. An array of string log messages. Omitted or null if log message recording was not yet enabled during the transaction
postBalances. An array of lamport balances for each account in the block after the transactions were processed.
postTokenBalances. The list of token balances from after the transaction was processed and it's omitted if inner instruction recording was not yet enabled during the transaction
preBalances. An array of lamport balances for each account in the block before the transactions were processed.
preTokenBalances. The list of token balances from before the transaction was processed and it's omitted if inner instruction recording was not yet enabled during the transaction
rewards. An array of reward objects detailing the rewards for this block. It is only present if rewards are requested; an array of JSON objects with the following fields:
pubkey. The public key of the account that received the award encoded as base-58 string.
lamports. The number of reward lamports credited or debited by the account.
postBalance. The account balance in lamports after the reward was applied.
rewardType. The type of reward. It could be fee, rent, voting, staking.
commission. The vote account commission when the reward was credited, only present for voting and staking rewards.
status. The status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError.
transaction. The transaction object with the following fields:
message. The transaction message containing the following fields:
accountKeys. An array of public keys involved in the transaction.
header An object containing the transaction's header, including the following fields:
numRequiredSignatures The number of required signatures for the transaction.
numReadonlySignedAccounts The number of readonly accounts that have signed the transaction.
numReadonlyUnsignedAccounts The number of readonly accounts that have not signed the transaction.
instructions. An array of instruction objects for the transaction with the following fields:
accounts An array of integers representing the indices of accounts involved in the instruction.
data The instruction data encoded in the specified format.
programIdIndex The index of the program ID in the accountKeys.
recentBlockhash. The most recent blockhash used for the transaction
signatures. An array of signatures strings corresponding to the transaction order in the block.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The current slot leader as base-58 encoded string.
// Result
{
"jsonrpc": "2.0",
"result": "EfPYQ4BUMiKa6736qqrtnCBGkUSRDGSr1WvtyUgWHuyp",
"id": 1
}
Returns confirmed signatures for transactions involving an address backwards in time from the provided signature or most recent confirmed block.
This method will use 30 .
Parameters
account_addressstring Required. The account address encoded as base-58 string.
object optional. Configuration object containing the following fields:
limit integer. The maximum number of transaction signatures to return (between 1 and 1000). The default value is 1000.
before string. Start searching backward from this transaction signature. If not provided, the search starts from the top of the highest max confirmed block.
until string. Searches until this transaction signature, if found before limit reached.
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result A JSON object with the following fields:
blockTime The estimated production time, as Unix timestamp (seconds since the Unix epoch). Null if not available.
confirmationStatus The transaction's cluster confirmation status. The status can either be processed, confirmed, or finalized.
err Error code if the transaction failed or null if the transaction succeeds.
memo The memo associated with the transaction and null if no memo is present.
signature The base58-encoded signature of the transaction.
slot The slot number in which the transaction was confirmed.
Returns the statuses of a list of signatures. Unless the searchTransactionHistory configuration parameter is included, this method only searches the recent status cache of signatures, which retains statuses for all active slots plus MAX_RECENT_BLOCKHASHES rooted slots.
This method will use 30 .
Parameters
tx signatures string. An array of transaction signatures to confirm encoded as base-58 strings.
object array. The configuration object with the following fields:
searchTransactionHistory boolean (default: false). If true, the search includes the entire transaction history. If false, the search only includes recent transactions in the latest confirmed block.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
confirmationStatus The transaction's cluster confirmation status. It can either be processed, confirmed, or finalized.
confirmations The number of confirmations a transaction has received. If the transaction is finalized (i.e., confirmed at the highest level of commitment), the value will be null.
err Error code if the transaction failed or null if the transaction succeeds.
slot The slot number in which the transaction was confirmed.
status The processing status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
circulating The total circulating supply of SOL tokens, encoded as u64 integer.
nonCirculating The total non-circulating supply of SOL tokens, encoded as u64 integer.
nonCirculatingAccounts An array containing the public keys (addresses) of accounts holding non-circulating tokens.
Returns the slot that has reached the given or default commitment level.
This method will use 30 .
Parameters
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string.
The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string.
The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string.
The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result Returns the current slot number.
// Result
{
"jsonrpc": "2.0",
"result": 320162469,
"id": 1
}
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
recent string. The node will query the minimum delegation commitment status for recent transactions.
single string. The node will query the minimum delegation commitment status for a single transaction.
singleGossip string. The node will query the minimum delegation commitment status for a single transaction via gossip.
root string. The node will query the minimum delegation commitment status at the root.
max string. The node will query the maximum commitment status for minimum delegation.
pubkey string. The Pubkey of token Mint to query encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
pubkey string. The Pubkey of account delegate to query encoded as base-58 string.
object array. The JSON object with the following fields:
mint string. The Pubkey of the specific token Mint to limit accounts to, as base-58 encoded string.
programId string. The Pubkey of the Token program ID that owns the accounts, as base-58 encoded string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
encoding string. The encoding format for account data. It can be one of base58 (slow, base64, base64+zstd or jsonParsed.
dataSlice string The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings.
minContextSlot integer The minimum slot at which the request can be evaluated.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
account An address on the Solana blockchain that is used to store assets.
data A string containing the encoded data to be passed to the instruction.
program The program that manages the token.
parsed An array of parsed instructions that were executed in the block's transactions.
info An array of information objects that provide additional details about the transactions in the block.
tokenAmount The balance of the token in the token account.
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
delegate The public address of the delegate from which the account tokens are to be retrieved encoded as base-58 string.
delegateAmount The configuration object with the following fields:
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
isNative A boolean value indicating whether the token is a native token of the Solana blockchain.
mint Provides information about the creation of new tokens.
owner The base-58 encoded Pubkey of the program this account has been assigned to.
state The current state of the token account.
type The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks.
space The amount of storage space required to store the token account.
pubkey The public key associated with the token account.
Returns the 20 largest accounts of a particular SPL Token type.
This method will use 30 .
Parameters
pubkey string. The Pubkey of token Mint to query encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
address The address of the token account.
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
pubkey string. The Pubkey of account delegate to query encoded as base-58 string.
object array. The JSON object with the following fields:
mint string. The Pubkey of the specific token Mint to limit accounts to, as base-58 encoded string.
programId string. The Pubkey of the Token program ID that owns the accounts, as base-58 encoded string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
encoding string. The encoding format for account data. It can be one of base58 (slow, base64, base64+zstd or jsonParsed.
dataSlice string The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings.
minContextSlot integer The minimum slot at which the request can be evaluated.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
account An address on the Solana blockchain that is used to store assets.
data A string containing the encoded data to be passed to the instruction.
parsed An array of parsed instructions that were executed in the block's transactions.
info An array of information objects that provide additional details about the transactions in the block.
isNative A boolean value indicating whether the token is a native token of the Solana blockchain.
mint Provides information about the creation of new tokens.
owner The base-58 encoded Pubkey of the program this account has been assigned to.
state The current state of the token account.
tokenAmount The balance of the token in the token account.
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
type The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks.
program The program that manages the token.
space The amount of storage space required to store the token account.
executable A boolean indicating if the account contains a program (and is strictly read-only).
lamports The number of lamports assigned to this account as u64 (64-bit unsigned integer).
owner The base-58 encoded Pubkey of the program this account has been assigned to.
rentEpoch The epoch at which the token account's storage will be subject to rent.
space The amount of storage space required to store the token account.
pubkey The public key associated with the token account.
pubkey string. The Pubkey of program encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
Returns
result An object with the following fields:
context The information about the current state of the program.
apiVersion The version of the Solana RPC API to use.
slot An integer representing the slot for which to retrieve the fee calculator.
value A JSON object with the following fields:
amount The raw total token supply without decimals, a string representation of a u64 integer.
decimals An integer value representing the number of decimal places used by the token.
uiAmount The total token supply using mint-prescribed decimals (DEPRECATED).
uiAmountString The total token supply as a string using mint-prescribed decimals.
Returns transaction details for a confirmed transaction.
This method will use 30 .
Parameters
tx_sig string. The transaction signature as base-58 encoded string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
maxSupportedTransactionVersion integer. The maximum transaction version to return in responses. If the requested block contains a transaction with a higher version, an error will be returned. If this parameter is omitted, only legacy transactions will be returned, and a block containing any versioned transaction will prompt an error.
Returns
result Null if the specified block is not confirmed otherwise RpcResponse JSON object with the following fields:
blockTime The estimated production time, as Unix timestamp (seconds since the Unix epoch). It's null if not available.
meta The transaction status metadata object, which contains additional information about the block and its transactions. The meta object can be null, or it may contain the following fields:
err Error code if the transaction failed or null if the transaction succeeds.
fee The total fees paid by all transactions in the block encoded as u64 integer.
innerInstructions An array of objects representing the inner instructions of all transactions in the block (omitted if inner instruction recording is not enabled). Each object has the following fields:
index The index of the instruction in the transaction, which determines the order in which the operations were executed.
instructions An array of instructions that were executed in the block's transactions.
parsed An array of parsed instructions that were executed in the block's transactions.
info An array of information objects that provide additional details about the transactions in the block.
lamports The number of lamports assigned to this account as u64 (64-bit unsigned integer).
newAccount The new account created as part of the transaction.
owner The base-58 encoded Pubkey of the program this account has been assigned to.
source The source account that funded the transaction.
space The amount of storage space required to store a specific transaction.
type The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks.
program The data associated with the program that was executed in the block's transactions.
programId The ID of the program that executed the instruction.
stackHeight The current depth of the execution stack.
logMessages An array of strings containing any log messages generated by the block's transactions (omitted if inner instruction recording is not enabled).
postBalances An array of lamport balances for each account in the block after the transactions were processed.
postTokenBalances An array of token balances for each token account in the block after the transactions were processed (omitted if inner instruction recording is not enabled).
accountIndex The index of an account within a transaction.
mint Provides information about the creation of new tokens.
owner The base-58 encoded Pubkey of the program this account has been assigned to.
uiTokenAmount The amount of a token transfer in a human-readable format.
amount The amount of a token transfer.
decimals The number of decimal places used by the token.
uiAmount The amount of a token transfer in the smallest unit of the token.
uiAmountString The amount of a token transfer as a string with the appropriate number of decimal places for the token.
preBalances An array of lamport balances for each account in the block before the transactions were processed.
preTokenBalances An array of token balances for each token account in the block before the transactions were processed (omitted if inner instruction recording is not enabled).
accountIndex The index of an account within a transaction.
mint Provides information about the creation of new tokens.
owner The base-58 encoded Pubkey of the program this account has been assigned to.
uiTokenAmount The amount of a token transfer in a human-readable format.
amount The amount of a token transfer.
decimals The number of decimal places used by the token.
uiAmount The amount of a token transfer in the smallest unit of the token.
uiAmountString The amount of a token transfer as a string with the appropriate number of decimal places for the token.
rewards An object containing information about the rewards earned by the block's validators (only present if the rewards are requested).
status The status of the transaction. If the transaction was successful, returns Ok and if the transaction failed with TransactionError, returns Err.
slot The slot number to retrieve block production information.
transaction The transaction object. It could be either JSON format or encoded binary data, depending on the encoding parameter.
message An array of transactions included in the block.
accountKeys An array of public keys associated with the accounts that were accessed during the execution of transactions in the block.
pubkey The Pubkey of program encoded as base-58 string.
signer Used to sign transactions in the block. Also used to identify the signers involved in the block's transactions and to verify the authenticity of the signatures.
source The source account that funded the transaction.
writable A boolean value that indicates whether the accounts associated with the given public keys were modified by the transactions or not.
instructions An array of instructions that were executed in the block's transactions.
parsed An array of parsed instructions that were executed in the block's transactions.
info An array of information objects that provide additional details about the transactions in the block.
account An address on the Solana blockchain that is used to store assets.
mint Provides information about the creation of new tokens.
source The source account that funded the transaction.
systemProgram The system program that executed the transaction.
tokenProgram Responsible for maintaining the supply and balance of the token, and for executing transfers of the token between accounts.
wallet Wallet is used for managing and storing assets.
type The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks.
program The data associated with the program that was executed in the block's transactions.
programId The ID of the program that executed the instruction.
recentBlockhash The recent block hash for the account's cluster.
signatures The list of transaction signatures contained within a particular block.
version The transaction version. It's undefined if maxSupportedTransactionVersion is not set in the requested parameters.
Returns the account info and associated stake for all the voting accounts in the current bank.
This method will use 30 .
Parameters
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
votePubkey string (optional). Only return results for this validator vote address (base-58 encoded).
keepUnstakedDelinquents boolean. The boolean value that determines whether or not to filter out delinquent validators with no stake.
delinquentSlotDistance u64. Specify the number of slots behind the tip that a validator must fall to be considered delinquent. The parameter is passed as an integer and it's not recomended to specify this argument.
Returns
result A JSON object of current and delinquent accounts, each containing an array of JSON objects with the following fields:
current The current account with the following fields:
activatedStake The stake, in lamports, delegated to this vote account and active in this epoch. Represented as an u64 integer.
commission The percentage (0-100) of rewards payout owed to the vote account.
epochCredits The latest history of earned credits for up to five epochs, as an array of arrays containing: epoch, credits, previousCredits.
epochVoteAccount Boolean value, whether the vote account is staked for this epoch.
lastVote Most recent slot voted on by this vote account.
nodePubkey The validator identity as base-58 encoded string.
rootSlot The current root slot for this vote account.
votePubkey The vote account address as base-58 encoded string.
delinquent The delinquent account with the following fields:
activatedStake The stake, in lamports, delegated to this vote account and active in this epoch. Represented as an u64 integer.
commission The percentage (0-100) of rewards payout owed to the vote account.
epochCredits The latest history of earned credits for up to five epochs, as an array of arrays containing: epoch, credits, previousCredits.
epochVoteAccount Boolean value, whether the vote account is staked for this epoch.
lastVote Most recent slot voted on by this vote account.
nodePubkey The validator identity as base-58 encoded string.
rootSlot The current root slot for this vote account.
votePubkey The vote account address as base-58 encoded string.
Returns whether a blockhash is still valid or not.
This method will use 30 .
Parameters
blockhashstring Required. The hash of the block encoded as base-58 string.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result True if the blockhash is still valid otherwise false.
Returns the current transaction count from the ledger.
This method will use 30 .
Parameters
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The current transaction count from the ledger.
// Result
{ "jsonrpc": "2.0", "result": 268, "id": 1 }
Requests an airdrop of lamports to a Pubkey (does not work on mainnet).
This method will use 30 .
Parameters
pubkey string. The Pubkey of account to receive lamports, as a base-58 encoded string.
lamports integer The lamports to airdrop, as a u64.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The transaction signature of the airdrop, as a base-58 encoded string.
// Result
{
"jsonrpc": "2.0",
"result": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"id": 1
}
Submits a signed transaction to the cluster for processing.
This method will use 30 .
Parameters
transaction string The transaction as an encoded string.
object optional. Configuration object containing the following fields:
skipPreflight boolean (default: false) If true, skip the preflight transaction checks.
preflightCommitment string (default: finalized) The commitment level to use for preflight.
encoding string The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
maxRetries usize The maximum number of times for the RPC node to retry sending the transaction to the leader. If this parameter is not provided, the RPC node will retry the transaction until it is finalized or until the blockhash expires.
minContextSlot integer. The minimum slot at which the request can be evaluated.
Returns
result The First Transaction Signature embedded in the transaction, as base-58 encoded string (transaction id).
// Result
{
"jsonrpc": "2.0",
"result": "2id3YC2jK9G5Wo2phDx4gJVAew8DcY5NAojnVuao8rkxwPYPe8cSwE5GzhEgJA2y8fVjDEo6iR6ykBvDxrTQrtpb",
"id": 1
}
transaction string The transaction as an encoded string. The transaction must have a valid blockhash, but is not required to be signed.
object optional. Configuration object containing the following fields:
commitment string. The level of commitment required for the query. The options include:
finalized string. The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
sigVerify boolean (default: false) If true, the transaction signatures will be verified (conflicts with replaceRecentBlockhash).
replaceRecentBlockhash boolean (default: false) If true, the transaction recent blockhash will be replaced with the most recent blockhash (conflicts with sigVerify).
encoding string (default: base58) The encoding format for account data. It can be either base58 (slow, DEPRECATED) or base64.
minContextSlot integer. The minimum slot at which the request can be evaluated.
innerInstructions boolean (default: false) If true the response will include inner instructions. These inner instructions will be jsonParsed where possible, otherwise json.
accounts object The accounts configuration object containing the following fields:
addresses string An array of accounts to return, as base-58 encoded strings
encoding string The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed.
Returns
result Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:
context An object that contains metadata about the current state of the Solana network at the time the request was processed.
apiVersion The version number.
slot The current slot in the Solana cluster during which the transactions are processed and new blocks are added to the blockchain.
err Error code if the transaction failed or null if the transaction succeeds.
logs An array of log messages the transaction instructions output during execution, null if simulation failed before the transaction was able to execute (for example due to an invalid blockhash or signature verification failure).
accounts An array of accounts with the same length as the accounts.addresses array in the request
null If the account doesn't exist or if err is not null.
object otherwise, a JSON object containing:
lamports The number of lamports assigned to this account as u64 (64-bit unsigned integer).
owner The base-58 encoded Pubkey of the program this account has been assigned to.
data The data associated with the account, either as encoded binary data or JSON format {'program': 'state'}, depending on encoding parameter.
executable A boolean indicating if the account contains a program (and is strictly read-only).
rentEpoch The epoch at which this account will next owe rent, as u64 (64-bit unsigned integer).
unitsConsumed The number of compute budget units consumed during the processing of this transaction.
returnData The most-recent return data generated by an instruction in the transaction, with the following fields:
programId string The program that generated the return data, as base-58 encoded Pubkey.
data The return data itself, as base-64 encoded binary data.
innerInstructions The value is a list of inner instructions.