starknet_getBlockWithTxs RPC Method

To query a specific block, use a payload like {"block_id": 100000}. To query the latest block, use "params": ["latest"]

Parameters

block_id string REQUIRED: The hash of the requested block, the block number (height) of the requested block, or a block tag (latest, pre_confirmed, or l1_accepted)

Returns

result object

The result object which can be one of the following object:

BLOCK_WITH_TXS object

(Optional) The block with transaction hashes object which have the following fields

status string: The block status, which can be one of - 'PRE_CONFIRMED', 'ACCEPTED_ON_L2', 'ACCEPTED_ON_L1'

block_hash string: The block hash

parent_hash string: The parent block hash

block_number integer: The block number (its height)

new_root string: The new global state root

timestamp integer: The time in which the block was created, encoded in Unix time

sequencer_address string: The StarkNet identity of the sequencer submitting this block

l1_gas_price object

The price of l1 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l2_gas_price object

The price of l2 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_data_gas_price object

The price of l1 data gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_da_mode string: It specifies whether the data of this block is published via blob data or calldata. It can be one of - 'BLOB' or 'CALLDATA'

starknet_version string: The semver of the current Starknet protocol

transactions array

The transactions object which contains the following objects:

TXN string

The TXN object which can have one of the following object:

INVOKE_TXN string

(Optional) The Invoke transaction object which can have one of the following object:

INVOKE_TXN_V0 object

The invoke transaction V0 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

contract_address string: The address of the contract

entry_point_selector string: (Optional) The entry point selector

calldata array: The parameters passed to the constructor

INVOKE_TXN_V1 object

The invoke transaction V1 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

sender_address string: The sender address

calldata array: The parameters passed to the constructor

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

INVOKE_TXN_V3 object

The invoke transaction V3 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

sender_address string: The sender address

calldata array: The parameters passed to the constructor

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

L1_HANDLER_TXN object

(Optional) The L1 Handler transaction object which contains the following fields:

version string: The version of the transaction scheme

type string: The type of the L1 transaction handler('L1_HANDLER')

nonce string: The L1->L2 message nonce field of the SN Core L1 contract at the time the transaction was sent

contract_address string: The contract address

entry_point_selector string: (Optional) The entry point selector

calldata array: The parameters passed to the function

DECLARE_TXN object

(Optional) The declare transaction object which can have one the following object:

DECLARE_TXN_V0 object

The declare contract transaction V0 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

class_hash string: The hash of the declared class

DECLARE_TXN_V1 object

The declare contract transaction V1 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce

class_hash string: The hash of the declared class

DECLARE_TXN_V2 object

The declare contract transaction V2 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce

class_hash string: The hash of the declared class

DECLARE_TXN_V3 object

The declare Contract Transaction V3 which have the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

compiled_class_hash string: The hash of the Cairo assembly resulting from the Sierra compilation

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

class_hash string: The hash of the declared class

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

DEPLOY_TXN object

(Optional) The structure of a deploy transaction. Note that this transaction type is deprecated and will no longer be supported in future versions. It contains the following fields:

version string: The version of the transaction scheme

type string: The type of the L1 transaction handler('L1_HANDLER')

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata string: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

DEPLOY_ACCOUNT_TXN object

(Optional) The deploy account transaction object which can have one of the following objects:

DEPLOY_ACCOUNT_TXN_V1 object

It deploys an account contract, charges fee from the pre-funded account addresses. It consist of following fields:

type string: The type of declare. It can take only one value - 'DEPLOY_ACCOUNT'

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata array: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

DEPLOY_ACCOUNT_TXN_V3 object

It deploys an account contract, charges fee from the pre-funded account addresses. It consist of following fields:

type string: The type of declare. It can take only one value - 'DEPLOY_ACCOUNT'

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata array: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

transaction_hash string: The transaction hash

PRE_CONFIRMED_BLOCK_WITH_TXS object

(Optional) The pre-confirmed block with transaction hashes object which have the following fields. Note that this object will be deprecated upon decentralization

BLOCK_WITH_TXS object

The block with transaction hashes object which have the following fields

block_hash string: The block hash

block_number string: The block number (its height)

new_root string: The new global state root

timestamp integer: The time in which the block was created, encoded in Unix time

sequencer_address string: The StarkNet identity of the sequencer submitting this block

l1_gas_price object

The price of l1 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l2_gas_price object

The price of l2 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_data_gas_price object

The price of l1 data gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_da_mode string: It specifies whether the data of this block is published via blob data or calldata. It can be one of - 'BLOB' or 'CALLDATA'

starknet_version string: The semver of the current Starknet protocol

transactions array

The transactions object which contains the following objects:

TXN string

The TXN object which can have one of the following object:

INVOKE_TXN string

(Optional) The Invoke transaction object which can have one of the following object:

INVOKE_TXN_V0 object

The invoke transaction V0 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

contract_address string: The address of the contract

entry_point_selector string: (Optional) The entry point selector

calldata array: The parameters passed to the constructor

INVOKE_TXN_V1 object

The invoke transaction V1 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

sender_address string: The sender address

calldata array: The parameters passed to the constructor

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

