@waku/core 0.0.26 → 0.0.28-434be7b.0

package/bundle/{index-cmONXM-V.js → index-vlQahmUj.js}

@@ -1,9 +1,4 @@
-import { i as identityBase, j as base2, k as base8, l as base10, m as base16, n as base32, o as base36, p as base58, q as base64, r as base256emoji, s as debug } from './browser-mTOOnVZp.js';
-
-// @ts-check
-
-
-const bases = { ...identityBase, ...base2, ...base8, ...base10, ...base16, ...base32, ...base36, ...base58, ...base64, ...base256emoji };
+import { i as identityBase, c as base2, d as base8, e as base10, f as base16, h as base32, j as base36, k as base58, l as base64, m as base256emoji, n as debug } from './browser-DoQRY-an.js';
 
 /**
  * To guarantee Uint8Array semantics, convert nodejs Buffers
@@ -38,6 +33,8 @@ function allocUnsafe(size = 0) {
     return new Uint8Array(size);
 }
 
+const bases = { ...identityBase, ...base2, ...base8, ...base10, ...base16, ...base32, ...base36, ...base58, ...base64, ...base256emoji };
+
 function createCodec(name, prefix, encode, decode) {
     return {
         name,
@@ -83,25 +80,6 @@ const BASES = {
     ...bases
 };
 
-/**
- * Turns a `Uint8Array` into a string.
- *
- * Supports `utf8`, `utf-8` and any encoding supported by the multibase module.
- *
- * Also `ascii` which is similar to node's 'binary' encoding.
- */
-function toString(array, encoding = 'utf8') {
-    const base = BASES[encoding];
-    if (base == null) {
-        throw new Error(`Unsupported encoding "${encoding}"`);
-    }
-    if ((encoding === 'utf8' || encoding === 'utf-8') && globalThis.Buffer != null && globalThis.Buffer.from != null) {
-        return globalThis.Buffer.from(array.buffer, array.byteOffset, array.byteLength).toString('utf8');
-    }
-    // strip multibase prefix
-    return base.encoder.encode(array).substring(1);
-}
-
 /**
  * Create a `Uint8Array` from the passed string
  *
@@ -121,13 +99,13 @@ function fromString(string, encoding = 'utf8') {
     return base.decoder.decode(`${base.prefix}${string}`); // eslint-disable-line @typescript-eslint/restrict-template-expressions
 }
 
-/**
- * DefaultPubsubTopic is the default gossipsub topic to use for Waku.
- */
-const DefaultPubsubTopic = "/waku/2/default-waku/proto";
-
+// copied from utils
+function isBytes$1(a) {
+    return (a instanceof Uint8Array ||
+        (a != null && typeof a === 'object' && a.constructor.name === 'Uint8Array'));
+}
 function bytes(b, ...lengths) {
-    if (!(b instanceof Uint8Array))
+    if (!isBytes$1(b))
         throw new Error('Expected Uint8Array');
     if (lengths.length > 0 && !lengths.includes(b.length))
         throw new Error(`Expected Uint8Array of length ${lengths}, not of length=${b.length}`);
@@ -152,14 +130,19 @@ function output(out, instance) {
 // For node.js, package.json#exports field mapping rewrites import
 // from `crypto` to `cryptoNode`, which imports native module.
 // Makes the utils un-importable in browsers without a bundler.
-// Once node.js 18 is deprecated, we can just drop the import.
-const u8a = (a) => a instanceof Uint8Array;
+// Once node.js 18 is deprecated (2025-04-30), we can just drop the import.
+function isBytes(a) {
+    return (a instanceof Uint8Array ||
+        (a != null && typeof a === 'object' && a.constructor.name === 'Uint8Array'));
+}
 // Cast array to view
 const createView = (arr) => new DataView(arr.buffer, arr.byteOffset, arr.byteLength);
 // The rotate right (circular right shift) operation for uint32
 const rotr = (word, shift) => (word << (32 - shift)) | (word >>> shift);
 // big-endian hardware is rare. Just in case someone still decides to run hashes:
 // early-throw an error because we don't support BE yet.
+// Other libraries would silently corrupt the data instead of throwing an error,
+// when they don't support it.
 const isLE = new Uint8Array(new Uint32Array([0x11223344]).buffer)[0] === 0x44;
 if (!isLE)
     throw new Error('Non little-endian hardware is not supported');
@@ -179,7 +162,7 @@ function utf8ToBytes$1(str) {
 function toBytes(data) {
     if (typeof data === 'string')
         data = utf8ToBytes$1(data);
-    if (!u8a(data))
+    if (!isBytes(data))
         throw new Error(`expected Uint8Array, got ${typeof data}`);
     return data;
 }
@@ -419,6 +402,34 @@ class SHA256 extends SHA2 {
  */
 const sha256 = /* @__PURE__ */ wrapConstructor(() => new SHA256());
 
+/**
+ * DefaultPubsubTopic is the default gossipsub topic to use for Waku.
+ */
+const DefaultPubsubTopic = "/waku/2/default-waku/proto";
+/**
+ * The default cluster ID for The Waku Network
+ */
+const DEFAULT_CLUSTER_ID = 1;
+
+/**
+ * Turns a `Uint8Array` into a string.
+ *
+ * Supports `utf8`, `utf-8` and any encoding supported by the multibase module.
+ *
+ * Also `ascii` which is similar to node's 'binary' encoding.
+ */
+function toString(array, encoding = 'utf8') {
+    const base = BASES[encoding];
+    if (base == null) {
+        throw new Error(`Unsupported encoding "${encoding}"`);
+    }
+    if ((encoding === 'utf8' || encoding === 'utf-8') && globalThis.Buffer != null && globalThis.Buffer.from != null) {
+        return globalThis.Buffer.from(array.buffer, array.byteOffset, array.byteLength).toString('utf8');
+    }
+    // strip multibase prefix
+    return base.encoder.encode(array).substring(1);
+}
+
 /**
  * Decode byte array to utf-8 string.
  */
@@ -447,9 +458,7 @@ const singleShardInfoToPubsubTopic = (shardInfo) => {
     return `/waku/2/rs/${shardInfo.clusterId}/${shardInfo.shard}`;
 };
 const shardInfoToPubsubTopics = (shardInfo) => {
-    if (shardInfo.clusterId === undefined)
-        throw new Error("Cluster ID must be specified");
-    if ("contentTopics" in shardInfo) {
+    if ("contentTopics" in shardInfo && shardInfo.contentTopics) {
         // Autosharding: explicitly defined content topics
         return Array.from(new Set(shardInfo.contentTopics.map((contentTopic) => contentTopicToPubsubTopic(contentTopic, shardInfo.clusterId))));
     }
@@ -457,14 +466,17 @@ const shardInfoToPubsubTopics = (shardInfo) => {
         // Static sharding
         if (shardInfo.shards === undefined)
             throw new Error("Invalid shard");
-        return Array.from(new Set(shardInfo.shards.map((index) => `/waku/2/rs/${shardInfo.clusterId}/${index}`)));
+        return Array.from(new Set(shardInfo.shards.map((index) => `/waku/2/rs/${shardInfo.clusterId ?? DEFAULT_CLUSTER_ID}/${index}`)));
     }
-    else {
+    else if ("application" in shardInfo && "version" in shardInfo) {
         // Autosharding: single shard from application and version
         return [
             contentTopicToPubsubTopic(`/${shardInfo.application}/${shardInfo.version}/default/default`)
         ];
     }
+    else {
+        throw new Error("Missing required configuration in shard parameters");
+    }
 };
 const pubsubTopicToSingleShardInfo = (pubsubTopics) => {
     const parts = pubsubTopics.split("/");
@@ -482,6 +494,8 @@ const pubsubTopicToSingleShardInfo = (pubsubTopics) => {
         shard
     };
 };
+//TODO: move part of BaseProtocol instead of utils
+// return `ProtocolError.TOPIC_NOT_CONFIGURED` instead of throwing
 function ensurePubsubTopicIsConfigured(pubsubTopic, configuredTopics) {
     if (!configuredTopics.includes(pubsubTopic)) {
         throw new Error(`Pubsub topic ${pubsubTopic} has not been configured on this instance. Configured topics are: ${configuredTopics}. Please update your configuration by passing in the topic during Waku node instantiation.`);
@@ -544,7 +558,7 @@ function contentTopicToShardIndex(contentTopic, networkShards = 8) {
     const dataview = new DataView(digest.buffer.slice(-8));
     return Number(dataview.getBigUint64(0, false) % BigInt(networkShards));
 }
-function contentTopicToPubsubTopic(contentTopic, clusterId = 1, networkShards = 8) {
+function contentTopicToPubsubTopic(contentTopic, clusterId = DEFAULT_CLUSTER_ID, networkShards = 8) {
     const shardIndex = contentTopicToShardIndex(contentTopic, networkShards);
     return `/waku/2/rs/${clusterId}/${shardIndex}`;
 }
@@ -563,6 +577,49 @@ function determinePubsubTopic(contentTopic, pubsubTopicShardInfo = DefaultPubsub
             : DefaultPubsubTopic;
     }
 }
+/**
+ * Validates sharding configuration and sets defaults where possible.
+ * @returns Validated sharding parameters, with any missing values set to defaults
+ */
+const ensureShardingConfigured = (shardInfo) => {
+    const clusterId = shardInfo.clusterId ?? DEFAULT_CLUSTER_ID;
+    const shards = "shards" in shardInfo ? shardInfo.shards : [];
+    const contentTopics = "contentTopics" in shardInfo ? shardInfo.contentTopics : [];
+    const [application, version] = "application" in shardInfo && "version" in shardInfo
+        ? [shardInfo.application, shardInfo.version]
+        : [undefined, undefined];
+    const isShardsConfigured = shards && shards.length > 0;
+    const isContentTopicsConfigured = contentTopics && contentTopics.length > 0;
+    const isApplicationVersionConfigured = application && version;
+    if (isShardsConfigured) {
+        return {
+            shardingParams: { clusterId, shards },
+            shardInfo: { clusterId, shards },
+            pubsubTopics: shardInfoToPubsubTopics({ clusterId, shards })
+        };
+    }
+    if (isContentTopicsConfigured) {
+        const pubsubTopics = Array.from(new Set(contentTopics.map((topic) => contentTopicToPubsubTopic(topic, clusterId))));
+        const shards = Array.from(new Set(contentTopics.map((topic) => contentTopicToShardIndex(topic))));
+        return {
+            shardingParams: { clusterId, contentTopics },
+            shardInfo: { clusterId, shards },
+            pubsubTopics
+        };
+    }
+    if (isApplicationVersionConfigured) {
+        const pubsubTopic = contentTopicToPubsubTopic(`/${application}/${version}/default/default`);
+        return {
+            shardingParams: { clusterId, application, version },
+            shardInfo: {
+                clusterId,
+                shards: [pubsubTopicToSingleShardInfo(pubsubTopic).shard]
+            },
+            pubsubTopics: [pubsubTopic]
+        };
+    }
+    throw new Error("Missing minimum required configuration options for static sharding or autosharding.");
+};
 
 const APP_NAME = "waku";
 class Logger {
@@ -592,4 +649,4 @@ class Logger {
     }
 }
 
-export { DefaultPubsubTopic as D, Logger as L, allocUnsafe as a, asUint8Array as b, bases as c, alloc as d, singleShardInfoToPubsubTopic as e, fromString as f, ensurePubsubTopicIsConfigured as g, sha256 as h, concat as i, determinePubsubTopic as j, bytesToUtf8 as k, pubsubTopicToSingleShardInfo as p, shardInfoToPubsubTopics as s, toString as t, utf8ToBytes as u };
+export { DefaultPubsubTopic as D, Logger as L, asUint8Array as a, bytesToUtf8 as b, concat as c, allocUnsafe as d, alloc as e, singleShardInfoToPubsubTopic as f, ensurePubsubTopicIsConfigured as g, shardInfoToPubsubTopics as h, fromString as i, determinePubsubTopic as j, ensureShardingConfigured as k, pubsubTopicToSingleShardInfo as p, sha256 as s, utf8ToBytes as u };