ic-query 0.102.0

Internet Computer query library for CloudEngine, NNS, SNS, ICRC, system canisters, and public network metadata
Documentation
//! Dashboard numeric admission for reward evidence.

use serde::{Deserialize, Deserializer, de::Error};
use serde_json::Number;

const MAX_EXACT_JSON_FLOAT_INTEGER: u64 = (1_u64 << 53) - 1;

pub(super) fn optional_integer<'de, D: Deserializer<'de>>(
    decoder: D,
) -> Result<Option<u64>, D::Error> {
    Option::<Number>::deserialize(decoder)?
        .map(|number| number_to_u64("reward integer", number).map_err(D::Error::custom))
        .transpose()
}

#[expect(
    clippy::needless_pass_by_value,
    reason = "Consumes a decoded numeric observation."
)]
pub(in crate::ic) fn number_to_u64(field: &str, value: Number) -> Result<u64, String> {
    if let Some(value) = value.as_u64() {
        return Ok(value);
    }
    let raw = value.to_string();
    let invalid = || format!("{field} is not an unsigned integer: {raw}");
    let (integer, fraction) = raw.split_once('.').ok_or_else(invalid)?;
    if integer.is_empty()
        || !integer.bytes().all(|byte| byte.is_ascii_digit())
        || fraction.is_empty()
        || !fraction.bytes().all(|byte| byte == b'0')
    {
        return Err(invalid());
    }
    let parsed = integer
        .parse::<u64>()
        .map_err(|_| format!("{field} is outside the u64 range: {raw}"))?;
    if parsed > MAX_EXACT_JSON_FLOAT_INTEGER {
        return Err(format!(
            "{field} uses a decimal JSON number above the exact-integer range: {raw}"
        ));
    }
    Ok(parsed)
}