pub struct RemoteSubscriber<T, N: Network = Ethereum> { /* private fields */ }Expand description
Remote, owner-aware event subscriber backed by an authoritative service.
Implementations§
Source§impl<T, N: Network> RemoteSubscriber<T, N>
impl<T, N: Network> RemoteSubscriber<T, N>
Sourcepub fn new(session_id: impl Into<String>, chain_id: u64, transport: T) -> Selfwhere
T: RemoteEventTransport,
pub fn new(session_id: impl Into<String>, chain_id: u64, transport: T) -> Selfwhere
T: RemoteEventTransport,
Create a remote subscriber for one durable session and chain.
Sourcepub fn new_at_revision(
session_id: impl Into<String>,
chain_id: u64,
committed_revision: u64,
transport: T,
) -> Selfwhere
T: RemoteEventTransport,
pub fn new_at_revision(
session_id: impl Into<String>,
chain_id: u64,
committed_revision: u64,
transport: T,
) -> Selfwhere
T: RemoteEventTransport,
Restore a remote subscriber at a service-authoritative revision.
Sourcepub fn committed_revision(&self) -> u64
pub fn committed_revision(&self) -> u64
Last authoritative desired-state revision acknowledged by the service.
Sourcepub fn transport_mut(&mut self) -> &mut T
pub fn transport_mut(&mut self) -> &mut T
Mutably borrow the transport.
Source§impl<T> RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
impl<T> RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
Restore local registration mirrors from the service-authoritative wire state. Provider-portable filters are exact; local-only matchers and route-key extractors cannot cross the protocol boundary and are reset.
§Errors
Returns RemoteError::InvalidAuthoritativeState when the supplied
session, chain, revision, owner topology, filter, or backfill state does
not form one self-consistent authoritative snapshot.
Source§impl RemoteSubscriber<GrpcEventTransport, Ethereum>
impl RemoteSubscriber<GrpcEventTransport, Ethereum>
Sourcepub async fn connect(
endpoint: impl Into<String>,
session_id: impl Into<String>,
chain_id: u64,
) -> Result<Self, RemoteTransportError>
pub async fn connect( endpoint: impl Into<String>, session_id: impl Into<String>, chain_id: u64, ) -> Result<Self, RemoteTransportError>
Connect and restore the authoritative desired-state revision.
If this sequence-zero handshake finds an existing nonzero durable
cursor, operations remain gated until EventSubscriber::restore_position
confirms the corresponding runtime checkpoint. Persisted callers that
already have that position should prefer Self::connect_from_position.
§Errors
Returns RemoteTransportError when transport negotiation fails or the
service’s authoritative desired state/cursor is internally inconsistent.
Sourcepub async fn connect_from_position(
endpoint: impl Into<String>,
session_id: impl Into<String>,
chain_id: u64,
position: &SubscriberResumePosition,
) -> Result<Self, RemoteTransportError>
pub async fn connect_from_position( endpoint: impl Into<String>, session_id: impl Into<String>, chain_id: u64, position: &SubscriberResumePosition, ) -> Result<Self, RemoteTransportError>
Connect using the delivery token/checkpoint restored with runtime state.
Unlike the convenience connect constructor, this sends the restored
sequence and cursor proof in Hello. Exact service/runtime agreement is
required except for the proven crash window where that exact delivery
remains one sequence ahead in the service’s durable outbox.
§Errors
Returns RemoteTransportError when the restored position is malformed
or disagrees with remote authority, transport negotiation fails, or the
accepted authoritative state is protocol-invalid.
Sourcepub async fn connect_with_bearer_token(
endpoint: impl Into<String>,
session_id: impl Into<String>,
chain_id: u64,
bearer_token: impl AsRef<str>,
) -> Result<Self, RemoteTransportError>
pub async fn connect_with_bearer_token( endpoint: impl Into<String>, session_id: impl Into<String>, chain_id: u64, bearer_token: impl AsRef<str>, ) -> Result<Self, RemoteTransportError>
Connect with bearer authorization retained across transport reconnects.
Existing nonzero sessions have the same restore gate as Self::connect.
§Security
Use an HTTPS endpoint, or plaintext only inside an authenticated and trusted local service mesh. The API retains the bearer token in memory so it can authenticate reconnect attempts.
§Errors
Returns RemoteTransportError for invalid authorization metadata,
failed/rejected negotiation, or an inconsistent authoritative state.
Sourcepub async fn connect_with_bearer_token_from_position(
endpoint: impl Into<String>,
session_id: impl Into<String>,
chain_id: u64,
bearer_token: impl AsRef<str>,
position: &SubscriberResumePosition,
) -> Result<Self, RemoteTransportError>
pub async fn connect_with_bearer_token_from_position( endpoint: impl Into<String>, session_id: impl Into<String>, chain_id: u64, bearer_token: impl AsRef<str>, position: &SubscriberResumePosition, ) -> Result<Self, RemoteTransportError>
Bearer-authenticated variant of connect_from_position.
§Security
Use an HTTPS endpoint, or plaintext only inside an authenticated and trusted local service mesh. The API retains the bearer token in memory so it can authenticate reconnect attempts.
§Errors
Returns RemoteTransportError when authorization metadata or the
restored position is invalid, negotiation fails, or remote authority
disagrees with the supplied durable proof.
Trait Implementations§
Source§impl<T> EventSubscriber for RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
impl<T> EventSubscriber for RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
Source§fn chain_id(&self) -> Option<u64>
fn chain_id(&self) -> Option<u64>
Source§fn capabilities(&self) -> SubscriberCapabilities
fn capabilities(&self) -> SubscriberCapabilities
Source§fn restore_position(
&mut self,
position: &SubscriberResumePosition,
) -> Result<(), SubscriberError>
fn restore_position( &mut self, position: &SubscriberResumePosition, ) -> Result<(), SubscriberError>
Source§fn register_interests(
&mut self,
interests: &[ReactiveInterest<Ethereum>],
) -> SubscriberOperation<'_, ()>
fn register_interests( &mut self, interests: &[ReactiveInterest<Ethereum>], ) -> SubscriberOperation<'_, ()>
Source§fn next_batch(&mut self) -> SubscriberNextBatch<'_, Ethereum>
fn next_batch(&mut self) -> SubscriberNextBatch<'_, Ethereum>
Ok(None) when the stream is exhausted. Read moreSource§fn acknowledge_delivery(
&mut self,
token: SubscriberDeliveryToken,
) -> SubscriberOperation<'_, ()>
fn acknowledge_delivery( &mut self, token: SubscriberDeliveryToken, ) -> SubscriberOperation<'_, ()>
Source§impl<T> InterestOwnerSubscriber for RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
impl<T> InterestOwnerSubscriber for RemoteSubscriber<T, Ethereum>where
T: RemoteEventTransport,
Source§fn upsert_interest_owners(
&mut self,
owner_updates: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>,
) -> SubscriberOperation<'_, ()>
fn upsert_interest_owners( &mut self, owner_updates: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>, ) -> SubscriberOperation<'_, ()>
Source§fn replace_interest_owners(
&mut self,
replacement: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>,
) -> SubscriberOperation<'_, ()>
fn replace_interest_owners( &mut self, replacement: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>, ) -> SubscriberOperation<'_, ()>
Source§fn replace_interest_owners_with_global_backfill(
&mut self,
replacement: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>,
backfill: SubscriberBackfill,
) -> SubscriberOperation<'_, ()>
fn replace_interest_owners_with_global_backfill( &mut self, replacement: Vec<(HandlerId, Vec<ReactiveInterest<Ethereum>>)>, backfill: SubscriberBackfill, ) -> SubscriberOperation<'_, ()>
Source§fn add_interest_owner(
&mut self,
owner: HandlerId,
interests: &[ReactiveInterest<Ethereum>],
) -> SubscriberOperation<'_, ()>
fn add_interest_owner( &mut self, owner: HandlerId, interests: &[ReactiveInterest<Ethereum>], ) -> SubscriberOperation<'_, ()>
owner, awaiting the subscriber’s
commit boundary. Read moreSource§fn add_interest_owner_with_backfill(
&mut self,
owner: HandlerId,
interests: &[ReactiveInterest<Ethereum>],
backfill: SubscriberBackfill,
) -> SubscriberOperation<'_, ()>
fn add_interest_owner_with_backfill( &mut self, owner: HandlerId, interests: &[ReactiveInterest<Ethereum>], backfill: SubscriberBackfill, ) -> SubscriberOperation<'_, ()>
Source§fn add_interest_owner_with_canonical_catchup(
&mut self,
owner: HandlerId,
interests: &[ReactiveInterest<Ethereum>],
retained: RuntimeBlockRef,
) -> SubscriberOperation<'_, ()>
fn add_interest_owner_with_canonical_catchup( &mut self, owner: HandlerId, interests: &[ReactiveInterest<Ethereum>], retained: RuntimeBlockRef, ) -> SubscriberOperation<'_, ()>
C without
opening a gap while registration commits. Read moreSource§fn remove_interest_owner(
&mut self,
owner: &HandlerId,
) -> SubscriberOperation<'_, Option<Vec<ReactiveInterest<Ethereum>>>>
fn remove_interest_owner( &mut self, owner: &HandlerId, ) -> SubscriberOperation<'_, Option<Vec<ReactiveInterest<Ethereum>>>>
Source§fn owner_interests(
&self,
owner: &HandlerId,
) -> Option<&[ReactiveInterest<Ethereum>]>
fn owner_interests( &self, owner: &HandlerId, ) -> Option<&[ReactiveInterest<Ethereum>]>
owner.Auto Trait Implementations§
impl<T, N = Ethereum> !RefUnwindSafe for RemoteSubscriber<T, N>
impl<T, N = Ethereum> !UnwindSafe for RemoteSubscriber<T, N>
impl<T, N> Freeze for RemoteSubscriber<T, N>
impl<T, N> Send for RemoteSubscriber<T, N>
impl<T, N> Sync for RemoteSubscriber<T, N>
impl<T, N> Unpin for RemoteSubscriber<T, N>
impl<T, N> UnsafeUnpin for RemoteSubscriber<T, N>where
Vec<ReactiveInterest<N>>: UnsafeUnpin,
HashMap<HandlerId, OwnedInterests<N>>: UnsafeUnpin,
Option<PendingCandidate<N>>: UnsafeUnpin,
T: UnsafeUnpin,
PhantomData<fn() -> N>: UnsafeUnpin,
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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§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 moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::RequestSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.Source§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.