Skip to main content

starknet_getTransactionByHash RPC Method

Return the details and status of a submitted transaction.

Updated on
Mar 18, 2024

Parameters

transaction_hash
string
REQUIRED

The hash of the requested transaction

Returns

result
object

The result object which contains the following fields:

transaction_hash
string

The transaction hash

TXN
string

(Optional) 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
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

(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

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
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

(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
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'

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free