Documented block time fallback and candle skew in docs/indexer-invariants.md (behavior of parse_block_time in indexer/src/indexer/poller.rs, mitigations, Prometheus counter indexer_block_time_fallbacks_total, link to reorg runbook).

@brouie please review.

## Epic #62 delivery Documented **block time fallback and candle skew** in `docs/indexer-invariants.md` (behavior of `parse_block_time` in `indexer/src/indexer/poller.rs`, mitigations, Prometheus counter `indexer_block_time_fallbacks_total`, link to reorg runbook). @brouie please review.

PlasticDigits commented

2026-04-13 12:29:18 +00:00

(Migrated from gitlab.com)

mentioned in issue #62

Brouie commented

2026-04-20 07:17:11 +00:00

(Migrated from gitlab.com)

@PlasticDigits Verified on current main. docs/indexer-invariants.md covers block time fallback:

Line 42: Summary table entry 'Block time usable | RFC3339 parse; else tracing::warn + Utc::now() | Misaligned candles (documented risk) | Manual / logs'
Line 70: Dedicated 'Block time fallback and candle skew' section
Line 72: parse_block_time source pointer (indexer/src/indexer/poller.rs)
Line 77: Risk statement 'Event times and candle bucket boundaries can diverge from true chain time -- OHLC intervals may skew relative to block time'
Line 79: Mitigations including Prometheus counter indexer_block_time_fallbacks_total with METRICS_BIND guidance

Risk documented, operator mitigations clear. Closing.

@PlasticDigits Verified on current main. docs/indexer-invariants.md covers block time fallback: - Line 42: Summary table entry 'Block time usable | RFC3339 parse; else tracing::warn + Utc::now() | Misaligned candles (documented risk) | Manual / logs' - Line 70: Dedicated 'Block time fallback and candle skew' section - Line 72: parse_block_time source pointer (indexer/src/indexer/poller.rs) - Line 77: Risk statement 'Event times and candle bucket boundaries can diverge from true chain time -- OHLC intervals may skew relative to block time' - Line 79: Mitigations including Prometheus counter indexer_block_time_fallbacks_total with METRICS_BIND guidance Risk documented, operator mitigations clear. Closing.

Brouie (Migrated from gitlab.com) closed this issue

2026-04-20 07:17:15 +00:00