Shardeum Documentation
Transaction-types

Transaction Types

Transaction Types on Shardeum

Shardeum uses different transaction types for various operations in the network. Understanding these transaction types is essential for developers working with the Shardeum blockchain.

1. EVM Transactions

These are standard Ethereum-style transactions that can be:

  • Regular token transfers
  • Smart contract deployments
  • Smart contract interactions

These transactions are handled through:

2. Internal Transaction Types

Internal transactions are special system-level operations that manage the network's infrastructure, configuration, and staking mechanisms. They're defined in InternalTXType enum:

CodeTransaction TypeDescription
1InitNetworkInitializes the network with basic parameters
2NodeRewardDeprecated - Previously used for node rewards
3ChangeConfigProposes configuration changes to the network
4ApplyChangeConfigApplies previously proposed configuration changes
5SetCertTimeSets certification time for network nodes
6StakeStakes tokens to participate in network validation
7UnstakeWithdraws staked tokens from the network
8InitRewardTimesInitializes the reward distribution schedule
9ClaimRewardClaims earned rewards by validators or participants
10ChangeNetworkParamProposes changes to network parameters
11ApplyNetworkParamApplies previously proposed network parameter changes
12PenaltyApplies penalties to misbehaving nodes
13TransferFromSecureAccountTransfers tokens from secure system accounts

Debug Transaction Types

Debug transactions are special transactions (DebugTx) used for testing and debugging purposes, defined in DebugTXType enum:

CodeTransaction TypeDescription
0createCreates new accounts or contracts
1transferTransfers tokens between accounts

Transaction Validation

  • EVM transactions are validated for chainId and proper formatting
  • Internal transactions require proper signatures and permissions
  • Debug transactions are only allowed when debugTxEnabled flag is set
  • Staking transactions have additional validation for minimum stake amounts and ticket types

Each transaction type serves a specific purpose in the Shardeum network, from regular value transfers to network governance and validation.

On this page