Skip to main content Module surb_store Copy item path Source AdmittedRing π An admitted ring together with the number naming the admission that installed it. EvictionCounts π Evictions from one cache in one report interval, by cause. EvictionReport π The counts of one closed report interval, ready to be logged. EvictionStats π Eviction counts per cache and cause, reported once per interval (GNO-793: per-entry lines flooded the log). GenerationalBuffer π The mutex-protected state of a SurbRingBuffer : the SURBs, in their two tiers, and the highest
generation seen. IntervalState π The interval being counted right now. MemorySurbStore Basic SurbStore implementation based on an in-memory cache. PoppedSurb Represents a single SURB along with its ID popped from the SurbRingBuffer . SurbRingBuffer Ring buffer of SURBs and their IDs, all belonging to one pseudonym and therefore identified only
by [HoprSurbId]. SurbStoreConfig Configuration for the SURB cache. EvictedCache π Which of the storeβs caches shed an entry. Doubles as the cache label on metrics and log lines. MadeRoom π What GenerationalBuffer::make_room_for did to a full buffer. SurbPopOrder Which end of the per-pseudonym buffer a pop consumes from. Replying side only. DEFAULT_PENDING_SURB_MAX_BYTES Default byte budget for each of the two Entry-side SURB maps. MAXIMUM_PENDING_SURB_MAX_BYTES Ceiling on SurbStoreConfig::pending_surb_max_bytes : 4 GiB per map. MINIMUM_EVICTION_REPORT_INTERVAL Lower bound on SurbStoreConfig::eviction_report_interval , enforced by the config validator. MINIMUM_OPENERS_PER_PSEUDONYM π MINIMUM_OPENER_LIFETIME π MINIMUM_OPENER_PSEUDONYMS π MINIMUM_PENDING_SURB_MAX_BYTES Floor on the byte budget of each Entry-side SURB map: 85 MB, about what the fixed 100 000-record
cap of the pending map used, measured at roughly 840 B per record in the cache it was built on
(hoprnet#8624). MINIMUM_QUARANTINE_PSEUDONYMS π Lower bound on SurbStoreConfig::quarantine_max_pseudonyms , enforced by the config validator. MINIMUM_QUARANTINE_RB_CAPACITY π Lower bound on SurbStoreConfig::quarantine_rb_capacity , enforced by the config validator. MINIMUM_SURB_LIFETIME Lower bound on SurbStoreConfig::pseudonyms_lifetime , enforced by the config validator. MIN_SURB_RB_CAPACITY π ADMISSION_EPOCHS π Mints the number naming each admission of a pseudonym, process-wide. SurbShareInfo Which SSA the PIX share sealed in a SURB belongs to. default_admitted_headroom_percent π default_admitted_max_pseudonyms π default_distress_threshold π default_eviction_report_interval π default_eviction_report_threshold π default_max_openers_per_pseudonym π default_max_pseudonyms π default_pending_surb_max_bytes π default_pseudonyms_lifetime π default_quarantine_lifetime π default_quarantine_max_pseudonyms π default_quarantine_rb_capacity π default_quarantine_surb_budget π default_rb_capacity π default_reply_opener_lifetime π generation_is_newer π RFC-1982 serial-number comparison over a u8 generation: is a strictly newer than b? next_admission_epoch π Takes the next admission number. Never zero β see ADMISSION_EPOCHS . refund_quarantine_budget π Subtracts n from the quarantine SURB budget, clamping at zero instead of wrapping. validate_eviction_report_interval π validate_pseudonyms_lifetime π validate_quarantine_lifetime π validate_reply_opener_lifetime π