@libp2p/floodsub 10.1.45 → 10.1.46-6059227cb

package/dist/src/index.d.ts

@@ -31,14 +31,227 @@
  * node.services.pubsub.publish('fruit', new TextEncoder().encode('banana'))
  * ```
  */
-import { multicodec } from './config.js';
-import type { PubSubInit, PubSub } from '@libp2p/interface';
-import type { PubSubComponents } from '@libp2p/pubsub';
-export { multicodec };
-export interface FloodSubInit extends PubSubInit {
-    seenTTL?: number;
+import { pubSubSymbol } from './constants.ts';
+import type { ComponentLogger, PeerId, PrivateKey, PublicKey, TypedEventTarget } from '@libp2p/interface';
+import type { Registrar } from '@libp2p/interface-internal';
+export declare const protocol = "/floodsub/1.0.0";
+/**
+ * On the producing side:
+ * - Build messages with the signature, key (from may be enough for certain inlineable public key types), from and seqno fields.
+ *
+ * On the consuming side:
+ * - Enforce the fields to be present, reject otherwise.
+ * - Propagate only if the fields are valid and signature can be verified, reject otherwise.
+ */
+export declare const StrictSign = "StrictSign";
+/**
+ * On the producing side:
+ * - Build messages without the signature, key, from and seqno fields.
+ * - The corresponding protobuf key-value pairs are absent from the marshaled message, not just empty.
+ *
+ * On the consuming side:
+ * - Enforce the fields to be absent, reject otherwise.
+ * - Propagate only if the fields are absent, reject otherwise.
+ * - A message_id function will not be able to use the above fields, and should instead rely on the data field. A commonplace strategy is to calculate a hash.
+ */
+export declare const StrictNoSign = "StrictNoSign";
+export type SignaturePolicy = typeof StrictSign | typeof StrictNoSign;
+export interface SignedMessage {
+    type: 'signed';
+    from: PeerId;
+    topic: string;
+    data: Uint8Array;
+    sequenceNumber: bigint;
+    signature: Uint8Array;
+    key: PublicKey;
+}
+export interface UnsignedMessage {
+    type: 'unsigned';
+    topic: string;
+    data: Uint8Array;
+}
+export type Message = SignedMessage | UnsignedMessage;
+export interface Subscription {
+    topic: string;
+    subscribe: boolean;
+}
+export interface SubscriptionChangeData {
+    peerId: PeerId;
+    subscriptions: Subscription[];
 }
-export interface FloodSubComponents extends PubSubComponents {
+export interface FloodSubEvents {
+    'subscription-change': CustomEvent<SubscriptionChangeData>;
+    message: CustomEvent<Message>;
+}
+export interface PublishResult {
+    recipients: PeerId[];
+}
+export declare enum TopicValidatorResult {
+    /**
+     * The message is considered valid, and it should be delivered and forwarded to the network
+     */
+    Accept = "accept",
+    /**
+     * The message is neither delivered nor forwarded to the network
+     */
+    Ignore = "ignore",
+    /**
+     * The message is considered invalid, and it should be rejected
+     */
+    Reject = "reject"
+}
+export interface TopicValidatorFn {
+    (peer: PeerId, message: Message): TopicValidatorResult | Promise<TopicValidatorResult>;
+}
+export interface PeerStreamEvents {
+    'stream:inbound': CustomEvent<never>;
+    'stream:outbound': CustomEvent<never>;
+    close: CustomEvent<never>;
+}
+export { pubSubSymbol };
+/**
+ * Returns true if the passed argument is a PubSub implementation
+ */
+export declare function isPubSub(obj?: any): obj is FloodSub;
+export interface FloodSub extends TypedEventTarget<FloodSubEvents> {
+    /**
+     * The global signature policy controls whether or not we sill send and receive
+     * signed or unsigned messages.
+     *
+     * Signed messages prevent spoofing message senders and should be preferred to
+     * using unsigned messages.
+     */
+    globalSignaturePolicy: typeof StrictSign | typeof StrictNoSign;
+    /**
+     * A list of multicodecs that contain the pubsub protocol name.
+     */
+    protocols: string[];
+    /**
+     * Pubsub routers support message validators per topic, which will validate the message
+     * before its propagations. They are stored in a map where keys are the topic name and
+     * values are the validators.
+     *
+     * @example
+     *
+     * ```TypeScript
+     * const topic = 'topic'
+     * const validateMessage = (msgTopic, msg) => {
+     *   const input = uint8ArrayToString(msg.data)
+     *   const validInputs = ['a', 'b', 'c']
+     *
+     *   if (!validInputs.includes(input)) {
+     *     throw new Error('no valid input received')
+     *   }
+     * }
+     * libp2p.pubsub.topicValidators.set(topic, validateMessage)
+     * ```
+     */
+    topicValidators: Map<string, TopicValidatorFn>;
+    getPeers(): PeerId[];
+    /**
+     * Gets a list of topics the node is subscribed to.
+     *
+     * ```TypeScript
+     * const topics = libp2p.pubsub.getTopics()
+     * ```
+     */
+    getTopics(): string[];
+    /**
+     * Subscribes to a pubsub topic.
+     *
+     * @example
+     *
+     * ```TypeScript
+     * const topic = 'topic'
+     * const handler = (msg) => {
+     *   if (msg.topic === topic) {
+     *     // msg.data - pubsub data received
+     *   }
+     * }
+     *
+     * libp2p.pubsub.addEventListener('message', handler)
+     * libp2p.pubsub.subscribe(topic)
+     * ```
+     */
+    subscribe(topic: string): void;
+    /**
+     * Unsubscribes from a pubsub topic.
+     *
+     * @example
+     *
+     * ```TypeScript
+     * const topic = 'topic'
+     * const handler = (msg) => {
+     *   // msg.data - pubsub data received
+     * }
+     *
+     * libp2p.pubsub.removeEventListener(topic handler)
+     * libp2p.pubsub.unsubscribe(topic)
+     * ```
+     */
+    unsubscribe(topic: string): void;
+    /**
+     * Gets a list of the PeerIds that are subscribed to one topic.
+     *
+     * @example
+     *
+     * ```TypeScript
+     * const peerIds = libp2p.pubsub.getSubscribers(topic)
+     * ```
+     */
+    getSubscribers(topic: string): PeerId[];
+    /**
+     * Publishes messages to the given topic.
+     *
+     * @example
+     *
+     * ```TypeScript
+     * const topic = 'topic'
+     * const data = uint8ArrayFromString('data')
+     *
+     * await libp2p.pubsub.publish(topic, data)
+     * ```
+     */
+    publish(topic: string, data?: Uint8Array): Promise<PublishResult>;
+}
+export interface FloodSubComponents {
+    peerId: PeerId;
+    privateKey: PrivateKey;
+    registrar: Registrar;
+    logger: ComponentLogger;
+}
+export interface FloodSubInit {
+    seenTTL?: number;
+    /**
+     * Override the protocol registered with the registrar
+     *
+     * @default ['/floodsub/1.0.0']
+     */
+    protocols?: string[];
+    /**
+     * defines how signatures should be handled
+     */
+    globalSignaturePolicy?: SignaturePolicy;
+    /**
+     * if can relay messages not subscribed
+     */
+    canRelayMessage?: boolean;
+    /**
+     * if publish should emit to self, if subscribed
+     */
+    emitSelf?: boolean;
+    /**
+     * handle this many incoming pubsub messages concurrently
+     */
+    messageProcessingConcurrency?: number;
+    /**
+     * How many parallel incoming streams to allow on the pubsub protocol per-connection
+     */
+    maxInboundStreams?: number;
+    /**
+     * How many parallel outgoing streams to allow on the pubsub protocol per-connection
+     */
+    maxOutboundStreams?: number;
 }
-export declare function floodsub(init?: FloodSubInit): (components: FloodSubComponents) => PubSub;
+export declare function floodsub(init?: FloodSubInit): (components: FloodSubComponents) => FloodSub;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,KAAK,EAAU,UAAU,EAAuD,MAAM,EAAE,MAAM,mBAAmB,CAAA;AACxH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,EAAE,UAAU,EAAE,CAAA;AAErB,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;CAE3D;AAkHD,wBAAgB,QAAQ,CAAE,IAAI,GAAE,YAAiB,GAAG,CAAC,UAAU,EAAE,kBAAkB,KAAK,MAAM,CAE7F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -31,103 +31,52 @@
  * node.services.pubsub.publish('fruit', new TextEncoder().encode('banana'))
  * ```
  */
