Protocol Parameters Reference

Cardano protocol parameters control the behavior of the network, including fees, block sizes, staking mechanics, and governance. These parameters can be queried from a running node and updated through governance actions.

Querying Parameters

torsten-cli query protocol-parameters \
  --socket-path ./node.sock \
  --out-file protocol-params.json

Fee Parameters

ParameterJSON KeyDescriptionMainnet Default
Min fee coefficienttxFeePerByte / minFeeAFee per byte of transaction size44
Min fee constanttxFeeFixed / minFeeBFixed fee component155381
Min UTxO value per byteutxoCostPerByte / adaPerUtxoByteMinimum lovelace per byte of UTxO4310

The transaction fee formula is:

fee = txFeePerByte * tx_size_in_bytes + txFeeFixed

Block Size Parameters

ParameterJSON KeyDescriptionMainnet Default
Max block body sizemaxBlockBodySizeMaximum block body size in bytes90112
Max transaction sizemaxTxSizeMaximum transaction size in bytes16384
Max block header sizemaxBlockHeaderSizeMaximum block header size in bytes1100

Staking Parameters

ParameterJSON KeyDescriptionMainnet Default
Stake address depositstakeAddressDeposit / keyDepositDeposit for stake key registration (lovelace)2000000
Pool depositstakePoolDeposit / poolDepositDeposit for pool registration (lovelace)500000000
Pool retire max epochpoolRetireMaxEpoch / eMaxMaximum future epochs for pool retirement18
Pool target countstakePoolTargetNum / nOptTarget number of pools (k parameter)500
Min pool costminPoolCostMinimum fixed pool cost (lovelace)170000000

Monetary Policy

ParameterDescription
Monetary expansion (rho)Rate of new ADA creation from reserves per epoch
Treasury cut (tau)Fraction of rewards directed to the treasury
Pledge influence (a0)How pledge affects reward calculations

Plutus Execution Parameters

ParameterJSON KeyDescriptionMainnet Default
Max tx execution unitsmaxTxExecutionUnits{memory, steps} per transaction{14000000, 10000000000}
Max block execution unitsmaxBlockExecutionUnits{memory, steps} per block{62000000, 40000000000}
Max value sizemaxValueSizeMaximum serialized value size in bytes5000
Collateral percentagecollateralPercentageCollateral % of total tx fee for Plutus txs150
Max collateral inputsmaxCollateralInputsMaximum collateral inputs per tx3

Governance Parameters (Conway)

ParameterJSON KeyDescriptionMainnet Default
DRep depositdrepDepositDeposit for DRep registration (lovelace)500000000
Gov action depositgovActionDepositDeposit for governance action submission (lovelace)100000000000
Gov action lifetimegovActionLifetimeGovernance action expiry (epochs)6

Voting Thresholds

Different governance action types require different voting thresholds from DReps, SPOs, and the Constitutional Committee:

Action TypeDRep ThresholdSPO ThresholdCC Threshold
No ConfidencedvtMotionNoConfidencepvtMotionNoConfidenceRequired
Update Committee (normal)dvtCommitteeNormalpvtCommitteeNormalN/A
Update Committee (no confidence)dvtCommitteeNoConfidencepvtCommitteeNoConfidenceN/A
New ConstitutiondvtUpdateToConstitutionN/ARequired
Hard Fork InitiationdvtHardForkInitiationpvtHardForkInitiationRequired
Protocol Parameter Update (network)dvtPPNetworkGroupN/ARequired
Protocol Parameter Update (economic)dvtPPEconomicGrouppvtPPEconomicGroupRequired
Protocol Parameter Update (technical)dvtPPTechnicalGroupN/ARequired
Protocol Parameter Update (governance)dvtPPGovGroupN/ARequired
Treasury WithdrawaldvtTreasuryWithdrawalN/ARequired

CBOR Field Numbers

When encoding protocol parameter updates in governance actions, each parameter maps to a CBOR field number:

CBOR KeyParameter
0txFeePerByte / minFeeA
1txFeeFixed / minFeeB
2maxBlockBodySize
3maxTxSize
4maxBlockHeaderSize
5stakeAddressDeposit / keyDeposit
6stakePoolDeposit / poolDeposit
7poolRetireMaxEpoch / eMax
8stakePoolTargetNum / nOpt
16minPoolCost
17utxoCostPerByte / adaPerUtxoByte
20maxTxExecutionUnits
21maxBlockExecutionUnits
22maxValueSize
23collateralPercentage
24maxCollateralInputs
30drepDeposit
31govActionDeposit
32govActionLifetime