pub struct PdsRecordStore { /* private fields */ }Expand description
Durable, RocksDB-backed PDS record store keyed by repo DID.
This is the per-account record store the DiscoveryService resolves against,
and that the registry service’s register/commit paths publish into (#910a).
Persistence follows the same pattern as RocksDbUserStore
(auth/rocksdb_store.rs): a single rocksdb::DB at a well-known directory,
opened read-write by the one process that publishes, and read-only by
resolvers.
The store holds no signing key. The writer (PdsPublisher) signs the
commit once and hands this store the signed bytes; the resolver only ever
reads them back. This is the security fix at the heart of #910a: a read path
that needed a private key to re-sign a commit on every getRecord was the
root of the key-exposure problem — atproto never re-signs on read.
RocksDB allows exactly one read-write handle per directory; on a single
node the registry service (the publisher) is the sole writer, and the
discovery service (the resolver) opens the same directory read-only —
mirroring RocksDbUserStore::open / open_readonly. A read-only handle
snapshots the manifest at open time, so PdsRecordStore::open_readonly
callers that need a live view reopen per read (see [RecordBacking::ReadOnly]).
Implementations§
Source§impl PdsRecordStore
impl PdsRecordStore
Sourcepub fn open(path: &Path) -> AnyResult<Self>
pub fn open(path: &Path) -> AnyResult<Self>
Open (or create) the durable store at path for read-write access.
Exactly one process should hold this — the publisher (registry
service). See the type-level docs for the single-writer rationale.
Sourcepub fn open_readonly(path: &Path) -> AnyResult<Self>
pub fn open_readonly(path: &Path) -> AnyResult<Self>
Open the store read-only at path, for resolvers that never write
(the discovery service). Verifies the directory opens successfully now
(surfacing a missing/corrupt store at startup) but does not hold the
handle — see the type-level docs. The resolver holds no signing key.
Sourcepub fn accepted_at9p_state(
&self,
did: &str,
now: Option<&str>,
) -> AnyResult<Option<AcceptedAt9pState>>
pub fn accepted_at9p_state( &self, did: &str, now: Option<&str>, ) -> AnyResult<Option<AcceptedAt9pState>>
Typed accepted-current state read path for resolver/admission consumers.
Read-only store instances reopen RocksDB for a live view, just like PDS
record resolution. now enforces update expiry when supplied.
Sourcepub fn accepted_at9p_states(&self) -> AnyResult<Vec<AcceptedAt9pState>>
pub fn accepted_at9p_states(&self) -> AnyResult<Vec<AcceptedAt9pState>>
Enumerate every checkpoint-verified accepted state. This is the production startup boundary used to build native announcements; a missing checkpoint half or any verification failure aborts the read.
Sourcepub fn first_boot_pending(&self) -> AnyResult<bool>
pub fn first_boot_pending(&self) -> AnyResult<bool>
Check whether the first-boot provisioning marker (FIRST_BOOT_KEY) is
present in the store. The marker is written by init-deployment-store
and deleted atomically with the first accepted-state commit. Its
presence alongside an empty store is the ONLY lifecycle evidence that
distinguishes genuine first boot from data loss.
Sourcepub fn mark_first_boot(&self) -> AnyResult<()>
pub fn mark_first_boot(&self) -> AnyResult<()>
Write the first-boot provisioning marker. Only valid on a read-write store that has just been freshly created. Propagates the write error so initialization cannot appear successful without the marker.
Sourcepub fn tid_for_repo(repo_id: &str) -> Tid
pub fn tid_for_repo(repo_id: &str) -> Tid
The stable record-key TID for repo_id, derived deterministically
from the repo id (#910a M1).
The rkey must be a pure function of repo_id: two distinct repos must
never alias onto one (collection, tid) key (which would silently and
permanently clobber one repo’s record with the other’s), and the same
repo must always resolve to the same key so a re-publish is a pointer
advance, not a new record. A wall-clock Tid::now() fails both (same
microsecond → identical TID; and it needs a persisted mint with a
get-then-put race). Instead derive the TID’s 53-bit micros field and
10-bit clock id from SHA-256(repo_id) — a hash, not a timestamp:
these records are not time-ordered, so 63 bits of collision resistance
is exactly what we want, with no mint, no persistence, and no race.
Auto Trait Implementations§
impl !Freeze for PdsRecordStore
impl !RefUnwindSafe for PdsRecordStore
impl Send for PdsRecordStore
impl Sync for PdsRecordStore
impl Unpin for PdsRecordStore
impl UnsafeUnpin for PdsRecordStore
impl UnwindSafe for PdsRecordStore
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
§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 moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request