Skip to main content

EventSubscriber

Struct EventSubscriber 

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

Canonical EventService subscriber. Public tracks pass through. Confidential tracks are installed only from per-member HyKEM/COSE controller grants.

Implementations§

Source§

impl EventSubscriber

Source

pub fn new() -> Result<Self>

Source

pub fn with_authz(self, authz: Arc<dyn EventAuthz>) -> Self

Install event-plane authorization. Installing MacEventAuthz makes missing subject clearance and missing object labels deny.

Source

pub fn with_caller(self, caller: Subject) -> Self

Bind the subscriber to an independently verified application subject.

Source

pub fn subscribe(&mut self, pattern: &str) -> Result<()>

Source

pub fn subscribe_all(&mut self) -> Result<()>

Source

pub fn unsubscribe(&mut self, pattern: &str) -> Result<()>

Source

pub fn subscribe_oid(&mut self, oid: &str) -> Result<()>

Source

pub fn with_backfill(&mut self, mode: BackfillMode) -> Result<()>

Source

pub fn with_qos(&mut self, qos: StreamOpt) -> Result<()>

Source

pub fn with_resume_from(&mut self, sequence: u64) -> Result<()>

Source

pub fn last_sequence(&self) -> u64

Source

pub fn dropped_count(&self) -> u64

Source

pub async fn expect_confidential_prefix( &self, tenant: &str, prefix: &str, controller_did: impl Into<String>, publisher: EventPublisherAnchor, ) -> Result<(), String>

Mark a subscribed prefix as confidential before any grant is delivered.

The controller and publisher anchor come from the caller’s authenticated control-plane configuration, rather than from a subsequently received grant. Frames for an expected prefix fail closed until a matching grant is installed.

Source

pub async fn install_epoch_grant( &self, prefix: &str, recipient: &RecipientKeypair, grant: &EpochGrant, publisher: EventPublisherAnchor, prior_last_issued_sequence: Option<u64>, grace_period: Option<Duration>, ) -> Result<(), String>

Install a per-member epoch grant after policy/accepted-state admission.

prior_last_issued_sequence is mandatory for an advance and bounds old epoch grace to objects issued before the transition. Grace is clamped to DEFAULT_SUBSCRIBER_GRACE_PERIOD; security-triggered transitions pass Some(Duration::ZERO).

Source

pub async fn join_prefix( &self, _prefix: &str, _publisher_dh_pubkey: &[u8; 32], _wrapped_key_blob: &[u8], ) -> Result<[u8; 32], String>

Removed classical admission API: an Ed25519/Ristretto key can never be substituted for an accepted #mesh-kem recipient.

Source

pub async fn handle_rekey( &self, _prefix: &str, _wrapped_blobs: &[Vec<u8>], _new_publisher_dh_pubkey: &[u8; 32], _effective_at: Instant, ) -> Result<(), String>

Source

pub async fn promote_key( &self, _prefix: &str, _new_key: Zeroizing<[u8; 32]>, _grace_period: Option<Duration>, ) -> Result<(), String>

Source

pub async fn gc_expired_keys(&self)

Source

pub async fn recv(&mut self) -> Result<(String, Vec<u8>)>

Receive the next event.

Unconfigured prefixes remain byte-identical Public passthrough; explicitly expected confidential prefixes fail closed until their grant is installed. For an installed confidential prefix, the wire frame must match a current or bounded prior epoch, use the required nonce domain, decrypt under the sender/track key, and verify against the externally anchored Ed25519 + ML-DSA-65 publisher identity. Invalid frames are dropped and the loop continues, matching best-effort event delivery.

Source

pub async fn recv_timeout( &mut self, timeout: Duration, ) -> Result<Option<(String, Vec<u8>)>>

Receive with a timeout. Same decode/decrypt behavior as Self::recv.

Source

pub async fn try_recv(&mut self) -> Result<Option<(String, Vec<u8>)>>

Try to receive without blocking. Same decode/decrypt behavior as Self::recv, except a frame that fails to decode/verify/decrypt is dropped and Ok(None) returned immediately rather than continuing to poll (this method must not block). Authorization denials are different: they are returned as an explicit error (and an installed MAC adapter audits the denial) so callers cannot confuse enforcement with an empty queue.

Async only because the authorization check may revalidate a credential-bearing cached subject against the revocation authority; the receive itself remains non-blocking.

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> 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, 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,