@libp2p/gossipsub 14.1.1-6059227cb

package/dist/src/types.d.ts

@@ -0,0 +1,148 @@
+import { TopicValidatorResult } from './index.ts';
+import type { Message } from './index.ts';
+import type { RPC } from './message/rpc.js';
+import type { PrivateKey, PeerId } from '@libp2p/interface';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export type MsgIdStr = string;
+export type PeerIdStr = string;
+export type TopicStr = string;
+export type IPStr = string;
+export interface AddrInfo {
+    id: PeerId;
+    addrs: Multiaddr[];
+}
+/**
+ * Compute a local non-spec'ed msg-id for faster de-duplication of seen messages.
+ * Used exclusively for a local seen_cache
+ */
+export interface FastMsgIdFn {
+    (msg: RPC.Message): string | number;
+}
+/**
+ * By default, gossipsub only provide a browser friendly function to convert Uint8Array message id to string.
+ * Application could use this option to provide a more efficient function.
+ */
+export interface MsgIdToStrFn {
+    (msgId: Uint8Array): string;
+}
+/**
+ * Compute spec'ed msg-id. Used for IHAVE / IWANT messages
+ */
+export interface MsgIdFn {
+    (msg: Message): Promise<Uint8Array> | Uint8Array;
+}
+export interface DataTransform {
+    /**
+     * Takes the data published by peers on a topic and transforms the data.
+     * Should be the reverse of outboundTransform(). Example:
+     * - `inboundTransform()`: decompress snappy payload
+     * - `outboundTransform()`: compress snappy payload
+     */
+    inboundTransform(topic: TopicStr, data: Uint8Array): Uint8Array;
+    /**
+     * Takes the data to be published (a topic and associated data) transforms the data. The
+     * transformed data will then be used to create a `RawGossipsubMessage` to be sent to peers.
+     */
+    outboundTransform(topic: TopicStr, data: Uint8Array): Uint8Array;
+}
+export declare enum SignaturePolicy {
+    /**
+     * 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.
+     */
+    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 marshalled 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.
+     */
+    StrictNoSign = "StrictNoSign"
+}
+export interface PublishOpts {
+    /**
+     * Do not throw `PublishError.NoPeersSubscribedToTopic` error if there are no
+     * peers listening on the topic.
+     *
+     * N.B. if you sent this option to true, and you publish a message on a topic
+     * with no peers listening on that topic, no other network node will ever
+     * receive the message.
+     */
+    allowPublishToZeroTopicPeers?: boolean;
+    ignoreDuplicatePublishError?: boolean;
+    /** serialize message once and send to all peers without control messages */
+    batchPublish?: boolean;
+}
+export declare enum PublishConfigType {
+    Signing = 0,
+    Anonymous = 1
+}
+export type PublishConfig = {
+    type: PublishConfigType.Signing;
+    author: PeerId;
+    key: Uint8Array;
+    privateKey: PrivateKey;
+} | {
+    type: PublishConfigType.Anonymous;
+};
+export type RejectReasonObj = {
+    reason: RejectReason.Error;
+    error: ValidateError;
+} | {
+    reason: Exclude<RejectReason, RejectReason.Error>;
+};
+export declare enum RejectReason {
+    /**
+     * The message failed the configured validation during decoding.
+     * SelfOrigin is considered a ValidationError
+     */
+    Error = "error",
+    /**
+     * Custom validator fn reported status IGNORE.
+     */
+    Ignore = "ignore",
+    /**
+     * Custom validator fn reported status REJECT.
+     */
+    Reject = "reject",
+    /**
+     * The peer that sent the message OR the source from field is blacklisted.
+     * Causes messages to be ignored, not penalized, neither do score record creation.
+     */
+    Blacklisted = "blacklisted"
+}
+export declare enum ValidateError {
+    InvalidSignature = "invalid_signature",
+    InvalidSeqno = "invalid_seqno",
+    InvalidPeerId = "invalid_peerid",
+    SignaturePresent = "signature_present",
+    SeqnoPresent = "seqno_present",
+    FromPresent = "from_present",
+    TransformFailed = "transform_failed"
+}
+export declare enum MessageStatus {
+    duplicate = "duplicate",
+    invalid = "invalid",
+    valid = "valid"
+}
+/**
+ * Store both Uint8Array and string message id so that we don't have to convert data between the two.
+ * See https://github.com/ChainSafe/js-libp2p-gossipsub/pull/274
+ */
+export interface MessageId {
+    msgId: Uint8Array;
+    msgIdStr: MsgIdStr;
+}
+/**
+ * Typesafe conversion of MessageAcceptance -> RejectReason. TS ensures all values covered
+ */
+export declare function rejectReasonFromAcceptance(acceptance: Exclude<TopicValidatorResult, TopicValidatorResult.Accept>): RejectReason.Ignore | RejectReason.Reject;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,90 @@
+import { TopicValidatorResult } from "./index.js";
+export var SignaturePolicy;
+(function (SignaturePolicy) {
+    /**
+     * 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.
+     */
+    SignaturePolicy["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 marshalled 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.
+     */
+    SignaturePolicy["StrictNoSign"] = "StrictNoSign";
+})(SignaturePolicy || (SignaturePolicy = {}));
+export var PublishConfigType;
+(function (PublishConfigType) {
+    PublishConfigType[PublishConfigType["Signing"] = 0] = "Signing";
+    PublishConfigType[PublishConfigType["Anonymous"] = 1] = "Anonymous";
+})(PublishConfigType || (PublishConfigType = {}));
+export var RejectReason;
+(function (RejectReason) {
+    /**
+     * The message failed the configured validation during decoding.
+     * SelfOrigin is considered a ValidationError
+     */
+    RejectReason["Error"] = "error";
+    /**
+     * Custom validator fn reported status IGNORE.
+     */
+    RejectReason["Ignore"] = "ignore";
+    /**
+     * Custom validator fn reported status REJECT.
+     */
+    RejectReason["Reject"] = "reject";
+    /**
+     * The peer that sent the message OR the source from field is blacklisted.
+     * Causes messages to be ignored, not penalized, neither do score record creation.
+     */
+    RejectReason["Blacklisted"] = "blacklisted";
+})(RejectReason || (RejectReason = {}));
+export var ValidateError;
+(function (ValidateError) {
+    /// The message has an invalid signature,
+    ValidateError["InvalidSignature"] = "invalid_signature";
+    /// The sequence number was the incorrect size
+    ValidateError["InvalidSeqno"] = "invalid_seqno";
+    /// The PeerId was invalid
+    ValidateError["InvalidPeerId"] = "invalid_peerid";
+    /// Signature existed when validation has been sent to
+    /// [`crate::behaviour::MessageAuthenticity::Anonymous`].
+    ValidateError["SignaturePresent"] = "signature_present";
+    /// Sequence number existed when validation has been sent to
+    /// [`crate::behaviour::MessageAuthenticity::Anonymous`].
+    ValidateError["SeqnoPresent"] = "seqno_present";
+    /// Message source existed when validation has been sent to
+    /// [`crate::behaviour::MessageAuthenticity::Anonymous`].
+    ValidateError["FromPresent"] = "from_present";
+    /// The data transformation failed.
+    ValidateError["TransformFailed"] = "transform_failed";
+})(ValidateError || (ValidateError = {}));
+export var MessageStatus;
+(function (MessageStatus) {
+    MessageStatus["duplicate"] = "duplicate";
+    MessageStatus["invalid"] = "invalid";
+    MessageStatus["valid"] = "valid";
+})(MessageStatus || (MessageStatus = {}));
+/**
+ * Typesafe conversion of MessageAcceptance -> RejectReason. TS ensures all values covered
+ */
+export function rejectReasonFromAcceptance(acceptance) {
+    switch (acceptance) {
+        case TopicValidatorResult.Ignore:
+            return RejectReason.Ignore;
+        case TopicValidatorResult.Reject:
+            return RejectReason.Reject;
+        default:
+            throw new Error('Unreachable');
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAmDjD,MAAM,CAAN,IAAY,eAqBX;AArBD,WAAY,eAAe;IACzB;;;;;;;OAOG;IACH,4CAAyB,CAAA;IACzB;;;;;;;;;OASG;IACH,gDAA6B,CAAA;AAC/B,CAAC,EArBW,eAAe,KAAf,eAAe,QAqB1B;AAiBD,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,+DAAO,CAAA;IACP,mEAAS,CAAA;AACX,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAeD,MAAM,CAAN,IAAY,YAmBX;AAnBD,WAAY,YAAY;IACtB;;;OAGG;IACH,+BAAe,CAAA;IACf;;OAEG;IACH,iCAAiB,CAAA;IACjB;;OAEG;IACH,iCAAiB,CAAA;IACjB;;;OAGG;IACH,2CAA2B,CAAA;AAC7B,CAAC,EAnBW,YAAY,KAAZ,YAAY,QAmBvB;AAED,MAAM,CAAN,IAAY,aAkBX;AAlBD,WAAY,aAAa;IACvB,yCAAyC;IACzC,uDAAsC,CAAA;IACtC,8CAA8C;IAC9C,+CAA8B,CAAA;IAC9B,0BAA0B;IAC1B,iDAAgC,CAAA;IAChC,sDAAsD;IACtD,yDAAyD;IACzD,uDAAsC,CAAA;IACtC,4DAA4D;IAC5D,yDAAyD;IACzD,+CAA8B,CAAA;IAC9B,2DAA2D;IAC3D,yDAAyD;IACzD,6CAA4B,CAAA;IAC5B,mCAAmC;IACnC,qDAAoC,CAAA;AACtC,CAAC,EAlBW,aAAa,KAAb,aAAa,QAkBxB;AAED,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAWD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAsE;IAEtE,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,oBAAoB,CAAC,MAAM;YAC9B,OAAO,YAAY,CAAC,MAAM,CAAA;QAC5B,KAAK,oBAAoB,CAAC,MAAM;YAC9B,OAAO,YAAY,CAAC,MAAM,CAAA;QAC5B;YACE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;IAClC,CAAC;AACH,CAAC"}

package/dist/src/utils/buildRawMessage.d.ts

@@ -0,0 +1,20 @@
+import { StrictSign, StrictNoSign } from '../index.ts';
+import { RPC } from '../message/rpc.js';
+import { ValidateError } from '../types.js';
+import type { Message } from '../index.ts';
+import type { PublishConfig, TopicStr } from '../types.js';
+export declare const SignPrefix: Uint8Array<ArrayBufferLike>;
+export interface RawMessageAndMessage {
+    raw: RPC.Message;
+    msg: Message;
+}
+export declare function buildRawMessage(publishConfig: PublishConfig, topic: TopicStr, originalData: Uint8Array, transformedData: Uint8Array): Promise<RawMessageAndMessage>;
+export type ValidationResult = {
+    valid: true;
+    message: Message;
+} | {
+    valid: false;
+    error: ValidateError;
+};
+export declare function validateToRawMessage(signaturePolicy: typeof StrictNoSign | typeof StrictSign, msg: RPC.Message): Promise<ValidationResult>;
+//# sourceMappingURL=buildRawMessage.d.ts.map

package/dist/src/utils/buildRawMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildRawMessage.d.ts","sourceRoot":"","sources":["../../../src/utils/buildRawMessage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAqB,aAAa,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,UAAU,6BAAyC,CAAA;AAEhE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;IAChB,GAAG,EAAE,OAAO,CAAA;CACb;AAED,wBAAsB,eAAe,CACnC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,QAAQ,EACf,YAAY,EAAE,UAAU,EACxB,eAAe,EAAE,UAAU,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAuD/B;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAA;AAEzG,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,OAAO,YAAY,GAAG,OAAO,UAAU,EACxD,GAAG,EAAE,GAAG,CAAC,OAAO,GACf,OAAO,CAAC,gBAAgB,CAAC,CAqF3B"}

package/dist/src/utils/buildRawMessage.js

@@ -0,0 +1,151 @@
+import { randomBytes } from '@libp2p/crypto';
+import { publicKeyFromProtobuf } from '@libp2p/crypto/keys';
+import { peerIdFromMultihash } from '@libp2p/peer-id';
+import * as Digest from 'multiformats/hashes/digest';
+import { concat as uint8ArrayConcat } from 'uint8arrays/concat';
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string';
+import { toString as uint8ArrayToString } from 'uint8arrays/to-string';
+import { StrictSign, StrictNoSign } from "../index.js";
+import { RPC } from '../message/rpc.js';
+import { PublishConfigType, ValidateError } from '../types.js';
+export const SignPrefix = uint8ArrayFromString('libp2p-pubsub:');
+export async function buildRawMessage(publishConfig, topic, originalData, transformedData) {
+    switch (publishConfig.type) {
+        case PublishConfigType.Signing: {
+            const rpcMsg = {
+                from: publishConfig.author.toMultihash().bytes,
+                data: transformedData,
+                seqno: randomBytes(8),
+                topic,
+                signature: undefined, // Exclude signature field for signing
+                key: undefined // Exclude key field for signing
+            };
+            // Get the message in bytes, and prepend with the pubsub prefix
+            // the signature is over the bytes "libp2p-pubsub:<protobuf-message>"
+            const bytes = uint8ArrayConcat([SignPrefix, RPC.Message.encode(rpcMsg)]);
+            rpcMsg.signature = await publishConfig.privateKey.sign(bytes);
+            rpcMsg.key = publishConfig.key;
+            const msg = {
+                type: 'signed',
+                from: publishConfig.author,
+                data: originalData,
+                sequenceNumber: BigInt(`0x${uint8ArrayToString(rpcMsg.seqno ?? new Uint8Array(0), 'base16')}`),
+                topic,
+                signature: rpcMsg.signature,
+                key: publicKeyFromProtobuf(rpcMsg.key)
+            };
+            return {
+                raw: rpcMsg,
+                msg
+            };
+        }
+        case PublishConfigType.Anonymous: {
+            return {
+                raw: {
+                    from: undefined,
+                    data: transformedData,
+                    seqno: undefined,
+                    topic,
+                    signature: undefined,
+                    key: undefined
+                },
+                msg: {
+                    type: 'unsigned',
+                    data: originalData,
+                    topic
+                }
+            };
+        }
+        default:
+            throw new Error('Unreachable');
+    }
+}
+export async function validateToRawMessage(signaturePolicy, msg) {
+    // If strict-sign, verify all
+    // If anonymous (no-sign), ensure no preven
+    switch (signaturePolicy) {
+        case StrictNoSign:
+            if (msg.signature != null) {
+                return { valid: false, error: ValidateError.SignaturePresent };
+            }
+            if (msg.seqno != null) {
+                return { valid: false, error: ValidateError.SeqnoPresent };
+            }
+            if (msg.key != null) {
+                return { valid: false, error: ValidateError.FromPresent };
+            }
+            return { valid: true, message: { type: 'unsigned', topic: msg.topic, data: msg.data ?? new Uint8Array(0) } };
+        case StrictSign: {
+            // Verify seqno
+            if (msg.seqno == null) {
+                return { valid: false, error: ValidateError.InvalidSeqno };
+            }
+            if (msg.seqno.length !== 8) {
+                return { valid: false, error: ValidateError.InvalidSeqno };
+            }
+            if (msg.signature == null) {
+                return { valid: false, error: ValidateError.InvalidSignature };
+            }
+            if (msg.from == null) {
+                return { valid: false, error: ValidateError.InvalidPeerId };
+            }
+            let fromPeerId;
+            try {
+                // TODO: Fix PeerId types
+                fromPeerId = peerIdFromMultihash(Digest.decode(msg.from));
+            }
+            catch (e) {
+                return { valid: false, error: ValidateError.InvalidPeerId };
+            }
+            // - check from defined
+            // - transform source to PeerId
+            // - parse signature
+            // - get .key, else from source
+            // - check key == source if present
+            // - verify sig
+            let publicKey;
+            if (msg.key != null) {
+                publicKey = publicKeyFromProtobuf(msg.key);
+                // TODO: Should `fromPeerId.pubKey` be optional?
+                if (fromPeerId.publicKey !== undefined && !publicKey.equals(fromPeerId.publicKey)) {
+                    return { valid: false, error: ValidateError.InvalidPeerId };
+                }
+            }
+            else {
+                if (fromPeerId.publicKey == null) {
+                    return { valid: false, error: ValidateError.InvalidPeerId };
+                }
+                publicKey = fromPeerId.publicKey;
+            }
+            const rpcMsgPreSign = {
+                from: msg.from,
+                data: msg.data,
+                seqno: msg.seqno,
+                topic: msg.topic,
+                signature: undefined, // Exclude signature field for signing
+                key: undefined // Exclude key field for signing
+            };
+            // Get the message in bytes, and prepend with the pubsub prefix
+            // the signature is over the bytes "libp2p-pubsub:<protobuf-message>"
+            const bytes = uint8ArrayConcat([SignPrefix, RPC.Message.encode(rpcMsgPreSign)]);
+            if (!(await publicKey.verify(bytes, msg.signature))) {
+                return { valid: false, error: ValidateError.InvalidSignature };
+            }
+            return {
+                valid: true,
+                message: {
+                    type: 'signed',
+                    from: fromPeerId,
+                    data: msg.data ?? new Uint8Array(0),
+                    sequenceNumber: BigInt(`0x${uint8ArrayToString(msg.seqno, 'base16')}`),
+                    topic: msg.topic,
+                    signature: msg.signature,
+                    key: msg.key != null ? publicKeyFromProtobuf(msg.key) : publicKey
+                }
+            };
+        }
+        default:
+            throw new Error('Unreachable');
+    }
+}
+//# sourceMappingURL=buildRawMessage.js.map

package/dist/src/utils/buildRawMessage.js.map

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

package/dist/src/utils/create-gossip-rpc.d.ts

@@ -0,0 +1,7 @@
+import type { RPC } from '../message/rpc.js';
+/**
+ * Create a gossipsub RPC object
+ */
+export declare function createGossipRpc(messages?: RPC.Message[], control?: Partial<RPC.ControlMessage>): RPC;
+export declare function ensureControl(rpc: RPC): Required<RPC>;
+//# sourceMappingURL=create-gossip-rpc.d.ts.map

package/dist/src/utils/create-gossip-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-gossip-rpc.d.ts","sourceRoot":"","sources":["../../../src/utils/create-gossip-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAE5C;;GAEG;AACH,wBAAgB,eAAe,CAAE,QAAQ,GAAE,GAAG,CAAC,OAAO,EAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAczG;AAED,wBAAgB,aAAa,CAAE,GAAG,EAAE,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAYtD"}

package/dist/src/utils/create-gossip-rpc.js

@@ -0,0 +1,31 @@
+/**
+ * Create a gossipsub RPC object
+ */
+export function createGossipRpc(messages = [], control) {
+    return {
+        subscriptions: [],
+        messages,
+        control: control !== undefined
+            ? {
+                graft: control.graft ?? [],
+                prune: control.prune ?? [],
+                ihave: control.ihave ?? [],
+                iwant: control.iwant ?? [],
+                idontwant: control.idontwant ?? []
+            }
+            : undefined
+    };
+}
+export function ensureControl(rpc) {
+    if (rpc.control === undefined) {
+        rpc.control = {
+            graft: [],
+            prune: [],
+            ihave: [],
+            iwant: [],
+            idontwant: []
+        };
+    }
+    return rpc;
+}
+//# sourceMappingURL=create-gossip-rpc.js.map

package/dist/src/utils/create-gossip-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-gossip-rpc.js","sourceRoot":"","sources":["../../../src/utils/create-gossip-rpc.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAE,WAA0B,EAAE,EAAE,OAAqC;IAClG,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,QAAQ;QACR,OAAO,EAAE,OAAO,KAAK,SAAS;YAC5B,CAAC,CAAC;gBACE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;aACnC;YACH,CAAC,CAAC,SAAS;KACd,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAE,GAAQ;IACrC,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,GAAG;YACZ,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd,CAAA;IACH,CAAC;IAED,OAAO,GAAoB,CAAA;AAC7B,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './shuffle.js';
+export * from './messageIdToString.js';
+export { getPublishConfigFromPeerId } from './publishConfig.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/src/utils/index.js

@@ -0,0 +1,4 @@
+export * from './shuffle.js';
+export * from './messageIdToString.js';
+export { getPublishConfigFromPeerId } from './publishConfig.js';
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/src/utils/messageIdToString.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Browser friendly function to convert Uint8Array message id to base64 string.
+ */
+export declare function messageIdToString(msgId: Uint8Array): string;
+//# sourceMappingURL=messageIdToString.d.ts.map

package/dist/src/utils/messageIdToString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageIdToString.d.ts","sourceRoot":"","sources":["../../../src/utils/messageIdToString.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,iBAAiB,CAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D"}

package/dist/src/utils/messageIdToString.js

@@ -0,0 +1,8 @@
+import { toString } from 'uint8arrays/to-string';
+/**
+ * Browser friendly function to convert Uint8Array message id to base64 string.
+ */
+export function messageIdToString(msgId) {
+    return toString(msgId, 'base64');
+}
+//# sourceMappingURL=messageIdToString.js.map

package/dist/src/utils/messageIdToString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageIdToString.js","sourceRoot":"","sources":["../../../src/utils/messageIdToString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAE,KAAiB;IAClD,OAAO,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAClC,CAAC"}

package/dist/src/utils/msgIdFn.d.ts

@@ -0,0 +1,10 @@
+import type { Message } from '../index.js';
+/**
+ * Generate a message id, based on the `key` and `seqno`
+ */
+export declare function msgIdFnStrictSign(msg: Message): Uint8Array;
+/**
+ * Generate a message id, based on message `data`
+ */
+export declare function msgIdFnStrictNoSign(msg: Message): Promise<Uint8Array>;
+//# sourceMappingURL=msgIdFn.d.ts.map

package/dist/src/utils/msgIdFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgIdFn.d.ts","sourceRoot":"","sources":["../../../src/utils/msgIdFn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C;;GAEG;AACH,wBAAgB,iBAAiB,CAAE,GAAG,EAAE,OAAO,GAAG,UAAU,CAS3D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAE5E"}

package/dist/src/utils/msgIdFn.js

@@ -0,0 +1,23 @@
+import { msgId } from '@libp2p/pubsub/utils';
+import { sha256 } from 'multiformats/hashes/sha2';
+/**
+ * Generate a message id, based on the `key` and `seqno`
+ */
+export function msgIdFnStrictSign(msg) {
+    if (msg.type !== 'signed') {
+        throw new Error('expected signed message type');
+    }
+    // Should never happen
+    if (msg.sequenceNumber == null) {
+        throw Error('missing seqno field');
+    }
+    // TODO: Should use .from here or key?
+    return msgId(msg.from.publicKey ?? msg.key, msg.sequenceNumber);
+}
+/**
+ * Generate a message id, based on message `data`
+ */
+export async function msgIdFnStrictNoSign(msg) {
+    return sha256.encode(msg.data);
+}
+//# sourceMappingURL=msgIdFn.js.map

package/dist/src/utils/msgIdFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgIdFn.js","sourceRoot":"","sources":["../../../src/utils/msgIdFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAGjD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAE,GAAY;IAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IACD,sBAAsB;IACtB,IAAI,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAA;IAAC,CAAC;IAEtE,sCAAsC;IACtC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAA;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAE,GAAY;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAChC,CAAC"}

package/dist/src/utils/multiaddr.d.ts

@@ -0,0 +1,3 @@
+import type { Multiaddr } from '@multiformats/multiaddr';
+export declare function multiaddrToIPStr(multiaddr: Multiaddr): string | null;
+//# sourceMappingURL=multiaddr.d.ts.map

package/dist/src/utils/multiaddr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiaddr.d.ts","sourceRoot":"","sources":["../../../src/utils/multiaddr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,wBAAgB,gBAAgB,CAAE,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAerE"}

package/dist/src/utils/multiaddr.js

@@ -0,0 +1,15 @@
+import { getNetConfig, isNetworkAddress } from '@libp2p/utils';
+export function multiaddrToIPStr(multiaddr) {
+    if (isNetworkAddress(multiaddr)) {
+        const config = getNetConfig(multiaddr);
+        switch (config.type) {
+            case 'ip4':
+            case 'ip6':
+                return config.host;
+            default:
+                break;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=multiaddr.js.map

package/dist/src/utils/multiaddr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiaddr.js","sourceRoot":"","sources":["../../../src/utils/multiaddr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAG9D,MAAM,UAAU,gBAAgB,CAAE,SAAoB;IACpD,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;QAEtC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,KAAK,CAAC;YACX,KAAK,KAAK;gBAER,OAAO,MAAM,CAAC,IAAI,CAAA;YACpB;gBACE,MAAK;QACT,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/src/utils/publishConfig.d.ts

@@ -0,0 +1,8 @@
+import { StrictSign, StrictNoSign } from '../index.ts';
+import type { PublishConfig } from '../types.js';
+import type { PeerId, PrivateKey } from '@libp2p/interface';
+/**
+ * Prepare a PublishConfig object from a PeerId.
+ */
+export declare function getPublishConfigFromPeerId(signaturePolicy: typeof StrictSign | typeof StrictNoSign, peerId: PeerId, privateKey: PrivateKey): PublishConfig;
+//# sourceMappingURL=publishConfig.d.ts.map

package/dist/src/utils/publishConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/publishConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE3D;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,OAAO,UAAU,GAAG,OAAO,YAAY,EACxD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,aAAa,CAmBf"}

package/dist/src/utils/publishConfig.js

@@ -0,0 +1,25 @@
+import { publicKeyToProtobuf } from '@libp2p/crypto/keys';
+import { StrictSign, StrictNoSign } from "../index.js";
+import { PublishConfigType } from '../types.js';
+/**
+ * Prepare a PublishConfig object from a PeerId.
+ */
+export function getPublishConfigFromPeerId(signaturePolicy, peerId, privateKey) {
+    switch (signaturePolicy) {
+        case StrictSign: {
+            return {
+                type: PublishConfigType.Signing,
+                author: peerId,
+                key: publicKeyToProtobuf(privateKey.publicKey),
+                privateKey
+            };
+        }
+        case StrictNoSign:
+            return {
+                type: PublishConfigType.Anonymous
+            };
+        default:
+            throw new Error(`Unknown signature policy "${signaturePolicy}"`);
+    }
+}
+//# sourceMappingURL=publishConfig.js.map