Skip to main content

0.01 credits per call

simulateTransaction on Solana: Simulates sending a transaction without submitting it.

​
Endpoint

https://rpc.goldrushdata.com/v1/solana-mainnet
Authenticate with Authorization: Bearer <GOLDRUSH_API_KEY>. See authentication.

​
Parameters

NameTypeRequiredDescriptionExample
transactionstringyesTransaction to simulate, base64 or base58 encoded. May be unsigned when sigVerify is false."AR4KbO6uYPS5PKSh8u1ah2Jq1pHeXwaojuxdDGbSSumHcCM1bukbYaDt5/wiqiIwP156mLvzJxk3ILQocD3W8wcBAAIEwS6EMxyDU3PzY4L5Q52OIthyvkPczZiNOrY0kYo1V1oNwwgfIhv6odn2qTUu/gOisDtaeCW1qlwW/gx3ccr/4wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAACmNAYg3PP4Wwb6+EaGmhEew4gOOjQBZwBCR73i+EDMaAMDAAkDgNHwCAAAAAADAAUC9AEAAAICAAEMAgAAAKCGAQAAAAAA"
configobjectno{encoding?, sigVerify?, replaceRecentBlockhash?, commitment?, accounts?, minContextSlot?}. accounts requests post-simulation account state.{"encoding":"base64","sigVerify":false,"replaceRecentBlockhash":true,"commitment":"confirmed"}

​
Returns

object: {context, value: {err, logs, accounts, unitsConsumed, returnData}}. 
{"context":{"slot":372877175},"value":{"err":null,"logs":["Program 11111111111111111111111111111111 invoke [1]"],"unitsConsumed":2100}}

​
Examples

curl https://rpc.goldrushdata.com/v1/solana-mainnet \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "simulateTransaction",
    "params": ["AR4KbO6uYPS5PKSh8u1ah2Jq1pHeXwaojuxdDGbSSumHcCM1bukbYaDt5/wiqiIwP156mLvzJxk3ILQocD3W8wcBAAIEwS6EMxyDU3PzY4L5Q52OIthyvkPczZiNOrY0kYo1V1oNwwgfIhv6odn2qTUu/gOisDtaeCW1qlwW/gx3ccr/4wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAACmNAYg3PP4Wwb6+EaGmhEew4gOOjQBZwBCR73i+EDMaAMDAAkDgNHwCAAAAAADAAUC9AEAAAICAAEMAgAAAKCGAQAAAAAA", {"encoding":"base64","sigVerify":false,"replaceRecentBlockhash":true,"commitment":"confirmed"}]
  }'

import {
  createDefaultRpcTransport,
  createSolanaRpcFromTransport,
} from "@solana/kit";

const transport = createDefaultRpcTransport({
  url: "https://rpc.goldrushdata.com/v1/solana-mainnet",
  headers: { Authorization: `Bearer ${process.env.GOLDRUSH_API_KEY}` },
});
const rpc = createSolanaRpcFromTransport(transport);

const result = await rpc.simulateTransaction("AR4KbO6uYPS5PKSh8u1ah2Jq1pHeXwaojuxdDGbSSumHcCM1bukbYaDt5/wiqiIwP156mLvzJxk3ILQocD3W8wcBAAIEwS6EMxyDU3PzY4L5Q52OIthyvkPczZiNOrY0kYo1V1oNwwgfIhv6odn2qTUu/gOisDtaeCW1qlwW/gx3ccr/4wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAACmNAYg3PP4Wwb6+EaGmhEew4gOOjQBZwBCR73i+EDMaAMDAAkDgNHwCAAAAAADAAUC9AEAAAICAAEMAgAAAKCGAQAAAAAA", {"encoding":"base64","sigVerify":false,"replaceRecentBlockhash":true,"commitment":"confirmed"}).send();
console.log(result);

import os
import requests

resp = requests.post(
    "https://rpc.goldrushdata.com/v1/solana-mainnet",
    headers={
        "Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "simulateTransaction", "params": ["AR4KbO6uYPS5PKSh8u1ah2Jq1pHeXwaojuxdDGbSSumHcCM1bukbYaDt5/wiqiIwP156mLvzJxk3ILQocD3W8wcBAAIEwS6EMxyDU3PzY4L5Q52OIthyvkPczZiNOrY0kYo1V1oNwwgfIhv6odn2qTUu/gOisDtaeCW1qlwW/gx3ccr/4wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAACmNAYg3PP4Wwb6+EaGmhEew4gOOjQBZwBCR73i+EDMaAMDAAkDgNHwCAAAAAADAAUC9AEAAAICAAEMAgAAAKCGAQAAAAAA", {"encoding":"base64","sigVerify":false,"replaceRecentBlockhash":true,"commitment":"confirmed"}]},
)
print(resp.json()["result"])

​
Errors

Standard JSON-RPC errors: -32600 invalid request, -32601 method not found, -32602 invalid params.