Function timestamp_to_epoch 

pub fn timestamp_to_epoch(timestamp: i64) -> u64

Convert Unix timestamp to epoch number (day sequence since launch).

Formula

epoch = (timestamp - START_AT) / EPOCH_DURATION

Parameters

• timestamp: Unix timestamp in seconds

Returns

• Epoch number (0-based day sequence since launch)

Epoch Alignment

• Epoch 0: Sept 1, 2025 00:00:00 UTC to Sept 1, 2025 23:59:59 UTC
• Epoch 1: Sept 2, 2025 00:00:00 UTC to Sept 2, 2025 23:59:59 UTC
• Each epoch aligns with a natural UTC date (midnight to midnight)
• Project launches at START_AT (10:00 AM UTC on Sept 1, 2025) within epoch 0

Example

use miracle_api::sdk;
let epoch = sdk::timestamp_to_epoch(1756756800); // Returns 0 (Sept 1, 2025 00:00:00 UTC)
let epoch = sdk::timestamp_to_epoch(1756843200); // Returns 1 (Sept 2, 2025 00:00:00 UTC)