Skip to main content

Commit

Struct Commit 

Source
pub struct Commit {
    pub did: String,
    pub version: u64,
    pub data: Cid,
    pub rev: Tid,
    pub prev: Option<Cid>,
    pub sig: Vec<u8>,
    /* private fields */
}
Expand description

A signed commit — the unsigned commit plus its ES256 sig.

Fields§

§did: String§version: u64§data: Cid§rev: Tid§prev: Option<Cid>§sig: Vec<u8>

Implementations§

Source§

impl Commit

Source

pub fn sign(unsigned: &UnsignedCommit, key: &SigningKey) -> Self

Sign an unsigned commit with a P-256 (#atproto) signing key, producing a Commit.

The signature is ES256: ECDSA over SHA-256 of the unsigned commit’s DAG-CBOR bytes. The signature is the fixed-width (64-byte) R‖V‖S encoding — Signature::to_vec in p256 0.13 gives this form, which is the JOSE/COSE/atproto-preferred raw concatenation (not DER).

Source

pub fn sign_atproto(unsigned: &UnsignedCommit, key: &SigningKey) -> Result<Self>

Sign a commit using public AT Protocol canonical bytes.

Source

pub fn from_atproto_signature( unsigned: &UnsignedCommit, signature: Vec<u8>, verifying_key: &VerifyingKey, ) -> Result<Self>

Build a public commit from a signature produced by an external signer.

The signer receives the exact canonical unsigned bytes and the supplied verifying key is checked before the commit is marked as eligible for public publication. This keeps private key material outside the repo storage boundary while retaining the same signature and provenance checks as Self::sign_atproto.

Source

pub fn to_dag_cbor(&self) -> Vec<u8> ⓘ

DAG-CBOR encode the (signed) commit. The sig field is a byte string.

Source

pub fn to_atproto_dag_cbor(&self) -> Result<Vec<u8>>

Encode the signed commit using public AT Protocol canonical bytes.

Source

pub fn to_value(&self) -> DagCbor

Source

pub fn repo_authority(&self) -> Result<RepoAuthority>

Classify this commit’s account DID as an accepted repo authority for our PDS (did:web/did:plc/did:at9p), or Err if the method is not one we host a repo for.

This is the method-level acceptance gate (#908); it is independent of and additional to the signature check in Commit::verify. A caller ingesting a commit should accept the authority and verify the signature.

Source

pub fn unsigned(&self) -> UnsignedCommit

The UnsignedCommit form of this commit (drops sig).

Source

pub fn from_dag_cbor(bytes: &[u8]) -> Result<Self>

Decode a signed commit from DAG-CBOR bytes, validating structure.

Source

pub fn from_atproto_dag_cbor(bytes: &[u8]) -> Result<Self>

Source

pub fn from_value(value: &DagCbor) -> Result<Self>

Source

pub fn verify_atproto_and_mark(self, vk: &VerifyingKey) -> Result<Self>

Verify a decoded public commit with the account’s published #atproto key and mark the value eligible for public CAR publication.

Canonical decoding alone is not signature provenance: a native commit can be re-encoded into the public shape, and its bytes remain perfectly canonical. This explicit key-bound verification is therefore required before a decoded value crosses the public publication boundary.

Source

pub fn cid(&self) -> Cid

The CID of this (signed) commit block.

Source

pub fn cid_atproto(&self) -> Result<Cid>

Source

pub fn verify(&self, vk: &VerifyingKey) -> Result<()>

Verify the commit’s signature against a #atproto P-256 verifying key.

Re-encodes the unsigned commit, hashes with SHA-256, and verifies the ES256 signature. Returns Ok(()) on success.

This is the core of the D5 untrusted-host posture: a host can serve any commit it likes, but only commits signed by the account’s #atproto key are accepted by verifiers.

For a rotated key set, use Commit::verify_against_published_keys. That path accepts only the active key and bounded, currently-live #atproto_drain / #atproto_lead keys published in the DID document.

Source

pub fn verify_atproto(&self, vk: &VerifyingKey) -> Result<()>

Source

pub fn verify_against_published_keys( &self, keys: &PublishedAtprotoKeys, now: i64, ) -> Result<()>

Verify against the bounded #atproto slot set currently published by a DID document. This is an overlap-availability mechanism: it accepts a pre-rotation commit under the bounded drain key, but does not establish that a key was valid at the commit’s causal position (that is #1169).

Source

pub fn unsigned_digest(unsigned: &UnsignedCommit) -> [u8; 32]

Compute the SHA-256 digest of the unsigned commit’s DAG-CBOR bytes.

Exposed for callers that compose their own signing/verification flow (e.g. using the DID’s key material from hyprstream::auth::key_rotation directly). Standard ES256 signers hash internally, so most callers want Commit::sign / Commit::verify instead.

Trait Implementations§

Source§

impl Clone for Commit

Source§

fn clone(&self) -> Commit

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

impl Debug for Commit

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Commit

Source§

fn eq(&self, other: &Commit) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Eq for Commit

Source§

impl StructuralPartialEq for Commit

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
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

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,