package core import ( "fmt" "math" "time" math2 "github.com/ethereum/go-ethereum/common/math" "github.com/pkg/errors" types "github.com/prysmaticlabs/eth2-types" "github.com/prysmaticlabs/prysm/beacon-chain/state" "github.com/prysmaticlabs/prysm/config/params" "github.com/prysmaticlabs/prysm/runtime/version" prysmTime "github.com/prysmaticlabs/prysm/time" ) // MaxSlotBuffer specifies the max buffer given to slots from // incoming objects. (24 mins with mainnet spec) const MaxSlotBuffer = uint64(1 << 7) // SlotToEpoch returns the epoch number of the input slot. // // Spec pseudocode definition: // def compute_epoch_at_slot(slot: Slot) -> Epoch: // """ // Return the epoch number at ``slot``. // """ // return Epoch(slot // SLOTS_PER_EPOCH) func SlotToEpoch(slot types.Slot) types.Epoch { return types.Epoch(slot.DivSlot(params.BeaconConfig().SlotsPerEpoch)) } // CurrentEpoch returns the current epoch number calculated from // the slot number stored in beacon state. // // Spec pseudocode definition: // def get_current_epoch(state: BeaconState) -> Epoch: // """ // Return the current epoch. // """ // return compute_epoch_at_slot(state.slot) func CurrentEpoch(state state.ReadOnlyBeaconState) types.Epoch { return SlotToEpoch(state.Slot()) } // PrevEpoch returns the previous epoch number calculated from // the slot number stored in beacon state. It also checks for // underflow condition. // // Spec pseudocode definition: // def get_previous_epoch(state: BeaconState) -> Epoch: // """` // Return the previous epoch (unless the current epoch is ``GENESIS_EPOCH``). // """ // current_epoch = get_current_epoch(state) // return GENESIS_EPOCH if current_epoch == GENESIS_EPOCH else Epoch(current_epoch - 1) func PrevEpoch(state state.ReadOnlyBeaconState) types.Epoch { currentEpoch := CurrentEpoch(state) if currentEpoch == 0 { return 0 } return currentEpoch - 1 } // NextEpoch returns the next epoch number calculated from // the slot number stored in beacon state. func NextEpoch(state state.ReadOnlyBeaconState) types.Epoch { return SlotToEpoch(state.Slot()) + 1 } // AltairCompatible returns if the input state `s` is altair compatible and input epoch `e` is higher equal than fork epoch. func AltairCompatible(s state.BeaconState, e types.Epoch) bool { return s.Version() == version.Altair && e >= params.BeaconConfig().AltairForkEpoch } // StartSlot returns the first slot number of the // current epoch. // // Spec pseudocode definition: // def compute_start_slot_at_epoch(epoch: Epoch) -> Slot: // """ // Return the start slot of ``epoch``. // """ // return Slot(epoch * SLOTS_PER_EPOCH) func StartSlot(epoch types.Epoch) (types.Slot, error) { slot, err := params.BeaconConfig().SlotsPerEpoch.SafeMul(uint64(epoch)) if err != nil { return slot, errors.Errorf("start slot calculation overflows: %v", err) } return slot, nil } // EndSlot returns the last slot number of the // current epoch. func EndSlot(epoch types.Epoch) (types.Slot, error) { if epoch == math.MaxUint64 { return 0, errors.New("start slot calculation overflows") } slot, err := StartSlot(epoch + 1) if err != nil { return 0, err } return slot - 1, nil } // IsEpochStart returns true if the given slot number is an epoch starting slot // number. func IsEpochStart(slot types.Slot) bool { return slot%params.BeaconConfig().SlotsPerEpoch == 0 } // IsEpochEnd returns true if the given slot number is an epoch ending slot // number. func IsEpochEnd(slot types.Slot) bool { return IsEpochStart(slot + 1) } // SlotsSinceEpochStarts returns number of slots since the start of the epoch. func SlotsSinceEpochStarts(slot types.Slot) types.Slot { return slot % params.BeaconConfig().SlotsPerEpoch } // VerifySlotTime validates the input slot is not from the future. func VerifySlotTime(genesisTime uint64, slot types.Slot, timeTolerance time.Duration) error { slotTime, err := SlotToTime(genesisTime, slot) if err != nil { return err } // Defensive check to ensure unreasonable slots are rejected // straight away. if err := ValidateSlotClock(slot, genesisTime); err != nil { return err } currentTime := prysmTime.Now() diff := slotTime.Sub(currentTime) if diff > timeTolerance { return fmt.Errorf("could not process slot from the future, slot time %s > current time %s", slotTime, currentTime) } return nil } // SlotToTime takes the given slot and genesis time to determine the start time of the slot. func SlotToTime(genesisTimeSec uint64, slot types.Slot) (time.Time, error) { timeSinceGenesis, err := slot.SafeMul(params.BeaconConfig().SecondsPerSlot) if err != nil { return time.Unix(0, 0), fmt.Errorf("slot (%d) is in the far distant future: %w", slot, err) } sTime, err := timeSinceGenesis.SafeAdd(genesisTimeSec) if err != nil { return time.Unix(0, 0), fmt.Errorf("slot (%d) is in the far distant future: %w", slot, err) } return time.Unix(int64(sTime), 0), nil } // SlotsSince computes the number of time slots that have occurred since the given timestamp. func SlotsSince(time time.Time) types.Slot { return CurrentSlot(uint64(time.Unix())) } // CurrentSlot returns the current slot as determined by the local clock and // provided genesis time. func CurrentSlot(genesisTimeSec uint64) types.Slot { now := prysmTime.Now().Unix() genesis := int64(genesisTimeSec) if now < genesis { return 0 } return types.Slot(uint64(now-genesis) / params.BeaconConfig().SecondsPerSlot) } // ValidateSlotClock validates a provided slot against the local // clock to ensure slots that are unreasonable are returned with // an error. func ValidateSlotClock(slot types.Slot, genesisTimeSec uint64) error { maxPossibleSlot := CurrentSlot(genesisTimeSec).Add(MaxSlotBuffer) // Defensive check to ensure that we only process slots up to a hard limit // from our local clock. if slot > maxPossibleSlot { return fmt.Errorf("slot %d > %d which exceeds max allowed value relative to the local clock", slot, maxPossibleSlot) } return nil } // RoundUpToNearestEpoch rounds up the provided slot value to the nearest epoch. func RoundUpToNearestEpoch(slot types.Slot) types.Slot { if slot%params.BeaconConfig().SlotsPerEpoch != 0 { slot -= slot % params.BeaconConfig().SlotsPerEpoch slot += params.BeaconConfig().SlotsPerEpoch } return slot } // VotingPeriodStartTime returns the current voting period's start time // depending on the provided genesis and current slot. func VotingPeriodStartTime(genesis uint64, slot types.Slot) uint64 { slots := params.BeaconConfig().SlotsPerEpoch.Mul(uint64(params.BeaconConfig().EpochsPerEth1VotingPeriod)) startTime := uint64((slot - slot.ModSlot(slots)).Mul(params.BeaconConfig().SecondsPerSlot)) return genesis + startTime } // PrevSlot returns previous slot, with an exception in slot 0 to prevent underflow. func PrevSlot(slot types.Slot) types.Slot { if slot > 0 { return slot.Sub(1) } return 0 } // SyncCommitteePeriod returns the sync committee period of input epoch `e`. // // Spec code: // def compute_sync_committee_period(epoch: Epoch) -> uint64: // return epoch // EPOCHS_PER_SYNC_COMMITTEE_PERIOD func SyncCommitteePeriod(e types.Epoch) uint64 { return uint64(e / params.BeaconConfig().EpochsPerSyncCommitteePeriod) } // SyncCommitteePeriodStartEpoch returns the start epoch of a sync committee period. func SyncCommitteePeriodStartEpoch(e types.Epoch) (types.Epoch, error) { // Overflow is impossible here because of division of `EPOCHS_PER_SYNC_COMMITTEE_PERIOD`. startEpoch, overflow := math2.SafeMul(SyncCommitteePeriod(e), uint64(params.BeaconConfig().EpochsPerSyncCommitteePeriod)) if overflow { return 0, errors.New("start epoch calculation overflow") } return types.Epoch(startEpoch), nil } // CanUpgradeToAltair returns true if the input `slot` can upgrade to Altair. // Spec code: // If state.slot % SLOTS_PER_EPOCH == 0 and compute_epoch_at_slot(state.slot) == ALTAIR_FORK_EPOCH func CanUpgradeToAltair(slot types.Slot) bool { epochStart := IsEpochStart(slot) altairEpoch := SlotToEpoch(slot) == params.BeaconConfig().AltairForkEpoch return epochStart && altairEpoch }