Struct NodeRegistry 

pub struct NodeRegistry { /* private fields */ }

In-memory node-id → public-key map.

Cheap to clone — the inner map is wrapped in Arc/DashMap.

Also holds the DerivedWriteGrant table — the mesh-canonical write-permissions seam. Both tables share the registry’s clone semantics so a service handed a NodeRegistry clone sees grant updates the daemon issues mid-boot.

Implementations

impl NodeRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn register( &self, pubkey: [u8; 32], label: Option<String>, ) -> RegisteredNode

Register a node. The node-id is derived deterministically from the pubkey — re-registering the same key updates the label but keeps the id stable. Returns the (possibly-updated) entry.

pub fn get(&self, node_id: &str) -> Option<RegisteredNode>

Look up a node by its id.

pub fn contains(&self, node_id: &str) -> bool

Whether node_id is known.

pub fn len(&self) -> usize

Number of registered nodes.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

pub fn list(&self) -> Vec<RegisteredNode>

List all registered nodes.

pub fn issue_derived_grant( &self, grantee_node_id: impl Into<String>, topic: impl Into<String>, scope: GrantScope, ) -> Result<DerivedWriteGrant, DerivedGrantError>

Issue a DerivedWriteGrant permitting grantee_node_id to publish under the mesh-canonical topic.

MVP authority model. Per R3.6 the daemon issues to itself in-process; there’s no signature check at this seam. Future federated grants will add an “issuer signature” arm that clawft-weave’s RPC boundary will check before this call. Today, callers are trusted because they had to be inside the daemon process to reach the registry.

Idempotent: re-issuing a (grantee, topic) pair overwrites issued_at_ms and scope. Returns the freshly-stored grant.

pub fn has_derived_grant(&self, grantee_node_id: &str, path: &str) -> bool

Whether grantee_node_id holds a grant covering path.

path must look like substrate/_derived/<topic>/... (or substrate/_derived/<topic> for GrantScope::ExactTopic). Anything else returns false. The check is the second half of the mesh-canonical write gate — the first half is the substrate/_derived/ tier detection that lives on crate::SubstrateService::publish_gated_with_grants.

pub fn list_derived_grants(&self) -> Vec<DerivedWriteGrant>

Snapshot of all currently-issued grants. Test helper / future admin-RPC seam; not intended for hot-path use.

Trait Implementations

impl Clone for NodeRegistry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeRegistry

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

Formats the value using the given formatter.

impl Default for NodeRegistry

fn default() -> Self

Returns the “default value” for a type.