github.com/codysnider/go-ethereum@v1.10.18-0.20220420071915-14f4ae99222a/params/protocol_params.go (about)

     1  // Copyright 2015 The go-ethereum Authors
     2  // This file is part of the go-ethereum library.
     3  //
     4  // The go-ethereum library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The go-ethereum library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  package params
    18  
    19  import "math/big"
    20  
    21  const (
    22  	GasLimitBoundDivisor uint64 = 1024               // The bound divisor of the gas limit, used in update calculations.
    23  	MinGasLimit          uint64 = 5000               // Minimum the gas limit may ever be.
    24  	MaxGasLimit          uint64 = 0x7fffffffffffffff // Maximum the gas limit (2^63-1).
    25  	GenesisGasLimit      uint64 = 4712388            // Gas limit of the Genesis block.
    26  
    27  	MaximumExtraDataSize  uint64 = 32    // Maximum size extra data may be after Genesis.
    28  	ExpByteGas            uint64 = 10    // Times ceil(log256(exponent)) for the EXP instruction.
    29  	SloadGas              uint64 = 50    // Multiplied by the number of 32-byte words that are copied (round up) for any *COPY operation and added.
    30  	CallValueTransferGas  uint64 = 9000  // Paid for CALL when the value transfer is non-zero.
    31  	CallNewAccountGas     uint64 = 25000 // Paid for CALL when the destination address didn't exist prior.
    32  	TxGas                 uint64 = 21000 // Per transaction not creating a contract. NOTE: Not payable on data of calls between transactions.
    33  	TxGasContractCreation uint64 = 53000 // Per transaction that creates a contract. NOTE: Not payable on data of calls between transactions.
    34  	TxDataZeroGas         uint64 = 4     // Per byte of data attached to a transaction that equals zero. NOTE: Not payable on data of calls between transactions.
    35  	QuadCoeffDiv          uint64 = 512   // Divisor for the quadratic particle of the memory cost equation.
    36  	LogDataGas            uint64 = 8     // Per byte in a LOG* operation's data.
    37  	CallStipend           uint64 = 2300  // Free gas given at beginning of call.
    38  
    39  	Keccak256Gas     uint64 = 30 // Once per KECCAK256 operation.
    40  	Keccak256WordGas uint64 = 6  // Once per word of the KECCAK256 operation's data.
    41  
    42  	SstoreSetGas    uint64 = 20000 // Once per SSTORE operation.
    43  	SstoreResetGas  uint64 = 5000  // Once per SSTORE operation if the zeroness changes from zero.
    44  	SstoreClearGas  uint64 = 5000  // Once per SSTORE operation if the zeroness doesn't change.
    45  	SstoreRefundGas uint64 = 15000 // Once per SSTORE operation if the zeroness changes to zero.
    46  
    47  	NetSstoreNoopGas  uint64 = 200   // Once per SSTORE operation if the value doesn't change.
    48  	NetSstoreInitGas  uint64 = 20000 // Once per SSTORE operation from clean zero.
    49  	NetSstoreCleanGas uint64 = 5000  // Once per SSTORE operation from clean non-zero.
    50  	NetSstoreDirtyGas uint64 = 200   // Once per SSTORE operation from dirty.
    51  
    52  	NetSstoreClearRefund      uint64 = 15000 // Once per SSTORE operation for clearing an originally existing storage slot
    53  	NetSstoreResetRefund      uint64 = 4800  // Once per SSTORE operation for resetting to the original non-zero value
    54  	NetSstoreResetClearRefund uint64 = 19800 // Once per SSTORE operation for resetting to the original zero value
    55  
    56  	SstoreSentryGasEIP2200            uint64 = 2300  // Minimum gas required to be present for an SSTORE call, not consumed
    57  	SstoreSetGasEIP2200               uint64 = 20000 // Once per SSTORE operation from clean zero to non-zero
    58  	SstoreResetGasEIP2200             uint64 = 5000  // Once per SSTORE operation from clean non-zero to something else
    59  	SstoreClearsScheduleRefundEIP2200 uint64 = 15000 // Once per SSTORE operation for clearing an originally existing storage slot
    60  
    61  	ColdAccountAccessCostEIP2929 = uint64(2600) // COLD_ACCOUNT_ACCESS_COST
    62  	ColdSloadCostEIP2929         = uint64(2100) // COLD_SLOAD_COST
    63  	WarmStorageReadCostEIP2929   = uint64(100)  // WARM_STORAGE_READ_COST
    64  
    65  	// In EIP-2200: SstoreResetGas was 5000.
    66  	// In EIP-2929: SstoreResetGas was changed to '5000 - COLD_SLOAD_COST'.
    67  	// In EIP-3529: SSTORE_CLEARS_SCHEDULE is defined as SSTORE_RESET_GAS + ACCESS_LIST_STORAGE_KEY_COST
    68  	// Which becomes: 5000 - 2100 + 1900 = 4800
    69  	SstoreClearsScheduleRefundEIP3529 uint64 = SstoreResetGasEIP2200 - ColdSloadCostEIP2929 + TxAccessListStorageKeyGas
    70  
    71  	JumpdestGas   uint64 = 1     // Once per JUMPDEST operation.
    72  	EpochDuration uint64 = 30000 // Duration between proof-of-work epochs.
    73  
    74  	CreateDataGas         uint64 = 200   //
    75  	CallCreateDepth       uint64 = 1024  // Maximum depth of call/create stack.
    76  	ExpGas                uint64 = 10    // Once per EXP instruction
    77  	LogGas                uint64 = 375   // Per LOG* operation.
    78  	CopyGas               uint64 = 3     //
    79  	StackLimit            uint64 = 1024  // Maximum size of VM stack allowed.
    80  	TierStepGas           uint64 = 0     // Once per operation, for a selection of them.
    81  	LogTopicGas           uint64 = 375   // Multiplied by the * of the LOG*, per LOG transaction. e.g. LOG0 incurs 0 * c_txLogTopicGas, LOG4 incurs 4 * c_txLogTopicGas.
    82  	CreateGas             uint64 = 32000 // Once per CREATE operation & contract-creation transaction.
    83  	Create2Gas            uint64 = 32000 // Once per CREATE2 operation
    84  	SelfdestructRefundGas uint64 = 24000 // Refunded following a selfdestruct operation.
    85  	MemoryGas             uint64 = 3     // Times the address of the (highest referenced byte in memory + 1). NOTE: referencing happens on read, write and in instructions such as RETURN and CALL.
    86  
    87  	TxDataNonZeroGasFrontier  uint64 = 68   // Per byte of data attached to a transaction that is not equal to zero. NOTE: Not payable on data of calls between transactions.
    88  	TxDataNonZeroGasEIP2028   uint64 = 16   // Per byte of non zero data attached to a transaction after EIP 2028 (part in Istanbul)
    89  	TxAccessListAddressGas    uint64 = 2400 // Per address specified in EIP 2930 access list
    90  	TxAccessListStorageKeyGas uint64 = 1900 // Per storage key specified in EIP 2930 access list
    91  
    92  	// These have been changed during the course of the chain
    93  	CallGasFrontier              uint64 = 40  // Once per CALL operation & message call transaction.
    94  	CallGasEIP150                uint64 = 700 // Static portion of gas for CALL-derivates after EIP 150 (Tangerine)
    95  	BalanceGasFrontier           uint64 = 20  // The cost of a BALANCE operation
    96  	BalanceGasEIP150             uint64 = 400 // The cost of a BALANCE operation after Tangerine
    97  	BalanceGasEIP1884            uint64 = 700 // The cost of a BALANCE operation after EIP 1884 (part of Istanbul)
    98  	ExtcodeSizeGasFrontier       uint64 = 20  // Cost of EXTCODESIZE before EIP 150 (Tangerine)
    99  	ExtcodeSizeGasEIP150         uint64 = 700 // Cost of EXTCODESIZE after EIP 150 (Tangerine)
   100  	SloadGasFrontier             uint64 = 50
   101  	SloadGasEIP150               uint64 = 200
   102  	SloadGasEIP1884              uint64 = 800  // Cost of SLOAD after EIP 1884 (part of Istanbul)
   103  	SloadGasEIP2200              uint64 = 800  // Cost of SLOAD after EIP 2200 (part of Istanbul)
   104  	ExtcodeHashGasConstantinople uint64 = 400  // Cost of EXTCODEHASH (introduced in Constantinople)
   105  	ExtcodeHashGasEIP1884        uint64 = 700  // Cost of EXTCODEHASH after EIP 1884 (part in Istanbul)
   106  	SelfdestructGasEIP150        uint64 = 5000 // Cost of SELFDESTRUCT post EIP 150 (Tangerine)
   107  
   108  	// EXP has a dynamic portion depending on the size of the exponent
   109  	ExpByteFrontier uint64 = 10 // was set to 10 in Frontier
   110  	ExpByteEIP158   uint64 = 50 // was raised to 50 during Eip158 (Spurious Dragon)
   111  
   112  	// Extcodecopy has a dynamic AND a static cost. This represents only the
   113  	// static portion of the gas. It was changed during EIP 150 (Tangerine)
   114  	ExtcodeCopyBaseFrontier uint64 = 20
   115  	ExtcodeCopyBaseEIP150   uint64 = 700
   116  
   117  	// CreateBySelfdestructGas is used when the refunded account is one that does
   118  	// not exist. This logic is similar to call.
   119  	// Introduced in Tangerine Whistle (Eip 150)
   120  	CreateBySelfdestructGas uint64 = 25000
   121  
   122  	BaseFeeChangeDenominator = 8          // Bounds the amount the base fee can change between blocks.
   123  	ElasticityMultiplier     = 2          // Bounds the maximum gas limit an EIP-1559 block may have.
   124  	InitialBaseFee           = 1000000000 // Initial base fee for EIP-1559 blocks.
   125  
   126  	MaxCodeSize = 24576 // Maximum bytecode to permit for a contract
   127  
   128  	// Precompiled contract gas prices
   129  
   130  	EcrecoverGas        uint64 = 3000 // Elliptic curve sender recovery gas price
   131  	Sha256BaseGas       uint64 = 60   // Base price for a SHA256 operation
   132  	Sha256PerWordGas    uint64 = 12   // Per-word price for a SHA256 operation
   133  	Ripemd160BaseGas    uint64 = 600  // Base price for a RIPEMD160 operation
   134  	Ripemd160PerWordGas uint64 = 120  // Per-word price for a RIPEMD160 operation
   135  	IdentityBaseGas     uint64 = 15   // Base price for a data copy operation
   136  	IdentityPerWordGas  uint64 = 3    // Per-work price for a data copy operation
   137  
   138  	Bn256AddGasByzantium             uint64 = 500    // Byzantium gas needed for an elliptic curve addition
   139  	Bn256AddGasIstanbul              uint64 = 150    // Gas needed for an elliptic curve addition
   140  	Bn256ScalarMulGasByzantium       uint64 = 40000  // Byzantium gas needed for an elliptic curve scalar multiplication
   141  	Bn256ScalarMulGasIstanbul        uint64 = 6000   // Gas needed for an elliptic curve scalar multiplication
   142  	Bn256PairingBaseGasByzantium     uint64 = 100000 // Byzantium base price for an elliptic curve pairing check
   143  	Bn256PairingBaseGasIstanbul      uint64 = 45000  // Base price for an elliptic curve pairing check
   144  	Bn256PairingPerPointGasByzantium uint64 = 80000  // Byzantium per-point price for an elliptic curve pairing check
   145  	Bn256PairingPerPointGasIstanbul  uint64 = 34000  // Per-point price for an elliptic curve pairing check
   146  
   147  	Bls12381G1AddGas          uint64 = 600    // Price for BLS12-381 elliptic curve G1 point addition
   148  	Bls12381G1MulGas          uint64 = 12000  // Price for BLS12-381 elliptic curve G1 point scalar multiplication
   149  	Bls12381G2AddGas          uint64 = 4500   // Price for BLS12-381 elliptic curve G2 point addition
   150  	Bls12381G2MulGas          uint64 = 55000  // Price for BLS12-381 elliptic curve G2 point scalar multiplication
   151  	Bls12381PairingBaseGas    uint64 = 115000 // Base gas price for BLS12-381 elliptic curve pairing check
   152  	Bls12381PairingPerPairGas uint64 = 23000  // Per-point pair gas price for BLS12-381 elliptic curve pairing check
   153  	Bls12381MapG1Gas          uint64 = 5500   // Gas price for BLS12-381 mapping field element to G1 operation
   154  	Bls12381MapG2Gas          uint64 = 110000 // Gas price for BLS12-381 mapping field element to G2 operation
   155  
   156  	// The Refund Quotient is the cap on how much of the used gas can be refunded. Before EIP-3529,
   157  	// up to half the consumed gas could be refunded. Redefined as 1/5th in EIP-3529
   158  	RefundQuotient        uint64 = 2
   159  	RefundQuotientEIP3529 uint64 = 5
   160  )
   161  
   162  // Gas discount table for BLS12-381 G1 and G2 multi exponentiation operations
   163  var Bls12381MultiExpDiscountTable = [128]uint64{1200, 888, 764, 641, 594, 547, 500, 453, 438, 423, 408, 394, 379, 364, 349, 334, 330, 326, 322, 318, 314, 310, 306, 302, 298, 294, 289, 285, 281, 277, 273, 269, 268, 266, 265, 263, 262, 260, 259, 257, 256, 254, 253, 251, 250, 248, 247, 245, 244, 242, 241, 239, 238, 236, 235, 233, 232, 231, 229, 228, 226, 225, 223, 222, 221, 220, 219, 219, 218, 217, 216, 216, 215, 214, 213, 213, 212, 211, 211, 210, 209, 208, 208, 207, 206, 205, 205, 204, 203, 202, 202, 201, 200, 199, 199, 198, 197, 196, 196, 195, 194, 193, 193, 192, 191, 191, 190, 189, 188, 188, 187, 186, 185, 185, 184, 183, 182, 182, 181, 180, 179, 179, 178, 177, 176, 176, 175, 174}
   164  
   165  var (
   166  	DifficultyBoundDivisor = big.NewInt(2048)   // The bound divisor of the difficulty, used in the update calculations.
   167  	GenesisDifficulty      = big.NewInt(131072) // Difficulty of the Genesis block.
   168  	MinimumDifficulty      = big.NewInt(131072) // The minimum that the difficulty may ever be.
   169  	DurationLimit          = big.NewInt(13)     // The decision boundary on the blocktime duration used to determine whether difficulty should go up or not.
   170  )