@typeberry/lib 0.5.1 → 0.5.2-03e1aed

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.d.ts

@@ -0,0 +1,63 @@
+import type { CoreIndex, WorkReportHash } from "#@typeberry/block";
+import { WorkPackageInfo } from "#@typeberry/block/refine-context.js";
+import type { BytesBlob } from "#@typeberry/bytes";
+import { type CodecRecord } from "#@typeberry/codec";
+import { type Ed25519Signature } from "#@typeberry/crypto";
+import { WithDebug } from "#@typeberry/utils";
+import { type StreamHandler, type StreamId, type StreamMessageSender } from "./stream.js";
+/**
+ * JAMNP-S CE 134 Stream
+ *
+ * Work-package sharing between guarantors.
+ *
+ * https://github.com/zdave-parity/jam-np/blob/main/simple.md#ce-134-work-package-sharing
+ */
+type WorkPackageBundle = BytesBlob;
+export declare const STREAM_KIND: 134 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+export declare class WorkPackageSharingRequest extends WithDebug {
+    readonly coreIndex: CoreIndex;
+    readonly segmentsRootMappings: WorkPackageInfo[];
+    static Codec: import("@typeberry/codec").Descriptor<WorkPackageSharingRequest, import("@typeberry/codec").ViewOf<WorkPackageSharingRequest, {
+        coreIndex: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<2> & import("@typeberry/utils").WithOpaque<"CoreIndex[u16]">, import("@typeberry/bytes").Bytes<2>>;
+        segmentsRootMappings: import("@typeberry/codec").Descriptor<WorkPackageInfo[], import("@typeberry/codec").SequenceView<WorkPackageInfo, import("@typeberry/codec").ViewOf<WorkPackageInfo, {
+            workPackageHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkPackageHash">, import("@typeberry/bytes").Bytes<32>>;
+            segmentTreeRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"ExportsRootHash">, import("@typeberry/bytes").Bytes<32>>;
+        }>>>;
+    }>>;
+    static create({ coreIndex, segmentsRootMappings }: CodecRecord<WorkPackageSharingRequest>): WorkPackageSharingRequest;
+    private constructor();
+}
+export declare class WorkPackageSharingResponse extends WithDebug {
+    readonly workReportHash: WorkReportHash;
+    readonly signature: Ed25519Signature;
+    static Codec: import("@typeberry/codec").Descriptor<WorkPackageSharingResponse, import("@typeberry/codec").ViewOf<WorkPackageSharingResponse, {
+        workReportHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkReportHash">, import("@typeberry/bytes").Bytes<32>>;
+        signature: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<64> & import("@typeberry/utils").WithOpaque<"Ed25519Signature">, import("@typeberry/bytes").Bytes<64>>;
+    }>>;
+    static create({ workReportHash, signature }: CodecRecord<WorkPackageSharingResponse>): WorkPackageSharingResponse;
+    private constructor();
+}
+export declare class ServerHandler implements StreamHandler<typeof STREAM_KIND> {
+    private readonly onWorkPackage;
+    kind: 134 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+    constructor(onWorkPackage: (coreIndex: CoreIndex, segmentsRootMappings: WorkPackageInfo[], workPackageBundle: WorkPackageBundle) => Promise<{
+        workReportHash: WorkReportHash;
+        signature: Ed25519Signature;
+    }>);
+    private readonly requestsMap;
+    private static sendWorkReport;
+    onStreamMessage(sender: StreamMessageSender, message: BytesBlob): void;
+    onClose(streamId: StreamId): void;
+}
+export declare class ClientHandler implements StreamHandler<typeof STREAM_KIND> {
+    kind: 134 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+    private readonly pendingRequests;
+    onStreamMessage(sender: StreamMessageSender, message: BytesBlob): void;
+    onClose(streamId: StreamId): void;
+    sendWorkPackage(sender: StreamMessageSender, coreIndex: CoreIndex, segmentsRootMappings: WorkPackageInfo[], workPackageBundle: WorkPackageBundle): Promise<{
+        workReportHash: WorkReportHash;
+        signature: Ed25519Signature;
+    }>;
+}
+export {};
+//# sourceMappingURL=ce-134-work-package-sharing.d.ts.map

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ce-134-work-package-sharing.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAE3G;;;;;;GAMG;AAIH,KAAK,iBAAiB,GAAG,SAAS,CAAC;AAGnC,eAAO,MAAM,WAAW,+DAAuB,CAAC;AAEhD,qBAAa,yBAA0B,SAAQ,SAAS;aAWpC,SAAS,EAAE,SAAS;aACpB,oBAAoB,EAAE,eAAe,EAAE;IAXzD,MAAM,CAAC,KAAK;;;;;;QAGT;IAEH,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,EAAE,WAAW,CAAC,yBAAyB,CAAC;IAIzF,OAAO;CAMR;AAED,qBAAa,0BAA2B,SAAQ,SAAS;aAWrC,cAAc,EAAE,cAAc;aAC9B,SAAS,EAAE,gBAAgB;IAX7C,MAAM,CAAC,KAAK;;;QAGT;IAEH,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,WAAW,CAAC,0BAA0B,CAAC;IAIpF,OAAO;CAMR;AAID,qBAAa,aAAc,YAAW,aAAa,CAAC,OAAO,WAAW,CAAC;IAInE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAHhC,IAAI,gEAAe;gBAGA,aAAa,EAAE,CAC9B,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,eAAe,EAAE,EACvC,iBAAiB,EAAE,iBAAiB,KACjC,OAAO,CAAC;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAG/E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkD;IAE9E,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI;IAsBtE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAGlC;AAED,qBAAa,aAAc,YAAW,aAAa,CAAC,OAAO,WAAW,CAAC;IACrE,IAAI,gEAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAM5B;IAEJ,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI;IAYtE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ3B,eAAe,CACnB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,eAAe,EAAE,EACvC,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAA;KAAE,CAAC;CAW5E"}

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.js

