Method reference

The current HTTP allowlist, grouped by its rate-limit class (the value in the X-Starkscan-Rpc-Class response header). The class tells you which budget a call draws from — read your live X-Ratelimit-* headers to see remaining budget per call. See Rate limits for the numbers and RPC errors for failure shapes.

The examples are representative result or error shapes. Examples containing an ellipsis are abbreviated for readability and are not copy-paste JSON fixtures. Call the capability endpoint shown in the overview for the current host-specific state; the gateway rejects methods outside this allowlist.

Read — light

Class rpc_read_light.

starknet_chainId

Params: []

Example response:

"0x534e5f4d41494e"

starknet_specVersion

Params: []

Result: The stable gateway compatibility version declared as rpcProvider.publicSpecVersion in the capability document. This is deliberately independent from the raw Pathfinder or Juno backend version selected for other methods.

"0.10.2"

starknet_blockNumber

Params: []

Example response:

12487891

starknet_blockHashAndNumber

Params: []

Example response:

{"block_hash": "0x1c6bdd0346409b650ec22a6c6eb4022ca180484c3d69c5509eb8e55ed481571", "block_number": 12487891}

starknet_syncing

Params: []

Example response:

false

Read — state & contract

Class rpc_read_state.

starknet_call

Params: [{"contract_address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d", "entry_point_selector": "0x02e4263afad30923c891518314c3c95dbe830a16874e8abc5777a9a20b54c76e", "calldata": ["0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"]}, "latest"]

Example response:

["0xd131c13c960580884a0", "0x0"]

starknet_getStorageAt

Params: ["0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d", "0x0", "latest"]

Example response:

"0x0"

starknet_getClassHashAt

Params: ["latest", "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"]

Example response:

"0x2e77ee61d4df3d988ee1f42ea5442e913862cc82c2584d212ecda76666498fc"

starknet_getClass

Params: ["latest", "0x2e77ee61d4df3d988ee1f42ea5442e913862cc82c2584d212ecda76666498fc"]

Result: A Starknet contract-class object. It can be large, so this page does not present an incomplete object as a parseable JSON fixture.

starknet_getClassAt

Params: ["latest", "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"]

Example response:

