SimulateTransaction - Documentation

simulateTransaction RPC Method

Simulate sending a transaction.

Method Information

The transaction must have a valid blockhash
Not required to be signed
Allows testing transaction execution without actually sending it to the network

Parameters

string required
Transaction, as an encoded stringobject optional
Configuration object containing the following fields:commitment string optional\

Default: finalized
Commitment level to simulate the transaction at

sigVerify bool optional\

If true, transaction signatures will be verified
Conflicts with replaceRecentBlockhash

replaceRecentBlockhash bool optional\

If true, replaces the transaction’s recent blockhash with the most recent blockhash
Conflicts with sigVerify

minContextSlot number optional\

Minimum slot that the request can be evaluated at

encoding string optional\

Default: base58
Encoding used for transaction data

Allowed Encoding Values:

base58 (slow, DEPRECATED)
base64

innerInstructions bool optional\

If true, response will include inner instructions
Inner instructions will be jsonParsed where possible

accounts object optional\

Accounts configuration object
- addresses: Array of accounts to return (base-58 encoded strings)
- encoding: Encoding for returned account data
  - Default: base64
  - Values: base64, base58, base64+zstd, jsonParsed

Code Sample

curl https://rpc.testnet.soo.network/rpc \
-X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "simulateTransaction",
  "params": [
    "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED10jMAfX8Ue4203MSpqzrJiy6UblHKSjE2XgziZTOo9IYryKvnI8Ktte81tibEA/lHkHTZwblOqoWwCvc8dth4gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwI0timn1vUjmelkWIwKhw93lLnwOrAFFyq3LKby0SNoBAgIAAQwCAAAAAOQLVAIAAAA=",
    {
      "commitment": "finalized",
      "encoding": "base64",
      "innerInstructions": true,
      "accounts": {
        "addresses": ["FVP39NNZMKfEDzbg3BWWZEiYPH3wyFp5kmtuN3M2AZFo"],
        "encoding": "jsonParsed"
      }
    }
  ]
}'

Response

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "apiVersion": "2.0.14",
      "slot": 406970
    },
    "value": {
      "accounts": [
        {
          "data": [
            "",
            "base64"
          ],
          "executable": false,
          "lamports": 20958674016,
          "owner": "11111111111111111111111111111111",
          "rentEpoch": 18446744073709551615,
          "space": 0
        }
      ],
      "err": null,
      "innerInstructions": [],
      "logs": [
        "Program 11111111111111111111111111111111 invoke [1]",
        "Program 11111111111111111111111111111111 success"
      ],
      "replacementBlockhash": null,
      "returnData": null,
      "unitsConsumed": 150
    }
  },
  "id": 1
}

Result Details

The result is an RpcResponse JSON object with value containing:

context: <object>
- apiVersion: <string> - Version of the API
- slot: <u64> - Slot at which the simulation was performed
value: <object>
- accounts: <array> - Requested account information
  - Each account contains:
    - data: Account data
    - executable: Whether account is executable
    - lamports: Account balance
    - owner: Program owning the account
    - rentEpoch: Epoch for next rent payment
    - space: Account data size
- err: <object|null> - Transaction error details
- innerInstructions: <array> - Inner instructions (if any)
- logs: <array> - Program execution log messages
- replacementBlockhash: <string|null> - Replacement blockhash if applicable
- returnData: <object|null> - Return data from instructions
- unitsConsumed: <u64> - Compute units consumed

Important Notes

Allows testing transaction execution without network submission
Provides detailed insights into potential transaction outcomes
Helpful for debugging and validating transactions before sending

​simulateTransaction RPC Method

​Method Information

​Parameters

​Code Sample

​Response

​Result Details

​Important Notes