@@ -0,0 +1,107 @@
+import { WorkPackageInfo } from "#@typeberry/block/refine-context.js";
+import { codec, Decoder, Encoder } from "#@typeberry/codec";
+import { ED25519_SIGNATURE_BYTES } from "#@typeberry/crypto";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { Logger } from "#@typeberry/logger";
+import { WithDebug } from "#@typeberry/utils";
+import { tryAsStreamKind } from "./stream.js";
+const WorkPackageBundleCodec = codec.blob;
+export const STREAM_KIND = tryAsStreamKind(134);
+export class WorkPackageSharingRequest extends WithDebug {
+    coreIndex;
+    segmentsRootMappings;
+    static Codec = codec.Class(WorkPackageSharingRequest, {
+        coreIndex: codec.u16.asOpaque(),
+        segmentsRootMappings: codec.sequenceVarLen(WorkPackageInfo.Codec),
+    });
+    static create({ coreIndex, segmentsRootMappings }) {
+        return new WorkPackageSharingRequest(coreIndex, segmentsRootMappings);
+    }
+    constructor(coreIndex, segmentsRootMappings) {
+        super();
+        this.coreIndex = coreIndex;
+        this.segmentsRootMappings = segmentsRootMappings;
+    }
+}
+export class WorkPackageSharingResponse extends WithDebug {
+    workReportHash;
+    signature;
+    static Codec = codec.Class(WorkPackageSharingResponse, {
+        workReportHash: codec.bytes(HASH_SIZE).asOpaque(),
+        signature: codec.bytes(ED25519_SIGNATURE_BYTES).asOpaque(),
+    });
+    static create({ workReportHash, signature }) {
+        return new WorkPackageSharingResponse(workReportHash, signature);
+    }
+    constructor(workReportHash, signature) {
+        super();
+        this.workReportHash = workReportHash;
+        this.signature = signature;
+    }
+}
+const logger = Logger.new(import.meta.filename, "protocol/ce-134");
+export class ServerHandler {
+    onWorkPackage;
+    kind = STREAM_KIND;
+    constructor(onWorkPackage) {
+        this.onWorkPackage = onWorkPackage;
+    }
+    requestsMap = new Map();
+    static sendWorkReport(sender, workReportHash, signature) {
+        const workReport = WorkPackageSharingResponse.create({ workReportHash, signature });
+        sender.bufferAndSend(Encoder.encodeObject(WorkPackageSharingResponse.Codec, workReport));
+        sender.close();
+    }
+    onStreamMessage(sender, message) {
+        const streamId = sender.streamId;
+        const request = this.requestsMap.get(streamId);
+        if (request === undefined) {
+            const receivedRequest = Decoder.decodeObject(WorkPackageSharingRequest.Codec, message);
+            this.requestsMap.set(streamId, receivedRequest);
+            return;
+        }
+        const workPackageBundle = Decoder.decodeObject(WorkPackageBundleCodec, message);
+        this.onWorkPackage(request.coreIndex, request.segmentsRootMappings, workPackageBundle)
+            .then(({ workReportHash, signature }) => {
+            ServerHandler.sendWorkReport(sender, workReportHash, signature);
+        })
+            .catch((error) => {
+            logger.error `[${streamId}] Error processing work package: ${error}`;
+            this.onClose(streamId);
+        });
+    }
+    onClose(streamId) {
+        this.requestsMap.delete(streamId);
+    }
+}
+export class ClientHandler {
+    kind = STREAM_KIND;
+    pendingRequests = new Map();
+    onStreamMessage(sender, message) {
+        const pendingRequest = this.pendingRequests.get(sender.streamId);
+        if (pendingRequest === undefined) {
+            throw new Error("Unexpected message received.");
+        }
+        const response = Decoder.decodeObject(WorkPackageSharingResponse.Codec, message);
+        logger.info `[${sender.streamId}] Received work report hash and signature.`;
+        pendingRequest.resolve({ workReportHash: response.workReportHash, signature: response.signature });
+        sender.close();
+    }
+    onClose(streamId) {
+        const pendingRequest = this.pendingRequests.get(streamId);
+        if (pendingRequest !== undefined) {
+            pendingRequest.reject(new Error("Stream closed."));
+            this.pendingRequests.delete(streamId);
+        }
+    }
+    async sendWorkPackage(sender, coreIndex, segmentsRootMappings, workPackageBundle) {
+        const request = WorkPackageSharingRequest.create({ coreIndex, segmentsRootMappings });
+        logger.trace `[${sender.streamId}] Sending core index and segments-root mappings.`;
+        sender.bufferAndSend(Encoder.encodeObject(WorkPackageSharingRequest.Codec, request));
+        logger.trace `[${sender.streamId}] Sending work package bundle.`;
+        sender.bufferAndSend(Encoder.encodeObject(WorkPackageBundleCodec, workPackageBundle));
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(sender.streamId, { resolve, reject });
+        });
+    }
+}

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ce-134-work-package-sharing.test.d.ts.map

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ce-134-work-package-sharing.test.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.test.ts"],"names":[],"mappings":""}

