starknet_simulateTransactions RPC Method

Please note that some of the transactions may revert, in which case no error is thrown, but revert details can be seen on the returned trace object. Additionally, the revert_error property in the trace will indicate any transactions that have experienced a revert. Other types of failures (e.g. unexpected error or failure in the validation phase) will result in TRANSACTION_EXECUTION_ERROR.

Parameters

block_id

string

REQUIRED

transactions

array

REQUIRED

BROADCASTED_INVOKE_TXN

object

type

string

REQUIRED

max_fee

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

contract_address

string

REQUIRED

entry_point_selector

string

REQUIRED

calldata

array

REQUIRED

BROADCASTED_DECLARE_TXN

object

BROADCASTED_DECLARE_TXN_V1

object

type

string

REQUIRED

sender_address

string

REQUIRED

max_fee

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

nonce

string

REQUIRED

contract_class

object

REQUIRED

sierra_program

array

REQUIRED

contract_class_version

string

REQUIRED

entry_points_by_type

object

REQUIRED

CONSTRUCTOR

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

EXTERNAL

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

L1_HANDLER

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

abi

string

BROADCASTED_DECLARE_TXN_V2

object

type

string

REQUIRED

sender_address

string

REQUIRED

compiled_class_hash

string

REQUIRED

max_fee

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

nonce

string

REQUIRED

contract_class

object

REQUIRED

sierra_program

array

REQUIRED

contract_class_version

string

REQUIRED

entry_points_by_type

object

REQUIRED

CONSTRUCTOR

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

EXTERNAL

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

L1_HANDLER

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

abi

string

BROADCASTED_DECLARE_TXN_V3

object

type

string

REQUIRED

sender_address

string

REQUIRED

compiled_class_hash

string

REQUIRED

max_fee

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

nonce

string

REQUIRED

contract_class

object

REQUIRED

sierra_program

array

REQUIRED

contract_class_version

string

REQUIRED

entry_points_by_type

object

REQUIRED

CONSTRUCTOR

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

EXTERNAL

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

L1_HANDLER

array

REQUIRED

selector

string

REQUIRED

function_idx

integer

REQUIRED

abi

string

resource_bounds

object

REQUIRED

l1_gas

string

REQUIRED

max_amount

string

REQUIRED

max_price_per_unit

string

REQUIRED

l2_gas

string

REQUIRED

max_amount

string

REQUIRED

max_price_per_unit

string

REQUIRED

tip

string

REQUIRED

paymaster_data

array

REQUIRED

account_deployment_data

array

REQUIRED

nonce_data_availability_mode

string

REQUIRED

fee_data_availability_mode

string

REQUIRED

BROADCASTED_DEPLOY_ACCOUNT_TXN

object

DEPLOY_ACCOUNT_TXN_V1

object

type

string

REQUIRED

max_fee

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

nonce

string

REQUIRED

contract_address_salt

string

REQUIRED

constructor_calldata

array

REQUIRED

class_hash

string

REQUIRED

DEPLOY_ACCOUNT_TXN_V3

object

type

string

REQUIRED

version

string

REQUIRED

signature

string

REQUIRED

nonce

string

REQUIRED

contract_address_salt

string

REQUIRED

constructor_calldata

array

REQUIRED

class_hash

string

REQUIRED

resource_bounds

object

REQUIRED

l1_gas

string

REQUIRED

max_amount

string

REQUIRED

max_price_per_unit

string

REQUIRED

l2_gas

string

REQUIRED

max_amount

string

REQUIRED

max_price_per_unit

string

REQUIRED

tip

string

REQUIRED

paymaster_data

array

REQUIRED

nonce_data_availability_mode

string

REQUIRED

fee_data_availability_mode

string

REQUIRED

simulation_flags

array

REQUIRED

Returns

result

object

schema

object

transaction_trace

object

trace_root

object

INVOKE_TXN_TRACE

object

validate_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

execute_invocation

object

revert_reason

string

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

fee_transfer_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

state_diff

object

storage_entries

array

key

string

value

string

deprecated_declared_classes

array

class_hash

string

address

string

declared_classes

array

class_hash

string

compiled_class_hash

string

deployed_contracts

array

class_hash

string

address

string

replaced_classes

array

class_hash

string

contract_address

string

nonces

array

nonce

string

contract_address

string

execution_resources

string

data_availability

object

l1_gas

integer

l1_data_gas

integer

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

type

object

DECLARE_TXN_TRACE

