Skip to main content

simulateTransaction RPC Method

Simulate sending a transaction.

Updated on
Dec 7, 2023

simulateTransaction RPC Method

Parameters

transaction
string
The transaction as an encoded string. The transaction must have a valid blockhash, but is not required to be signed
object
The configuration object with the following fields:

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)
Request
1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method":"simulateTransaction","params":["ENTER_ENCODED_TRANSACTION_ID"],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free