Struct Fabric 

pub struct Fabric { /* private fields */ }

Implementations

impl Fabric

pub fn new() -> Self

Create a new client with the default seeds.

pub fn with_seeds(seeds: &[&str]) -> Self

Create a new client with custom seed URLs.

pub fn with_dev_mode(self) -> Self

pub fn save_state(&self) -> FabricState

Export the current state for persistence.

pub fn from_state(state: FabricState) -> Result<Self>

Create a Fabric instance from previously saved state. Rebuilds trust sets and Veritas from the persisted anchors.

pub fn badge(&self, zone: &Zone) -> Badge

pub async fn trust(&self, trust_id: TrustId) -> Result<()>

Pin a specific trust id to be loaded from peers.

pub async fn observe(&self) -> Result<()>

Update observed trust id from peers

pub async fn semi_trust(&self, trust_id: TrustId) -> Result<()>

Set a semi-trusted anchor from an external source (e.g. public explorer).

pub fn trusted(&self) -> Option<TrustId>

The trusted trust id, pinned explicitly with trust()

pub fn observed(&self) -> Option<TrustId>

The latest trust id observed from peers, if any.

pub fn semi_trusted(&self) -> Option<TrustId>

The semi-trusted trust id, if any.

pub fn trust_from_set(&self, set: &AnchorSet) -> Result<TrustId>

Pin trust directly from an AnchorSet. No network requests. Returns the computed TrustId.

pub async fn trust_from_qr(&self, payload: &str) -> Result<()>

Parse a veritas://scan?id=... QR payload and pin as trusted.

pub async fn semi_trust_from_qr(&self, payload: &str) -> Result<()>

Parse a veritas://scan?id=... QR payload and pin as semi-trusted.

pub fn clear_trusted(&self)

Clear the trusted state. Badge will never return Orange until trust is pinned again.

pub fn clear_semi_trusted(&self)

Clear the semi trusted state.

pub fn set_prefer_latest(&self, latest: bool)

Set whether to query multiple relays for freshness hints before resolving.

pub async fn bootstrap(&self) -> Result<()>

Bootstrap the client: discover peers from seeds and fetch anchors.

pub async fn resolve(&self, handle: &str) -> Result<Option<Zone>>

Resolve a single handle and return its verified Zone. Returns None if the handle doesn’t exist. Supports dotted names like hello.alice@bitcoin.

pub async fn resolve_by_id(&self, num_id: &str) -> Result<Option<Zone>>

Reverse-resolve by a num id to retrieve its human-readable name.

Queries relays for the reverse mapping, resolves the forward name, and verifies the zone’s num_id matches.

pub async fn search_addr(&self, name: &str, addr: &str) -> Result<Vec<Zone>>

Search for handles by address record.

Queries relays for handles claiming the address, resolves them forward, and filters to zones that actually contain the matching addr record.

pub async fn resolve_all(&self, handles: &[&str]) -> Result<Vec<Zone>>

Resolve multiple handles, including nested names like hello.alice@bitcoin.

pub async fn export(&self, handle: &str) -> Result<Vec<u8>>

Export a certificate chain for a handle in .spacecert format.

pub async fn prove(&self, request: &ChainProofRequest) -> Result<Vec<u8>>

Request a chain proof from a relay. Sends a ChainProofRequest and returns the borsh-encoded ChainProof bytes.

pub async fn broadcast(&self, msg_bytes: &[u8]) -> Result<()>

Broadcast a message to up to 4 random relays for gossip propagation. Returns Ok if at least one relay accepted.

pub async fn peers(&self) -> Result<Vec<PeerInfo>>

Fetch the peer list from a random relay.

pub async fn refresh_peers(&self) -> Result<()>

Re-fetch peers from all known relays and update the relay pool.

pub fn relays(&self) -> Vec<String>

Get the current list of known relay URLs.

pub fn veritas(&self) -> Veritas

Returns a clone of the internal Veritas instance for offline verification.

Trait Implementations

impl Default for Fabric

fn default() -> Self

Returns the “default value” for a type.