Skip to main content

AccountRecordStore

Struct AccountRecordStore 

Source
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

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

pub async fn refresh_hosted_did_index( &self, authority: &Subject, ) -> Result<(), AccountReadError>

Source

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.

Source

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.

Source

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.

Source

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.

Source

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

Source§

fn clone(&self) -> AccountRecordStore

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FromRef<T> for T
where T: Clone,

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts 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
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> TerminalState for T
where T: Clone + Send + Sync,