Skip to main content

PdsRecordStore

Struct PdsRecordStore 

Source
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

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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§

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
§

impl<T> Any for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

§

fn type_name(&self) -> &'static str

§

impl<T> AnySync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ

§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

§

const WITNESS: W = W::MAKE

A constant of the type witness
§

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

§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
§

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

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
§

impl<T> JaggedSlice<T> for T

§

type Index = Index2

§

fn push_into(self, array: &mut Jagged<T>)

§

fn insert_into(self, index: <T as JaggedSlice<T>>::Index, array: &mut Jagged<T>)

§

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, 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> SendSyncUnwindSafe for T
where T: Send + Sync + UnwindSafe + ?Sized,