@waku/core 0.0.36-16328a3.0 → 0.0.36-3730abc.0

package/dist/lib/light_push/light_push_v3.js

@@ -0,0 +1,172 @@
+import { ProtocolError } from "@waku/interfaces";
+import { proto_lightpush_v3 } from "@waku/proto";
+import { isMessageSizeUnderCap } from "@waku/utils";
+import { Logger } from "@waku/utils";
+import all from "it-all";
+import * as lp from "it-length-prefixed";
+import { pipe } from "it-pipe";
+import { Uint8ArrayList } from "uint8arraylist";
+import { BaseProtocol } from "../base_protocol.js";
+import { PushRpcV3 } from "./push_rpc_v3.js";
+import { getLightPushStatusDescriptionV3, isSuccessStatusCodeV3, lightPushStatusCodeToProtocolErrorV3, LightPushStatusCodeV3 } from "./status_codes_v3.js";
+import { isRLNResponseError } from "./utils.js";
+const log = new Logger("light-push-v3");
+export const LightPushCodecV3 = "/vac/waku/lightpush/3.0.0";
+export class LightPushCoreV3 extends BaseProtocol {
+    pubsubTopics;
+    constructor(pubsubTopics, libp2p) {
+        super(LightPushCodecV3, libp2p.components, pubsubTopics);
+        this.pubsubTopics = pubsubTopics;
+    }
+    async preparePushMessage(encoder, message) {
+        try {
+            if (!message.payload || message.payload.length === 0) {
+                log.error("Failed to send waku light push: payload is empty");
+                return { query: null, error: ProtocolError.EMPTY_PAYLOAD };
+            }
+            if (!(await isMessageSizeUnderCap(encoder, message))) {
+                log.error("Failed to send waku light push: message is bigger than 1MB");
+                return { query: null, error: ProtocolError.SIZE_TOO_BIG };
+            }
+            const protoMessage = await encoder.toProtoObj(message);
+            if (!protoMessage) {
+                log.error("Failed to encode to protoMessage, aborting push");
+                return {
+                    query: null,
+                    error: ProtocolError.ENCODE_FAILED
+                };
+            }
+            const query = PushRpcV3.createRequest(protoMessage, encoder.pubsubTopic);
+            return { query, error: null };
+        }
+        catch (error) {
+            log.error("Failed to prepare push message", error);
+            return {
+                query: null,
+                error: ProtocolError.GENERIC_FAIL
+            };
+        }
+    }
+    async send(encoder, message, peerId) {
+        const { query, error: preparationError } = await this.preparePushMessage(encoder, message);
+        if (preparationError || !query) {
+            return {
+                success: null,
+                failure: {
+                    error: preparationError,
+                    peerId
+                }
+            };
+        }
+        let stream;
+        try {
+            stream = await this.getStream(peerId);
+        }
+        catch (error) {
+            log.error("Failed to get stream", error);
+            return {
+                success: null,
+                failure: {
+                    error: ProtocolError.NO_STREAM_AVAILABLE,
+                    peerId: peerId
+                }
+            };
+        }
+        let res;
+        try {
+            res = await pipe([query.encode()], lp.encode, stream, lp.decode, async (source) => await all(source));
+        }
+        catch (err) {
+            log.error("Failed to send waku light push request", err);
+            return {
+                success: null,
+                failure: {
+                    error: ProtocolError.STREAM_ABORTED,
+                    peerId: peerId
+                }
+            };
+        }
+        const bytes = new Uint8ArrayList();
+        res.forEach((chunk) => {
+            bytes.append(chunk);
+        });
+        let response;
+        try {
+            response = proto_lightpush_v3.LightpushResponse.decode(bytes);
+        }
+        catch (err) {
+            log.error("Failed to decode push response", err);
+            return {
+                success: null,
+                failure: {
+                    error: ProtocolError.DECODE_FAILED,
+                    peerId: peerId
+                }
+            };
+        }
+        if (!response) {
+            log.error("Remote peer fault: No response received");
+            return {
+                success: null,
+                failure: {
+                    error: ProtocolError.NO_RESPONSE,
+                    peerId: peerId
+                }
+            };
+        }
+        // Validate request ID matches (except for rate limiting responses)
+        if (response.requestId !== query.query?.requestId) {
+            // nwaku sends "N/A" for rate limiting responses
+            if (response.statusCode !== LightPushStatusCodeV3.TOO_MANY_REQUESTS) {
+                log.error("Request ID mismatch", {
+                    sent: query.query?.requestId,
+                    received: response.requestId
+                });
+                return {
+                    success: null,
+                    failure: {
+                        error: ProtocolError.GENERIC_FAIL,
+                        peerId: peerId
+                    }
+                };
+            }
+        }
+        const statusCode = response.statusCode;
+        const isSuccess = isSuccessStatusCodeV3(statusCode);
+        // Special handling for nwaku rate limiting
+        if (statusCode === LightPushStatusCodeV3.TOO_MANY_REQUESTS) {
+            if (response.requestId === "N/A") {
+                log.warn("Rate limited by nwaku node", {
+                    statusDesc: response.statusDesc || "Request rejected due to too many requests"
+                });
+            }
+        }
+        if (response.relayPeerCount !== undefined) {
+            log.info(`Message relayed to ${response.relayPeerCount} peers`);
+        }
+        if (response.statusDesc && isRLNResponseError(response.statusDesc)) {
+            log.error("Remote peer fault: RLN generation");
+            return {
+                success: null,
+                failure: {
+                    error: ProtocolError.RLN_PROOF_GENERATION,
+                    peerId: peerId
+                }
+            };
+        }
+        if (!isSuccess) {
+            const errorMessage = getLightPushStatusDescriptionV3(statusCode, response.statusDesc);
+            log.error("Remote peer rejected the message: ", errorMessage);
+            const protocolError = lightPushStatusCodeToProtocolErrorV3(statusCode);
+            return {
+                success: null,
+                failure: {
+                    error: protocolError,
+                    peerId: peerId
+                }
+            };
+        }
+        return { success: peerId, failure: null };
+    }
+}
+//# sourceMappingURL=light_push_v3.js.map

