ckb_sdk/types/
since.rs

1use ckb_types::core::EpochNumberWithFraction;
2
3use crate::constants::{LOCK_TYPE_FLAG, METRIC_TYPE_FLAG_MASK, REMAIN_FLAGS_BITS, VALUE_MASK};
4
5#[derive(Clone, Copy, Debug, Eq, PartialEq)]
6pub enum SinceType {
7    BlockNumber,
8    EpochNumberWithFraction,
9    Timestamp,
10}
11
12#[derive(Clone, Copy, Debug, Eq, PartialEq)]
13pub struct Since(u64);
14
15impl Since {
16    pub fn new(ty: SinceType, value: u64, is_relative: bool) -> Since {
17        let value = match ty {
18            SinceType::BlockNumber => value,
19            SinceType::EpochNumberWithFraction => 0x2000_0000_0000_0000 | value,
20            SinceType::Timestamp => 0x4000_0000_0000_0000 | value,
21        };
22        if is_relative {
23            Since(LOCK_TYPE_FLAG | value)
24        } else {
25            Since(value)
26        }
27    }
28
29    pub fn new_absolute_epoch(epoch_number: u64) -> Since {
30        let epoch = EpochNumberWithFraction::new(epoch_number, 0, 1);
31        Self::new(
32            SinceType::EpochNumberWithFraction,
33            epoch.full_value(),
34            false,
35        )
36    }
37
38    pub fn from_raw_value(value: u64) -> Since {
39        Since(value)
40    }
41
42    pub fn value(self) -> u64 {
43        self.0
44    }
45
46    pub fn is_absolute(self) -> bool {
47        self.0 & LOCK_TYPE_FLAG == 0
48    }
49
50    pub fn is_relative(self) -> bool {
51        !self.is_absolute()
52    }
53
54    pub fn flags_is_valid(self) -> bool {
55        (self.0 & REMAIN_FLAGS_BITS == 0)
56            && ((self.0 & METRIC_TYPE_FLAG_MASK) != METRIC_TYPE_FLAG_MASK)
57    }
58
59    pub fn extract_metric(self) -> Option<(SinceType, u64)> {
60        let value = self.0 & VALUE_MASK;
61        let ty_opt = match self.0 & METRIC_TYPE_FLAG_MASK {
62            //0b0000_0000
63            0x0000_0000_0000_0000 => Some(SinceType::BlockNumber),
64            //0b0010_0000
65            0x2000_0000_0000_0000 => Some(SinceType::EpochNumberWithFraction),
66            //0b0100_0000
67            0x4000_0000_0000_0000 => Some(SinceType::Timestamp),
68            _ => None,
69        };
70        ty_opt.map(|ty| (ty, value))
71    }
72}