INVOKE_TXN_V3 object

The invoke transaction V3 object which contains the following field:

type string: The type of declare. It can take only one value - 'INVOKE'

sender_address string: The sender address

calldata array: The parameters passed to the constructor

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

L1_HANDLER_TXN object

(Optional) The L1 Handler transaction object which contains the following fields:

version string: The version of the transaction scheme

type string: The type of the L1 transaction handler('L1_HANDLER')

nonce string: The L1->L2 message nonce field of the SN Core L1 contract at the time the transaction was sent

contract_address string: The contract address

entry_point_selector string: (Optional) The entry point selector

calldata array: The parameters passed to the function

DECLARE_TXN object

(Optional) The declare transaction object which can have one the following object:

DECLARE_TXN_V0 object

The declare contract transaction V0 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

class_hash string: The hash of the declared class

DECLARE_TXN_V1 object

The declare contract transaction V1 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce

class_hash string: The hash of the declared class

DECLARE_TXN_V2 object

The declare contract transaction V2 which contains the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce

class_hash string: The hash of the declared class

DECLARE_TXN_V3 object

The declare Contract Transaction V3 which have the following fields:

type string: The type of declare. It can take only one value - 'DECLARE'

sender_address string: The address of the account contract sending the declaration transaction

compiled_class_hash string: The hash of the Cairo assembly resulting from the Sierra compilation

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

class_hash string: The hash of the declared class

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

DEPLOY_TXN object

(Optional) The structure of a deploy transaction. Note that this transaction type is deprecated and will no longer be supported in future versions. It contains the following fields:

version string: The version of the transaction scheme

type string: The type of the L1 transaction handler('L1_HANDLER')

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata string: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

DEPLOY_ACCOUNT_TXN object

(Optional) The deploy account transaction object which can have one of the following objects:

DEPLOY_ACCOUNT_TXN_V1 object

It deploys an account contract, charges fee from the pre-funded account addresses. It consist of following fields:

type string: The type of declare. It can take only one value - 'DEPLOY_ACCOUNT'

max_fee string: The maximal fee that can be charged for including the transaction

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata array: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

DEPLOY_ACCOUNT_TXN_V3 object

It deploys an account contract, charges fee from the pre-funded account addresses. It consist of following fields:

type string: The type of declare. It can take only one value - 'DEPLOY_ACCOUNT'

version string: The version of the transaction scheme

signature string: The signature associated with the transaction

nonce string: The nonce value

contract_address_salt string: The salt for the address of the deployed contract

constructor_calldata array: The parameters passed to the constructor

class_hash string: The hash of the deployed contract's class

resource_bounds object

The resource bounds for the transaction execution

l1_gas string

The max amount and max price per unit of L1 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

l2_gas string

The max amount and max price per unit of L2 gas used in this tx

max_amount string: The max amount of the resource that can be used in the tx

max_price_per_unit string: The max price per unit of this resource for this tx

tip string: The tip for the transaction

paymaster_data array: The data needed to allow the paymaster to pay for the transaction in native tokens

account_deployment_data array: The data needed to deploy the account contract from which this tx will be initiated

nonce_data_availability_mode string: The storage domain of the account's nonce (an account has a nonce per DA mode). It can be one of 'L1' or 'L2'

fee_data_availability_mode string: The storage domain of the account's balance from which fee will be charged. It can be one of 'L1' or 'L2'

transaction_hash string: The transaction hash

PRE_CONFIRMED_BLOCK_HEADER object

The pre-confirmed block header which contains the following fields:

block_number integer: The block number of the block that the proposer is currently building. Note that this is a local view of the node, whose accuracy depends on its polling interval length

timestamp integer: The time in which the block was created, encoded in Unix time

sequencer_address string: The StarkNet identity of the sequencer submitting this block

l1_gas_price object

The price of l1 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l2_gas_price object

The price of l2 gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_data_gas_price object

The price of l1 data gas in the block

price_in_fri string: The price of one unit of the given resource, denominated in fri (10^-18 strk)

price_in_wei string: The price of one unit of the given resource, denominated in wei

l1_da_mode string: It specifies whether the data of this block is published via blob data or calldata. It can be one of - 'BLOB' or 'CALLDATA'

starknet_version string: The semver of the current Starknet protocol

Request

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9' \
4
--header 'accept: application/json' \
5
--header 'content-type: application/json' \
6
--data '{
7
    "id": 1,
8
    "jsonrpc": "2.0",
9
    "method": "starknet_getBlockWithTxs",
10
    "params": [
11
        {"block_number" : 100000}
12
    ]
13
}'

1
# Note: You can specify Starknet version in the URL path
2
# Example: /rpc/v0_9 for version 0.9. Versions 0.6, 0.7, and 0.8 are no longer supported
3
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/rpc/v0_9' \
4
--header 'accept: application/json' \
5
--header 'content-type: application/json' \
6
--data '{
7
    "id": 1,
8
    "jsonrpc": "2.0",
9
    "method": "starknet_getBlockWithTxs",
10
    "params": [
11
        {"block_number" : 100000}
12
    ]
13
}'

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free