package/packages/jam/jamnp-s/protocol/ce-134-work-package-sharing.test.js

@@ -0,0 +1,48 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { tryAsCoreIndex } from "#@typeberry/block";
+import { WorkPackageInfo } from "#@typeberry/block/refine-context.js";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
+import { ED25519_SIGNATURE_BYTES } from "#@typeberry/crypto";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { OK } from "#@typeberry/utils";
+import { ClientHandler, ServerHandler, STREAM_KIND } from "./ce-134-work-package-sharing.js";
+import { testClientServer } from "./test-utils.js";
+const MOCK_CORE_INDEX = tryAsCoreIndex(1);
+const MOCK_SEGMENTS_ROOT_MAPPINGS = [
+    WorkPackageInfo.create({
+        workPackageHash: Bytes.zero(HASH_SIZE).asOpaque(),
+        segmentTreeRoot: Bytes.zero(HASH_SIZE).asOpaque(),
+    }),
+];
+const MOCK_WORK_PACKAGE_BUNDLE = BytesBlob.blobFromString("hello");
+const MOCK_WORK_REPORT_HASH = Bytes.zero(HASH_SIZE).asOpaque();
+const MOCK_SIGNATURE = Bytes.zero(ED25519_SIGNATURE_BYTES).asOpaque();
+describe("CE 134: Work Package Sharing", () => {
+    it("Client sends a work package and the server returns a work report hash", async () => {
+        const handlers = testClientServer();
+        await new Promise((resolve) => {
+            const serverHandler = new ServerHandler((coreIndex, segmentsRootMappings, workPackageBundle) => {
+                assert.deepStrictEqual(coreIndex, MOCK_CORE_INDEX);
+                assert.deepStrictEqual(segmentsRootMappings, MOCK_SEGMENTS_ROOT_MAPPINGS);
+                assert.deepStrictEqual(workPackageBundle, MOCK_WORK_PACKAGE_BUNDLE);
+                return Promise.resolve({
+                    workReportHash: MOCK_WORK_REPORT_HASH,
+                    signature: MOCK_SIGNATURE,
+                });
+            });
+            handlers.server.registerHandlers(serverHandler);
+            handlers.client.registerHandlers(new ClientHandler());
+            handlers.client.withNewStream(STREAM_KIND, (handler, sender) => {
+                handler
+                    .sendWorkPackage(sender, MOCK_CORE_INDEX, MOCK_SEGMENTS_ROOT_MAPPINGS, MOCK_WORK_PACKAGE_BUNDLE)
+                    .then(({ workReportHash, signature }) => {
+                    assert.deepStrictEqual(workReportHash, MOCK_WORK_REPORT_HASH);
+                    assert.deepStrictEqual(signature, MOCK_SIGNATURE);
+                    resolve(undefined);
+                });
+                return OK;
+            });
+        });
+    });
+});

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.d.ts

