jamtime

var (
	// ErrBeforeJamEpoch is returned when attempting to create or manipulate a
	// JamTime that represents a moment before the JAM Epoch (1200 UTC on January 1, 2024).
	// This error indicates that the given time is outside the valid range for
	// the JAM protocol.
	ErrBeforeJamEpoch = errors.New("time is before JAM Epoch")

	// ErrAfterMaxJamTime is returned when attempting to create or manipulate a
	// JamTime that represents a moment after the maximum representable time in the
	// JAM protocol (typically around mid-August 2840). This error indicates that
	// the given time exceeds the maximum value that can be represented within the
	// protocol's time range.
	ErrAfterMaxJamTime = errors.New("time is after maximum representable JAM time")

	// ErrMinEpochReached is returned when attempting to get the previous epoch
	// from the minimum possible epoch value.
	ErrMinEpochReached = errors.New("minimum epoch reached")

	// ErrMaxEpochReached is returned when attempting to get the next epoch
	// from the maximum possible epoch value.
	ErrMaxEpochReached = errors.New("maximum epoch reached")

	// ErrEpochExceedsMaxJamTime is returned when an epoch value exceeds the maximum
	// representable time in the JAM system, typically during epoch calculations
	// or conversions.
	ErrEpochExceedsMaxJamTime = errors.New("epoch is after maximum representable JAM time")

	// ErrMinTimeslotReached is returned when attempting to get the previous timeslot
	// from the minimum possible timeslot value.
	ErrMinTimeslotReached = errors.New("minimum timeslot reached")

	// ErrMaxTimeslotReached is returned when attempting to get the next timeslot
	// from the maximum possible timeslot value.
	ErrMaxTimeslotReached = errors.New("maximum timeslot reached")

	// ErrTimeslotExceedsEpochLength is returned when a timeslot number is greater than
	// or equal to the number of timeslots in an epoch. This typically occurs when
	// converting between epochs and timeslots or when validating timeslot values.
	ErrTimeslotExceedsEpochLength = errors.New("timeslot number exceeds epoch length")
)

var JamEpoch = time.Date(2025, time.January, 1, 12, 0, 0, 0, time.UTC)

var MaxRepresentableJamTime = time.Date(2841, time.August, 15, 23, 59, 59, 999999999, time.UTC)