feat: predict protocol upgrade time based on voting date

[stedfn]

Usage:

python3 estimate_epoch_start_time.py --chain_id mainnet --voting_date "2024-10-15 00:20:00"

Example Output

Epoch -1: 13 hours, 42 minutes
Epoch -2: 13 hours, 37 minutes
Epoch -3: 13 hours, 15 minutes
Epoch -4: 13 hours, 37 minutes

Exponential weighted average epoch length: 13 hours, 33 minutes
Predicted start of epoch 1: 2024-10-11 00:24:31 UTC+0000 Friday
Predicted start of epoch 2: 2024-10-11 13:58:19 UTC+0000 Friday
Predicted start of epoch 3: 2024-10-12 03:32:06 UTC+0000 Saturday
Predicted start of epoch 4: 2024-10-12 17:05:54 UTC+0000 Saturday
Predicted start of epoch 5: 2024-10-13 06:39:42 UTC+0000 Sunday
Predicted start of epoch 6: 2024-10-13 20:13:29 UTC+0000 Sunday
Predicted start of epoch 7: 2024-10-14 09:47:17 UTC+0000 Monday
Predicted start of epoch 8: 2024-10-14 23:21:04 UTC+0000 Monday
Predicted start of epoch 9: 2024-10-15 12:54:52 UTC+0000 Tuesday
Predicted start of epoch 10: 2024-10-16 02:28:40 UTC+0000 Wednesday

Voting date falls into epoch 8.
Protocol upgrade will happen at the start of epoch 10: 2024-10-16 02:28:40 UTC+0000 Wednesday

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 71.83%. Comparing base (bef29bc) to head (cd945de).
Report is 2 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master   #12202      +/-   ##
==========================================
- Coverage   71.84%   71.83%   -0.02%     
==========================================
  Files         827      827              
  Lines      166690   166716      +26     
  Branches   166690   166716      +26     
==========================================
- Hits       119763   119760       -3     
- Misses      41710    41736      +26     
- Partials     5217     5220       +3     

Flag	Coverage Δ
backward-compatibility	0.17% <ø> (-0.01%)	⬇️
db-migration	0.17% <ø> (-0.01%)	⬇️
genesis-check	1.25% <ø> (-0.01%)	⬇️
integration-tests	38.92% <ø> (+<0.01%)	⬆️
linux	71.50% <ø> (-0.03%)	⬇️
linux-nightly	71.42% <ø> (-0.02%)	⬇️
macos	53.34% <ø> (-0.93%)	⬇️
pytests	1.57% <ø> (-0.01%)	⬇️
sanity-checks	1.37% <ø> (-0.01%)	⬇️
unittests	65.62% <ø> (-0.02%)	⬇️
upgradability	0.21% <ø> (-0.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[VanBarbascu]

Other than the parser functions, it looks good. Feel free to merge it after you fix it.
Thanks!