@@ -0,0 +1,102 @@
+import type { TimeSlot } from "#@typeberry/block";
+import { Credential } from "#@typeberry/block/guarantees.js";
+import { WorkReport } from "#@typeberry/block/work-report.js";
+import type { BytesBlob } from "#@typeberry/bytes";
+import { type CodecRecord } from "#@typeberry/codec";
+import type { KnownSizeArray } from "#@typeberry/collections";
+import type { ChainSpec } from "#@typeberry/config";
+import { WithDebug } from "#@typeberry/utils";
+import { type StreamHandler, type StreamMessageSender } from "./stream.js";
+/**
+ * JAMNP-S CE 135 Stream
+ *
+ * Distribution of a fully guaranteed work-report ready for inclusion in a block.
+ *
+ * https://github.com/zdave-parity/jam-np/blob/main/simple.md#ce-135-work-report-distribution
+ */
+export declare const STREAM_KIND: 135 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+export declare class GuaranteedWorkReport extends WithDebug {
+    readonly report: WorkReport;
+    readonly slot: TimeSlot;
+    readonly signatures: KnownSizeArray<Credential, "[0..ValidatorsCount)">;
+    static Codec: import("@typeberry/codec").Descriptor<GuaranteedWorkReport, import("@typeberry/codec").ViewOf<GuaranteedWorkReport, {
+        report: import("@typeberry/codec").Descriptor<WorkReport, import("@typeberry/codec").ViewOf<WorkReport, {
+            workPackageSpec: import("@typeberry/codec").Descriptor<import("@typeberry/block/work-report.js").WorkPackageSpec, import("@typeberry/codec").ViewOf<import("@typeberry/block/work-report.js").WorkPackageSpec, {
+                hash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkPackageHash">, import("@typeberry/bytes").Bytes<32>>;
+                length: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U32, import("@typeberry/bytes").Bytes<4>>;
+                erasureRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32>, import("@typeberry/bytes").Bytes<32>>;
+                exportsRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"ExportsRootHash">, import("@typeberry/bytes").Bytes<32>>;
+                exportsCount: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U16, import("@typeberry/bytes").Bytes<2>>;
+            }>>;
+            context: import("@typeberry/codec").Descriptor<import("@typeberry/block/refine-context.js").RefineContext, import("@typeberry/codec").ViewOf<import("@typeberry/block/refine-context.js").RefineContext, {
+                anchor: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"HeaderHash">, import("@typeberry/bytes").Bytes<32>>;
+                stateRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"StateRootHash">, import("@typeberry/bytes").Bytes<32>>;
+                beefyRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"BeefyHash">, import("@typeberry/bytes").Bytes<32>>;
+                lookupAnchor: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"HeaderHash">, import("@typeberry/bytes").Bytes<32>>;
+                lookupAnchorSlot: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"TimeSlot[u32]">, import("@typeberry/bytes").Bytes<4>>;
+                prerequisites: import("@typeberry/codec").Descriptor<(import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkPackageHash">)[], import("@typeberry/codec").SequenceView<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkPackageHash">, import("@typeberry/bytes").Bytes<32>>>;
+            }>>;
+            coreIndex: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<2> & import("@typeberry/utils").WithOpaque<"CoreIndex[u16]">, import("@typeberry/numbers").U32>;
+            authorizerHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"AuthorizerHash">, import("@typeberry/bytes").Bytes<32>>;
+            authorizationGasUsed: import("@typeberry/codec").Descriptor<bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">, import("@typeberry/numbers").U64>;
+            authorizationOutput: import("@typeberry/codec").Descriptor<BytesBlob, BytesBlob>;
+            segmentRootLookup: import("@typeberry/codec").Descriptor<readonly import("@typeberry/block/refine-context.js").WorkPackageInfo[], import("@typeberry/codec").SequenceView<import("@typeberry/block/refine-context.js").WorkPackageInfo, import("@typeberry/codec").ViewOf<import("@typeberry/block/refine-context.js").WorkPackageInfo, {
+                workPackageHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"WorkPackageHash">, import("@typeberry/bytes").Bytes<32>>;
+                segmentTreeRoot: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"ExportsRootHash">, import("@typeberry/bytes").Bytes<32>>;
+            }>>>;
+            results: import("@typeberry/codec").Descriptor<import("@typeberry/collections").FixedSizeArray<import("@typeberry/block/work-result.js").WorkResult, import("@typeberry/numbers").U8>, import("@typeberry/codec").SequenceView<import("@typeberry/block/work-result.js").WorkResult, import("@typeberry/codec").ViewOf<import("@typeberry/block/work-result.js").WorkResult, {
+                serviceId: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"ServiceId[u32]">, import("@typeberry/bytes").Bytes<4>>;
+                codeHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32> & import("@typeberry/utils").WithOpaque<"CodeHash">, import("@typeberry/bytes").Bytes<32>>;
+                payloadHash: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32>, import("@typeberry/bytes").Bytes<32>>;
+                gas: import("@typeberry/codec").Descriptor<bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">, import("@typeberry/bytes").Bytes<8>>;
+                result: import("@typeberry/codec").Descriptor<import("@typeberry/block/work-result.js").WorkExecResult, {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.ok;
+                    okBlob: BytesBlob;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.outOfGas;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.panic;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.incorrectNumberOfExports;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.digestTooBig;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.badCode;
+                } | {
+                    kind: import("@typeberry/block/work-result.js").WorkExecResultKind.codeOversize;
+                }>;
+                load: import("@typeberry/codec").Descriptor<import("@typeberry/block/work-result.js").WorkRefineLoad, import("@typeberry/codec").ViewOf<import("@typeberry/block/work-result.js").WorkRefineLoad, {
+                    gasUsed: import("@typeberry/codec").Descriptor<bigint & import("@typeberry/numbers").WithBytesRepresentation<8> & import("@typeberry/utils").WithOpaque<"ServiceGas[u64]">, import("@typeberry/numbers").U64>;
+                    importedSegments: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U32, import("@typeberry/numbers").U32>;
+                    extrinsicCount: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U32, import("@typeberry/numbers").U32>;
+                    extrinsicSize: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U32, import("@typeberry/numbers").U32>;
+                    exportedSegments: import("@typeberry/codec").Descriptor<import("@typeberry/numbers").U32, import("@typeberry/numbers").U32>;
+                }>>;
+            }>>>;
+        }>>;
+        slot: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<4> & import("@typeberry/utils").WithOpaque<"TimeSlot[u32]">, import("@typeberry/bytes").Bytes<4>>;
+        signatures: import("@typeberry/codec").Descriptor<readonly Credential[] & import("@typeberry/utils").WithOpaque<"[0..ValidatorsCount)">, import("@typeberry/codec").SequenceView<Credential, import("@typeberry/codec").ViewOf<Credential, {
+            validatorIndex: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<2> & import("@typeberry/utils").WithOpaque<"ValidatorIndex[u16]">, import("@typeberry/bytes").Bytes<2>>;
+            signature: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<64> & import("@typeberry/utils").WithOpaque<"Ed25519Signature">, import("@typeberry/bytes").Bytes<64>>;
+        }>>>;
+    }>>;
+    static create({ report, slot, signatures }: CodecRecord<GuaranteedWorkReport>): GuaranteedWorkReport;
+    private constructor();
+}
+export declare class ServerHandler implements StreamHandler<typeof STREAM_KIND> {
+    private readonly chainSpec;
+    private readonly onWorkReport;
+    kind: 135 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+    constructor(chainSpec: ChainSpec, onWorkReport: (workReport: GuaranteedWorkReport) => void);
+    onStreamMessage(sender: StreamMessageSender, message: BytesBlob): void;
+    onClose(): void;
+}
+export declare class ClientHandler implements StreamHandler<typeof STREAM_KIND> {
+    private readonly chainSpec;
+    kind: 135 & import("@typeberry/numbers").WithBytesRepresentation<1>;
+    constructor(chainSpec: ChainSpec);
+    onStreamMessage(sender: StreamMessageSender): void;
+    onClose(): void;
+    sendWorkReport(sender: StreamMessageSender, workReport: GuaranteedWorkReport): void;
+}
+//# sourceMappingURL=ce-135-work-report-distribution.d.ts.map

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ce-135-work-report-distribution.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAE5F;;;;;;GAMG;AAEH,eAAO,MAAM,WAAW,+DAAuB,CAAC;AAEhD,qBAAa,oBAAqB,SAAQ,SAAS;aAkB/B,MAAM,EAAE,UAAU;aAClB,IAAI,EAAE,QAAQ;aACd,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAnBhF,MAAM,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAUT;IAEH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC;IAI7E,OAAO;CAOR;AAID,qBAAa,aAAc,YAAW,aAAa,CAAC,OAAO,WAAW,CAAC;IAInE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/B,IAAI,gEAAe;gBAGA,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI;IAG3E,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI;IAOtE,OAAO;CACR;AAED,qBAAa,aAAc,YAAW,aAAa,CAAC,OAAO,WAAW,CAAC;IAGzD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,IAAI,gEAAe;gBAEU,SAAS,EAAE,SAAS;IAEjD,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAKlD,OAAO,IAAI,IAAI;IAEf,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,oBAAoB;CAK7E"}

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.js

@@ -0,0 +1,74 @@
+import { codecKnownSizeArray, codecWithContext } from "#@typeberry/block/codec-utils.js";
+import { Credential } from "#@typeberry/block/guarantees.js";
+import { WorkReport } from "#@typeberry/block/work-report.js";
+import { codec, Decoder, Encoder } from "#@typeberry/codec";
+import { Logger } from "#@typeberry/logger";
+import { WithDebug } from "#@typeberry/utils";
+import { tryAsStreamKind } from "./stream.js";
+/**
+ * JAMNP-S CE 135 Stream
+ *
+ * Distribution of a fully guaranteed work-report ready for inclusion in a block.
+ *
+ * https://github.com/zdave-parity/jam-np/blob/main/simple.md#ce-135-work-report-distribution
+ */
+export const STREAM_KIND = tryAsStreamKind(135);
+export class GuaranteedWorkReport extends WithDebug {
+    report;
+    slot;
+    signatures;
+    static Codec = codec.Class(GuaranteedWorkReport, {
+        report: WorkReport.Codec,
+        slot: codec.u32.asOpaque(),
+        signatures: codecWithContext((context) => {
+            return codecKnownSizeArray(Credential.Codec, {
+                minLength: 0,
+                maxLength: context.validatorsCount,
+                typicalLength: context.validatorsCount / 2,
+            });
+        }),
+    });
+    static create({ report, slot, signatures }) {
+        return new GuaranteedWorkReport(report, slot, signatures);
+    }
+    constructor(report, slot, signatures) {
+        super();
+        this.report = report;
+        this.slot = slot;
+        this.signatures = signatures;
+    }
+}
+const logger = Logger.new(import.meta.filename, "protocol/ce-135");
+export class ServerHandler {
+    chainSpec;
+    onWorkReport;
+    kind = STREAM_KIND;
+    constructor(chainSpec, onWorkReport) {
+        this.chainSpec = chainSpec;
+        this.onWorkReport = onWorkReport;
+    }
+    onStreamMessage(sender, message) {
+        const guaranteedWorkReport = Decoder.decodeObject(GuaranteedWorkReport.Codec, message, this.chainSpec);
+        logger.log `[${sender.streamId}] Received guaranteed work report.`;
+        this.onWorkReport(guaranteedWorkReport);
+        sender.close();
+    }
+    onClose() { }
+}
+export class ClientHandler {
+    chainSpec;
+    kind = STREAM_KIND;
+    constructor(chainSpec) {
+        this.chainSpec = chainSpec;
+    }
+    onStreamMessage(sender) {
+        logger.warn `[${sender.streamId}] Got unexpected message on CE-135 stream. Closing.`;
+        sender.close();
+    }
+    onClose() { }
+    sendWorkReport(sender, workReport) {
+        logger.trace `[${sender.streamId}] Sending guaranteed work report.`;
+        sender.bufferAndSend(Encoder.encodeObject(GuaranteedWorkReport.Codec, workReport, this.chainSpec));
+        sender.close();
+    }
+}

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ce-135-work-report-distribution.test.d.ts.map

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ce-135-work-report-distribution.test.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.test.ts"],"names":[],"mappings":""}

package/packages/jam/jamnp-s/protocol/ce-135-work-report-distribution.test.js

@@ -0,0 +1,89 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { tryAsCoreIndex, tryAsServiceGas, tryAsServiceId, tryAsTimeSlot, tryAsValidatorIndex } from "#@typeberry/block";
+import { Credential } from "#@typeberry/block/guarantees.js";
+import { RefineContext } from "#@typeberry/block/refine-context.js";
+import { tryAsWorkItemsCount } from "#@typeberry/block/work-package.js";
+import { WorkPackageSpec, WorkReport } from "#@typeberry/block/work-report.js";
+import { WorkExecResult, WorkExecResultKind, WorkRefineLoad, WorkResult } from "#@typeberry/block/work-result.js";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
+import { asKnownSize, FixedSizeArray } from "#@typeberry/collections";
+import { tinyChainSpec } from "#@typeberry/config";
+import { ED25519_SIGNATURE_BYTES } from "#@typeberry/crypto";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { tryAsU16, tryAsU32 } from "#@typeberry/numbers";
+import { OK } from "#@typeberry/utils";
+import { ClientHandler, GuaranteedWorkReport, ServerHandler, STREAM_KIND } from "./ce-135-work-report-distribution.js";
+import { testClientServer } from "./test-utils.js";
+const MOCK_SLOT = tryAsTimeSlot(1000);
+const MOCK_WORK_PACKAGE_SPEC = WorkPackageSpec.create({
+    hash: Bytes.zero(HASH_SIZE).asOpaque(),
+    length: tryAsU32(100),
+    erasureRoot: Bytes.zero(HASH_SIZE).asOpaque(),
+    exportsRoot: Bytes.zero(HASH_SIZE).asOpaque(),
+    exportsCount: tryAsU16(0),
+});
+const MOCK_CONTEXT = RefineContext.create({
+    anchor: Bytes.zero(HASH_SIZE).asOpaque(),
+    stateRoot: Bytes.zero(HASH_SIZE).asOpaque(),
+    beefyRoot: Bytes.zero(HASH_SIZE).asOpaque(),
+    lookupAnchor: Bytes.zero(HASH_SIZE).asOpaque(),
+    lookupAnchorSlot: tryAsTimeSlot(1),
+    prerequisites: [],
+});
+const MOCK_WORK_RESULT = WorkResult.create({
+    serviceId: tryAsServiceId(1),
+    codeHash: Bytes.zero(HASH_SIZE).asOpaque(),
+    payloadHash: Bytes.zero(HASH_SIZE),
+    gas: tryAsServiceGas(1000n),
+    result: new WorkExecResult(WorkExecResultKind.ok, BytesBlob.blobFrom(new Uint8Array())),
+    load: WorkRefineLoad.create({
+        gasUsed: tryAsServiceGas(10000n),
+        importedSegments: tryAsU32(1),
+        exportedSegments: tryAsU32(1),
+        extrinsicCount: tryAsU32(100),
+        extrinsicSize: tryAsU32(100),
+    }),
+});
+const MOCK_WORK_REPORT = WorkReport.create({
+    workPackageSpec: MOCK_WORK_PACKAGE_SPEC,
+    context: MOCK_CONTEXT,
+    coreIndex: tryAsCoreIndex(0),
+    authorizerHash: Bytes.zero(HASH_SIZE).asOpaque(),
+    authorizationOutput: BytesBlob.blobFrom(new Uint8Array()),
+    segmentRootLookup: [],
+    results: FixedSizeArray.new([MOCK_WORK_RESULT], tryAsWorkItemsCount(1)),
+    authorizationGasUsed: tryAsServiceGas(10000n),
+});
+const MOCK_SIGNATURES = asKnownSize([
+    Credential.create({
+        validatorIndex: tryAsValidatorIndex(0),
+        signature: Bytes.zero(ED25519_SIGNATURE_BYTES).asOpaque(),
+    }),
+    Credential.create({
+        validatorIndex: tryAsValidatorIndex(1),
+        signature: Bytes.zero(ED25519_SIGNATURE_BYTES).asOpaque(),
+    }),
+]);
+const MOCK_GUARANTEED_WORK_REPORT = GuaranteedWorkReport.create({
+    report: MOCK_WORK_REPORT,
+    slot: MOCK_SLOT,
+    signatures: MOCK_SIGNATURES,
+});
+describe("CE 135: Work Report Distribution", () => {
+    it("Guarantor sends a work report and validator receives it", async () => {
+        const handlers = testClientServer();
+        await new Promise((resolve) => {
+            const serverHandler = new ServerHandler(tinyChainSpec, (workReport) => {
+                assert.deepStrictEqual(workReport, MOCK_GUARANTEED_WORK_REPORT);
+                resolve(undefined);
+            });
+            handlers.server.registerHandlers(serverHandler);
+            handlers.client.registerHandlers(new ClientHandler(tinyChainSpec));
+            handlers.client.withNewStream(STREAM_KIND, (handler, sender) => {
+                handler.sendWorkReport(sender, MOCK_GUARANTEED_WORK_REPORT);
+                return OK;
+            });
+        });
+    });
+});

package/packages/jam/jamnp-s/protocol/index.d.ts

@@ -0,0 +1,9 @@
+export * as ce128 from "./ce-128-block-request.js";
+export * as ce129 from "./ce-129-state-request.js";
+export * as ce131 from "./ce-131-ce-132-safrole-ticket-distribution.js";
+export * as ce133 from "./ce-133-work-package-submission.js";
+export * as ce134 from "./ce-134-work-package-sharing.js";
+export * as ce135 from "./ce-135-work-report-distribution.js";
+export * from "./stream.js";
+export * as up0 from "./up-0-block-announcement.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/jam/jamnp-s/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,gDAAgD,CAAC;AACxE,OAAO,KAAK,KAAK,MAAM,qCAAqC,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAC1D,OAAO,KAAK,KAAK,MAAM,sCAAsC,CAAC;AAC9D,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,GAAG,MAAM,8BAA8B,CAAC"}

