Transaction fields and hash calculations

​

INVOKE v3

​

Transaction fields

​

Hash calculation

invoke_v3_tx_hash = h(
  "invoke",
  version,
  sender_address,
  h(tip, l1_gas_bounds, l2_gas_bounds, l1_data_gas_bounds),
  h(paymaster_data),
  chain_id,
  nonce,
  data_availability_modes,
  h(account_deployment_data),
  h(calldata)
)

• invoke is a constant prefix string, encoded in ASCII.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain ID.
• l1_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l2_gas_bounds is constructed as follows: $$\underbrace{\texttt{L2\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l1_data_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_DATA}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• data_availability_modes is a concatenation of fee_data_availability_mode and nonce_data_availability_mode, as follows: $$\underbrace{\texttt{0...0}}_{\text{188 bits}} \, | \, \underbrace{\texttt{nonce\_data\_availability\_mode}}_{\text{32 bits}} \, | \, \underbrace{\texttt{fee\_data\_availability\_mode}}_{\text{32 bits}}$$
• h is the Poseidon hash.

​

DECLARE v3

​

Transaction fields

​

Hash calculation

declare_v3_tx_hash = h(
  "declare",
  version,
  sender_address,
  h(tip, l1_gas_bounds, l2_gas_bounds, l1_data_gas_bounds),
  h(paymaster_data),
  chain_id,
  nonce,
  data_availability_modes,
  h(account_deployment_data),
  class_hash,
  compiled_class_hash
)

• declare is a constant prefix string, encoded in ASCII.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain ID.
• l1_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l2_gas_bounds is constructed as follows: $$\underbrace{\texttt{L2\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l1_data_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_DATA}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• data_availability_modes is a concatenation of fee_data_availability_mode and nonce_data_availability_mode, as follows: $$\underbrace{\texttt{0...0}}_{\text{188 bits}} \, | \, \underbrace{\texttt{nonce\_data\_availability\_mode}}_{\text{32 bits}} \, | \, \underbrace{\texttt{fee\_data\_availability\_mode}}_{\text{32 bits}}$$
• h is the Poseidon hash.
• class_hash is the hash of the contract class. See the Cairo Book] for details about how the hash is computed
• compiled_class_hash is the hash of the compiled class generated by the Sierra→Casm compiler that is used in Starknet

​

DEPLOY_ACCOUNT v3

​

Transaction fields

​

Hash calculation

deploy_account_v3_tx_hash = h(
  "deploy_account",
  version,
  contract_address,
  h(tip, l1_gas_bounds, l2_gas_bounds, l1_data_gas_bounds),
  h(paymaster_data),
  chain_id,
  nonce,
  data_availability_modes,
  h(constructor_calldata),
  class_hash,
  contract_address_salt
)

• deploy_account is a constant prefix string, encoded in ASCII.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain ID.
• l1_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l2_gas_bounds is constructed as follows: $$\underbrace{\texttt{L2\_GAS}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• l1_data_gas_bounds is constructed as follows: $$\underbrace{\texttt{L1\_DATA}}_{\text{60 bits}} \, | \, \underbrace{\texttt{max\_amount}}_{\text{64 bits}} \, | \, \underbrace{\texttt{max\_price\_per\_unit}}_{\text{128 bits}}$$
• data_availability_modes is a concatenation of fee_data_availability_mode and nonce_data_availability_mode, as follows: $$\underbrace{\texttt{0...0}}_{\text{188 bits}} \, | \, \underbrace{\texttt{nonce\_data\_availability\_mode}}_{\text{32 bits}} \, | \, \underbrace{\texttt{fee\_data\_availability\_mode}}_{\text{32 bits}}$$
• h is the Poseidon hash.
• class_hash is the hash of the contract class hash. See the Cairo Book for details about how the hash is computed.
• contract_address is the address of the newly deployed account. For information on how this address is calculated, see the Cairo Book.

​

Additional information

​

Signature

​

Chain ID

chain_id = int.from_bytes(value, byteorder="big", signed=False)

• SN_MAIN for Starknet’s main network.
• SN_SEPOLIA for Starknet’s public testnet on Sepolia.

​

Legacy information

​

INVOKE v1

​

Transaction fields

​

Hash calculation

invoke_v1_tx_hash = h(
  "invoke",
  version,
  sender_address,
  0,
  h(calldata),
  max_fee,
  chain_id,
  nonce
)

• invoke is a constant prefix string, encoded in ASCII.
• The placeholder zero is used to align the hash computation for the different types of transactions.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain-Id.
• h is the Pedersen hash

​

INVOKE v0

​

Hash calculation

invoke_v0_tx_hash = h(
  "invoke",
  version,
  contract_address,
  entry_point_selector,
  h(calldata),
  max_fee,
  chain_id
)

• invoke is a constant prefix string, encoded in (ASCII).
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain-Id. v2 and v3
• h is the Pedersen hash

​

DECLARE v2

​

Transaction fields

​

Hash calculation

declare_v2_tx_hash = h(
  "declare",
  version,
  sender_address,
  0,
  h(class_hash),
  max_fee,
  chain_id,
  nonce,
  compiled_class_hash
)

• h is the Poseidon hash function
• class_hash is the hash of the contract class. See the Cairo Book for details about how the hash is computed
• compiled_class_hash is the hash of the compiled class generated by the Sierra→Casm compiler that is used in Starknet

​

DECLARE v1

​

Transaction fields

​

Hash calculation

declare_v1_tx_hash = h(
  "declare",
  version,
  sender_address,
  0,
  h(class_hash),
  max_fee,
  chain_id,
  nonce
)

• declare is a constant prefix string, encoded in ASCII.
• class_hash is the hash of the contract class. See the Cairo Book for details about how the hash is computed.
• The placeholder zero is used to align the hash computation for the different types of transactions.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain ID.
• h is the Pedersen hash

​

DECLARE v0

​

Hash calculation

declare_v0_tx_hash = h(
  "declare",
  version,
  sender_address,
  0,
  h(),
  max_fee,
  chain_id,
  class_hash
)

• declare is a constant prefix string, encoded in ASCII.
• The placeholder zeros are used to align the hash computation for the different types of transactions.
• h is the Pedersen hash
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain-Id.
• class_hash is the hash of the contract class. See the Cairo Book for details about how the hash is computed.

​

DEPLOY_ACCOUNT v1

​

Transaction fields

​

Hash calculation

deploy_account_v1_tx_hash = h(
  "deploy_account",
  version,
  contract_address,
  0,
  h(class_hash, contract_address_salt, constructor_calldata),
  max_fee,
  chain_id,
  nonce
)

• deploy_account is a constant prefix string, encoded in ASCII.
• The placeholder zero is used to align the hash computation for the different types of transactions.
• h is the Pedersen hash
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see [chain-id].
• class_hash is the hash of the contract class. See the Cairo Book for details about how the hash is computed.

​

DEPLOY v0

​

Hash calculation

deploy_tx_hash = h(
  "deploy",
  version,
  contract_address,
  sn_keccak("constructor"),
  h constructor_calldata),
  0,
  chain_id
)

• The placeholder zero is used to align the hash computation for the different types of transactions.
• deploy and constructor are constant strings encoded in ASCII.
• h is the Pedersen hash and sn_keccak is Starknet Keccak.
• chain_id is a constant value that specifies the network to which this transaction is sent. For more information, see Chain ID.
• contract_address is calculated as described see the Cairo Book.