prns-runtime 0.3.4

Runtime-neutral Personal Reticulum node contracts and manifold kernel
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

use crate::engine::InstantMillis;

#[allow(async_fn_in_trait)]
pub trait Host {
    fn now(&self) -> InstantMillis;
    async fn sleep_until(&self, deadline: InstantMillis);
    fn fill_entropy(&mut self, bytes: &mut [u8]);
}

pub mod airtime;
pub mod announce_pacer;
pub mod duty_gate;
pub mod grant;
pub mod interface_seam;
pub mod kernel;
pub mod reconnect;
pub mod throughput;
pub mod timers;

pub(crate) mod window_ring;

/// The app's synchronous judgment seams, consulted inline on the manifold: RNS 1.4.2 `PROVE_APP` and `ACCEPT_APP`.
pub struct AppDeciders<P, A>
where
    P: FnMut(&prns_core::routing::proof::ProofRequest) -> bool,
    A: FnMut(&prns_core::routing::links::resources::ResourceOffer) -> bool,
{
    pub should_prove: P,
    pub should_accept_resource: A,
}

/// Every offer declined, every proof withheld: the posture of a manifold whose host installed no deciders.
#[must_use]
pub fn decline_all() -> AppDeciders<
    impl FnMut(&prns_core::routing::proof::ProofRequest) -> bool,
    impl FnMut(&prns_core::routing::links::resources::ResourceOffer) -> bool,
> {
    AppDeciders {
        should_prove: |_| false,
        should_accept_resource: |_| false,
    }
}