Struct Blocklist 

pub struct Blocklist { /* private fields */ }

File-backed per-peer block-list. Maps a DID → entry. Absence = not blocked.

Implementations

impl Blocklist

pub fn load() -> Self

Load from config/wire/blocklist.json. Missing → empty. Malformed → empty + a warning (fail-safe: never wedge, never silently lose a real block without saying so).

pub fn load_path(path: &Path) -> Self

Load from an explicit path (testable).

pub fn block(&mut self, did: &str, note: Option<String>) -> bool

Block a DID (idempotent: re-blocking refreshes the note, keeps at). Returns true if this is a newly-added block, false if already present.

pub fn unblock(&mut self, did: &str) -> bool

Remove a DID from the block-list. Returns true if it was present.

pub fn is_blocked(&self, did: &str) -> bool

Is this exact DID blocked?

pub fn blocks_card<'c>(&self, card: &'c AgentCard) -> Option<&'c str>

Does this card belong to a blocked peer? Checks both the session DID and the operator DID (op_did) the card carries, so blocking an operator cuts off all of their sessions. Returns the matched DID for diagnostics.

pub fn entries(&self) -> impl Iterator<Item = (&String, &BlockEntry)>

Iterate entries (sorted by DID via the BTreeMap), for wire blocked.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn save(&self) -> Result<()>

Persist to config/wire/blocklist.json.

pub fn save_path(&self, path: &Path) -> Result<()>

Persist to an explicit path (testable).

Trait Implementations

impl Clone for Blocklist

fn clone(&self) -> Blocklist

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Blocklist

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Blocklist

fn default() -> Blocklist

Returns the “default value” for a type.