2018-11-23 23:58:49 +00:00
|
|
|
import
|
2019-02-06 17:56:04 +00:00
|
|
|
chronos,
|
2019-03-22 15:49:37 +00:00
|
|
|
spec/[datatypes]
|
|
|
|
|
|
|
|
from times import Time, getTime, fromUnix, `<`, `-`
|
2018-11-23 23:58:49 +00:00
|
|
|
|
|
|
|
type
|
2019-03-22 15:49:37 +00:00
|
|
|
BeaconClock* = object
|
|
|
|
## The beacon clock represents time as it passes on a beacon chain. Beacon
|
|
|
|
## time is locked to unix time, starting at a particular offset set during
|
|
|
|
## beacon chain instantiation.
|
|
|
|
##
|
|
|
|
## Time on the beacon chain determines what actions should be taken and
|
|
|
|
## which blocks are valid - in particular, blocks are not valid if they
|
|
|
|
## come from the future as seen from the local clock.
|
|
|
|
##
|
2019-04-29 16:48:30 +00:00
|
|
|
## https://github.com/ethereum/eth2.0-specs/blob/v0.6.0/specs/core/0_fork-choice.md#beacon-chain-processing
|
2019-03-22 15:49:37 +00:00
|
|
|
##
|
|
|
|
# TODO replace time in chronos with a proper unit type, then this code can
|
|
|
|
# follow:
|
|
|
|
# https://github.com/status-im/nim-chronos/issues/15
|
|
|
|
# TODO consider NTP and network-adjusted timestamps as outlined here:
|
|
|
|
# https://ethresear.ch/t/network-adjusted-timestamps/4187
|
|
|
|
genesis: Time
|
|
|
|
|
|
|
|
BeaconTime* = distinct int64 ## Seconds from beacon genesis time
|
|
|
|
|
|
|
|
proc init*(T: type BeaconClock, state: BeaconState): T =
|
|
|
|
## Initialize time from a beacon state. The genesis time of a beacon state is
|
|
|
|
## constant throughout its lifetime, so the state from any slot will do,
|
|
|
|
## including the genesis state.
|
|
|
|
|
|
|
|
let
|
|
|
|
unixGenesis = fromUnix(state.genesis_time.int64)
|
|
|
|
# GENESIS_SLOT offsets slot time, but to simplify calculations, we apply that
|
|
|
|
# offset to genesis instead of applying it at every time conversion
|
|
|
|
unixGenesisOffset = times.seconds(int(GENESIS_SLOT * SECONDS_PER_SLOT))
|
|
|
|
|
|
|
|
T(genesis: unixGenesis - unixGenesisOffset)
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
func toSlot*(t: BeaconTime): Slot =
|
|
|
|
Slot(uint64(t) div SECONDS_PER_SLOT)
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
func toBeaconTime*(c: BeaconClock, t: Time): BeaconTime =
|
|
|
|
doAssert t > c.genesis,
|
|
|
|
"Cannot represent time before genesis, fix BeaconClock"
|
2018-12-19 12:58:53 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
BeaconTime(times.seconds(t - c.genesis).uint64)
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
func toSlot*(c: BeaconClock, t: Time): Slot =
|
|
|
|
c.toBeaconTime(t).toSlot()
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
func toBeaconTime*(s: Slot, offset = chronos.seconds(0)): BeaconTime =
|
|
|
|
BeaconTime(int64(uint64(s) * SECONDS_PER_SLOT) + seconds(offset))
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc now*(c: BeaconClock): BeaconTime =
|
|
|
|
## Current time, in slots - this may end up being less than GENESIS_SLOT(!)
|
|
|
|
toBeaconTime(c, getTime())
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc fromNow*(c: BeaconClock, t: BeaconTime): tuple[inFuture: bool, offset: Duration] =
|
|
|
|
let now = c.now()
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
if int64(t) > int64(now):
|
|
|
|
(true, seconds(int64(t) - int64(now)))
|
|
|
|
else:
|
|
|
|
(false, seconds(int64(now) - int64(t)))
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc fromNow*(c: BeaconClock, slot: Slot): tuple[inFuture: bool, offset: Duration] =
|
|
|
|
c.fromNow(slot.toBeaconTime())
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc saturate*(d: tuple[inFuture: bool, offset: Duration]): Duration =
|
|
|
|
if d.inFuture: d.offset else: seconds(0)
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc addTimer*(fromNow: Duration, cb: CallbackFunc, udata: pointer = nil) =
|
|
|
|
addTimer(Moment.now() + fromNow, cb, udata)
|
2018-11-23 23:58:49 +00:00
|
|
|
|
2019-03-22 15:49:37 +00:00
|
|
|
proc shortLog*(d: Duration): string =
|
|
|
|
let dd = int64(d.milliseconds())
|
|
|
|
if dd < 1000:
|
|
|
|
$dd & "ms"
|
|
|
|
elif dd < 60 * 1000:
|
|
|
|
$(dd div 1000) & "s"
|
|
|
|
elif dd < 60 * 60 * 1000:
|
|
|
|
let secs = dd div 1000
|
|
|
|
var tmp = $(secs div 60) & "m"
|
|
|
|
if (let frac = secs mod 60; frac > 0):
|
|
|
|
tmp &= $frac & "s"
|
|
|
|
tmp
|
|
|
|
else:
|
|
|
|
let mins = dd div 60 * 1000
|
|
|
|
var tmp = $(mins div 60) & "h"
|
|
|
|
if (let frac = mins mod 60; frac > 0):
|
|
|
|
tmp &= $frac & "m"
|
|
|
|
tmp
|