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
impl EventSubscriber
pub fn new() -> Result<Self>
Sourcepub fn with_authz(self, authz: Arc<dyn EventAuthz>) -> Self
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.
Sourcepub fn with_caller(self, caller: Subject) -> Self
pub fn with_caller(self, caller: Subject) -> Self
Bind the subscriber to an independently verified application subject.
pub fn subscribe(&mut self, pattern: &str) -> Result<()>
pub fn subscribe_all(&mut self) -> Result<()>
pub fn unsubscribe(&mut self, pattern: &str) -> Result<()>
pub fn subscribe_oid(&mut self, oid: &str) -> Result<()>
pub fn with_backfill(&mut self, mode: BackfillMode) -> Result<()>
pub fn with_qos(&mut self, qos: StreamOpt) -> Result<()>
pub fn with_resume_from(&mut self, sequence: u64) -> Result<()>
pub fn last_sequence(&self) -> u64
pub fn dropped_count(&self) -> u64
Sourcepub async fn expect_confidential_prefix(
&self,
tenant: &str,
prefix: &str,
controller_did: impl Into<String>,
publisher: EventPublisherAnchor,
) -> Result<(), String>
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.
Sourcepub 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>
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).
Sourcepub async fn join_prefix(
&self,
_prefix: &str,
_publisher_dh_pubkey: &[u8; 32],
_wrapped_key_blob: &[u8],
) -> Result<[u8; 32], String>
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.
pub async fn handle_rekey( &self, _prefix: &str, _wrapped_blobs: &[Vec<u8>], _new_publisher_dh_pubkey: &[u8; 32], _effective_at: Instant, ) -> Result<(), String>
pub async fn promote_key( &self, _prefix: &str, _new_key: Zeroizing<[u8; 32]>, _grace_period: Option<Duration>, ) -> Result<(), String>
pub async fn gc_expired_keys(&self)
Sourcepub async fn recv(&mut self) -> Result<(String, Vec<u8>)>
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.
Sourcepub async fn recv_timeout(
&mut self,
timeout: Duration,
) -> Result<Option<(String, Vec<u8>)>>
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.
Sourcepub async fn try_recv(&mut self) -> Result<Option<(String, Vec<u8>)>>
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§
impl Freeze for EventSubscriber
impl !RefUnwindSafe for EventSubscriber
impl Send for EventSubscriber
impl Sync for EventSubscriber
impl Unpin for EventSubscriber
impl UnsafeUnpin for EventSubscriber
impl !UnwindSafe for EventSubscriber
Blanket Implementations§
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> 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 more