{"abi": "[{\"type\": \"impl\", \"name\": \"ERC20MetadataImpl\", \"interface_name\": \"openzeppelin_interfaces::token::erc20::IERC20Metadata\"}, {\"type\": \"struct\", \"name\": \"core::byte_array::ByteArray\", \"members\…(+686246 chars)

starknet_getNonce

Params: ["latest", "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"]

Example response:

"0x0"

starknet_getStorageProof

Params: [{"block_number": 12487886}, ["0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"], [], []]

Example response:

{"classes_proof": [{"node": {"left": "0x301749bdf477b022f1aa2697f62da24631b1c0ae05e8ab08ee6356d6a707f7f", "right": "0x1814a87f80a1784446f456532ff7c1a02876a06aa032f624a16f1b540884c91"}, "node_hash": "0x7144a2ff18484d7f137…(+4100 chars)

This is a bounded upstream passthrough, not an archive-proof guarantee. The gateway accepts latest, block_number, and block_hash; it rejects pending and pre_confirmed, caps proof targets, and caps the serialized response at 1 MiB. A 50,000-block-behind-head probe is the certification target, not an advertised horizon: rpcProvider.storageProofBeta.historicalHorizon reports advertised: false and a null guarantee until exact-deploy evidence exists. The pinned Starknet OpenRPC v0.10.2 result does not define state_diff_commitment; Starkscan does not synthesize or guarantee that field. An upstream extension is preserved if returned, so clients must ignore it unless a future capability contract explicitly certifies it.

starknet_getCompiledCasm

Params: ["0x2e77ee61d4df3d988ee1f42ea5442e913862cc82c2584d212ecda76666498fc"]

Example response:

{"bytecode": ["0x40780017fff7fff", "0x4", "0xa0680017fff8000", "0x7", "0x482680017ffa8000", "0x100000000000000000000000000000000", "0x400280007ff87fff", "0x10780017fff7fff", "0x77", "0x4825800180007ffa", "0x0", "0x400280…(+667863 chars)

Read — history, tx & events

Class rpc_read_history.

starknet_getBlockWithTxHashes

Params: [{"block_number": 12487886}]

Example response:

{"block_hash": "0x41e485d5bf1c71b9d55594cfa03000e8f312c3a7b2aaae2c19da2593b32069a", "block_number": 12487886, "event_commitment": "0x514dbb2de7ae6d754e5b0c33a17cbb93d52c3266c86e587ff340cbc6878c48e", "event_count": 21, "l…(+1287 chars)

starknet_getBlockWithTxs

Params: ["latest"]

Example response:

{"block_hash": "0x5d47e397384bb0ab2ceb7ff7fec497e8ca7d3ca9fe7edc04e0744e5a8c89d18", "block_number": 12487896, "event_commitment": "0x78ac35a0c8a97e8f2ecaed244175d29c5abdd8d9314ab6a4f4bc77b35443563", "event_count": 12, "l…(+7024 chars)

starknet_getBlockWithReceipts

Params: [{"block_number": 12487886}]

Example response:

{"block_hash": "0x41e485d5bf1c71b9d55594cfa03000e8f312c3a7b2aaae2c19da2593b32069a", "block_number": 12487886, "event_commitment": "0x514dbb2de7ae6d754e5b0c33a17cbb93d52c3266c86e587ff340cbc6878c48e", "event_count": 21, "l…(+16918 chars)

starknet_getBlockTransactionCount

Params: [{"block_number": 12487886}]

Example response:

5

starknet_getTransactionByBlockIdAndIndex

Params: [{"block_number": 12487886}, 0]

Example response:

{"account_deployment_data": [], "calldata": ["0x1", "0x127021a1b5a52d3174c2ab077c2b043c80369250d29428cee956d76ee51584f", "0x3d82f059acd7c22528fe93d2cd7c941d47411bf7c5525efe7f71eedebd62647", "0x2c", "0x7fddbe22dd3447c0720…(+2646 chars)

starknet_getTransactionByHash

Params: ["0x44456842d1e4f02358b43496f5000d7f8966781bedbf965b598086fd72ac307"]

Example response:

{"account_deployment_data": [], "calldata": ["0x1", "0x127021a1b5a52d3174c2ab077c2b043c80369250d29428cee956d76ee51584f", "0x3d82f059acd7c22528fe93d2cd7c941d47411bf7c5525efe7f71eedebd62647", "0x2c", "0x7fddbe22dd3447c0720…(+2646 chars)

starknet_getTransactionReceipt

Params: ["0x44456842d1e4f02358b43496f5000d7f8966781bedbf965b598086fd72ac307"]

Example response:

{"actual_fee": {"amount": "0x21c166572d41c00", "unit": "FRI"}, "block_hash": "0x41e485d5bf1c71b9d55594cfa03000e8f312c3a7b2aaae2c19da2593b32069a", "block_number": 12487886, "events": [{"data": [], "from_address": "0x377c2…(+1723 chars)

starknet_getTransactionStatus

Params: ["0x44456842d1e4f02358b43496f5000d7f8966781bedbf965b598086fd72ac307"]

Example response:

{"execution_status": "SUCCEEDED", "finality_status": "ACCEPTED_ON_L2"}

starknet_getStateUpdate

Params: [{"block_number": 12487886}]

Example response:

{"block_hash": "0x41e485d5bf1c71b9d55594cfa03000e8f312c3a7b2aaae2c19da2593b32069a", "new_root": "0x5d31805c1e9f3ade0bd374c012d2467f133295240f149b6b9577438b7fb09d0", "old_root": "0x4a435fd2ab72c10e54a3b17e89721452cdb48b65…(+6732 chars)

starknet_getEvents

Params: [{"from_block": {"block_number": 12487876}, "to_block": {"block_number": 12487886}, "address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d", "chunk_size": 5}]

Example response:

{"continuation_token": "12487877-9", "events": [{"block_hash": "0x6499094af14093e47c94067001e19de4779f9c9fabfa59e2decffd23d507834", "block_number": 12487876, "data": ["0x8b288fc4678d000", "0x0"], "event_index": 9, "from_…(+2727 chars)

starknet_getMessagesStatus

Params: ["0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"]

Example error for an unknown transaction hash:

{"code": 29, "data": {"code": "upstream_json_rpc_error", "method": "starknet_getMessagesStatus", "requestId": "mzk-19fb112de46-129c1-4269c8b44a26561b", "service": "starkscan_rpc_gateway"}, "message": "Transaction hash no…(+9 chars)

Simulation & estimation

Class rpc_simulation.

starknet_estimateFee

params: [ [<txn>...], [SIMULATION_FLAGS], <block_id> ] — returns FeeEstimate[] or a typed error. SKIP_VALIDATE is forwarded when accepted by the upstream method.

starknet_estimateMessageFee

params: [ {from_address,to_address,entry_point_selector,payload}, <block_id> ] — L1-to-L2 message fee.

starknet_simulateTransactions

params: [ <block_id>, [<txn>...], [SIMULATION_FLAGS] ] — simulation flags are forwarded when accepted by the upstream method.

Write (signed submission)

Class rpc_write.

starknet_addInvokeTransaction

Available only when rpcProvider.writeBeta.enabled is true. Requires an eligible key and an already-signed payload; Starkscan never signs. Params: [ <signed invoke v3> ].

starknet_addDeclareTransaction

Available only when rpcProvider.writeBeta.enabled is true. Requires an eligible key and an already-signed payload. Params: [ <signed declare> ].

starknet_addDeployAccountTransaction

Available only when rpcProvider.writeBeta.enabled is true. Requires an eligible key and an already-signed payload. Params: [ <signed deploy_account> ].

Partner trace methods

• starknet_traceTransaction / starknet_traceBlockTransactions — served only to enrolled, trace-certified partner policies with explicit rpc_trace quotas. Ordinary read and batch keys fail closed.

Not served over HTTP

• starknet_subscribe* / starknet_unsubscribe — use the WebSocket beta route; HTTP rejects them with class rpc_ws.