import { GossipSub, GossipSubComponents, GossipsubMessage, GossipsubOpts, } from "@chainsafe/libp2p-gossipsub"; import type { PeerIdStr, TopicStr } from "@chainsafe/libp2p-gossipsub/types"; import { SignaturePolicy } from "@chainsafe/libp2p-gossipsub/types"; import type { Callback, IDecoder, IEncoder, IMessage, IRelay, ProtocolCreateOptions, SendResult, } from "@waku/interfaces"; import { IDecodedMessage } from "@waku/interfaces"; import debug from "debug"; import { DefaultPubSubTopic } from "../constants.js"; import { TopicOnlyDecoder } from "../message/topic_only_message.js"; import { pushOrInitMapSet } from "../push_or_init_map.js"; import * as constants from "./constants.js"; const log = debug("waku:relay"); export type Observer = { decoder: IDecoder; callback: Callback; }; export type RelayCreateOptions = ProtocolCreateOptions & GossipsubOpts; /** * Implements the [Waku v2 Relay protocol](https://rfc.vac.dev/spec/11/). * Must be passed as a `pubsub` module to a `Libp2p` instance. * * @implements {require('libp2p-interfaces/src/pubsub')} */ class Relay extends GossipSub implements IRelay { options: Partial; defaultDecoder: IDecoder; public static multicodec: string = constants.RelayCodecs[0]; /** * observers called when receiving new message. * Observers under key `""` are always called. */ public observers: Map>>; constructor( components: GossipSubComponents, options?: Partial ) { options = Object.assign(options ?? {}, { // Ensure that no signature is included nor expected in the messages. globalSignaturePolicy: SignaturePolicy.StrictNoSign, fallbackToFloodsub: false, }); super(components, options); this.multicodecs = constants.RelayCodecs; this.observers = new Map(); this.options = options ?? {}; // TODO: User might want to decide what decoder should be used (e.g. for RLN) this.defaultDecoder = new TopicOnlyDecoder(); } /** * Mounts the gossipsub protocol onto the libp2p node * and subscribes to the default topic. * * @override * @returns {void} */ public async start(): Promise { const { pubSubTopic = DefaultPubSubTopic } = this.options; await super.start(); this.subscribe(pubSubTopic); } /** * Send Waku message. */ public async send(encoder: IEncoder, message: IMessage): Promise { const { pubSubTopic = DefaultPubSubTopic } = this.options; const msg = await encoder.toWire(message); if (!msg) { log("Failed to encode message, aborting publish"); return { recipients: [] }; } return this.publish(pubSubTopic, msg); } /** * Add an observer and associated Decoder to process incoming messages on a given content topic. * * @returns Function to delete the observer */ addObserver( decoder: IDecoder, callback: Callback ): () => void { const observer = { decoder, callback, }; pushOrInitMapSet(this.observers, decoder.contentTopic, observer); return () => { const observers = this.observers.get(decoder.contentTopic); if (observers) { observers.delete(observer); } }; } /** * Subscribe to a pubsub topic and start emitting Waku messages to observers. * * @override */ subscribe(pubSubTopic: string): void { this.addEventListener( "gossipsub:message", async (event: CustomEvent) => { if (event.detail.msg.topic !== pubSubTopic) return; log(`Message received on ${pubSubTopic}`); const topicOnlyMsg = await this.defaultDecoder.fromWireToProtoObj( event.detail.msg.data ); if (!topicOnlyMsg || !topicOnlyMsg.contentTopic) { log("Message does not have a content topic, skipping"); return; } const observers = this.observers.get(topicOnlyMsg.contentTopic); if (!observers) { return; } await Promise.all( Array.from(observers).map(async ({ decoder, callback }) => { const protoMsg = await decoder.fromWireToProtoObj( event.detail.msg.data ); if (!protoMsg) { log( "Internal error: message previously decoded failed on 2nd pass." ); return; } const msg = await decoder.fromProtoObj(protoMsg); if (msg) { callback(msg); } else { log("Failed to decode messages on", topicOnlyMsg.contentTopic); } }) ); } ); super.subscribe(pubSubTopic); } getMeshPeers(topic?: TopicStr): PeerIdStr[] { const { pubSubTopic = DefaultPubSubTopic } = this.options; return super.getMeshPeers(topic ?? pubSubTopic); } } Relay.multicodec = constants.RelayCodecs[constants.RelayCodecs.length - 1]; export function wakuRelay( init: Partial = {} ): (components: GossipSubComponents) => IRelay { return (components: GossipSubComponents) => new Relay(components, init); }