import type { Libp2p } from "@libp2p/interface"; import type { PeerId } from "@libp2p/interface/peer-id"; import type { Peer, PeerStore } from "@libp2p/interface/peer-store"; import type { Libp2pOptions } from "libp2p"; import type { IDecodedMessage } from "./message.js"; export enum Protocols { Relay = "relay", Store = "store", LightPush = "lightpush", Filter = "filter" } export interface IBaseProtocol { multicodec: string; peerStore: PeerStore; peers: () => Promise; addLibp2pEventListener: Libp2p["addEventListener"]; removeLibp2pEventListener: Libp2p["removeEventListener"]; } export type ProtocolCreateOptions = { /** * The PubSub Topic to use. Defaults to {@link @waku/core.DefaultPubSubTopic }. * * One and only one pubsub topic is used by Waku. This is used by: * - WakuRelay to receive, route and send messages, * - WakuLightPush to send messages, * - WakuStore to retrieve messages. * * The usage of the default pubsub topic is recommended. * See [Waku v2 Topic Usage Recommendations](https://rfc.vac.dev/spec/23/) for details. * */ pubSubTopic?: string; /** * You can pass options to the `Libp2p` instance used by {@link @waku/core.WakuNode} using the `libp2p` property. * This property is the same type as the one passed to [`Libp2p.create`](https://github.com/libp2p/js-libp2p/blob/master/doc/API.md#create) * apart that we made the `modules` property optional and partial, * allowing its omission and letting Waku set good defaults. * Notes that some values are overridden by {@link @waku/core.WakuNode} to ensure it implements the Waku protocol. */ libp2p?: Partial; /** * Byte array used as key for the noise protocol used for connection encryption * by [`Libp2p.create`](https://github.com/libp2p/js-libp2p/blob/master/doc/API.md#create) * This is only used for test purposes to not run out of entropy during CI runs. */ staticNoiseKey?: Uint8Array; /** * Use recommended bootstrap method to discovery and connect to new nodes. */ defaultBootstrap?: boolean; }; export type Callback = ( msg: T ) => void | Promise; export enum SendError { GENERIC_FAIL = "Generic error", ENCODE_FAILED = "Failed to encode", DECODE_FAILED = "Failed to decode", SIZE_TOO_BIG = "Size is too big", NO_PEER_AVAILABLE = "No peer available", REMOTE_PEER_FAULT = "Remote peer fault" } export interface SendResult { errors?: SendError[]; recipients: PeerId[]; }