@waku/core 0.0.26 → 0.0.28-070b625.0

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

@@ -1,29 +1,10 @@
-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 };
-
-/**
- * To guarantee Uint8Array semantics, convert nodejs Buffers
- * into vanilla Uint8Arrays
- */
-function asUint8Array(buf) {
-    if (globalThis.Buffer != null) {
-        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
-    }
-    return buf;
-}
+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';
 
 /**
  * Returns a `Uint8Array` of the requested size. Referenced memory will
  * be initialized to 0.
  */
 function alloc(size = 0) {
-    if (globalThis.Buffer?.alloc != null) {
-        return asUint8Array(globalThis.Buffer.alloc(size));
-    }
     return new Uint8Array(size);
 }
 /**
@@ -32,12 +13,11 @@ function alloc(size = 0) {
  * overwrite every value in the returned `Uint8Array`.
  */
 function allocUnsafe(size = 0) {
-    if (globalThis.Buffer?.allocUnsafe != null) {
-        return asUint8Array(globalThis.Buffer.allocUnsafe(size));
-    }
     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 +63,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
  *
@@ -114,23 +75,20 @@ function fromString(string, encoding = 'utf8') {
     if (base == null) {
         throw new Error(`Unsupported encoding "${encoding}"`);
     }
-    if ((encoding === 'utf8' || encoding === 'utf-8') && globalThis.Buffer != null && globalThis.Buffer.from != null) {
-        return asUint8Array(globalThis.Buffer.from(string, 'utf-8'));
-    }
     // add multibase prefix
     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(a) {
+    return (a instanceof Uint8Array ||
+        (a != null && typeof a === 'object' && a.constructor.name === 'Uint8Array'));
+}
 function bytes(b, ...lengths) {
-    if (!(b instanceof Uint8Array))
-        throw new Error('Expected Uint8Array');
+    if (!isBytes(b))
+        throw new Error('Uint8Array expected');
     if (lengths.length > 0 && !lengths.includes(b.length))
-        throw new Error(`Expected Uint8Array of length ${lengths}, not of length=${b.length}`);
+        throw new Error(`Uint8Array expected of length ${lengths}, not of length=${b.length}`);
 }
 function exists(instance, checkFinished = true) {
     if (instance.destroyed)
@@ -152,17 +110,12 @@ 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.
 // 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.
-const isLE = new Uint8Array(new Uint32Array([0x11223344]).buffer)[0] === 0x44;
-if (!isLE)
-    throw new Error('Non little-endian hardware is not supported');
+new Uint8Array(new Uint32Array([0x11223344]).buffer)[0] === 0x44;
 /**
  * @example utf8ToBytes('abc') // new Uint8Array([97, 98, 99])
  */
@@ -179,8 +132,7 @@ function utf8ToBytes$1(str) {
 function toBytes(data) {
     if (typeof data === 'string')
         data = utf8ToBytes$1(data);
-    if (!u8a(data))
-        throw new Error(`expected Uint8Array, got ${typeof data}`);
+    bytes(data);
     return data;
 }
 // For runtime check if class implements interface
@@ -212,8 +164,15 @@ function setBigUint64(view, byteOffset, value, isLE) {
     view.setUint32(byteOffset + h, wh, isLE);
     view.setUint32(byteOffset + l, wl, isLE);
 }
-// Base SHA2 class (RFC 6234)
-class SHA2 extends Hash {
+// Choice: a ? b : c
+const Chi = (a, b, c) => (a & b) ^ (~a & c);
+// Majority function, true if any two inpust is true
+const Maj = (a, b, c) => (a & b) ^ (a & c) ^ (b & c);
+/**
+ * Merkle-Damgard hash construction base class.
+ * Could be used to create MD5, RIPEMD, SHA1, SHA2.
+ */
+class HashMD extends Hash {
     constructor(blockLen, outputLen, padOffset, isLE) {
         super();
         this.blockLen = blockLen;
@@ -265,7 +224,8 @@ class SHA2 extends Hash {
         // append the bit '1' to the message
         buffer[pos++] = 0b10000000;
         this.buffer.subarray(pos).fill(0);
-        // we have less than padOffset left in buffer, so we cannot put length in current block, need process it and pad again
+        // we have less than padOffset left in buffer, so we cannot put length in
+        // current block, need process it and pad again
         if (this.padOffset > blockLen - pos) {
             this.process(view, 0);
             pos = 0;
@@ -313,10 +273,6 @@ class SHA2 extends Hash {
 
 // SHA2-256 need to try 2^128 hashes to execute birthday attack.
 // BTC network is doing 2^67 hashes/sec as per early 2023.
-// Choice: a ? b : c
-const Chi = (a, b, c) => (a & b) ^ (~a & c);
-// Majority function, true if any two inpust is true
-const Maj = (a, b, c) => (a & b) ^ (a & c) ^ (b & c);
 // Round constants:
 // first 32 bits of the fractional parts of the cube roots of the first 64 primes 2..311)
 // prettier-ignore
@@ -330,27 +286,28 @@ const SHA256_K = /* @__PURE__ */ new Uint32Array([
     0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
     0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
 ]);
-// Initial state (first 32 bits of the fractional parts of the square roots of the first 8 primes 2..19):
+// Initial state:
+// first 32 bits of the fractional parts of the square roots of the first 8 primes 2..19
 // prettier-ignore
-const IV = /* @__PURE__ */ new Uint32Array([
+const SHA256_IV = /* @__PURE__ */ new Uint32Array([
     0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19
 ]);
 // Temporary buffer, not used to store anything between runs
 // Named this way because it matches specification.
 const SHA256_W = /* @__PURE__ */ new Uint32Array(64);
-class SHA256 extends SHA2 {
+class SHA256 extends HashMD {
     constructor() {
         super(64, 32, 8, false);
         // We cannot use array here since array allows indexing by variable
         // which means optimizer/compiler cannot use registers.
-        this.A = IV[0] | 0;
-        this.B = IV[1] | 0;
-        this.C = IV[2] | 0;
-        this.D = IV[3] | 0;
-        this.E = IV[4] | 0;
-        this.F = IV[5] | 0;
-        this.G = IV[6] | 0;
-        this.H = IV[7] | 0;
+        this.A = SHA256_IV[0] | 0;
+        this.B = SHA256_IV[1] | 0;
+        this.C = SHA256_IV[2] | 0;
+        this.D = SHA256_IV[3] | 0;
+        this.E = SHA256_IV[4] | 0;
+        this.F = SHA256_IV[5] | 0;
+        this.G = SHA256_IV[6] | 0;
+        this.H = SHA256_IV[7] | 0;
     }
     get() {
         const { A, B, C, D, E, F, G, H } = this;
@@ -419,6 +376,31 @@ 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}"`);
+    }
+    // strip multibase prefix
+    return base.encoder.encode(array).substring(1);
+}
+
 /**
  * Decode byte array to utf-8 string.
  */
@@ -447,9 +429,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 +437,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`)
+            contentTopicToPubsubTopic(`/${shardInfo.application}/${shardInfo.version}/default/default`, shardInfo.clusterId)
         ];
     }
+    else {
+        throw new Error("Missing required configuration in shard parameters");
+    }
 };
 const pubsubTopicToSingleShardInfo = (pubsubTopics) => {
     const parts = pubsubTopics.split("/");
@@ -482,6 +465,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 +529,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 +548,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`, clusterId);
+        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 +620,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, allocUnsafe as a, bytesToUtf8 as b, concat as c, alloc as d, singleShardInfoToPubsubTopic as e, ensurePubsubTopicIsConfigured as f, shardInfoToPubsubTopics as g, fromString as h, determinePubsubTopic as i, ensureShardingConfigured as j, pubsubTopicToSingleShardInfo as p, sha256 as s, utf8ToBytes as u };