@typeberry/lib 0.5.10-ec38e0b → 0.5.11-019e542

package/packages/jam/fuzz-proto/v1/handler.js

@@ -8,6 +8,9 @@ export class FuzzTarget {
     sender;
     spec;
     sessionFeatures = 0;
+    static new(msgHandler, sender, spec) {
+        return new FuzzTarget(msgHandler, sender, spec);
+    }
     constructor(msgHandler, sender, spec) {
         this.msgHandler = msgHandler;
         this.sender = sender;

package/packages/jam/fuzz-proto/v1/handler.test.js

@@ -70,7 +70,7 @@ describe("FuzzV1Target Handler", () => {
                 value: responsePeerInfo,
             };
             mockMessageHandler.getPeerInfo.mock.mockImplementation(async () => responsePeerInfo);
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             const testMessage = encode(incomingMessage);
             await fuzzTarget.onSocketMessage(testMessage);
             // Verify handshake completion and feature negotiation
@@ -116,7 +116,7 @@ describe("FuzzV1Target Handler", () => {
                 value: expectedStateRoot,
             };
             mockMessageHandler.initialize.mock.mockImplementation(async () => expectedStateRoot);
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -144,7 +144,7 @@ describe("FuzzV1Target Handler", () => {
                 value: expectedStateRoot,
             };
             mockMessageHandler.importBlock.mock.mockImplementation(async () => Result.ok(expectedStateRoot));
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -169,7 +169,7 @@ describe("FuzzV1Target Handler", () => {
                 value: expectedError,
             };
             mockMessageHandler.importBlock.mock.mockImplementation(async () => Result.error(expectedError, () => "Test: ImportBlock error"));
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -205,7 +205,7 @@ describe("FuzzV1Target Handler", () => {
                 value: keyValues,
             };
             mockMessageHandler.getSerializedState.mock.mockImplementation(async () => keyValues);
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -227,7 +227,7 @@ describe("FuzzV1Target Handler", () => {
                 type: MessageType.StateRoot,
                 value: stateRoot,
             };
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -248,7 +248,7 @@ describe("FuzzV1Target Handler", () => {
                 type: MessageType.State,
                 value: keyValues,
             };
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -264,7 +264,7 @@ describe("FuzzV1Target Handler", () => {
                 type: MessageType.Error,
                 value: error,
             };
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             await completeHandshake(mockMessageHandler, mockSender, fuzzTarget);
             mockSender._sentData = []; // Clear handshake response
             const testMessage = encode(incomingMessage);
@@ -277,7 +277,7 @@ describe("FuzzV1Target Handler", () => {
         it("should handle decoding error gracefully", async () => {
             const mockMessageHandler = new MockV1MessageHandler();
             const mockSender = new MockSender();
-            const fuzzTarget = new FuzzTarget(mockMessageHandler, mockSender, spec);
+            const fuzzTarget = FuzzTarget.new(mockMessageHandler, mockSender, spec);
             // Create malformed message with valid length prefix but invalid data
             const malformedMessage = new Uint8Array(8);
             const dataView = new DataView(malformedMessage.buffer);
@@ -300,7 +300,7 @@ describe("FuzzV1Target Handler", () => {
         return Decoder.decodeObject(messageCodec, data, spec);
     }
     async function completeHandshake(mockMessageHandler, mockSender, fuzzTarget) {
-        const target = fuzzTarget ?? new FuzzTarget(mockMessageHandler, mockSender, spec);
+        const target = fuzzTarget ?? FuzzTarget.new(mockMessageHandler, mockSender, spec);
         const inputPeerInfo = PeerInfo.create({
             fuzzVersion: tryAsU8(1),
             features: tryAsU32(Features.Ancestry),

package/packages/jam/in-core/externalities/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./is-authorized-fetch.js";
+export * from "./refine.js";
+export * from "./refine-fetch.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/jam/in-core/externalities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/in-core/externalities/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/packages/jam/in-core/externalities/index.js

@@ -0,0 +1,3 @@
+export * from "./is-authorized-fetch.js";
+export * from "./refine.js";
+export * from "./refine-fetch.js";

package/packages/jam/{transition/externalities/is-authorized-fetch-externalities.d.ts → in-core/externalities/is-authorized-fetch.d.ts}

@@ -1,22 +1,20 @@
-import { BytesBlob } from "#@typeberry/bytes";
+import type { BytesBlob } from "#@typeberry/bytes";
 import type { ChainSpec } from "#@typeberry/config";
 import { general } from "#@typeberry/jam-host-calls";
 import type { U64 } from "#@typeberry/numbers";
+import { type WorkPackageFetchData } from "#@typeberry/transition/externalities/fetch-externalities.js";
 export declare class IsAuthorizedFetchExternalities implements general.IIsAuthorizedFetch {
     private readonly chainSpec;
-    private readonly params;
+    private readonly pkg;
     readonly context = general.FetchContext.IsAuthorized;
-    constructor(chainSpec: ChainSpec, params: {
-        authToken: BytesBlob;
-        authConfiguration: BytesBlob;
-    });
+    constructor(chainSpec: ChainSpec, pkg: WorkPackageFetchData);
     constants(): BytesBlob;
     workPackage(): BytesBlob;
     authConfiguration(): BytesBlob;
     authToken(): BytesBlob;
     refineContext(): BytesBlob;
     allWorkItems(): BytesBlob;
-    oneWorkItem(_workItem: U64): BytesBlob | null;
-    workItemPayload(_workItem: U64): BytesBlob | null;
+    oneWorkItem(workItem: U64): BytesBlob | null;
+    workItemPayload(workItem: U64): BytesBlob | null;
 }
-//# sourceMappingURL=is-authorized-fetch-externalities.d.ts.map
+//# sourceMappingURL=is-authorized-fetch.d.ts.map

package/packages/jam/in-core/externalities/is-authorized-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-authorized-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/in-core/externalities/is-authorized-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,4DAA4D,CAAC;AAEpE,qBAAa,8BAA+B,YAAW,OAAO,CAAC,kBAAkB;IAI7E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,QAAQ,CAAC,OAAO,qCAAqC;gBAGlC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,oBAAoB;IAG5C,SAAS,IAAI,SAAS;IAItB,WAAW,IAAI,SAAS;IAIxB,iBAAiB,IAAI,SAAS;IAI9B,SAAS,IAAI,SAAS;IAItB,aAAa,IAAI,SAAS;IAI1B,YAAY,IAAI,SAAS;IAIzB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAK5C,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAQjD"}

package/packages/jam/in-core/externalities/is-authorized-fetch.js

@@ -0,0 +1,41 @@
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants, u64ToArrayIndex, } from "#@typeberry/transition/externalities/fetch-externalities.js";
+export class IsAuthorizedFetchExternalities {
+    chainSpec;
+    pkg;
+    context = general.FetchContext.IsAuthorized;
+    constructor(chainSpec, pkg) {
+        this.chainSpec = chainSpec;
+        this.pkg = pkg;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    workPackage() {
+        return this.pkg.packageView.encoded();
+    }
+    authConfiguration() {
+        return this.pkg.packageView.authConfiguration.view();
+    }
+    authToken() {
+        return this.pkg.packageView.authToken.view();
+    }
+    refineContext() {
+        return this.pkg.packageView.context.encoded();
+    }
+    allWorkItems() {
+        return this.pkg.workItemSummaries.encoded();
+    }
+    oneWorkItem(workItem) {
+        const idx = u64ToArrayIndex(workItem, this.pkg.workItemSummaries.length);
+        return idx === null ? null : (this.pkg.workItemSummaries.get(idx)?.encoded() ?? null);
+    }
+    workItemPayload(workItem) {
+        const items = this.pkg.packageView.items.view();
+        const idx = u64ToArrayIndex(workItem, items.length);
+        if (idx === null) {
+            return null;
+        }
+        return items.get(idx)?.view().payload.view() ?? null;
+    }
+}

package/packages/jam/in-core/externalities/is-authorized-fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-authorized-fetch.test.d.ts.map

package/packages/jam/in-core/externalities/is-authorized-fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-authorized-fetch.test.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/in-core/externalities/is-authorized-fetch.test.ts"],"names":[],"mappings":""}

package/packages/jam/in-core/externalities/is-authorized-fetch.test.js

@@ -0,0 +1,101 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { tryAsServiceGas, tryAsServiceId, tryAsTimeSlot } from "#@typeberry/block";
+import { RefineContext } from "#@typeberry/block/refine-context.js";
+import { WorkItem } from "#@typeberry/block/work-item.js";
+import { tryAsWorkItemsCount, WorkPackage } from "#@typeberry/block/work-package.js";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
+import { Encoder } from "#@typeberry/codec";
+import { asKnownSize, FixedSizeArray } from "#@typeberry/collections";
+import { fullChainSpec, tinyChainSpec } from "#@typeberry/config";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { tryAsU16, tryAsU64 } from "#@typeberry/numbers";
+import { buildWorkPackageFetchData } from "#@typeberry/transition/externalities/fetch-externalities.js";
+import { IsAuthorizedFetchExternalities } from "./is-authorized-fetch.js";
+function fetchDataFor(pkg, chainSpec = tinyChainSpec) {
+    return buildWorkPackageFetchData(chainSpec, pkg);
+}
+function buildWorkItem(overrides = {}) {
+    return WorkItem.create({
+        service: tryAsServiceId(overrides.service ?? 1),
+        codeHash: Bytes.fill(HASH_SIZE, 7).asOpaque(),
+        payload: BytesBlob.blobFrom(new Uint8Array(overrides.payloadLen ?? 3).fill(0xab)),
+        refineGasLimit: tryAsServiceGas(1_000_000),
+        accumulateGasLimit: tryAsServiceGas(2_000_000),
+        importSegments: asKnownSize([]),
+        extrinsic: [],
+        exportCount: tryAsU16(0),
+    });
+}
+function buildPackage(items = [buildWorkItem({})]) {
+    return WorkPackage.create({
+        authToken: BytesBlob.blobFrom(new Uint8Array([1, 2, 3])),
+        authCodeHost: tryAsServiceId(42),
+        authCodeHash: Bytes.fill(HASH_SIZE, 9).asOpaque(),
+        authConfiguration: BytesBlob.blobFrom(new Uint8Array([4, 5, 6, 7])),
+        context: RefineContext.create({
+            anchor: Bytes.fill(HASH_SIZE, 1).asOpaque(),
+            stateRoot: Bytes.fill(HASH_SIZE, 2).asOpaque(),
+            beefyRoot: Bytes.fill(HASH_SIZE, 3).asOpaque(),
+            lookupAnchor: Bytes.fill(HASH_SIZE, 4).asOpaque(),
+            lookupAnchorSlot: tryAsTimeSlot(16),
+            prerequisites: [],
+        }),
+        items: FixedSizeArray.new(items, tryAsWorkItemsCount(items.length)),
+    });
+}
+describe("IsAuthorizedFetchExternalities", () => {
+    it("returns different constants for different chain specs", () => {
+        const tinyExt = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage(), tinyChainSpec));
+        const fullExt = new IsAuthorizedFetchExternalities(fullChainSpec, fetchDataFor(buildPackage(), fullChainSpec));
+        assert.notStrictEqual(tinyExt.constants().length, 0);
+        assert.notDeepStrictEqual(tinyExt.constants(), fullExt.constants());
+    });
+    it("returns encoded work package", () => {
+        const pkg = buildPackage();
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(pkg));
+        const expected = Encoder.encodeObject(WorkPackage.Codec, pkg, tinyChainSpec);
+        assert.deepStrictEqual(ext.workPackage().raw, expected.raw);
+    });
+    it("returns auth configuration and auth token from the package", () => {
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage()));
+        assert.deepStrictEqual(ext.authConfiguration().raw, new Uint8Array([4, 5, 6, 7]));
+        assert.deepStrictEqual(ext.authToken().raw, new Uint8Array([1, 2, 3]));
+    });
+    it("returns encoded refine context", () => {
+        const pkg = buildPackage();
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(pkg));
+        const expected = Encoder.encodeObject(RefineContext.Codec, pkg.context);
+        assert.deepStrictEqual(ext.refineContext().raw, expected.raw);
+    });
+    it("returns concatenated work item summaries with 62 bytes per item", () => {
+        const items = [buildWorkItem({ service: 1 }), buildWorkItem({ service: 2, payloadLen: 5 })];
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage(items)));
+        assert.strictEqual(ext.allWorkItems().length, 62 * items.length);
+    });
+    it("returns a single work item summary (kind 12)", () => {
+        const items = [buildWorkItem({ service: 1 }), buildWorkItem({ service: 2, payloadLen: 10 })];
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage(items)));
+        const one = ext.oneWorkItem(tryAsU64(1));
+        assert.ok(one !== null);
+        assert.strictEqual(one.length, 62);
+        const serviceId = new DataView(one.raw.buffer, one.raw.byteOffset, 4).getUint32(0, true);
+        assert.strictEqual(serviceId, 2);
+    });
+    it("returns null for one work item when index is out of range", () => {
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage()));
+        assert.strictEqual(ext.oneWorkItem(tryAsU64(99)), null);
+    });
+    it("returns the raw payload of a work item (kind 13)", () => {
+        const items = [buildWorkItem({ service: 1, payloadLen: 2 }), buildWorkItem({ service: 2, payloadLen: 5 })];
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage(items)));
+        const payload = ext.workItemPayload(tryAsU64(1));
+        assert.ok(payload !== null);
+        assert.strictEqual(payload.length, 5);
+        assert.ok(payload.raw.every((x) => x === 0xab));
+    });
+    it("returns null for payload when index is out of range", () => {
+        const ext = new IsAuthorizedFetchExternalities(tinyChainSpec, fetchDataFor(buildPackage()));
+        assert.strictEqual(ext.workItemPayload(tryAsU64(99)), null);
+    });
+});

package/packages/jam/in-core/externalities/refine-fetch.d.ts

@@ -0,0 +1,51 @@
+import type { EntropyHash, Segment, SegmentIndex } from "#@typeberry/block";
+import type { WorkItemExtrinsic } from "#@typeberry/block/work-item.js";
+import { type BytesBlob } from "#@typeberry/bytes";
+import type { KnownSizeArray } from "#@typeberry/collections";
+import type { ChainSpec } from "#@typeberry/config";
+import { general } from "#@typeberry/jam-host-calls";
+import type { U64 } from "#@typeberry/numbers";
+import { type WorkPackageFetchData } from "#@typeberry/transition/externalities/fetch-externalities.js";
+/** A single decoded import segment passed into refine. */
+export type ImportedSegment = {
+    index: SegmentIndex;
+    data: Segment;
+};
+/** An array whose length matches the work-package's work-item count. */
+export type PerWorkItem<T> = KnownSizeArray<T, "for each work item">;
+export type RefineFetchData = {
+    /** Pre-computed per-work-package encodings. */
+    packageData: WorkPackageFetchData;
+    /** Index of the work item currently being refined (`i` in GP). */
+    currentWorkItemIndex: number;
+    /** Imports per work item (`ī`). */
+    imports: PerWorkItem<ImportedSegment[]>;
+    /** Extrinsics per work item (`x̄`). */
+    extrinsics: PerWorkItem<WorkItemExtrinsic[]>;
+    /** Authorizer trace produced by Is-Authorized (`r`). */
+    authorizerTrace: BytesBlob;
+};
+export declare class RefineFetchExternalities implements general.IRefineFetch {
+    private readonly chainSpec;
+    private readonly data;
+    readonly context = general.FetchContext.Refine;
+    constructor(chainSpec: ChainSpec, data: RefineFetchData);
+    constants(): BytesBlob;
+    /**
+     * Refine entropy is `H₀` (zero hash) per GP §B.3.
+     *
+     * https://graypaper.fluffylabs.dev/#/ab2cdbd/2fe0012fe201?v=0.7.2
+     */
+    entropy(): EntropyHash;
+    authorizerTrace(): BytesBlob;
+    workItemExtrinsic(workItem: U64 | null, index: U64): BytesBlob | null;
+    workItemImport(workItem: U64 | null, index: U64): BytesBlob | null;
+    workPackage(): BytesBlob;
+    authConfiguration(): BytesBlob;
+    authToken(): BytesBlob;
+    refineContext(): BytesBlob;
+    allWorkItems(): BytesBlob;
+    oneWorkItem(workItem: U64): BytesBlob | null;
+    workItemPayload(workItem: U64): BytesBlob | null;
+}
+//# sourceMappingURL=refine-fetch.d.ts.map

package/packages/jam/in-core/externalities/refine-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/in-core/externalities/refine-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,4DAA4D,CAAC;AAEpE,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,oBAAoB,CAAC;IAClC,kEAAkE;IAClE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IACnC,OAAO,EAAE,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,uCAAuC;IACvC,UAAU,EAAE,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC7C,wDAAwD;IACxD,eAAe,EAAE,SAAS,CAAC;CAC5B,CAAC;AAEF,qBAAa,wBAAyB,YAAW,OAAO,CAAC,YAAY;IAIjE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,QAAQ,CAAC,OAAO,+BAA+B;gBAG5B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,eAAe;IAGxC,SAAS,IAAI,SAAS;IAItB;;;;OAIG;IACH,OAAO,IAAI,WAAW;IAItB,eAAe,IAAI,SAAS;IAI5B,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAcrE,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAelE,WAAW,IAAI,SAAS;IAIxB,iBAAiB,IAAI,SAAS;IAI9B,SAAS,IAAI,SAAS;IAItB,aAAa,IAAI,SAAS;IAI1B,YAAY,IAAI,SAAS;IAIzB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAM5C,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAQjD"}

package/packages/jam/in-core/externalities/refine-fetch.js

@@ -0,0 +1,80 @@
+import { Bytes } from "#@typeberry/bytes";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants, u64ToArrayIndex, } from "#@typeberry/transition/externalities/fetch-externalities.js";
+export class RefineFetchExternalities {
+    chainSpec;
+    data;
+    context = general.FetchContext.Refine;
+    constructor(chainSpec, data) {
+        this.chainSpec = chainSpec;
+        this.data = data;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    /**
+     * Refine entropy is `H₀` (zero hash) per GP §B.3.
+     *
+     * https://graypaper.fluffylabs.dev/#/ab2cdbd/2fe0012fe201?v=0.7.2
+     */
+    entropy() {
+        return Bytes.zero(HASH_SIZE).asOpaque();
+    }
+    authorizerTrace() {
+        return this.data.authorizerTrace;
+    }
+    workItemExtrinsic(workItem, index) {
+        const itemIdx = workItem === null ? this.data.currentWorkItemIndex : u64ToArrayIndex(workItem, this.data.extrinsics.length);
+        if (itemIdx === null) {
+            return null;
+        }
+        const perItem = this.data.extrinsics[itemIdx];
+        const xIdx = u64ToArrayIndex(index, perItem.length);
+        if (xIdx === null) {
+            return null;
+        }
+        return perItem[xIdx];
+    }
+    workItemImport(workItem, index) {
+        const itemIdx = workItem === null ? this.data.currentWorkItemIndex : u64ToArrayIndex(workItem, this.data.imports.length);
+        if (itemIdx === null) {
+            return null;
+        }
+        const perItem = this.data.imports[itemIdx];
+        const segIdx = u64ToArrayIndex(index, perItem.length);
+        if (segIdx === null) {
+            return null;
+        }
+        // `Segment` extends `BytesBlob`, so it can be returned directly.
+        return perItem[segIdx].data;
+    }
+    workPackage() {
+        return this.data.packageData.packageView.encoded();
+    }
+    authConfiguration() {
+        return this.data.packageData.packageView.authConfiguration.view();
+    }
+    authToken() {
+        return this.data.packageData.packageView.authToken.view();
+    }
+    refineContext() {
+        return this.data.packageData.packageView.context.encoded();
+    }
+    allWorkItems() {
+        return this.data.packageData.workItemSummaries.encoded();
+    }
+    oneWorkItem(workItem) {
+        const summaries = this.data.packageData.workItemSummaries;
+        const idx = u64ToArrayIndex(workItem, summaries.length);
+        return idx === null ? null : (summaries.get(idx)?.encoded() ?? null);
+    }
+    workItemPayload(workItem) {
+        const items = this.data.packageData.packageView.items.view();
+        const idx = u64ToArrayIndex(workItem, items.length);
+        if (idx === null) {
+            return null;
+        }
+        return items.get(idx)?.view().payload.view() ?? null;
+    }
+}

package/packages/jam/in-core/externalities/refine-fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refine-fetch.test.d.ts.map

package/packages/jam/in-core/externalities/refine-fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-fetch.test.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/in-core/externalities/refine-fetch.test.ts"],"names":[],"mappings":""}