-import { pubSubSymbol, serviceCapabilities, serviceDependencies } from '@libp2p/interface';
-import { PubSubBaseProtocol } from '@libp2p/pubsub';
-import { toString } from 'uint8arrays/to-string';
-import { SimpleTimeCache } from './cache.js';
-import { multicodec } from './config.js';
-import { RPC } from './message/rpc.js';
-export { multicodec };
+import { pubSubSymbol } from "./constants.js";
+import { FloodSub as FloodSubClass } from './floodsub.js';
+export const protocol = '/floodsub/1.0.0';
 /**
- * FloodSub (aka dumbsub is an implementation of pubsub focused on
- * delivering an API for Publish/Subscribe, but with no CastTree Forming
- * (it just floods the network).
+ * On the producing side:
+ * - Build messages with the signature, key (from may be enough for certain inlineable public key types), from and seqno fields.
+ *
+ * On the consuming side:
+ * - Enforce the fields to be present, reject otherwise.
+ * - Propagate only if the fields are valid and signature can be verified, reject otherwise.
  */
-class FloodSub extends PubSubBaseProtocol {
-    seenCache;
-    constructor(components, init) {
-        super(components, {
-            ...init,
-            canRelayMessage: true,
-            multicodecs: [multicodec]
-        });
-        this.log = components.logger.forComponent('libp2p:floodsub');
-        /**
-         * Cache of seen messages
-         *
-         * @type {TimeCache}
-         */
-        this.seenCache = new SimpleTimeCache({
-            validityMs: init?.seenTTL ?? 30000
-        });
-    }
-    [pubSubSymbol] = true;
-    [Symbol.toStringTag] = '@libp2p/floodsub';
-    [serviceCapabilities] = [
-        '@libp2p/pubsub'
-    ];
-    [serviceDependencies] = [
-        '@libp2p/identify'
-    ];
-    /**
-     * Decode a Uint8Array into an RPC object
-     */
-    decodeRpc(bytes) {
-        return RPC.decode(bytes);
-    }
+export const StrictSign = 'StrictSign';
+/**
+ * On the producing side:
+ * - Build messages without the signature, key, from and seqno fields.
+ * - The corresponding protobuf key-value pairs are absent from the marshaled message, not just empty.
+ *
+ * On the consuming side:
+ * - Enforce the fields to be absent, reject otherwise.
+ * - Propagate only if the fields are absent, reject otherwise.
+ * - A message_id function will not be able to use the above fields, and should instead rely on the data field. A commonplace strategy is to calculate a hash.
+ */
+export const StrictNoSign = 'StrictNoSign';
+export var TopicValidatorResult;
+(function (TopicValidatorResult) {
     /**
-     * Encode an RPC object into a Uint8Array
+     * The message is considered valid, and it should be delivered and forwarded to the network
      */
-    encodeRpc(rpc) {
-        return RPC.encode(rpc);
-    }
-    decodeMessage(bytes) {
-        return RPC.Message.decode(bytes);
-    }
-    encodeMessage(rpc) {
-        return RPC.Message.encode(rpc);
-    }
+    TopicValidatorResult["Accept"] = "accept";
     /**
-     * Process incoming message
-     * Extends base implementation to check router cache.
+     * The message is neither delivered nor forwarded to the network
      */
-    async processMessage(from, message) {
-        // Check if I've seen the message, if yes, ignore
-        const seqno = await super.getMsgId(message);
-        const msgIdStr = toString(seqno, 'base64');
-        if (this.seenCache.has(msgIdStr)) {
-            return;
-        }
-        this.seenCache.put(msgIdStr, true);
-        await super.processMessage(from, message);
-    }
+    TopicValidatorResult["Ignore"] = "ignore";
     /**
-     * Publish message created. Forward it to the peers.
+     * The message is considered invalid, and it should be rejected
      */
-    async publishMessage(from, message) {
-        const peers = this.getSubscribers(message.topic);
-        const recipients = [];
-        if (peers == null || peers.length === 0) {
-            this.log('no peers are subscribed to topic %s', message.topic);
-            return { recipients };
-        }
-        peers.forEach(id => {
-            if (this.components.peerId.equals(id)) {
-                this.log('not sending message on topic %s to myself', message.topic);
-                return;
-            }
-            if (id.equals(from)) {
-                this.log('not sending message on topic %s to sender %p', message.topic, id);
-                return;
-            }
-            this.log('publish msgs on topics %s %p', message.topic, id);
-            recipients.push(id);
-            this.send(id, { messages: [message] });
-        });
-        return { recipients };
-    }
+    TopicValidatorResult["Reject"] = "reject";
+})(TopicValidatorResult || (TopicValidatorResult = {}));
+export { pubSubSymbol };
+/**
+ * Returns true if the passed argument is a PubSub implementation
+ */
+export function isPubSub(obj) {
+    return Boolean(obj?.[pubSubSymbol]);
 }
 export function floodsub(init = {}) {
-    return (components) => new FloodSub(components, init);
+    return (components) => new FloodSubClass(components, init);
 }
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAA;AAIzD,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAA;AAyC1C,MAAM,CAAN,IAAY,oBAaX;AAbD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,yCAAiB,CAAA;IACjB;;OAEG;IACH,yCAAiB,CAAA;IACjB;;OAEG;IACH,yCAAiB,CAAA;AACnB,CAAC,EAbW,oBAAoB,KAApB,oBAAoB,QAa/B;AAYD,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAE,GAAS;IACjC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;AACrC,CAAC;AAgKD,MAAM,UAAU,QAAQ,CAAE,OAAqB,EAAE;IAC/C,OAAO,CAAC,UAA8B,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AAChF,CAAC"}

package/dist/src/peer-streams.d.ts

@@ -0,0 +1,71 @@
+import { TypedEventEmitter } from 'main-event';
+import { Uint8ArrayList } from 'uint8arraylist';
+import type { PeerStreamEvents } from './index.ts';
+import type { ComponentLogger, Stream, PeerId } from '@libp2p/interface';
+import type { DecoderOptions as LpDecoderOptions } from 'it-length-prefixed';
+import type { Pushable } from 'it-pushable';
+export interface PeerStreamsInit {
+    id: PeerId;
+    protocol: string;
+}
+export interface PeerStreamsComponents {
+    logger: ComponentLogger;
+}
+export interface DecoderOptions extends LpDecoderOptions {
+}
+/**
+ * Thin wrapper around a peer's inbound / outbound pubsub streams
+ */
+export declare class PeerStreams extends TypedEventEmitter<PeerStreamEvents> {
+    readonly id: PeerId;
+    readonly protocol: string;
+    /**
+     * Write stream - it's preferable to use the write method
+     */
+    outboundStream?: Pushable<Uint8ArrayList>;
+    /**
+     * Read stream
+     */
+    inboundStream?: AsyncIterable<Uint8ArrayList>;
+    /**
+     * The raw outbound stream, as retrieved from conn.newStream
+     */
+    private _rawOutboundStream?;
+    /**
+     * The raw inbound stream, as retrieved from the callback from libp2p.handle
+     */
+    private _rawInboundStream?;
+    /**
+     * An AbortController for controlled shutdown of the inbound stream
+     */
+    private readonly _inboundAbortController;
+    private closed;
+    private readonly log;
+    constructor(components: PeerStreamsComponents, init: PeerStreamsInit);
+    /**
+     * Do we have a connection to read from?
+     */
+    get isReadable(): boolean;
+    /**
+     * Do we have a connection to write on?
+     */
+    get isWritable(): boolean;
+    /**
+     * Send a message to this peer.
+     * Throws if there is no `stream` to write to available.
+     */
+    write(data: Uint8Array | Uint8ArrayList): void;
+    /**
+     * Attach a raw inbound stream and setup a read stream
+     */
+    attachInboundStream(stream: Stream, decoderOptions?: DecoderOptions): AsyncIterable<Uint8ArrayList>;
+    /**
+     * Attach a raw outbound stream and setup a write stream
+     */
+    attachOutboundStream(stream: Stream): Promise<Pushable<Uint8ArrayList>>;
+    /**
+     * Closes the open connection to peer
+     */
+    close(): void;
+}
+//# sourceMappingURL=peer-streams.d.ts.map

package/dist/src/peer-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-streams.d.ts","sourceRoot":"","sources":["../../src/peer-streams.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,KAAK,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;CAEvD;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,iBAAiB,CAAC,gBAAgB,CAAC;IAClE,SAAgB,EAAE,EAAE,MAAM,CAAA;IAC1B,SAAgB,QAAQ,EAAE,MAAM,CAAA;IAChC;;OAEG;IACI,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;IAChD;;OAEG;IACI,aAAa,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IACpD;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAC,CAAQ;IACnC;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAC,CAAQ;IAClC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAiB;IACzD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAEf,UAAU,EAAE,qBAAqB,EAAE,IAAI,EAAE,eAAe;IAWrE;;OAEG;IACH,IAAI,UAAU,IAAK,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,UAAU,IAAK,OAAO,CAEzB;IAED;;;OAGG;IACH,KAAK,CAAE,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI;IAS/C;;OAEG;IACH,mBAAmB,CAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IAuBpG;;OAEG;IACG,oBAAoB,CAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAqD9E;;OAEG;IACH,KAAK,IAAK,IAAI;CAsBf"}

package/dist/src/peer-streams.js

@@ -0,0 +1,154 @@
+import { AbortError } from '@libp2p/interface';
+import { pipe } from '@libp2p/utils';
+import * as lp from 'it-length-prefixed';
+import { pushable } from 'it-pushable';
+import { TypedEventEmitter } from 'main-event';
+import { pEvent } from 'p-event';
+import { Uint8ArrayList } from 'uint8arraylist';
+/**
+ * Thin wrapper around a peer's inbound / outbound pubsub streams
+ */
+export class PeerStreams extends TypedEventEmitter {
+    id;
+    protocol;
+    /**
+     * Write stream - it's preferable to use the write method
+     */
+    outboundStream;
+    /**
+     * Read stream
+     */
+    inboundStream;
+    /**
+     * The raw outbound stream, as retrieved from conn.newStream
+     */
+    _rawOutboundStream;
+    /**
+     * The raw inbound stream, as retrieved from the callback from libp2p.handle
+     */
+    _rawInboundStream;
+    /**
+     * An AbortController for controlled shutdown of the inbound stream
+     */
+    _inboundAbortController;
+    closed;
+    log;
+    constructor(components, init) {
+        super();
+        this.log = components.logger.forComponent('libp2p-pubsub:peer-streams');
+        this.id = init.id;
+        this.protocol = init.protocol;
+        this._inboundAbortController = new AbortController();
+        this.closed = false;
+    }
+    /**
+     * Do we have a connection to read from?
+     */
+    get isReadable() {
+        return Boolean(this.inboundStream);
+    }
+    /**
+     * Do we have a connection to write on?
+     */
+    get isWritable() {
+        return Boolean(this.outboundStream);
+    }
+    /**
+     * Send a message to this peer.
+     * Throws if there is no `stream` to write to available.
+     */
+    write(data) {
+        if (this.outboundStream == null) {
+            const id = this.id.toString();
+            throw new Error('No writable connection to ' + id);
+        }
+        this.outboundStream.push(data instanceof Uint8Array ? new Uint8ArrayList(data) : data);
+    }
+    /**
+     * Attach a raw inbound stream and setup a read stream
+     */
+    attachInboundStream(stream, decoderOptions) {
+        const abortListener = () => {
+            stream.abort(new AbortError());
+        };
+        this._inboundAbortController.signal.addEventListener('abort', abortListener, {
+            once: true
+        });
+        // Create and attach a new inbound stream
+        // The inbound stream is:
+        // - abortable, set to only return on abort, rather than throw
+        // - transformed with length-prefix transform
+        this._rawInboundStream = stream;
+        this.inboundStream = pipe(this._rawInboundStream, (source) => lp.decode(source, decoderOptions));
+        this.dispatchEvent(new CustomEvent('stream:inbound'));
+        return this.inboundStream;
+    }
+    /**
+     * Attach a raw outbound stream and setup a write stream
+     */
+    async attachOutboundStream(stream) {
+        // If an outbound stream already exists, gently close it
+        const _prevStream = this.outboundStream;
+        if (this.outboundStream != null) {
+            // End the stream without emitting a close event
+            this.outboundStream.end();
+        }
+        this._rawOutboundStream = stream;
+        this.outboundStream = pushable({
+            onEnd: (shouldEmit) => {
+                // close writable side of the stream if it exists
+                this._rawOutboundStream?.close()
+                    .catch(err => {
+                    this.log('error closing outbound stream', err);
+                });
+                this._rawOutboundStream = undefined;
+                this.outboundStream = undefined;
+                if (shouldEmit != null) {
+                    this.dispatchEvent(new CustomEvent('close'));
+                }
+            }
+        });
+        pipe(this.outboundStream, (source) => lp.encode(source), async (source) => {
+            for await (const buf of source) {
+                const sendMore = stream.send(buf);
+                if (sendMore === false) {
+                    await pEvent(stream, 'drain', {
+                        rejectionEvents: [
+                            'close'
+                        ]
+                    });
+                }
+            }
+        }).catch((err) => {
+            this.log.error(err);
+        });
+        // Only emit if the connection is new
+        if (_prevStream == null) {
+            this.dispatchEvent(new CustomEvent('stream:outbound'));
+        }
+        return this.outboundStream;
+    }
+    /**
+     * Closes the open connection to peer
+     */
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        // End the outbound stream
+        if (this.outboundStream != null) {
+            this.outboundStream.end();
+        }
+        // End the inbound stream
+        if (this.inboundStream != null) {
+            this._inboundAbortController.abort();
+        }
+        this._rawOutboundStream = undefined;
+        this.outboundStream = undefined;
+        this._rawInboundStream = undefined;
+        this.inboundStream = undefined;
+        this.dispatchEvent(new CustomEvent('close'));
+    }
+}
+//# sourceMappingURL=peer-streams.js.map

