starknet_simulateTransactions | Starknet

Starknet API method that simulates the execution of a list of transactions on a given state. Available on Starknet via Chainstack.

POST /365cf697a3ad6d950b4c4a911e2e4f4d

starknet_simulateTransactions

cURL

curl --request POST \
  --url https://starknet-mainnet.core.chainstack.com/365cf697a3ad6d950b4c4a911e2e4f4d \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "starknet_simulateTransactions",
  "params": [
    {
      "block_number": 385940
    },
    [
      {
        "type": "INVOKE",
        "max_fee": "0xb3a2f1ab6d632",
        "version": "0x1",
        "signature": [
          "0x54c2201c7b9021777389e208e28eafc67e4ba1f1aa7016a1123b61c6ff79c29",
          "0x58c2d97614e5abfd9668b314f344c945d16ea154cb32a7b08b4445204f1f1d3"
        ],
        "sender_address": "0x0569b13e8164bc8000c0bbcf4887856516643af123c5bc3b01e229e92f9cfd10",
        "calldata": [
          "0x3",
          "0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
          "0x219209e083275171774dab1df80982e9df2096516f06319c5c6d71ae0a8480c",
          "0x3",
          "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
          "0x984e103a8acd6",
          "0x0",
          "0x68f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
          "0x219209e083275171774dab1df80982e9df2096516f06319c5c6d71ae0a8480c",
          "0x3",
          "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
          "0x4c4b40",
          "0x0",
          "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
          "0x2f0b3c5710379609eb5495f1ecd348cb28167711b73609fe565a72734550354",
          "0xe",
          "0x569b13e8164bc8000c0bbcf4887856516643af123c5bc3b01e229e92f9cfd10",
          "0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
          "0x68f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
          "0x1f4",
          "0xa76cc",
          "0xa7b5e",
          "0x984e103a8acd6",
          "0x0",
          "0x4c4b40",
          "0x0",
          "0x9542431aa6bf1",
          "0x0",
          "0x4ac4a0",
          "0x0"
        ],
        "nonce": "0x51"
      }
    ],
    [
      "SKIP_VALIDATE",
      "SKIP_FEE_CHARGE"
    ]
  ]
}
'

Starknet OpenRPC spec

For the latest version of the publicly maintained OpenRPC spec, see the Starknet specs GitHub repo.

Starknet API method that simulates the execution of a list of transactions on a given state.

It provides a simulation of the execution of a list of transactions based on the network’s current state and the transactions’ parameters. A client or wallet can use this simulation to understand the potential outcome of these transactions if they were to be included in a block.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

• request — the list of transactions to simulate.
• block_id — the hash of the requested block, or number (height) of the requested block, or a block tag, for the block referencing the state or call the transaction on.

Response

• result — the result of the simulation, represented as a list of transaction receipts.

Use case

A practical use case for starknet_simulateTransactions is to simulate the execution of a list of transactions that interact with contracts on StarkNet. This can be useful for testing and debugging purposes, as it allows developers to understand the potential outcome of these transactions without actually executing them on the network.

Deprecated feeder gateway method

The feeder gateway was deprecated on December 11, 2023.

Example of the call you had to make to the feeder gateway before the deprecation:

Shell

curl --request POST \
     --url 'https://alpha-mainnet.starknet.io/feeder_gateway/simulate_transaction?blockNumber=385940' \
     --header 'Content-Type: application/json' \
     --data-raw '{
         "type": "INVOKE_FUNCTION",
         "sender_address": "0x0569b13e8164bc8000c0bbcf4887856516643af123c5bc3b01e229e92f9cfd10",
         "nonce": "0x51",
         "max_fee": "0xb3a2f1ab6d632",
         "version": "0x1",
         "calldata": [
            "0x3",
            "0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
            "0x219209e083275171774dab1df80982e9df2096516f06319c5c6d71ae0a8480c",
            "0x3",
            "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
            "0x984e103a8acd6",
            "0x0",
            "0x68f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
            "0x219209e083275171774dab1df80982e9df2096516f06319c5c6d71ae0a8480c",
            "0x3",
            "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
            "0x4c4b40",
            "0x0",
            "0xfff107e2403123c7df78d91728a7ee5cfd557aec0fa2d2bdc5891c286bbfff",
            "0x2f0b3c5710379609eb5495f1ecd348cb28167711b73609fe565a72734550354",
            "0xe",
            "0x569b13e8164bc8000c0bbcf4887856516643af123c5bc3b01e229e92f9cfd10",
            "0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
            "0x68f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
            "0x1f4",
            "0xa76cc",
            "0xa7b5e",
            "0x984e103a8acd6",
            "0x0",
            "0x4c4b40",
            "0x0",
            "0x9542431aa6bf1",
            "0x0",
            "0x4ac4a0",
            "0x0"
         ],
         "signature": ["0x54c2201c7b9021777389e208e28eafc67e4ba1f1aa7016a1123b61c6ff79c29", "0x58c2d97614e5abfd9668b314f344c945d16ea154cb32a7b08b4445204f1f1d3"]
     }'

Body

application/json

id · integer · default: 0

jsonrpc · string · default: 2.0

method · string · default: starknet_simulateTransactions

params · (object | object[] | string[])[]

Show child attributes

Response

200

Successful response