Struct WotService 

pub struct WotService { /* private fields */ }

Indexing-layer service for trusted metadata and local governance records.

Implementations

impl WotService

pub fn new(indexing: &IndexingService, policy: TrustPolicy) -> Self

Create a Web-of-Trust service using an existing indexing service.

pub fn with_database(database: IndexingDatabase, policy: TrustPolicy) -> Self

Create a service backed by an indexing database.

pub fn in_memory(policy: TrustPolicy) -> Result<Self>

Create an isolated in-memory Web-of-Trust service.

Errors

Returns an error if SQLite cannot initialize.

pub const fn database(&self) -> &IndexingDatabase

pub fn policy(&self) -> Result<TrustPolicy>

Return a copy of the current local trust policy.

Errors

Returns an error if policy state is poisoned.

pub fn trust_author(&self, author: &VerifyingKey) -> Result<()>

Add a local trusted root.

Errors

Returns an error if policy state is poisoned.

pub fn add_delegation(&self, delegation: TrustDelegation) -> Result<bool>

Add a signed delegation to the local policy.

Errors

Returns an error if the delegation is invalid or its issuer is not locally trusted.

pub fn add_delegation_at( &self, delegation: TrustDelegation, now: u64, ) -> Result<bool>

Add a signed delegation using an explicit validation time.

Errors

Returns an error if the delegation is invalid or its issuer is not locally trusted.

pub fn revoke_delegation( &self, delegator: &str, delegate: &str, scope: Option<&Hash>, ) -> Result<bool>

Revoke a delegation matching the delegate, scope, and delegator.

Returns true if any delegation was marked revoked.

Errors

Returns an error if the policy lock is poisoned.

pub fn revoke_delegation_at( &self, delegator: &str, delegate: &str, scope: Option<&Hash>, at: u64, ) -> Result<bool>

Revoke a delegation using an explicit revocation time.

Returns true if any delegation was marked revoked.

Errors

Returns an error if the policy lock is poisoned.

pub fn apply_provider_trust(&self, record: ProviderTrustRecord) -> Result<bool>

Apply a signed manual provider trust record from a trusted issuer.

A provider may always publish a signed self-distrust, which allows a compromised or retiring provider to withdraw its own availability.

Errors

Returns an error when the record is invalid or its issuer is untrusted.

pub fn evaluate_provider_trust( &self, provider: PublicKey, hash: Option<&Hash>, now: u64, ) -> Result<ProviderTrustDecision>

Evaluate the newest applicable provider trust records.

Errors

Returns an error when the WoT state lock is poisoned.

pub fn evaluate_provider_trust_for_hash( &self, provider: PublicKey, hash: Hash, now: u64, ) -> Result<ProviderTrustDecision>

Evaluate a provider trust decision for a concrete content hash.

Errors

Returns an error when the WoT state lock is poisoned.

pub fn provider_trust_records( &self, provider: PublicKey, ) -> Result<Vec<ProviderTrustRecord>>

Return all records for a provider, newest first.

Errors

Returns an error when the WoT state lock is poisoned.

pub fn append_metadata(&self, entry: &MetadataEntry) -> Result<bool>

Append metadata after signature and local trust checks.

Errors

Returns an error if the metadata is not signed, trusted, or the content has been self-revoked.

pub fn search_metadata( &self, query: &str, limit: usize, ) -> Result<Vec<MetadataEntry>>

Search trusted metadata while applying local revocation and moderation.

Errors

Returns an error if the query or index is invalid.

pub fn search(&self, query: &str, limit: usize) -> Result<Vec<MetadataEntry>>

Alias for Self::search_metadata.

Errors

Returns an error if the query or index is invalid.

pub fn revoke_self(&self, record: RevocationRecord) -> Result<bool>

Accept a publisher’s self-revocation.

Errors

Returns an error if the signature is invalid or an older sequence was already recorded.

pub fn is_revoked(&self, content: &Hash) -> Result<bool>

Return whether a content hash has a valid self-revocation.

Errors

Returns an error if state is poisoned.

pub fn apply_moderation(&self, record: ModerationRecord) -> Result<bool>

Accept a trusted moderation record.

Errors

Returns an error if the signature is invalid, the moderator is not trusted, or an older sequence was already recorded.

pub fn moderation(&self, content: &Hash) -> Result<Option<ModerationRecord>>

Return the latest moderation record for a content hash.

Errors

Returns an error if state is poisoned.

pub fn moderation_records( &self, content: &Hash, ) -> Result<Vec<ModerationRecord>>

Return all moderation records for a content hash, newest first.

Errors

Returns an error if state is poisoned.

pub fn list_moderation( &self, content: Option<&Hash>, ) -> Result<Vec<ModerationRecord>>

List all moderation records, optionally restricted to one content hash.

Errors

Returns an error if state is poisoned.

pub fn moderation_decision( &self, context: &ModerationContext, ) -> Result<ModerationAction>

Evaluate the latest applicable moderation decision for a context.

More recent decisions win; when sequence numbers tie, the more specific scope wins.

Errors

Returns an error if state is poisoned.

pub fn evaluate_moderation( &self, context: &ModerationContext, ) -> Result<ModerationAction>

Alias for Self::moderation_decision.

Errors

Returns an error if state is poisoned.

pub fn append_attestation(&self, attestation: Attestation) -> Result<bool>

Store an attestation after cryptographic and local trust checks.

Errors

Returns an error if the attestation is invalid or its issuer is not trusted.

pub fn verify_attestation(&self, attestation: &Attestation) -> Result<()>

Verify an attestation’s cryptographic signature without applying local trust policy.

Errors

Returns an error if the attestation is malformed or tampered with.

Trait Implementations

impl Clone for WotService

fn clone(&self) -> WotService

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WotService

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

Formats the value using the given formatter.