github.com/core-coin/go-core/v2@v2.1.9/core/energypool.go (about)

     1  // Copyright 2023 by the Authors
     2  // This file is part of the go-core library.
     3  //
     4  // The go-core 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-core 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-core library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  package core
    18  
    19  import (
    20  	"fmt"
    21  	"math"
    22  )
    23  
    24  // EnergyPool tracks the amount of energy available during execution of the transactions
    25  // in a block. The zero value is a pool with zero energy available.
    26  type EnergyPool uint64
    27  
    28  // AddEnergy makes energy available for execution.
    29  func (gp *EnergyPool) AddEnergy(amount uint64) *EnergyPool {
    30  	if uint64(*gp) > math.MaxUint64-amount {
    31  		panic("energy pool pushed above uint64")
    32  	}
    33  	*(*uint64)(gp) += amount
    34  	return gp
    35  }
    36  
    37  // SubEnergy deducts the given amount from the pool if enough energy is
    38  // available and returns an error otherwise.
    39  func (gp *EnergyPool) SubEnergy(amount uint64) error {
    40  	if uint64(*gp) < amount {
    41  		return ErrEnergyLimitReached
    42  	}
    43  	*(*uint64)(gp) -= amount
    44  	return nil
    45  }
    46  
    47  // Energy returns the amount of energy remaining in the pool.
    48  func (gp *EnergyPool) Energy() uint64 {
    49  	return uint64(*gp)
    50  }
    51  
    52  func (gp *EnergyPool) String() string {
    53  	return fmt.Sprintf("%d", *gp)
    54  }