Solana transaction simulation for builders and traders

These methods handle the creation, simulation, and inspection of transactions on the blockchain. They are essential for executing state changes, estimating fees, checking transaction outcomes, and monitoring transaction lifecycles.

getSignatureStatuses

Returns the signature statuses for a given signature.

Parameters

Name	Type	Description
`signatures`*	`array[string]`	An array of transaction signatures to query, as base-58 encoded strings.
`config`	`object`	Configuration object for the query.
└`searchTransactionHistory`	`boolean`	Whether to search the transaction history.

Result

Field	Type	Description
`context`	`object`
└`apiVersion`	`string`	The API version
└`slot`	`integer`	The current slot
`value`	`array<any>`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignatureStatuses",
  "params": {
    "signatures": [
      "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW"
    ],
    "config": {
      "searchTransactionHistory": true
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "getSignatureStatuses",  "params": {    "signatures": [      "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW"    ],    "config": {      "searchTransactionHistory": true    }  }}

requestAirdrop

Requests an airdrop to a given address.

Parameters

Name	Type	Description
`pubkey`*	`string`	The public key of the account to receive the airdrop, as a base-58 encoded string.
`lamports`*	`integer`	The amount of lamports to airdrop.
`config`	`object`	Configuration object for the query.
└`commitment`	`string \| string \| string`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'

Result

Field	Type	Description
`result`	`string`	requestAirdrop - Requests an airdrop to a given address

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "requestAirdrop",
  "params": {
    "pubkey": "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    "lamports": 1000000000,
    "config": {
      "commitment": "Processed"
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "requestAirdrop",  "params": {    "pubkey": "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",    "lamports": 1000000000,    "config": {      "commitment": "Processed"    }  }}

sendTransaction

Sends a transaction to the cluster.

Parameters

Name	Type	Description
`transaction`*	`string`	The signed transaction, as a base-64 encoded string.
`config`	`object`	Configuration object for the query.
└`encoding`	`string`	The encoding for the transaction.
└`maxRetries`	`integer`	The maximum number of retries for the transaction.
└`minContextSlot`	`integer`	The minimum context slot for the transaction.
└`preflightCommitment`	`string`	The commitment level for the preflight check.
└`skipPreflight`	`boolean`	Whether to skip the preflight check.

Result

Field	Type	Description
`result`	`string`	sendTransaction - Sends a transaction to the cluster

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sendTransaction",
  "params": {
    "transaction": "<some-transaction>",
    "config": {
      "encoding": "binary",
      "maxRetries": 0,
      "minContextSlot": 123456789,
      "preflightCommitment": "Processed",
      "skipPreflight": true
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "sendTransaction",  "params": {    "transaction": "<some-transaction>",    "config": {      "encoding": "binary",      "maxRetries": 0,      "minContextSlot": 123456789,      "preflightCommitment": "Processed",      "skipPreflight": true    }  }}

simulateTransaction

Simulates a transaction.

Parameters

Name	Type	Description
`transaction`*	`string`	The transaction to simulate, as a base-64 encoded string.
`config`	`object`	Configuration object for the query.
└`accounts`	`object`	Accounts to return in the simulation result.
└`addresses`	`array[string]`	An array of account addresses to return, as base-58 encoded strings.
└`encoding`	`string`	Encoding for the account data.
└`commitment`	`string \| string \| string`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'
└`encoding`	`string`	Encoding for the transaction data.
└`innerInstructions`	`boolean`	Whether to include inner instructions in the simulation result.
└`minContextSlot`	`integer`	Mincontextslot
└`replaceRecentBlockhash`	`boolean`	Whether to replace the recent blockhash with a new one.
└`sigVerify`	`boolean`	Whether to verify transaction signatures.

Result

Field	Type	Description
`context`	`object`
└`apiVersion`	`string`	The API version
└`slot`	`integer`	The current slot
`value`	`object`
└`accounts`	`array`
└`err`	`object`
└`errorType`	`string`	Error type
└`message`	`string`	Error message
└`innerInstructions`	`array`
└`logs`	`array`
└`replacementBlockhash`	`object`
└`blockhash`	`string`
└`lastValidBlockHeight`	`integer`
└`returnData`	`object`
└`data`	`array<string>`	Returned data
└`programId`	`string`	Program ID that returned the data
└`unitsConsumed`	`integer`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "simulateTransaction",
  "params": {
    "transaction": "<some-transaction>",
    "config": {
      "accounts": {
        "addresses": [
          "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
        ],
        "encoding": "binary"
      },
      "commitment": "Processed",
      "encoding": "binary",
      "innerInstructions": true,
      "minContextSlot": 123456789,
      "replaceRecentBlockhash": true,
      "sigVerify": true
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "simulateTransaction",  "params": {    "transaction": "<some-transaction>",    "config": {      "accounts": {        "addresses": [          "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"        ],        "encoding": "binary"      },      "commitment": "Processed",      "encoding": "binary",      "innerInstructions": true,      "minContextSlot": 123456789,      "replaceRecentBlockhash": true,      "sigVerify": true    }  }}

getTransaction

Returns the transaction for a given signature.

Parameters

Name	Type	Description
`signature`*	`string`	The transaction signature to query, as a base-58 encoded string.
`config`	`object`	Configuration object for the query.
└`commitment`	`object`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'.
└`commitment`	`string \| string \| string`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'
└`maxSupportedTransactionVersion`	`integer`	The maximum transaction version to support.

Result

Field	Type	Description
`blockTime`	`integer`	Block time
`meta`	`object`	Transaction metadata
└`computeUnitsConsumed`	`integer`	Compute units consumed
└`err`	`object`	Transaction error
└`errorType`	`string`	Error type
└`message`	`string`	Error message
└`fee`	`integer`	Transaction fee
└`innerInstructions`	`array`	Inner instructions
└`logMessages`	`array`	Log messages
└`postBalances`	`array<integer>`	Account balances after transaction
└`postTokenBalances`	`array`	Post token balances
└`preBalances`	`array<integer>`	Account balances before transaction
└`preTokenBalances`	`array`	Pre token balances
└`returnData`	`object`	Return data
└`data`	`array<string>`	Returned data
└`programId`	`string`	Program ID that returned the data
`slot`	`integer`	The transaction slot
`transaction`	`object`	The encoded transaction
└`message`	`object`	Transaction message
└`accountKeys`	`array<string>`	List of account keys
└`addressTableLookups`	`array`	List of address table lookups
└`instructions`	`array<InstructionSchema>`	List of instructions
└`[]`	`object`	Array item
└`accounts`	`array<integer>`	Account indices
└`data`	`string`	Instruction data
└`programIdIndex`	`integer`	Program ID index
└`numReadonlySignedAccounts`	`integer`	Number of readonly signed accounts
└`numReadonlyUnsignedAccounts`	`integer`	Number of readonly unsigned accounts
└`numRequiredSignatures`	`integer`	Number of required signatures
└`recentBlockhash`	`string`	Recent blockhash
└`signatures`	`array<string>`	List of signatures
`version`	`integer`	Transaction version

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransaction",
  "params": {
    "signature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
    "config": {
      "commitment": {
        "commitment": "Processed"
      },
      "maxSupportedTransactionVersion": 0
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "getTransaction",  "params": {    "signature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",    "config": {      "commitment": {        "commitment": "Processed"      },      "maxSupportedTransactionVersion": 0    }  }}

getSignaturesForAddress

Returns the signatures for a given address.

Parameters

Name	Type	Description
`address`*	`string`	The address to query for transaction signatures, as a base-58 encoded string.
`before`	`string`	Start searching backwards from this transaction signature.
`limit`	`integer`	The maximum number of signatures to return.
`until`	`string`	Search until this transaction signature.

Result

Field	Type	Description
`result`	`array<RpcConfirmedTransactionStatusWithSignature>`	getSignaturesForAddress - Returns signatures for an address
└`[]`	`object`	Array item
└`blockTime`	`integer`
└`confirmationStatus`	`object`
└`status`	`string`	Confirmation level
└`err`	`object`
└`errorType`	`string`	Error type
└`message`	`string`	Error message
└`memo`	`string`
└`signature`	`string`
└`slot`	`integer`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": {
    "address": "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    "before": "<some-before>",
    "limit": 0,
    "until": "<some-until>"
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "getSignaturesForAddress",  "params": {    "address": "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",    "before": "<some-before>",    "limit": 0,    "until": "<some-until>"  }}

getFeeForMessage

Returns the fee for a given message.

Parameters

Name	Type	Description
`message`*	`string`	The message to calculate the fee for, as a base-64 encoded string.
`config`	`object`	Configuration object for the query.
└`commitment`	`string \| string \| string`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'
└`minContextSlot`	`integer`	The minimum context slot for the context.

Result

Field	Type	Description
`context`	`object`
└`apiVersion`	`string`	The API version
└`slot`	`integer`	The current slot
`value`	`integer`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getFeeForMessage",
  "params": {
    "message": "<some-message>",
    "config": {
      "commitment": "Processed",
      "minContextSlot": 123456789
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "getFeeForMessage",  "params": {    "message": "<some-message>",    "config": {      "commitment": "Processed",      "minContextSlot": 123456789    }  }}

getStakeMinimumDelegation

Returns the stake minimum delegation.

Parameters

Name	Type	Description
`config`	`object`	Configuration object for the query.
└`commitment`	`string \| string \| string`	The commitment describes how finalized a block is at that point in time. Options are 'processed', 'confirmed', or 'finalized'
└`minContextSlot`	`integer`	The minimum context slot for the context.

Result

Field	Type	Description
`context`	`object`
└`apiVersion`	`string`	The API version
└`slot`	`integer`	The current slot
`value`	`integer`

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getStakeMinimumDelegation",
  "params": {
    "config": {
      "commitment": "Processed",
      "minContextSlot": 123456789
    }
  }
}

{  "jsonrpc": "2.0",  "id": 1,  "method": "getStakeMinimumDelegation",  "params": {    "config": {      "commitment": "Processed",      "minContextSlot": 123456789    }  }}

Transactions

getSignatureStatuses

requestAirdrop

sendTransaction

simulateTransaction

getTransaction

getSignaturesForAddress

getFeeForMessage

getStakeMinimumDelegation

On this page