Skip to main content

starknet_getTransactionByBlockIdAndIndex RPC Method

Returns the details of a transaction by a given block id and index. If no transaction is found, null is returned.

Updated on
Mar 18, 2024

starknet_getTransactionByBlockIdAndIndex RPC Method

Parameters

block_id
string
REQUIRED
The hash of the requested block, the block number (height) of the requested block, or a block tag (latest or pending)
index
string
REQUIRED
The index in the block to search for the transaction

Returns

result
string
The result object which contains the following fields:
TXN
string
The TXN object which can have one of the following object:
INVOKE_TXN
string
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
array
The signature associated with the transaction
contract_address
string
The address of the contract
entry_point_selector
string
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
array
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
array
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
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
The entry point selector
calldata
array
The parameters passed to the function
DECLARE_TXN
object
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
array
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
array
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
array
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
array
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
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
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
array
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
array
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
Request
1
curl --location 'https://docs-demo.strk-mainnet.quiknode.pro/' \
2
--header 'accept: application/json' \
3
--header 'content-type: application/json' \
4
--data '{
5
"id": 1,
6
"jsonrpc": "2.0",
7
"method": "starknet_getTransactionByBlockIdAndIndex",
8
"params": [
9
"latest",
10
0
11
]
12
}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free