Matrix Transaction Spec
Overview
Matrix transactions are regular BNB L1 transactions whose calldata contains a Matrix payload. Any transaction sent to the Matrix Inbox EOA is later read by Matrix-node and executed on Matrix.
Transaction Format
Matrix transactions use the EIP-2718 transaction type 0x46 (70 in base 10) and contain the following fields:
chain_id
Distinguishes the payload as being relevant only to Matrix
• Mainnet: 768945 (0xbbbb1 in hex)
• Testnet: 768946 (0xbbbb2 in hex)
to
L2 recipient's address (EOA or L2 contract). Blank for contract creations
value
Amount of GAS being transferred in the transaction
gas_limit
The gas limit of the L2 transaction
data
EVM input data (ABI encoded contract call or contract creation code)
mine_boost
Optional appended data that increases payload size to increase GAS mining (see below)
Important: Matrix transactions have no signature field. The "from" address is inferred from the properties of the BNB Chain transaction in which they are delivered.
Serialization Format
Matrix transactions must be serialized in this specific format for Matrix nodes to process them:
0x46 ++ rlp_encode([chain_id, to, value, gas_limit, data, mine_boost])Fee Model
Matrix uses a simple execution-only fee model on L2. Matrix transactions do not include priority fees, tip fields, or max fee fields. All Matrix executions consume Matrix L2 gas, with the base fee computed by the Matrix protocol.
The user only pays BNB L1 gas for submitting the envelope transaction. No additional fee markets or sequencer fees exist.
Execution on L2 (Derived Transaction Type)
Matrix payloads are executed on L2 as derived transactions, produced directly from BNB L1 calldata. These L2 execution transactions contain the following fields:
sourceHash— hash linking the L2 execution to the originating L1 envelopefrom— inferred from the L1 transaction signervalue— amount of WGAS (or other L2 asset) transferredgas— L2 gas allocated for executionisSystemTransaction— indicates system-level derivationdata— ABI-encoded Matrix calldata
Matrix does not mint tokens during execution, and the execution hash is computed independently of any L1 value. All state transitions are derived deterministically from BNB L1 ordering.
For detailed field definitions and hashing rules, see Reference → Chain State Derivation.
Last updated