Trait libp2p::gossipsub::subscription_filter::TopicSubscriptionFilter

pub trait TopicSubscriptionFilter {
    pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool;

    pub fn filter_incoming_subscriptions(
        &mut self, 
        subscriptions: &'a [GossipsubSubscription], 
        currently_subscribed_topics: &BTreeSet<TopicHash>
    ) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String> { ... }
    pub fn filter_incoming_subscription_set(
        &mut self, 
        subscriptions: HashSet<&'a GossipsubSubscription, RandomState>, 
        _currently_subscribed_topics: &BTreeSet<TopicHash>
    ) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String> { ... }
    pub fn allow_incoming_subscription(
        &mut self, 
        subscription: &GossipsubSubscription
    ) -> bool { ... }
}

Required methods

pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool

Returns true iff the topic is of interest and we can subscribe to it.

Loading content...

Provided methods

pub fn filter_incoming_subscriptions(
    &mut self,
    subscriptions: &'a [GossipsubSubscription],
    currently_subscribed_topics: &BTreeSet<TopicHash>
) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String>

Filters a list of incoming subscriptions and returns a filtered set By default this deduplicates the subscriptions and calls Self::filter_incoming_subscription_set on the filtered set.

pub fn filter_incoming_subscription_set(
    &mut self,
    subscriptions: HashSet<&'a GossipsubSubscription, RandomState>,
    _currently_subscribed_topics: &BTreeSet<TopicHash>
) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String>

Filters a set of deduplicated subscriptions By default this filters the elements based on Self::allow_incoming_subscription.

pub fn allow_incoming_subscription(
    &mut self,
    subscription: &GossipsubSubscription
) -> bool

Returns true iff we allow an incoming subscription. This is used by the default implementation of filter_incoming_subscription_set to decide whether to filter out a subscription or not. By default this uses can_subscribe to decide the same for incoming subscriptions as for outgoing ones.

Loading content...

Implementors

impl TopicSubscriptionFilter for AllowAllSubscriptionFilter

pub fn can_subscribe(&mut self, &TopicHash) -> bool

impl TopicSubscriptionFilter for WhitelistSubscriptionFilter

pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool

impl<T> TopicSubscriptionFilter for CallbackSubscriptionFilter<T> where
    T: FnMut(&TopicHash) -> bool, 

pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool

impl<T> TopicSubscriptionFilter for MaxCountSubscriptionFilter<T> where
    T: TopicSubscriptionFilter, 

pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool

pub fn filter_incoming_subscriptions(
    &mut self,
    subscriptions: &'a [GossipsubSubscription],
    currently_subscribed_topics: &BTreeSet<TopicHash>
) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String>

impl<T, S> TopicSubscriptionFilter for CombinedSubscriptionFilters<T, S> where
    T: TopicSubscriptionFilter,
    S: TopicSubscriptionFilter, 

pub fn can_subscribe(&mut self, topic_hash: &TopicHash) -> bool

pub fn filter_incoming_subscription_set(
    &mut self,
    subscriptions: HashSet<&'a GossipsubSubscription, RandomState>,
    currently_subscribed_topics: &BTreeSet<TopicHash>
) -> Result<HashSet<&'a GossipsubSubscription, RandomState>, String>

Loading content...