package/dist/src/peer-streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-streams.js","sourceRoot":"","sources":["../../src/peer-streams.ts"],"names":[],"mappings":"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"}

package/dist/src/sign.d.ts

@@ -0,0 +1,23 @@
+import type { PubSubRPCMessage } from './floodsub.ts';
+import type { SignedMessage } from './index.ts';
+import type { PeerId, PrivateKey, PublicKey } from '@libp2p/interface';
+export declare const SignPrefix: Uint8Array<ArrayBufferLike>;
+/**
+ * Signs the provided message with the given `peerId`
+ */
+export declare function signMessage(privateKey: PrivateKey, message: {
+    from: PeerId;
+    topic: string;
+    data: Uint8Array;
+    sequenceNumber: bigint;
+}, encode: (rpc: PubSubRPCMessage) => Uint8Array): Promise<SignedMessage>;
+/**
+ * Verifies the signature of the given message
+ */
+export declare function verifySignature(message: SignedMessage, encode: (rpc: PubSubRPCMessage) => Uint8Array): Promise<boolean>;
+/**
+ * Returns the PublicKey associated with the given message.
+ * If no valid PublicKey can be retrieved an error will be returned.
+ */
+export declare function messagePublicKey(message: SignedMessage): PublicKey;
+//# sourceMappingURL=sign.d.ts.map

package/dist/src/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../../src/sign.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEtE,eAAO,MAAM,UAAU,6BAAyC,CAAA;AAEhE;;GAEG;AACH,wBAAsB,WAAW,CAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBpN;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B9H;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CAoBnE"}