Struct TreeState 

pub struct TreeState {
    pub parked: ParkedKeys,
    pub replay: Replay,
    pub jwks: JwksCache,
    top_edges: Mutex<HashMap<String, (bool, Instant)>>,
    name_read_failed: Mutex<Option<Instant>>,
    pub client: Client,
    pub issuers: Vec<String>,
    pub freshness: Duration,
    pub loopback_fetches: bool,
    pub reserved_labels: Vec<String>,
}

What the tree’s routes hold between requests.

Fields

parked: ParkedKeys

Keys waiting for the operator; see ParkedKeys.

replay: Replay

Proofs already presented; see Replay.

jwks: JwksCache

Issuers’ key sets; see JwksCache.

top_edges: Mutex<HashMap<String, (bool, Instant)>>

The operator’s record for each root creator, as last re-read, and when; see TOP_EDGE_TTL.

name_read_failed: Mutex<Option<Instant>>

When a read of the operator’s record for a requested name last failed; see refuse_operators_name.

client: Client

Reaches the operator’s PDS and a DID directory.

issuers: Vec<String>

The issuers whose tokens are accepted, as iss spells them. Empty admits any issuer at a public HTTPS address.

freshness: Duration

How old a token’s iat may be; see DEFAULT_OIDC_FRESHNESS.

loopback_fetches: bool

Whether this deployment may fetch from its own network: a development stack’s posture, and a test’s. It covers an issuer on this host over plain HTTP, and an operator whose repository answers at a loopback address. Every deployment on the public internet leaves it off, and didbot_http::REFUSED_BLOCKS then applies to every URL a fetched document names.

reserved_labels: Vec<String>

Labels no account may take directly under a zone; see RESERVED_LABELS.

Implementations

impl TreeState

pub fn new(park_ttl: Duration) -> Self

Parks for park_ttl, with a fresh HTTP client and the defaults for everything else.

pub fn with_spent_store(self, store: SpentStore) -> Result<Self, SideStoreError>

Keeps the proof window in store, holding what it already had.

Errors

The kept file is there and cannot be read. It stops the boot: see didbot_pds::side_store.

pub fn with_reserved_labels(self, labels: Vec<String>) -> Self

Reserves labels directly under every zone instead of RESERVED_LABELS.

pub fn with_loopback_fetches(self, allowed: bool) -> Self

Accepts issuers on this host over plain HTTP.

pub(crate) fn private_addresses(&self) -> PrivateAddresses

loopback_fetches as the guard reads it.

pub fn with_issuers(self, issuers: Vec<String>) -> Self

Accepts only issuers; empty admits any public HTTPS issuer.

pub fn with_freshness(self, freshness: Duration) -> Self

Refuses a token whose iat is older than freshness.

fn top_edge(&self, did: &str) -> Option<bool>

Whether the operator’s record for did stood when last re-read inside TOP_EDGE_TTL, or None when it is time to read again.

fn remember_top_edge(&self, did: &str, stands: bool)

fn name_read_failed_lately(&self) -> bool

Whether a read of the operator’s record for a name failed inside TOP_EDGE_TTL.

fn remember_name_read_failed(&self)

Trait Implementations

impl Default for TreeState

fn default() -> Self

Returns the “default value” for a type.