Skip to main content

qualia_core_db/p2p/connectivity/
nat64.rs

1//! NAT64 / PREF64 discovery contract. Do not assume 64:ff9b::/96.
2
3#![cfg(not(target_arch = "wasm32"))]
4
5use std::net::Ipv6Addr;
6
7/// Well-known WKP (RFC 6052). Last-resort only after an operator declares it.
8pub const WELL_KNOWN_PREF64: Ipv6Addr = Ipv6Addr::new(0x64, 0xff9b, 0, 0, 0, 0, 0, 0);
9
10#[derive(Debug, Clone, Copy, PartialEq, Eq)]
11pub enum Pref64 {
12    Discovered(Ipv6Addr),
13    /// Operator set `QDNF_PREF64=64:ff9b::/96`. Never the silent default.
14    WellKnownOnlyIfOperatorDeclared,
15    Unavailable,
16}
17
18/// Discover PREF64. Unset env is unavailable — not the well-known prefix.
19pub fn discover_pref64() -> Pref64 {
20    match std::env::var("QDNF_PREF64") {
21        Ok(raw) => {
22            let t = raw.trim();
23            if t == "64:ff9b::/96" || t == "64:ff9b::" {
24                return Pref64::WellKnownOnlyIfOperatorDeclared;
25            }
26            match t.parse::<Ipv6Addr>() {
27                Ok(addr) => Pref64::Discovered(addr),
28                Err(_) => Pref64::Unavailable,
29            }
30        }
31        Err(_) => Pref64::Unavailable,
32    }
33}
34
35/// `?::numeric_ipv4_hint_insufficient_on_v6only`.
36pub const fn numeric_ipv4_hint_insufficient_on_v6only() -> bool {
37    true
38}
39
40#[cfg(test)]
41mod tests {
42    use super::*;
43
44    #[test]
45    fn unset_env_does_not_assume_well_known() {
46        // This test process may inherit QDNF_PREF64; the contract is: never
47        // invent Discovered(WELL_KNOWN) without an env/OS source.
48        match discover_pref64() {
49            Pref64::Discovered(addr) => assert_ne!(
50                std::env::var("QDNF_PREF64").ok().as_deref(),
51                None,
52                "discovered {addr} without QDNF_PREF64"
53            ),
54            Pref64::WellKnownOnlyIfOperatorDeclared => {
55                let raw = std::env::var("QDNF_PREF64").unwrap();
56                assert!(raw.contains("64:ff9b"));
57            }
58            Pref64::Unavailable => {}
59        }
60        assert!(numeric_ipv4_hint_insufficient_on_v6only());
61        assert_eq!(WELL_KNOWN_PREF64.segments()[0], 0x64);
62    }
63}