package/packages/jam/jamnp-s/protocol/index.js

@@ -0,0 +1,8 @@
+export * as ce128 from "./ce-128-block-request.js";
+export * as ce129 from "./ce-129-state-request.js";
+export * as ce131 from "./ce-131-ce-132-safrole-ticket-distribution.js";
+export * as ce133 from "./ce-133-work-package-submission.js";
+export * as ce134 from "./ce-134-work-package-sharing.js";
+export * as ce135 from "./ce-135-work-report-distribution.js";
+export * from "./stream.js";
+export * as up0 from "./up-0-block-announcement.js";

package/packages/jam/jamnp-s/protocol/stream.d.ts

@@ -0,0 +1,37 @@
+import type { BytesBlob } from "#@typeberry/bytes";
+import { type U8, type U32 } from "#@typeberry/numbers";
+/** Unique stream identifier. */
+export type StreamId = U32;
+/** Try to cast the number as `StreamId`. */
+export declare function tryAsStreamId(num: number): StreamId;
+/** Unique stream kind. */
+export type StreamKind<T extends U8 = U8> = T;
+/** Try to cast the number as `StreamKind`. */
+export declare function tryAsStreamKind<T extends number>(num: T): StreamKind<T & U8>;
+/** Abstraction over sending messages tied to a particular stream. */
+export interface StreamMessageSender {
+    /** Stream Id information. */
+    streamId: StreamId;
+    /**
+     * Send data blob to the other end.
+     *
+     * NOTE: in case the reader is slow, we might be dropping
+     * messages. Check the result to know if the message was
+     * sent/buffered correctly (`true`) or dropped (`false`)
+     */
+    bufferAndSend(data: BytesBlob, prefixWithLength?: boolean): boolean;
+    /** Close the connection on our side (FIN). */
+    close(): void;
+}
+/** Protocol handler for many streams of the same, given kind. */
+export interface StreamHandler<TStreamKind extends StreamKind = StreamKind> {
+    /** Kind of the stream */
+    readonly kind: TStreamKind;
+    /** Handle message for that particular stream kind. */
+    onStreamMessage(streamSender: StreamMessageSender, message: BytesBlob): void;
+    /** Handle closing of given `streamId`. */
+    onClose(streamId: StreamId, isError: boolean): void;
+}
+/** Extract the stream kind out of the the handler type. */
+export type StreamKindOf<T extends StreamHandler> = T extends StreamHandler<infer TKind> ? TKind : never;
+//# sourceMappingURL=stream.d.ts.map

package/packages/jam/jamnp-s/protocol/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/jamnp-s/protocol/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAqB,KAAK,EAAE,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE1E,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC3B,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,0BAA0B;AAC1B,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC9C,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,CAE5E;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEpE,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU;IACxE,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,sDAAsD;IACtD,eAAe,CAAC,YAAY,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAE7E,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD;AAED,2DAA2D;AAC3D,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC"}

package/packages/jam/jamnp-s/protocol/stream.js

@@ -0,0 +1,9 @@
+import { tryAsU8, tryAsU32 } from "#@typeberry/numbers";
+/** Try to cast the number as `StreamId`. */
+export function tryAsStreamId(num) {
+    return tryAsU32(num);
+}
+/** Try to cast the number as `StreamKind`. */
+export function tryAsStreamKind(num) {
+    return tryAsU8(num);
+}