package/dist/lib/light_push/light_push_v3.js.map

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

package/dist/lib/light_push/push_rpc.d.ts

@@ -3,7 +3,7 @@ import type { Uint8ArrayList } from "uint8arraylist";
 export declare class PushRpc {
     proto: proto.PushRpc;
     constructor(proto: proto.PushRpc);
-    static createRequest(message: proto.WakuMessage, pubsubTopic: string): PushRpc;
+    static createRequest(message: proto.WakuMessage, pubsubTopic?: string): PushRpc;
     static decode(bytes: Uint8ArrayList): PushRpc;
     encode(): Uint8Array;
     get query(): proto.PushRequest | undefined;

package/dist/lib/light_push/push_rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"push_rpc.js","sourceRoot":"","sources":["../../../src/lib/light_push/push_rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,MAAM,OAAO,OAAO;IACQ;IAA1B,YAA0B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAE3C,MAAM,CAAC,aAAa,CACzB,OAA0B,EAC1B,WAAmB;QAEnB,OAAO,IAAI,OAAO,CAAC;YACjB,SAAS,EAAE,IAAI,EAAE;YACjB,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,WAAW;aACzB;YACD,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAqB;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEM,MAAM;QACX,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"push_rpc.js","sourceRoot":"","sources":["../../../src/lib/light_push/push_rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,MAAM,OAAO,OAAO;IACQ;IAA1B,YAA0B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAE3C,MAAM,CAAC,aAAa,CACzB,OAA0B,EAC1B,WAAoB;QAEpB,OAAO,IAAI,OAAO,CAAC;YACjB,SAAS,EAAE,IAAI,EAAE;YACjB,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,WAAW;aACzB;YACD,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAqB;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEM,MAAM;QACX,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/lib/light_push/push_rpc_v2.d.ts

@@ -0,0 +1,11 @@
+import { proto_lightpush_v2 as proto } from "@waku/proto";
+import type { Uint8ArrayList } from "uint8arraylist";
+export declare class PushRpcV2 {
+    proto: proto.PushRpc;
+    constructor(proto: proto.PushRpc);
+    static createRequest(message: proto.WakuMessage, pubsubTopic: string): PushRpcV2;
+    static decode(bytes: Uint8ArrayList): PushRpcV2;
+    encode(): Uint8Array;
+    get query(): proto.PushRequest | undefined;
+    get response(): proto.PushResponse | undefined;
+}

package/dist/lib/light_push/push_rpc_v2.js

@@ -0,0 +1,32 @@
+import { proto_lightpush_v2 as proto } from "@waku/proto";
+import { v4 as uuid } from "uuid";
+export class PushRpcV2 {
+    proto;
+    constructor(proto) {
+        this.proto = proto;
+    }
+    static createRequest(message, pubsubTopic) {
+        return new PushRpcV2({
+            requestId: uuid(),
+            request: {
+                message: message,
+                pubsubTopic: pubsubTopic
+            },
+            response: undefined
+        });
+    }
+    static decode(bytes) {
+        const res = proto.PushRpc.decode(bytes);
+        return new PushRpcV2(res);
+    }
+    encode() {
+        return proto.PushRpc.encode(this.proto);
+    }
+    get query() {
+        return this.proto.request;
+    }
+    get response() {
+        return this.proto.response;
+    }
+}
+//# sourceMappingURL=push_rpc_v2.js.map

package/dist/lib/light_push/push_rpc_v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push_rpc_v2.js","sourceRoot":"","sources":["../../../src/lib/light_push/push_rpc_v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,KAAK,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,MAAM,OAAO,SAAS;IACM;IAA1B,YAA0B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAE3C,MAAM,CAAC,aAAa,CACzB,OAA0B,EAC1B,WAAmB;QAEnB,OAAO,IAAI,SAAS,CAAC;YACnB,SAAS,EAAE,IAAI,EAAE;YACjB,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,WAAW;aACzB;YACD,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAqB;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAEM,MAAM;QACX,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/lib/light_push/push_rpc_v3.d.ts

@@ -0,0 +1,11 @@
+import { proto_lightpush_v3, WakuMessage } from "@waku/proto";
+import type { Uint8ArrayList } from "uint8arraylist";
+export declare class PushRpcV3 {
+    request?: proto_lightpush_v3.LightpushRequest;
+    response?: proto_lightpush_v3.LightpushResponse;
+    private constructor();
+    static createRequest(message: WakuMessage, pubsubTopic?: string): PushRpcV3;
+    static decode(bytes: Uint8ArrayList | Uint8Array): PushRpcV3;
+    encode(): Uint8Array;
+    get query(): proto_lightpush_v3.LightpushRequest | undefined;
+}

package/dist/lib/light_push/push_rpc_v3.js

@@ -0,0 +1,33 @@
+import { proto_lightpush_v3 } from "@waku/proto";
+import { v4 as uuid } from "uuid";
+export class PushRpcV3 {
+    request;
+    response;
+    constructor(request, response) {
+        this.request = request;
+        this.response = response;
+    }
+    static createRequest(message, pubsubTopic) {
+        const request = {
+            requestId: uuid(),
+            message: message,
+            // Only include pubsubTopic if explicitly provided (for nwaku autosharding compatibility)
+            ...(pubsubTopic && { pubsubTopic })
+        };
+        return new PushRpcV3(request, undefined);
+    }
+    static decode(bytes) {
+        const response = proto_lightpush_v3.LightpushResponse.decode(bytes);
+        return new PushRpcV3(undefined, response);
+    }
+    encode() {
+        if (!this.request) {
+            throw new Error("Cannot encode without a request");
+        }
+        return proto_lightpush_v3.LightpushRequest.encode(this.request);
+    }
+    get query() {
+        return this.request;
+    }
+}
+//# sourceMappingURL=push_rpc_v3.js.map

package/dist/lib/light_push/push_rpc_v3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push_rpc_v3.js","sourceRoot":"","sources":["../../../src/lib/light_push/push_rpc_v3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,MAAM,OAAO,SAAS;IACb,OAAO,CAAuC;IAC9C,QAAQ,CAAwC;IAEvD,YACE,OAA6C,EAC7C,QAA+C;QAE/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,aAAa,CACzB,OAAoB,EACpB,WAAoB;QAEpB,MAAM,OAAO,GAAwC;YACnD,SAAS,EAAE,IAAI,EAAE;YACjB,OAAO,EAAE,OAAO;YAChB,yFAAyF;YACzF,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;SACpC,CAAC;QAEF,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAkC;QACrD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,kBAAkB,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/lib/light_push/status_codes.d.ts

@@ -0,0 +1,14 @@
+import { ProtocolError } from "@waku/interfaces";
+export declare enum LightPushStatusCode {
+    SUCCESS = 200,
+    BAD_REQUEST = 400,
+    UNSUPPORTED_PUBSUB_TOPIC = 404,
+    REQUEST_TOO_LARGE = 413,
+    TOO_MANY_REQUESTS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    NO_PEERS_TO_RELAY = 503
+}
+export declare function lightPushStatusCodeToProtocolError(statusCode: number): ProtocolError | null;
+export declare const lightPushStatusDescriptions: Record<number, string>;
+export declare function isSuccessStatusCode(statusCode: number): boolean;
+export declare function getLightPushStatusDescription(statusCode: number, statusDesc?: string): string;

package/dist/lib/light_push/status_codes.js

@@ -0,0 +1,49 @@
+import { ProtocolError } from "@waku/interfaces";
+export var LightPushStatusCode;
+(function (LightPushStatusCode) {
+    LightPushStatusCode[LightPushStatusCode["SUCCESS"] = 200] = "SUCCESS";
+    LightPushStatusCode[LightPushStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    LightPushStatusCode[LightPushStatusCode["UNSUPPORTED_PUBSUB_TOPIC"] = 404] = "UNSUPPORTED_PUBSUB_TOPIC";
+    LightPushStatusCode[LightPushStatusCode["REQUEST_TOO_LARGE"] = 413] = "REQUEST_TOO_LARGE";
+    LightPushStatusCode[LightPushStatusCode["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    LightPushStatusCode[LightPushStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    LightPushStatusCode[LightPushStatusCode["NO_PEERS_TO_RELAY"] = 503] = "NO_PEERS_TO_RELAY";
+})(LightPushStatusCode || (LightPushStatusCode = {}));
+export function lightPushStatusCodeToProtocolError(statusCode) {
+    switch (statusCode) {
+        case LightPushStatusCode.SUCCESS:
+            return null;
+        case LightPushStatusCode.BAD_REQUEST:
+            return ProtocolError.GENERIC_FAIL;
+        case LightPushStatusCode.UNSUPPORTED_PUBSUB_TOPIC:
+            return ProtocolError.TOPIC_NOT_CONFIGURED;
+        case LightPushStatusCode.REQUEST_TOO_LARGE:
+            return ProtocolError.SIZE_TOO_BIG;
+        case LightPushStatusCode.TOO_MANY_REQUESTS:
+            return ProtocolError.GENERIC_FAIL;
+        case LightPushStatusCode.INTERNAL_SERVER_ERROR:
+            return ProtocolError.REMOTE_PEER_REJECTED;
+        case LightPushStatusCode.NO_PEERS_TO_RELAY:
+            return ProtocolError.NO_PEER_AVAILABLE;
+        default:
+            return ProtocolError.REMOTE_PEER_REJECTED;
+    }
+}
+export const lightPushStatusDescriptions = {
+    [LightPushStatusCode.SUCCESS]: "Message pushed successfully",
+    [LightPushStatusCode.BAD_REQUEST]: "Invalid request format or missing required fields",
+    [LightPushStatusCode.UNSUPPORTED_PUBSUB_TOPIC]: "The specified pubsub topic is not supported",
+    [LightPushStatusCode.REQUEST_TOO_LARGE]: "Message size exceeds maximum allowed size",
+    [LightPushStatusCode.TOO_MANY_REQUESTS]: "Rate limit exceeded, too many requests",
+    [LightPushStatusCode.INTERNAL_SERVER_ERROR]: "Internal server error occurred",
+    [LightPushStatusCode.NO_PEERS_TO_RELAY]: "No relay peers available to forward the message"
+};
+export function isSuccessStatusCode(statusCode) {
+    return statusCode === LightPushStatusCode.SUCCESS;
+}
+export function getLightPushStatusDescription(statusCode, statusDesc) {
+    return (statusDesc ||
+        lightPushStatusDescriptions[statusCode] ||
+        `Unknown status code: ${statusCode}`);
+}
+//# sourceMappingURL=status_codes.js.map

package/dist/lib/light_push/status_codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status_codes.js","sourceRoot":"","sources":["../../../src/lib/light_push/status_codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAN,IAAY,mBAQX;AARD,WAAY,mBAAmB;IAC7B,qEAAa,CAAA;IACb,6EAAiB,CAAA;IACjB,uGAA8B,CAAA;IAC9B,yFAAuB,CAAA;IACvB,yFAAuB,CAAA;IACvB,iGAA2B,CAAA;IAC3B,yFAAuB,CAAA;AACzB,CAAC,EARW,mBAAmB,KAAnB,mBAAmB,QAQ9B;AAED,MAAM,UAAU,kCAAkC,CAChD,UAAkB;IAElB,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,mBAAmB,CAAC,OAAO;YAC9B,OAAO,IAAI,CAAC;QAEd,KAAK,mBAAmB,CAAC,WAAW;YAClC,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,mBAAmB,CAAC,wBAAwB;YAC/C,OAAO,aAAa,CAAC,oBAAoB,CAAC;QAE5C,KAAK,mBAAmB,CAAC,iBAAiB;YACxC,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,mBAAmB,CAAC,iBAAiB;YACxC,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,mBAAmB,CAAC,qBAAqB;YAC5C,OAAO,aAAa,CAAC,oBAAoB,CAAC;QAE5C,KAAK,mBAAmB,CAAC,iBAAiB;YACxC,OAAO,aAAa,CAAC,iBAAiB,CAAC;QAEzC;YACE,OAAO,aAAa,CAAC,oBAAoB,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAA2B;IACjE,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,6BAA6B;IAC5D,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAC/B,mDAAmD;IACrD,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,EAC5C,6CAA6C;IAC/C,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EACrC,2CAA2C;IAC7C,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EACrC,wCAAwC;IAC1C,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,gCAAgC;IAC7E,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EACrC,iDAAiD;CACpD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,UAAU,KAAK,mBAAmB,CAAC,OAAO,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,UAAkB,EAClB,UAAmB;IAEnB,OAAO,CACL,UAAU;QACV,2BAA2B,CAAC,UAAU,CAAC;QACvC,wBAAwB,UAAU,EAAE,CACrC,CAAC;AACJ,CAAC"}

package/dist/lib/light_push/status_codes_v3.d.ts

@@ -0,0 +1,17 @@
+import { ProtocolError } from "@waku/interfaces";
+export declare enum LightPushStatusCodeV3 {
+    SUCCESS = 200,
+    BAD_REQUEST = 400,
+    PAYLOAD_TOO_LARGE = 413,
+    INVALID_MESSAGE_ERROR = 420,
+    UNSUPPORTED_PUBSUB_TOPIC = 421,
+    TOO_MANY_REQUESTS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    SERVICE_NOT_AVAILABLE = 503,
+    OUT_OF_RLN_PROOF = 504,
+    NO_PEERS_TO_RELAY = 505
+}
+export declare const lightPushStatusDescriptionsV3: Record<LightPushStatusCodeV3, string>;
+export declare function lightPushStatusCodeToProtocolErrorV3(statusCode: LightPushStatusCodeV3 | number | undefined): ProtocolError;
+export declare function isSuccessStatusCodeV3(statusCode: number | undefined): boolean;
+export declare function getLightPushStatusDescriptionV3(statusCode: number | undefined, customDesc?: string): string;

package/dist/lib/light_push/status_codes_v3.js

@@ -0,0 +1,69 @@
+import { ProtocolError } from "@waku/interfaces";
+export var LightPushStatusCodeV3;
+(function (LightPushStatusCodeV3) {
+    LightPushStatusCodeV3[LightPushStatusCodeV3["SUCCESS"] = 200] = "SUCCESS";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["INVALID_MESSAGE_ERROR"] = 420] = "INVALID_MESSAGE_ERROR";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["UNSUPPORTED_PUBSUB_TOPIC"] = 421] = "UNSUPPORTED_PUBSUB_TOPIC";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["SERVICE_NOT_AVAILABLE"] = 503] = "SERVICE_NOT_AVAILABLE";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["OUT_OF_RLN_PROOF"] = 504] = "OUT_OF_RLN_PROOF";
+    LightPushStatusCodeV3[LightPushStatusCodeV3["NO_PEERS_TO_RELAY"] = 505] = "NO_PEERS_TO_RELAY";
+})(LightPushStatusCodeV3 || (LightPushStatusCodeV3 = {}));
+export const lightPushStatusDescriptionsV3 = {
+    [LightPushStatusCodeV3.SUCCESS]: "Message sent successfully",
+    [LightPushStatusCodeV3.BAD_REQUEST]: "Bad request format",
+    [LightPushStatusCodeV3.PAYLOAD_TOO_LARGE]: "Message payload exceeds maximum size",
+    [LightPushStatusCodeV3.INVALID_MESSAGE_ERROR]: "Message validation failed",
+    [LightPushStatusCodeV3.UNSUPPORTED_PUBSUB_TOPIC]: "Unsupported pubsub topic",
+    [LightPushStatusCodeV3.TOO_MANY_REQUESTS]: "Rate limit exceeded",
+    [LightPushStatusCodeV3.INTERNAL_SERVER_ERROR]: "Internal server error",
+    [LightPushStatusCodeV3.SERVICE_NOT_AVAILABLE]: "Service temporarily unavailable",
+    [LightPushStatusCodeV3.OUT_OF_RLN_PROOF]: "RLN proof generation failed",
+    [LightPushStatusCodeV3.NO_PEERS_TO_RELAY]: "No relay peers available"
+};
+export function lightPushStatusCodeToProtocolErrorV3(statusCode) {
+    if (!statusCode) {
+        return ProtocolError.GENERIC_FAIL;
+    }
+    switch (statusCode) {
+        case LightPushStatusCodeV3.SUCCESS:
+            return ProtocolError.GENERIC_FAIL;
+        case LightPushStatusCodeV3.BAD_REQUEST:
+            return ProtocolError.DECODE_FAILED;
+        case LightPushStatusCodeV3.PAYLOAD_TOO_LARGE:
+            return ProtocolError.SIZE_TOO_BIG;
+        case LightPushStatusCodeV3.INVALID_MESSAGE_ERROR:
+            return ProtocolError.EMPTY_PAYLOAD;
+        case LightPushStatusCodeV3.UNSUPPORTED_PUBSUB_TOPIC:
+            return ProtocolError.TOPIC_NOT_CONFIGURED;
+        case LightPushStatusCodeV3.TOO_MANY_REQUESTS:
+            return ProtocolError.REMOTE_PEER_REJECTED;
+        case LightPushStatusCodeV3.INTERNAL_SERVER_ERROR:
+            return ProtocolError.GENERIC_FAIL;
+        case LightPushStatusCodeV3.SERVICE_NOT_AVAILABLE:
+            return ProtocolError.NO_PEER_AVAILABLE;
+        case LightPushStatusCodeV3.OUT_OF_RLN_PROOF:
+            return ProtocolError.RLN_PROOF_GENERATION;
+        case LightPushStatusCodeV3.NO_PEERS_TO_RELAY:
+            return ProtocolError.NO_PEER_AVAILABLE;
+        default:
+            return ProtocolError.REMOTE_PEER_REJECTED;
+    }
+}
+export function isSuccessStatusCodeV3(statusCode) {
+    return statusCode === LightPushStatusCodeV3.SUCCESS;
+}
+export function getLightPushStatusDescriptionV3(statusCode, customDesc) {
+    if (customDesc) {
+        return customDesc;
+    }
+    if (!statusCode) {
+        return "Unknown error";
+    }
+    return (lightPushStatusDescriptionsV3[statusCode] ||
+        `Unknown status code: ${statusCode}`);
+}
+//# sourceMappingURL=status_codes_v3.js.map

package/dist/lib/light_push/status_codes_v3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status_codes_v3.js","sourceRoot":"","sources":["../../../src/lib/light_push/status_codes_v3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAN,IAAY,qBAWX;AAXD,WAAY,qBAAqB;IAC/B,yEAAa,CAAA;IACb,iFAAiB,CAAA;IACjB,6FAAuB,CAAA;IACvB,qGAA2B,CAAA;IAC3B,2GAA8B,CAAA;IAC9B,6FAAuB,CAAA;IACvB,qGAA2B,CAAA;IAC3B,qGAA2B,CAAA;IAC3B,2FAAsB,CAAA;IACtB,6FAAuB,CAAA;AACzB,CAAC,EAXW,qBAAqB,KAArB,qBAAqB,QAWhC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAGtC;IACF,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,2BAA2B;IAC5D,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,oBAAoB;IACzD,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,EACvC,sCAAsC;IACxC,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,EAAE,2BAA2B;IAC1E,CAAC,qBAAqB,CAAC,wBAAwB,CAAC,EAAE,0BAA0B;IAC5E,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,qBAAqB;IAChE,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,EAAE,uBAAuB;IACtE,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,EAC3C,iCAAiC;IACnC,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,6BAA6B;IACvE,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,0BAA0B;CACtE,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAClD,UAAsD;IAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,qBAAqB,CAAC,OAAO;YAChC,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,qBAAqB,CAAC,WAAW;YACpC,OAAO,aAAa,CAAC,aAAa,CAAC;QAErC,KAAK,qBAAqB,CAAC,iBAAiB;YAC1C,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,qBAAqB,CAAC,qBAAqB;YAC9C,OAAO,aAAa,CAAC,aAAa,CAAC;QAErC,KAAK,qBAAqB,CAAC,wBAAwB;YACjD,OAAO,aAAa,CAAC,oBAAoB,CAAC;QAE5C,KAAK,qBAAqB,CAAC,iBAAiB;YAC1C,OAAO,aAAa,CAAC,oBAAoB,CAAC;QAE5C,KAAK,qBAAqB,CAAC,qBAAqB;YAC9C,OAAO,aAAa,CAAC,YAAY,CAAC;QAEpC,KAAK,qBAAqB,CAAC,qBAAqB;YAC9C,OAAO,aAAa,CAAC,iBAAiB,CAAC;QAEzC,KAAK,qBAAqB,CAAC,gBAAgB;YACzC,OAAO,aAAa,CAAC,oBAAoB,CAAC;QAE5C,KAAK,qBAAqB,CAAC,iBAAiB;YAC1C,OAAO,aAAa,CAAC,iBAAiB,CAAC;QAEzC;YACE,OAAO,aAAa,CAAC,oBAAoB,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAA8B;IAClE,OAAO,UAAU,KAAK,qBAAqB,CAAC,OAAO,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,UAA8B,EAC9B,UAAmB;IAEnB,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,OAAO,CACL,6BAA6B,CAAC,UAAmC,CAAC;QAClE,wBAAwB,UAAU,EAAE,CACrC,CAAC;AACJ,CAAC"}

package/dist/lib/message/version_0.d.ts

@@ -4,12 +4,11 @@ export declare const Version = 0;
 export { proto };
 export declare class DecodedMessage implements IDecodedMessage {
     pubsubTopic: string;
-    protected proto: proto.WakuMessage;
+    private proto;
     constructor(pubsubTopic: string, proto: proto.WakuMessage);
     get ephemeral(): boolean;
     get payload(): Uint8Array;
     get contentTopic(): string;
-    get _rawTimestamp(): bigint | undefined;
     get timestamp(): Date | undefined;
     get meta(): Uint8Array | undefined;
     get version(): number;
@@ -38,7 +37,7 @@ export declare class Decoder implements IDecoder<IDecodedMessage> {
     contentTopic: string;
     constructor(pubsubTopic: PubsubTopic, contentTopic: string);
     fromWireToProtoObj(bytes: Uint8Array): Promise<IProtoMessage | undefined>;
-    fromProtoObj(pubsubTopic: string, proto: IProtoMessage): Promise<DecodedMessage | undefined>;
+    fromProtoObj(pubsubTopic: string, proto: IProtoMessage): Promise<IDecodedMessage | undefined>;
 }
 /**
  * Creates a decoder that decode messages without Waku level encryption.

package/dist/lib/message/version_0.js

@@ -20,9 +20,6 @@ export class DecodedMessage {
     get contentTopic() {
         return this.proto.contentTopic;
     }
-    get _rawTimestamp() {
-        return this.proto.timestamp;
-    }
     get timestamp() {
         // In the case we receive a value that is bigger than JS's max number,
         // we catch the error and return undefined.
@@ -44,7 +41,7 @@ export class DecodedMessage {
     get version() {
         // https://rfc.vac.dev/spec/14/
         // > If omitted, the value SHOULD be interpreted as version 0.
-        return this.proto.version ?? 0;
+        return this.proto.version ?? Version;
     }
     get rateLimitProof() {
         return this.proto.rateLimitProof;

package/dist/lib/message/version_0.js.map

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

package/dist/lib/message_hash/index.d.ts

@@ -0,0 +1 @@
+export { messageHash, messageHashStr } from "./message_hash.js";

package/dist/lib/message_hash/index.js

@@ -0,0 +1,2 @@
+export { messageHash, messageHashStr } from "./message_hash.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/message_hash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/message_hash/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lib/message_hash/message_hash.d.ts

@@ -0,0 +1,52 @@
+import type { IDecodedMessage, IProtoMessage } from "@waku/interfaces";
+/**
+ * Deterministic Message Hashing as defined in
+ * [14/WAKU2-MESSAGE](https://rfc.vac.dev/spec/14/#deterministic-message-hashing)
+ *
+ * Computes a SHA-256 hash of the concatenation of pubsub topic, payload, content topic, meta, and timestamp.
+ *
+ * @param pubsubTopic - The pubsub topic string
+ * @param message - The message to be hashed
+ * @returns A Uint8Array containing the SHA-256 hash
+ *
+ * @example
+ * ```typescript
+ * import { messageHash } from "@waku/core";
+ *
+ * const pubsubTopic = "/waku/2/default-waku/proto";
+ * const message = {
+ *   payload: new Uint8Array([1, 2, 3, 4]),
+ *   contentTopic: "/waku/2/default-content/proto",
+ *   meta: new Uint8Array([5, 6, 7, 8]),
+ *   timestamp: new Date()
+ * };
+ *
+ * const hash = messageHash(pubsubTopic, message);
+ * ```
+ */
+export declare function messageHash(pubsubTopic: string, message: IProtoMessage | IDecodedMessage): Uint8Array;
+/**
+ * Computes a deterministic message hash and returns it as a hexadecimal string.
+ * This is a convenience wrapper around messageHash that converts the result to a hex string.
+ *
+ * @param pubsubTopic - The pubsub topic string
+ * @param message - The message to be hashed
+ * @returns A string containing the hex representation of the SHA-256 hash
+ *
+ * @example
+ * ```typescript
+ * import { messageHashStr } from "@waku/core";
+ *
+ * const pubsubTopic = "/waku/2/default-waku/proto";
+ * const message = {
+ *   payload: new Uint8Array([1, 2, 3, 4]),
+ *   contentTopic: "/waku/2/default-content/proto",
+ *   meta: new Uint8Array([5, 6, 7, 8]),
+ *   timestamp: new Date()
+ * };
+ *
+ * const hashString = messageHashStr(pubsubTopic, message);
+ * console.log(hashString); // e.g. "a1b2c3d4..."
+ * ```
+ */
+export declare function messageHashStr(pubsubTopic: string, message: IProtoMessage | IDecodedMessage): string;