object

validate_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

fee_transfer_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

state_diff

object

storage_entries

array

key

string

value

string

deprecated_declared_classes

array

class_hash

string

address

string

declared_classes

array

class_hash

string

compiled_class_hash

string

deployed_contracts

array

class_hash

string

address

string

replaced_classes

array

class_hash

string

contract_address

string

nonces

array

nonce

string

contract_address

string

execution_resources

string

data_availability

object

l1_gas

integer

l1_data_gas

integer

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

type

object

DEPLOY_ACCOUNT_TXN_TRACE

object

validate_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

constructor_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

fee_transfer_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

state_diff

object

storage_entries

array

key

string

value

string

deprecated_declared_classes

array

class_hash

string

address

string

declared_classes

array

class_hash

string

compiled_class_hash

string

deployed_contracts

array

class_hash

string

address

string

replaced_classes

array

class_hash

string

contract_address

string

nonces

array

nonce

string

contract_address

string

execution_resources

string

data_availability

object

l1_gas

integer

l1_data_gas

integer

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

type

object

DEPLOY_ACCOUNT_TXN_TRACE

object

function_invocation

object

contract_address

string

entry_point_selector

string

calldata

array

caller_address

string

class_hash

string

entry_point_type

string

call_type

string

result

array

calls

array

events

array

order

integer

keys

array

data

array

messages

array

order

integer

from_address

string

to_address

string

payload

string

execution_resources

array

steps

integer

memory_holes

integer

range_check_builtin_applications

integer

pedersen_builtin_applications

integer

poseidon_builtin_applications

integer

ec_op_builtin_applications

integer

ecdsa_builtin_applications

integer

bitwise_builtin_applications

integer

keccak_builtin_applications

integer

segment_arena_builtin

integer

state_diff

object

storage_entries

array

key

string

value

string

deprecated_declared_classes

array

class_hash

string

address

string

declared_classes

array

class_hash

string

compiled_class_hash

string

deployed_contracts

array

class_hash

string

address

string

replaced_classes

array

class_hash

string

contract_address

string

nonces

array

nonce

string

contract_address

string

type

object

fee_estimation

object

gas_consumed

string

gas_price

string

data_gas_consumed

string

data_gas_price

string

overall_fee

string

unit

string

Request

# Note: You can specify Starknet version in the URL path
# Example: /rpc/v0_8 for version 0.8, /rpc/v0_6 for version 0.6
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_8' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "starknet_simulateTransactions",
    "params": {
        "transactions": [
            {
                "to": "TO_ADDRESS",
                "type": "TYPE",
                "data": "TRANSACTION_DATA",
                "nonce": "NONCE",
                "signature": "SIGNATURE"
            }
        ],
        "block_id": "latest"
    }
}'

// Note: You can specify Starknet version in the URL path
// Example: /rpc/v0_8 for version 0.8, /rpc/v0_6 for version 0.6
const myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

const raw = JSON.stringify({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_simulateTransactions",
  "params": {
    "transactions": [
      {
        "to": "TO_ADDRESS",
        "type": "TYPE",
        "data": "TRANSACTION_DATA",
        "nonce": "NONCE",
        "signature": "SIGNATURE"
      }
    ],
    "block_id": "latest"
  }
});


const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_8", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

# Note: You can specify Starknet version in the URL path
# Example: /rpc/v0_8 for version 0.8, /rpc/v0_6 for version 0.6
import requests
import json

url = "https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_8"

payload = json.dumps({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_simulateTransactions",
  "params": {
    "transactions": [
      {
        "to": "TO_ADDRESS",
        "type": "TYPE",
        "data": "TRANSACTION_DATA",
        "nonce": "NONCE",
        "signature": "SIGNATURE"
      }
    ],
    "block_id": "latest"
  }
})
headers = {
  'accept': 'application/json',
  'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# Note: You can specify Starknet version in the URL path
# Example: /rpc/v0_8 for version 0.8, /rpc/v0_6 for version 0.6
require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_8")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "starknet_simulateTransactions",
  "params": {
    "transactions": [
      {
        "to": "TO_ADDRESS",
        "type": "TYPE",
        "data": "TRANSACTION_DATA",
        "nonce": "NONCE",
        "signature": "SIGNATURE"
      }
    ],
    "block_id": "latest",
    "simulation_flags": [
      "flag1"
    ]
  }
})

response = http.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

starknet_simulateTransactions RPC Method

Loading...

Parameters

Returns