Skip to main content

SignerRegistry

Struct SignerRegistry 

Source
pub struct SignerRegistry { /* private fields */ }
Expand description

Mutable signer registry attached to a SIGNED_BY collection.

Invariants:

  1. allowed is the exact set of keys that may produce new signatures. Empty set ⇒ collection rejects every insert (the runtime treats an empty SIGNED_BY list as a parse error, so in practice this only happens after every key is revoked — intentional kill-switch behaviour).
  2. history is append-only. add_signer / revoke_signer push new entries; nothing ever pops.
  3. add_signer of an already-allowed key is a no-op (no history entry written) so that idempotent DDL replays don’t flood the log. revoke_signer of an unknown key returns false.

Implementations§

Source§

impl SignerRegistry

Source

pub fn from_initial( initial: &[[u8; 32]], actor: impl Into<String>, ts_unix_ms: u128, ) -> Self

Build a registry from the initial SIGNED_BY (...) list parsed at CREATE COLLECTION time. Each key receives one SignerHistoryAction::Add entry with the supplied actor / timestamp so the audit trail is non-empty from genesis.

Source

pub fn from_persisted_parts( allowed: Vec<[u8; 32]>, history: Vec<SignerHistoryEntry>, ) -> Self

Rebuild a registry from previously-persisted state. Used by the runtime adapter when loading the registry off red_config — the caller is responsible for the storage format; this constructor only stitches the in-memory invariants back together.

Source

pub fn allowed(&self) -> impl Iterator<Item = &[u8; 32]>

Snapshot of the currently-allowed signers, in stable order.

Source

pub fn allowed_len(&self) -> usize

Source

pub fn history(&self) -> &[SignerHistoryEntry]

Source

pub fn is_allowed(&self, pubkey: &[u8; 32]) -> bool

Source

pub fn ever_added(&self, pubkey: &[u8; 32]) -> bool

Returns true if this key was added at any point in the past (even if later revoked). Used by verify_insert to distinguish UnknownSigner from RevokedSigner.

Source

pub fn add_signer( &mut self, pubkey: [u8; 32], actor: impl Into<String>, ts_unix_ms: u128, ) -> bool

Add pubkey to the allowed set. Returns true if the key was newly added (history entry written), false if it was already allowed (idempotent no-op).

Source

pub fn revoke_signer( &mut self, pubkey: &[u8; 32], actor: impl Into<String>, ts_unix_ms: u128, ) -> bool

Remove pubkey from the allowed set. Returns true if the key was present (and a Revoke history entry written), false if it was unknown. Past rows signed by pubkey remain valid and re-verifiable — only future inserts are rejected.

Trait Implementations§

Source§

impl Clone for SignerRegistry

Source§

fn clone(&self) -> SignerRegistry

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 SignerRegistry

Source§

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

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

impl Default for SignerRegistry

Source§

fn default() -> SignerRegistry

Returns the “default value” for a type. Read more
Source§

impl PartialEq for SignerRegistry

Source§

fn eq(&self, other: &SignerRegistry) -> 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 SignerRegistry

Source§

impl StructuralPartialEq for SignerRegistry

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<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

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

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

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

Source§

fn from_ref(input: &T) -> T

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

impl<T> Instrument for T

Source§

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

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

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

impl<L> LayerExt<L> for L

Source§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

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

Initializes a with the given initializer. Read more
Source§

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

Dereferences the given pointer. Read more
Source§

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

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

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

impl<T> Same for T

Source§

type Output = T

Should always be Self
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.
Source§

impl<T> WithSubscriber for T

Source§

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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