atlas_native_token/
lib.rs

1//! Definitions for the native ATLAS token and its fractional lamports.
2
3#![allow(clippy::arithmetic_side_effects)]
4
5/// There are 10^9 lamports in one ATLAS
6pub const LAMPORTS_PER_ATLAS: u64 = 1_000_000_000;
7const ATLAS_DECIMALS: usize = 9;
8
9/// Convert native tokens (ATLAS) into fractional native tokens (lamports)
10pub fn atlas_str_to_lamports(atlas_str: &str) -> Option<u64> {
11    if atlas_str == "." {
12        None
13    } else {
14        let (atlas, lamports) = atlas_str.split_once('.').unwrap_or((atlas_str, ""));
15        let atlas = if atlas.is_empty() {
16            0
17        } else {
18            atlas.parse::<u64>().ok()?
19        };
20        let lamports = if lamports.is_empty() {
21            0
22        } else {
23            format!("{lamports:0<9}")[..ATLAS_DECIMALS].parse().ok()?
24        };
25        LAMPORTS_PER_ATLAS
26            .checked_mul(atlas)
27            .and_then(|x| x.checked_add(lamports))
28    }
29}
30
31use std::fmt::{Debug, Display, Formatter, Result};
32pub struct Atlas(pub u64);
33
34impl Atlas {
35    fn write_in_atlas(&self, f: &mut Formatter) -> Result {
36        write!(
37            f,
38            "◎{}.{:09}",
39            self.0 / LAMPORTS_PER_ATLAS,
40            self.0 % LAMPORTS_PER_ATLAS
41        )
42    }
43}
44
45impl Display for Atlas {
46    fn fmt(&self, f: &mut Formatter) -> Result {
47        self.write_in_atlas(f)
48    }
49}
50
51impl Debug for Atlas {
52    fn fmt(&self, f: &mut Formatter) -> Result {
53        self.write_in_atlas(f)
54    }
55}
56
57#[cfg(test)]
58mod tests {
59    use super::*;
60
61    #[test]
62    fn test_atlas_str_to_lamports() {
63        assert_eq!(0, atlas_str_to_lamports("0.0").unwrap());
64        assert_eq!(1, atlas_str_to_lamports("0.000000001").unwrap());
65        assert_eq!(10, atlas_str_to_lamports("0.00000001").unwrap());
66        assert_eq!(100, atlas_str_to_lamports("0.0000001").unwrap());
67        assert_eq!(1000, atlas_str_to_lamports("0.000001").unwrap());
68        assert_eq!(10000, atlas_str_to_lamports("0.00001").unwrap());
69        assert_eq!(100000, atlas_str_to_lamports("0.0001").unwrap());
70        assert_eq!(1000000, atlas_str_to_lamports("0.001").unwrap());
71        assert_eq!(10000000, atlas_str_to_lamports("0.01").unwrap());
72        assert_eq!(100000000, atlas_str_to_lamports("0.1").unwrap());
73        assert_eq!(1000000000, atlas_str_to_lamports("1").unwrap());
74        assert_eq!(4_100_000_000, atlas_str_to_lamports("4.1").unwrap());
75        assert_eq!(8_200_000_000, atlas_str_to_lamports("8.2").unwrap());
76        assert_eq!(8_502_282_880, atlas_str_to_lamports("8.50228288").unwrap());
77
78        assert_eq!(
79            u64::MAX,
80            atlas_str_to_lamports("18446744073.709551615").unwrap()
81        );
82        // bigger than u64::MAX, error
83        assert_eq!(None, atlas_str_to_lamports("18446744073.709551616"));
84        // Negative, error
85        assert_eq!(None, atlas_str_to_lamports("-0.000000001"));
86        // i64::MIN as string, error
87        assert_eq!(None, atlas_str_to_lamports("-9223372036.854775808"));
88    }
89}
atlas_native_token/lib.rs

atlas_native_token/
lib.rs
