Struct AlloySubscriber 

pub struct AlloySubscriber<P, N: Network = Ethereum> { /* private fields */ }

Alloy-backed event subscriber.

The default transport slice drives Alloy pubsub subscriptions for logs, block headers, and pending transaction hashes. The HTTP polling watch_* transport remains available behind the opt-in reactive-polling feature. Pubsub streams reconnect automatically after termination, and log subscriptions are backfilled from the last seen block. Owner-scoped log additions can request backfill from an explicit block anchor. Full pending transaction hydration and full block bodies remain explicit follow-up work. With no registered interests, EventSubscriber::next_batch returns Ok(None).

Implementations

impl<P, N: Network> AlloySubscriber<P, N>

pub fn new(provider: P, mode: SubscriberMode, config: SubscriberConfig) -> Self

Create a new Alloy subscriber.

pub fn provider(&self) -> &P

Borrow the provider.

pub fn mode(&self) -> SubscriberMode

Subscriber mode.

pub fn config(&self) -> &SubscriberConfig

Subscriber config.

pub fn registered_interests(&self) -> &[ReactiveInterest<N>]

Registered interests across base and owner-scoped registrations.

pub fn add_interest_owner( &mut self, owner: HandlerId, interests: &[ReactiveInterest<N>], ) -> Result<(), SubscriberError>

Add or replace the interests owned by owner.

This preserves unrelated owners, queued/pending records, recent dedupe state, and last-seen log anchors. The live transport is reconciled on the next EventSubscriber::next_batch call so newly added log filters can be subscribed without rebuilding the whole subscriber object.

Replacing an existing owner is continuity-safe: filters the owner already had keep their delivery anchors, and any changed or new filter shape is automatically backfilled from the owner’s oldest prior anchor — growing a pool set on an established owner does not open a delivery gap for what the old subscription had already covered. A brand-new owner has no anchor to inherit; pass an explicit add_interest_owner_with_backfill anchor (or register through ReactiveEngine::register_handler, which anchors to the runtime’s last canonical block).

pub fn add_interest_owner_with_backfill( &mut self, owner: HandlerId, interests: &[ReactiveInterest<N>], backfill: SubscriberBackfill, ) -> Result<(), SubscriberError>

Add or replace owner interests and schedule log backfill for that owner.

Backfill is queued only for log interests; block and pending transaction interests are live-only. Queued backfill is drained before live stream initialization, its resolved upper bound seeds the filter’s delivery anchor, and the anchored filter is caught up again right after its live stream connects — so the discovery boundary is closed end to end as long as backfill starts at (or before) the block the interest was discovered in. Continuity backfill for a replaced owner (see add_interest_owner) is queued in addition, unless this explicit backfill is open-ended and already starts at or below the owner’s prior anchor.

pub fn remove_interest_owner( &mut self, owner: &HandlerId, ) -> Option<Vec<ReactiveInterest<N>>>

Remove one owner’s interests, preserving unrelated owner/base interests.

The owner’s queued backfills are dropped, and source-id/anchor bookkeeping for filters no other owner references is retired. Live streams for retired filters are torn down on the next EventSubscriber::next_batch call (dropping an Alloy subscription unsubscribes provider-side); events already in flight from them stop matching the merged interest set and are discarded.

pub fn owner_interests( &self, owner: &HandlerId, ) -> Option<&[ReactiveInterest<N>]>

Borrow the interests currently owned by owner.

Trait Implementations

impl<P, N> EventSubscriber<N> for AlloySubscriber<P, N>

where P: Provider<N> + Send + Sync, N: Network + 'static, N::HeaderResponse: Send + 'static,

fn register_interests( &mut self, interests: &[ReactiveInterest<N>], ) -> Result<(), SubscriberError>

Replace all interests registered with the subscriber.

fn next_batch(&mut self) -> SubscriberNextBatch<'_, N>

Return the next input batch, or Ok(None) when the stream is exhausted.

impl<P, N> InterestOwnerSubscriber<N> for AlloySubscriber<P, N>

where P: Provider<N> + Send + Sync, N: Network + 'static, N::HeaderResponse: Send + 'static,

fn add_interest_owner( &mut self, owner: HandlerId, interests: &[ReactiveInterest<N>], ) -> Result<(), SubscriberError>

Add or replace the interests owned by owner.

fn add_interest_owner_with_backfill( &mut self, owner: HandlerId, interests: &[ReactiveInterest<N>], backfill: SubscriberBackfill, ) -> Result<(), SubscriberError>

Add or replace owner interests and schedule log backfill for that owner.

fn remove_interest_owner( &mut self, owner: &HandlerId, ) -> Option<Vec<ReactiveInterest<N>>>

Remove one owner’s interests, preserving unrelated interests.

fn owner_interests(&self, owner: &HandlerId) -> Option<&[ReactiveInterest<N>]>

Borrow the interests currently owned by owner.