pub struct AccountRecordStore { /* private fields */ }Expand description
Read-only account record service over a mount rooted at PDS_NAMESPACE.
Every construction requires an AccountRecordReadAuthorizer. The store
binds the requested canonical name to one fid, MAC-authorizes that exact
name, and only then opens and reads from the same fid.
Implementations§
Source§impl AccountRecordStore
impl AccountRecordStore
Sourcepub fn new(
pds_mount: Arc<dyn Mount>,
read_authorizer: Arc<dyn AccountRecordReadAuthorizer>,
) -> Self
pub fn new( pds_mount: Arc<dyn Mount>, read_authorizer: Arc<dyn AccountRecordReadAuthorizer>, ) -> Self
Construct a store over the mount bound at /pds and a mandatory MAC
read capability.
Sourcepub fn scope(
&self,
context: &EnvelopeContext,
) -> Result<AccountReadScope, AccountReadError>
pub fn scope( &self, context: &EnvelopeContext, ) -> Result<AccountReadScope, AccountReadError>
Capture a tenant-scoped account reader from a verified RPC context.
EnvelopeContext::domain() is the only tenant input. It fails closed
when verified_tenant is missing, empty, or wildcard. This method then
applies path-component validation before the tenant can reach 9P.
Sourcepub async fn resolve_tenant_for_hosted_did(
&self,
authority: &Subject,
did: &str,
) -> Result<Option<String>, AccountReadError>
pub async fn resolve_tenant_for_hosted_did( &self, authority: &Subject, did: &str, ) -> Result<Option<String>, AccountReadError>
Resolve a hosted account DID to its authority-owned tenant binding.
Unlike Self::scope, this lookup starts without a tenant because the
ATProto assertion proves only the DID. It therefore accepts no tenant
argument: the OAuth service identity scans the account-record index and
returns the tenant containing the one canonical record whose DID
matches. Missing records return Ok(None) (federated-only identity);
corrupt, denied, or ambiguous records fail closed.
Sourcepub async fn resolve_current_tenant_for_hosted_did(
&self,
authority: &Subject,
did: &str,
) -> Result<Option<String>, AccountReadError>
pub async fn resolve_current_tenant_for_hosted_did( &self, authority: &Subject, did: &str, ) -> Result<Option<String>, AccountReadError>
Uncached authority read for disabled Federate admission integration. The caller must impose an aggregate deadline and capacity bound. This never publishes or consumes the shared hosted-DID cache. The admitted mount remains responsible for signed-record authority and freshness.
Sourcepub fn schedule_hosted_did_index_refresh(&self, authority: Subject)
pub fn schedule_hosted_did_index_refresh(&self, authority: Subject)
Start a single-flight refresh without making the caller perform tenant
enumeration. A stale snapshot remains available for O(1) lookups while
one background task refreshes it; the refresh lock prevents duplicate
scans. Before the first snapshot, lookups return
AccountReadError::HostedDidIndexNotReady while this task warms it.
Sourcepub async fn hosted_did_index_ready(&self) -> bool
pub async fn hosted_did_index_ready(&self) -> bool
Check an already-published snapshot without starting filesystem work. In-process consumers must warm their injected store before startup.
pub async fn refresh_hosted_did_index( &self, authority: &Subject, ) -> Result<(), AccountReadError>
Sourcepub async fn refresh_hosted_did_index_after_publish(
&self,
authority: &Subject,
) -> Result<(), AccountReadError>
pub async fn refresh_hosted_did_index_after_publish( &self, authority: &Subject, ) -> Result<(), AccountReadError>
Force a new hosted-DID snapshot after an authority-owned account publication. Unlike the periodic/startup refresh above, this does not honor the negative-entry TTL: callers use it only after the durable account-record publication has completed and before issuing credentials that depend on the new binding.
Sourcepub async fn sign_for_hosted_did(
&self,
authority: &Subject,
did: &str,
signing_input: &[u8],
) -> Result<Option<Vec<u8>>, AccountReadError>
pub async fn sign_for_hosted_did( &self, authority: &Subject, did: &str, signing_input: &[u8], ) -> Result<Option<Vec<u8>>, AccountReadError>
Sign bytes with the account-specific #atproto key for one hosted DID.
This is deliberately an authority-only operation: the caller supplies neither a tenant nor a label. The store resolves the tenant from the immutable account index, reloads the exact public account record, and verifies the secret key against that record before signing. Missing, corrupt, substituted, or ambiguous state fails closed and the secret key never leaves this service boundary.
Sourcepub async fn verifying_key_for_hosted_did(
&self,
authority: &Subject,
did: &str,
) -> Result<Option<VerifyingKey>, AccountReadError>
pub async fn verifying_key_for_hosted_did( &self, authority: &Subject, did: &str, ) -> Result<Option<VerifyingKey>, AccountReadError>
Read the public #atproto verification key for one authority-owned
hosted DID without exposing its private signing material. The same
bounded index, exact account-record checks, and fixed OAuth authority
used by Self::sign_for_hosted_did are applied.
Sourcepub async fn hosted_repo_genesis_for_hosted_did(
&self,
authority: &Subject,
did: &str,
) -> Result<Option<(Vec<u8>, Vec<u8>)>, AccountReadError>
pub async fn hosted_repo_genesis_for_hosted_did( &self, authority: &Subject, did: &str, ) -> Result<Option<(Vec<u8>, Vec<u8>)>, AccountReadError>
Resolve an owned account’s public genesis, including legacy conversion.
Sourcepub async fn hosted_repo_genesis_with_cached_public(
&self,
authority: &Subject,
did: &str,
cached_public: Option<&[u8]>,
) -> Result<Option<(Vec<u8>, Vec<u8>)>, AccountReadError>
pub async fn hosted_repo_genesis_with_cached_public( &self, authority: &Subject, did: &str, cached_public: Option<&[u8]>, ) -> Result<Option<(Vec<u8>, Vec<u8>)>, AccountReadError>
Read the verified native/public empty genesis pair for an owned DID. Older accounts may have only the native artifact. In that case reuse a caller’s durable public genesis after verification, or convert through account signing custody. Neither a corrupt artifact nor a progressed native commit is eligible for conversion. Private keys never escape.
Trait Implementations§
Source§impl Clone for AccountRecordStore
impl Clone for AccountRecordStore
Source§fn clone(&self) -> AccountRecordStore
fn clone(&self) -> AccountRecordStore
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreAuto Trait Implementations§
impl Freeze for AccountRecordStore
impl !RefUnwindSafe for AccountRecordStore
impl Send for AccountRecordStore
impl Sync for AccountRecordStore
impl Unpin for AccountRecordStore
impl UnsafeUnpin for AccountRecordStore
impl !UnwindSafe for AccountRecordStore
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more