@typeberry/lib 0.5.9 → 0.5.10-47fe638

package/packages/jam/transition/externalities/accumulate-fetch-externalities.js

@@ -0,0 +1,45 @@
+import { Encoder } from "#@typeberry/codec";
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants, TRANSFER_OR_OPERAND, TRANSFERS_AND_OPERANDS, TransferOperandKind, } from "./fetch-externalities.js";
+export class AccumulateFetchExternalities {
+    entropyHash;
+    transfers;
+    operands;
+    chainSpec;
+    context = general.FetchContext.Accumulate;
+    constructor(entropyHash, transfers, operands, chainSpec) {
+        this.entropyHash = entropyHash;
+        this.transfers = transfers;
+        this.operands = operands;
+        this.chainSpec = chainSpec;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    entropy() {
+        return this.entropyHash;
+    }
+    allTransfersAndOperands() {
+        const transfersAndOperands = this.transfers
+            .map((transfer) => ({ kind: TransferOperandKind.TRANSFER, value: transfer }))
+            .concat(this.operands.map((operand) => ({ kind: TransferOperandKind.OPERAND, value: operand })));
+        return Encoder.encodeObject(TRANSFERS_AND_OPERANDS, transfersAndOperands, this.chainSpec);
+    }
+    oneTransferOrOperand(index) {
+        if (index >= this.transfers.length + this.operands.length) {
+            return null;
+        }
+        // Transfers-first ordering, consistent with allTransfersAndOperands()
+        const kind = index < this.transfers.length ? TransferOperandKind.TRANSFER : TransferOperandKind.OPERAND;
+        const transferOrOperand = kind === TransferOperandKind.TRANSFER
+            ? { kind: TransferOperandKind.TRANSFER, value: this.transfers[Number(index)] }
+            : {
+                kind: TransferOperandKind.OPERAND,
+                value: this.operands[Number(index) - this.transfers.length],
+            };
+        if (transferOrOperand.value === undefined) {
+            return null;
+        }
+        return Encoder.encodeObject(TRANSFER_OR_OPERAND, transferOrOperand, this.chainSpec);
+    }
+}

package/packages/jam/transition/externalities/accumulate-fetch-externalities.test.d.ts

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

package/packages/jam/transition/externalities/accumulate-fetch-externalities.test.d.ts.map

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

package/packages/jam/transition/externalities/accumulate-fetch-externalities.test.js

@@ -0,0 +1,192 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { tryAsServiceGas, tryAsServiceId } from "#@typeberry/block";
+import { WorkExecResult } from "#@typeberry/block/work-result.js";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
+import { codec, Encoder } from "#@typeberry/codec";
+import { fullChainSpec, tinyChainSpec } from "#@typeberry/config";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { TRANSFER_MEMO_BYTES } from "#@typeberry/jam-host-calls/externalities/partial-state.js";
+import { PendingTransfer } from "#@typeberry/jam-host-calls/externalities/pending-transfer.js";
+import { tryAsU64 } from "#@typeberry/numbers";
+import { Operand } from "../accumulate/operand.js";
+import { AccumulateFetchExternalities } from "./accumulate-fetch-externalities.js";
+import { TRANSFER_OR_OPERAND, TransferOperandKind } from "./fetch-externalities.js";
+describe("AccumulateFetchExternalities", () => {
+    const prepareOperands = (length) => {
+        const operands = [];
+        for (let i = 0; i < length; i++) {
+            operands.push(Operand.create({
+                authorizationOutput: BytesBlob.empty(),
+                authorizerHash: Bytes.fill(HASH_SIZE, i + 1).asOpaque(),
+                exportsRoot: Bytes.fill(HASH_SIZE, i + 2).asOpaque(),
+                hash: Bytes.fill(HASH_SIZE, i + 4).asOpaque(),
+                payloadHash: Bytes.fill(HASH_SIZE, i + 5).asOpaque(),
+                result: WorkExecResult.ok(BytesBlob.empty()),
+                gas: tryAsServiceGas(1_000),
+            }));
+        }
+        return operands;
+    };
+    const prepareTransfers = (length) => {
+        const transfers = [];
+        for (let i = 0; i < length; i++) {
+            transfers.push(PendingTransfer.create({
+                amount: tryAsU64(1000),
+                source: tryAsServiceId(i),
+                destination: tryAsServiceId(i + 1),
+                gas: tryAsServiceGas(10),
+                memo: Bytes.fill(TRANSFER_MEMO_BYTES, 0),
+            }));
+        }
+        return transfers;
+    };
+    // allTransfersAndOperands: transfers first, then operands
+    const toAllTransfersAndOperands = (operands, transfers) => {
+        return [
+            ...transfers.map((t) => ({ kind: TransferOperandKind.TRANSFER, value: t })),
+            ...operands.map((o) => ({ kind: TransferOperandKind.OPERAND, value: o })),
+        ];
+    };
+    // oneTransferOrOperand: transfers first, then operands (same as allTransfersAndOperands)
+    const toOneTransferOrOperandAt = (operands, transfers, index) => {
+        if (index >= transfers.length + operands.length) {
+            return null;
+        }
+        if (index < transfers.length) {
+            return { kind: TransferOperandKind.TRANSFER, value: transfers[index] };
+        }
+        return { kind: TransferOperandKind.OPERAND, value: operands[index - transfers.length] };
+    };
+    const encodeOneTransferOrOperand = (item, chainSpec) => {
+        if (item === null) {
+            return null;
+        }
+        return Encoder.encodeObject(TRANSFER_OR_OPERAND, item, chainSpec);
+    };
+    const prepareAccumulateData = ({ chainSpec, operands, entropy, transfers, }) => {
+        const defaultChainSpec = tinyChainSpec;
+        const defaultEntropy = Bytes.zero(HASH_SIZE).asOpaque();
+        const defaultOperands = [];
+        const defaultTransfers = [];
+        return new AccumulateFetchExternalities(entropy ?? defaultEntropy, transfers ?? defaultTransfers, operands ?? defaultOperands, chainSpec ?? defaultChainSpec);
+    };
+    it("should return different constants for different chain specs", () => {
+        const tinyFetchExternalities = prepareAccumulateData({ chainSpec: tinyChainSpec });
+        const fullFetchExternalities = prepareAccumulateData({ chainSpec: fullChainSpec });
+        const tinyConstants = tinyFetchExternalities.constants();
+        const fullConstants = fullFetchExternalities.constants();
+        assert.notStrictEqual(tinyConstants.length, 0);
+        assert.notStrictEqual(fullConstants.length, 0);
+        assert.notDeepStrictEqual(tinyConstants, fullConstants);
+    });
+    it("should return entropy hash", () => {
+        const expectedEntropy = Bytes.fill(HASH_SIZE, 5).asOpaque();
+        const fetchExternalities = prepareAccumulateData({ entropy: expectedEntropy });
+        const entropy = fetchExternalities.entropy();
+        assert.deepStrictEqual(entropy, expectedEntropy);
+    });
+    it("should return all transfers and operands", () => {
+        const operands = prepareOperands(3);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const expected = toAllTransfersAndOperands(operands, transfers);
+        const encodedExpected = Encoder.encodeObject(codec.sequenceVarLen(TRANSFER_OR_OPERAND), expected, chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        const result = fetchExternalities.allTransfersAndOperands();
+        assert.deepStrictEqual(result, encodedExpected);
+    });
+    it("should return empty encoded sequence when no transfers and no operands", () => {
+        const chainSpec = tinyChainSpec;
+        const encodedExpected = Encoder.encodeObject(codec.sequenceVarLen(TRANSFER_OR_OPERAND), [], chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands: [], transfers: [], chainSpec });
+        const result = fetchExternalities.allTransfersAndOperands();
+        assert.deepStrictEqual(result, encodedExpected);
+    });
+    it("should return one transfer by index (first range)", () => {
+        const operands = prepareOperands(3);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const encodedExpected = encodeOneTransferOrOperand(toOneTransferOrOperandAt(operands, transfers, 0), chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        // Transfers come first (indices 0..1), then operands (indices 2..4)
+        const result = fetchExternalities.oneTransferOrOperand(tryAsU64(0));
+        assert.deepStrictEqual(result, encodedExpected);
+    });
+    it("should return one operand by index (second range)", () => {
+        const operands = prepareOperands(3);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const encodedExpected = encodeOneTransferOrOperand(toOneTransferOrOperandAt(operands, transfers, 2), chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        // Operands start after transfers, so index 2 is the first operand
+        const result = fetchExternalities.oneTransferOrOperand(tryAsU64(2));
+        assert.deepStrictEqual(result, encodedExpected);
+    });
+    it("should return null when index is out of bounds", () => {
+        const operands = prepareOperands(3);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        // Total items: 3 operands + 2 transfers = 5, so index 5 is out of bounds
+        const result = fetchExternalities.oneTransferOrOperand(tryAsU64(5));
+        assert.strictEqual(result, null);
+    });
+    it("should return null when index is far out of bounds", () => {
+        const operands = prepareOperands(3);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        const result = fetchExternalities.oneTransferOrOperand(tryAsU64(153));
+        assert.strictEqual(result, null);
+    });
+    it("should have consistent encoding between all and one", () => {
+        const operands = prepareOperands(2);
+        const transfers = prepareTransfers(2);
+        const chainSpec = tinyChainSpec;
+        const allItems = toAllTransfersAndOperands(operands, transfers);
+        const encodedAll = Encoder.encodeObject(codec.sequenceVarLen(TRANSFER_OR_OPERAND), allItems, chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands, transfers, chainSpec });
+        const all = fetchExternalities.allTransfersAndOperands();
+        assert.deepStrictEqual(all, encodedAll);
+        for (let i = 0; i < operands.length + transfers.length; i++) {
+            const one = fetchExternalities.oneTransferOrOperand(tryAsU64(i));
+            const encodedOne = encodeOneTransferOrOperand(toOneTransferOrOperandAt(operands, transfers, i), chainSpec);
+            assert.deepStrictEqual(one, encodedOne, `Mismatch at index ${i}`);
+        }
+        const outOfRange = fetchExternalities.oneTransferOrOperand(tryAsU64(operands.length + transfers.length));
+        assert.strictEqual(outOfRange, null);
+    });
+    it("should handle only operands without transfers", () => {
+        const operands = prepareOperands(5);
+        const chainSpec = tinyChainSpec;
+        const allItems = toAllTransfersAndOperands(operands, []);
+        const encodedAll = Encoder.encodeObject(codec.sequenceVarLen(TRANSFER_OR_OPERAND), allItems, chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands, transfers: [], chainSpec });
+        const result = fetchExternalities.allTransfersAndOperands();
+        assert.deepStrictEqual(result, encodedAll);
+        for (let i = 0; i < operands.length; i++) {
+            const one = fetchExternalities.oneTransferOrOperand(tryAsU64(i));
+            const encodedOne = encodeOneTransferOrOperand(toOneTransferOrOperandAt(operands, [], i), chainSpec);
+            assert.deepStrictEqual(one, encodedOne, `Mismatch at operand index ${i}`);
+        }
+        const outOfRange = fetchExternalities.oneTransferOrOperand(tryAsU64(operands.length));
+        assert.strictEqual(outOfRange, null);
+    });
+    it("should handle only transfers without operands", () => {
+        const transfers = prepareTransfers(5);
+        const chainSpec = tinyChainSpec;
+        const allItems = toAllTransfersAndOperands([], transfers);
+        const encodedAll = Encoder.encodeObject(codec.sequenceVarLen(TRANSFER_OR_OPERAND), allItems, chainSpec);
+        const fetchExternalities = prepareAccumulateData({ operands: [], transfers, chainSpec });
+        const result = fetchExternalities.allTransfersAndOperands();
+        assert.deepStrictEqual(result, encodedAll);
+        for (let i = 0; i < transfers.length; i++) {
+            const one = fetchExternalities.oneTransferOrOperand(tryAsU64(i));
+            const encodedOne = encodeOneTransferOrOperand(toOneTransferOrOperandAt([], transfers, i), chainSpec);
+            assert.deepStrictEqual(one, encodedOne, `Mismatch at transfer index ${i}`);
+        }
+        const outOfRange = fetchExternalities.oneTransferOrOperand(tryAsU64(transfers.length));
+        assert.strictEqual(outOfRange, null);
+    });
+});

package/packages/jam/transition/externalities/fetch-externalities.d.ts

@@ -1,8 +1,6 @@
-import type { EntropyHash } from "#@typeberry/block";
 import type { BytesBlob } from "#@typeberry/bytes";
 import type { ChainSpec } from "#@typeberry/config";
-import { type general, PendingTransfer } from "#@typeberry/jam-host-calls";
-import { type U64 } from "#@typeberry/numbers";
+import { PendingTransfer } from "#@typeberry/jam-host-calls";
 import { Operand } from "../accumulate/operand.js";
 export declare enum TransferOperandKind {
     OPERAND = 0,
@@ -16,40 +14,6 @@ export type TransferOrOperand = {
     value: PendingTransfer;
 };
 export declare const TRANSFER_OR_OPERAND: import("@typeberry/codec").Descriptor<TransferOrOperand, TransferOrOperand>;
-declare enum FetchContext {
-    Accumulate = 0,
-    Refine = 1
-}
-type AccumulateFetchData = {
-    context: FetchContext.Accumulate;
-    entropy: EntropyHash;
-    transfers: PendingTransfer[];
-    operands: Operand[];
-};
-type RefineFetchData = {
-    context: FetchContext.Refine;
-    entropy: undefined;
-};
-export declare class FetchExternalities implements general.IFetchExternalities {
-    private fetchData;
-    private chainSpec;
-    private constructor();
-    static createForAccumulate(fetchData: Omit<AccumulateFetchData, "context">, chainSpec: ChainSpec): FetchExternalities;
-    static createForRefine(fetchData: Omit<RefineFetchData, "context">, chainSpec: ChainSpec): FetchExternalities;
-    constants(): BytesBlob;
-    entropy(): BytesBlob | null;
-    authorizerTrace(): BytesBlob | null;
-    workItemExtrinsic(_workItem: U64 | null, _index: U64): BytesBlob | null;
-    workItemImport(_workItem: U64 | null, _index: U64): BytesBlob | null;
-    workPackage(): BytesBlob | null;
-    authorizer(): BytesBlob | null;
-    authorizationToken(): BytesBlob | null;
-    refineContext(): BytesBlob | null;
-    allWorkItems(): BytesBlob | null;
-    oneWorkItem(_workItem: U64): BytesBlob | null;
-    workItemPayload(_workItem: U64): BytesBlob | null;
-    allTransfersAndOperands(): BytesBlob | null;
-    oneTransferOrOperand(index: U64): BytesBlob | null;
-}
-export {};
+export declare const TRANSFERS_AND_OPERANDS: import("@typeberry/codec").Descriptor<TransferOrOperand[], import("@typeberry/codec").SequenceView<TransferOrOperand, TransferOrOperand>>;
+export declare function getEncodedConstants(chainSpec: ChainSpec): BytesBlob;
 //# sourceMappingURL=fetch-externalities.d.ts.map

package/packages/jam/transition/externalities/fetch-externalities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAQ5E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInD,oBAAY,mBAAmB;IAC7B,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IACnC,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEN,eAAO,MAAM,mBAAmB,6EAG9B,CAAC;AA2FH,aAAK,YAAY;IACf,UAAU,IAAI;IACd,MAAM,IAAI;CACX;AAED,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;IAE7B,OAAO,EAAE,SAAS,CAAC;CACpB,CAAC;AAOF,qBAAa,kBAAmB,YAAW,OAAO,CAAC,mBAAmB;IAElE,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IAFnB,OAAO;IAKP,MAAM,CAAC,mBAAmB,CACxB,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAC/C,SAAS,EAAE,SAAS,GACnB,kBAAkB;IAIrB,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,kBAAkB;IAI7G,SAAS,IAAI,SAAS;IAItB,OAAO,IAAI,SAAS,GAAG,IAAI;IAS3B,eAAe,IAAI,SAAS,GAAG,IAAI;IAInC,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIvE,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIpE,WAAW,IAAI,SAAS,GAAG,IAAI;IAI/B,UAAU,IAAI,SAAS,GAAG,IAAI;IAI9B,kBAAkB,IAAI,SAAS,GAAG,IAAI;IAItC,aAAa,IAAI,SAAS,GAAG,IAAI;IAIjC,YAAY,IAAI,SAAS,GAAG,IAAI;IAIhC,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAI7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIjD,uBAAuB,IAAI,SAAS,GAAG,IAAI;IAa3C,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAuBnD"}
+{"version":3,"file":"fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/fetch-externalities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAS5D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInD,oBAAY,mBAAmB;IAC7B,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IACnC,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEN,eAAO,MAAM,mBAAmB,6EAG9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,2IAA4C,CAAC;AA0ChF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,aA6CvD"}

package/packages/jam/transition/externalities/fetch-externalities.js

@@ -17,7 +17,7 @@ export const TRANSFER_OR_OPERAND = codec.union("TransferOrOperand", {
     [TransferOperandKind.OPERAND]: codec.object({ value: Operand.Codec }),
     [TransferOperandKind.TRANSFER]: codec.object({ value: PendingTransfer.Codec }),
 });
-const TRANSFERS_AND_OPERANDS = codec.sequenceVarLen(TRANSFER_OR_OPERAND);
+export const TRANSFERS_AND_OPERANDS = codec.sequenceVarLen(TRANSFER_OR_OPERAND);
 // https://github.com/gavofyork/graypaper/pull/414
 // 0.7.0 encoding is used for prior versions as well.
 const CONSTANTS_CODEC = codec.object({
@@ -56,7 +56,7 @@ const CONSTANTS_CODEC = codec.object({
     Y: codec.u32,
 });
 const encodedConstantsCache = new Map();
-function getEncodedConstants(chainSpec) {
+export function getEncodedConstants(chainSpec) {
     const constsFromCache = encodedConstantsCache.get(chainSpec);
     if (constsFromCache !== undefined) {
         return constsFromCache;
@@ -99,89 +99,3 @@ function getEncodedConstants(chainSpec) {
     encodedConstantsCache.set(chainSpec, encodedConsts);
     return encodedConsts;
 }
-var FetchContext;
-(function (FetchContext) {
-    FetchContext[FetchContext["Accumulate"] = 0] = "Accumulate";
-    FetchContext[FetchContext["Refine"] = 1] = "Refine";
-})(FetchContext || (FetchContext = {}));
-export class FetchExternalities {
-    fetchData;
-    chainSpec;
-    constructor(fetchData, chainSpec) {
-        this.fetchData = fetchData;
-        this.chainSpec = chainSpec;
-    }
-    static createForAccumulate(fetchData, chainSpec) {
-        return new FetchExternalities({ context: FetchContext.Accumulate, ...fetchData }, chainSpec);
-    }
-    static createForRefine(fetchData, chainSpec) {
-        return new FetchExternalities({ context: FetchContext.Refine, ...fetchData }, chainSpec);
-    }
-    constants() {
-        return getEncodedConstants(this.chainSpec);
-    }
-    entropy() {
-        const { entropy } = this.fetchData;
-        if (entropy === undefined) {
-            return null;
-        }
-        return entropy.asOpaque();
-    }
-    authorizerTrace() {
-        return null;
-    }
-    workItemExtrinsic(_workItem, _index) {
-        return null;
-    }
-    workItemImport(_workItem, _index) {
-        return null;
-    }
-    workPackage() {
-        return null;
-    }
-    authorizer() {
-        return null;
-    }
-    authorizationToken() {
-        return null;
-    }
-    refineContext() {
-        return null;
-    }
-    allWorkItems() {
-        return null;
-    }
-    oneWorkItem(_workItem) {
-        return null;
-    }
-    workItemPayload(_workItem) {
-        return null;
-    }
-    allTransfersAndOperands() {
-        if (this.fetchData.context === FetchContext.Accumulate) {
-            const { transfers, operands } = this.fetchData;
-            const transfersAndOperands = transfers
-                .map((transfer) => ({ kind: TransferOperandKind.TRANSFER, value: transfer }))
-                .concat(operands.map((operand) => ({ kind: TransferOperandKind.OPERAND, value: operand })));
-            return Encoder.encodeObject(TRANSFERS_AND_OPERANDS, transfersAndOperands, this.chainSpec);
-        }
-        return null;
-    }
-    oneTransferOrOperand(index) {
-        if (this.fetchData.context === FetchContext.Accumulate) {
-            const { operands, transfers } = this.fetchData;
-            if (index >= operands.length + transfers.length) {
-                return null;
-            }
-            const kind = index < operands.length ? TransferOperandKind.OPERAND : TransferOperandKind.TRANSFER;
-            const transferOrOperand = kind === TransferOperandKind.OPERAND
-                ? { kind: TransferOperandKind.OPERAND, value: operands[Number(index)] }
-                : { kind: TransferOperandKind.TRANSFER, value: transfers[Number(index) - operands.length] };
-            if (transferOrOperand.value === undefined) {
-                return null;
-            }
-            return Encoder.encodeObject(TRANSFER_OR_OPERAND, transferOrOperand, this.chainSpec);
-        }
-        return null;
-    }
-}

package/packages/jam/transition/externalities/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./accumulate-externalities.js";
+export * from "./accumulate-fetch-externalities.js";
 export * from "./fetch-externalities.js";
+export * from "./refine-fetch-externalities.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/jam/transition/externalities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC"}

package/packages/jam/transition/externalities/index.js

@@ -1,2 +1,4 @@
 export * from "./accumulate-externalities.js";
+export * from "./accumulate-fetch-externalities.js";
 export * from "./fetch-externalities.js";
+export * from "./refine-fetch-externalities.js";

package/packages/jam/transition/externalities/refine-fetch-externalities.d.ts

@@ -0,0 +1,23 @@
+import type { EntropyHash } from "#@typeberry/block";
+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";
+export declare class RefineFetchExternalities implements general.IRefineFetch {
+    private readonly chainSpec;
+    readonly context = general.FetchContext.Refine;
+    constructor(chainSpec: ChainSpec);
+    constants(): BytesBlob;
+    entropy(): EntropyHash;
+    authorizerTrace(): BytesBlob | null;
+    workItemExtrinsic(_workItem: U64 | null, _index: U64): BytesBlob | null;
+    workItemImport(_workItem: U64 | null, _index: U64): BytesBlob | null;
+    workPackage(): BytesBlob | null;
+    authorizer(): BytesBlob | null;
+    authorizationToken(): BytesBlob | null;
+    refineContext(): BytesBlob | null;
+    allWorkItems(): BytesBlob | null;
+    oneWorkItem(_workItem: U64): BytesBlob | null;
+    workItemPayload(_workItem: U64): BytesBlob | null;
+}
+//# sourceMappingURL=refine-fetch-externalities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refine-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/refine-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,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;AAG9C,qBAAa,wBAAyB,YAAW,OAAO,CAAC,YAAY;IAGvD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,QAAQ,CAAC,OAAO,+BAA+B;gBAElB,SAAS,EAAE,SAAS;IAEjD,SAAS,IAAI,SAAS;IAKtB,OAAO,IAAI,WAAW;IAItB,eAAe,IAAI,SAAS,GAAG,IAAI;IAInC,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIvE,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAIpE,WAAW,IAAI,SAAS,GAAG,IAAI;IAI/B,UAAU,IAAI,SAAS,GAAG,IAAI;IAI9B,kBAAkB,IAAI,SAAS,GAAG,IAAI;IAItC,aAAa,IAAI,SAAS,GAAG,IAAI;IAIjC,YAAY,IAAI,SAAS,GAAG,IAAI;IAIhC,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAI7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAGlD"}

package/packages/jam/transition/externalities/refine-fetch-externalities.js

@@ -0,0 +1,48 @@
+import { Bytes } from "#@typeberry/bytes";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants } from "./fetch-externalities.js";
+export class RefineFetchExternalities {
+    chainSpec;
+    context = general.FetchContext.Refine;
+    constructor(chainSpec) {
+        this.chainSpec = chainSpec;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    // Returns H₀ (zero hash)
+    entropy() {
+        return Bytes.zero(HASH_SIZE).asOpaque();
+    }
+    authorizerTrace() {
+        return null;
+    }
+    workItemExtrinsic(_workItem, _index) {
+        return null;
+    }
+    workItemImport(_workItem, _index) {
+        return null;
+    }
+    workPackage() {
+        return null;
+    }
+    authorizer() {
+        return null;
+    }
+    authorizationToken() {
+        return null;
+    }
+    refineContext() {
+        return null;
+    }
+    allWorkItems() {
+        return null;
+    }
+    oneWorkItem(_workItem) {
+        return null;
+    }
+    workItemPayload(_workItem) {
+        return null;
+    }
+}

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

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

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

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

package/packages/jam/transition/externalities/refine-fetch-externalities.test.js

@@ -0,0 +1,32 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { fullChainSpec, tinyChainSpec } from "#@typeberry/config";
+import { RefineFetchExternalities } from "./refine-fetch-externalities.js";
+describe("RefineFetchExternalities", () => {
+    const prepareRefineData = ({ chainSpec } = {}) => {
+        const defaultChainSpec = tinyChainSpec;
+        return new RefineFetchExternalities(chainSpec ?? defaultChainSpec);
+    };
+    it("should return different constants for different chain specs", () => {
+        const tinyFetchExternalities = prepareRefineData({ chainSpec: tinyChainSpec });
+        const fullFetchExternalities = prepareRefineData({ chainSpec: fullChainSpec });
+        const tinyConstants = tinyFetchExternalities.constants();
+        const fullConstants = fullFetchExternalities.constants();
+        assert.notStrictEqual(tinyConstants.length, 0);
+        assert.notStrictEqual(fullConstants.length, 0);
+        assert.notDeepStrictEqual(tinyConstants, fullConstants);
+    });
+    // Pending implementation — these should assert against real fixture values once
+    // RefineFetchExternalities accepts and exposes the required refine inputs.
+    it.todo("should return entropy (H₀ header hash of anchor block)");
+    it.todo("should return authorizer trace");
+    it.todo("should return work item extrinsic");
+    it.todo("should return work item import");
+    it.todo("should return work package");
+    it.todo("should return authorizer");
+    it.todo("should return authorization token");
+    it.todo("should return refine context");
+    it.todo("should return all work items");
+    it.todo("should return one work item");
+    it.todo("should return work item payload");
+});

package/packages/jam/transition/hasher.test.js

@@ -40,7 +40,7 @@ describe("TransitionHasher", () => {
         }
         function prepareTickets() {
             return rawTickets.map(({ attempt, signature }) => SignedTicket.create({
-                attempt: tryAsTicketAttempt(attempt, tinyChainSpec),
+                attempt: tryAsTicketAttempt(attempt),
                 signature: Bytes.parseBytes(signature, BANDERSNATCH_PROOF_BYTES).asOpaque(),
             }));
         }

package/packages/workers/block-authorship/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/main.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK9E,KAAK,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAkBlD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBAgPpG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/block-authorship/main.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK9E,KAAK,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAkBlD,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,iBA+OpG"}

package/packages/workers/block-authorship/main.js

@@ -152,7 +152,7 @@ export async function main(config, comms, networkingComms) {
                 // After epoch change, it has been shifted to index 2.
                 const ticketEntropy = isNewEpoch ? state.entropy[1] : state.entropy[2];
                 logger.info `Epoch ${epoch}, slot ${slotInEpoch}/${chainSpec.contestLength}. Generating tickets for ${validatorKeys.length} validators...`;
-                const ticketsResult = await generateTickets(bandersnatch, ringKeys, validatorKeys, ticketEntropy, chainSpec.ticketsPerValidator, chainSpec);
+                const ticketsResult = await generateTickets(bandersnatch, ringKeys, validatorKeys, ticketEntropy, chainSpec.ticketsPerValidator);
                 if (ticketsResult.isError) {
                     logger.warn `Failed to generate tickets for epoch ${epoch}: ${ticketsResult.error}`;
                 }

package/packages/workers/block-authorship/protocol.d.ts

@@ -28,7 +28,7 @@ export declare const protocol: import("@typeberry/workers-api").LousyProtocol<{
                 ticketsMarker: import("@typeberry/codec").Descriptor<import("@typeberry/block").TicketsMarker | null, import("@typeberry/codec").ViewOf<import("@typeberry/block").TicketsMarker, {
                     tickets: import("@typeberry/codec").Descriptor<readonly import("@typeberry/block").Ticket[] & import("@typeberry/utils").WithOpaque<"EpochLength">, import("@typeberry/codec").SequenceView<import("@typeberry/block").Ticket, import("@typeberry/codec").ViewOf<import("@typeberry/block").Ticket, {
                         id: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32>, import("@typeberry/bytes").Bytes<32>>;
-                        attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[0|1|2]">, import("@typeberry/numbers").U32>;
+                        attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[u8]">, import("@typeberry/numbers").U32>;
                     }>>>;
                 }> | null>;
                 bandersnatchBlockAuthorIndex: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<2> & import("@typeberry/utils").WithOpaque<"ValidatorIndex[u16]">, import("@typeberry/bytes").Bytes<2>>;
@@ -38,7 +38,7 @@ export declare const protocol: import("@typeberry/workers-api").LousyProtocol<{
             }>>;
             extrinsic: import("@typeberry/codec").Descriptor<import("@typeberry/block").Extrinsic, import("@typeberry/codec").ViewOf<import("@typeberry/block").Extrinsic, {
                 tickets: import("@typeberry/codec").Descriptor<readonly import("@typeberry/block").SignedTicket[] & import("@typeberry/utils").WithOpaque<"Size: [0..chainSpec.maxTicketsPerExtrinsic)">, import("@typeberry/codec").SequenceView<import("@typeberry/block").SignedTicket, import("@typeberry/codec").ViewOf<import("@typeberry/block").SignedTicket, {
-                    attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[0|1|2]">, import("@typeberry/numbers").U32>;
+                    attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[u8]">, import("@typeberry/numbers").U32>;
                     signature: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<784> & import("@typeberry/utils").WithOpaque<"BandersnatchRingSignature">, import("@typeberry/bytes").Bytes<784>>;
                 }>>>;
                 preimages: import("@typeberry/codec").Descriptor<import("@typeberry/block").Preimage[], import("@typeberry/codec").SequenceView<import("@typeberry/block").Preimage, import("@typeberry/codec").ViewOf<import("@typeberry/block").Preimage, {
@@ -152,7 +152,7 @@ export declare const protocol: import("@typeberry/workers-api").LousyProtocol<{
                 ticketsMarker: import("@typeberry/codec").Descriptor<import("@typeberry/block").TicketsMarker | null, import("@typeberry/codec").ViewOf<import("@typeberry/block").TicketsMarker, {
                     tickets: import("@typeberry/codec").Descriptor<readonly import("@typeberry/block").Ticket[] & import("@typeberry/utils").WithOpaque<"EpochLength">, import("@typeberry/codec").SequenceView<import("@typeberry/block").Ticket, import("@typeberry/codec").ViewOf<import("@typeberry/block").Ticket, {
                         id: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<32>, import("@typeberry/bytes").Bytes<32>>;
-                        attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[0|1|2]">, import("@typeberry/numbers").U32>;
+                        attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[u8]">, import("@typeberry/numbers").U32>;
                     }>>>;
                 }> | null>;
                 bandersnatchBlockAuthorIndex: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<2> & import("@typeberry/utils").WithOpaque<"ValidatorIndex[u16]">, import("@typeberry/bytes").Bytes<2>>;
@@ -162,7 +162,7 @@ export declare const protocol: import("@typeberry/workers-api").LousyProtocol<{
             }>>;
             extrinsic: import("@typeberry/codec").Descriptor<import("@typeberry/block").Extrinsic, import("@typeberry/codec").ViewOf<import("@typeberry/block").Extrinsic, {
                 tickets: import("@typeberry/codec").Descriptor<readonly import("@typeberry/block").SignedTicket[] & import("@typeberry/utils").WithOpaque<"Size: [0..chainSpec.maxTicketsPerExtrinsic)">, import("@typeberry/codec").SequenceView<import("@typeberry/block").SignedTicket, import("@typeberry/codec").ViewOf<import("@typeberry/block").SignedTicket, {
-                    attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[0|1|2]">, import("@typeberry/numbers").U32>;
+                    attempt: import("@typeberry/codec").Descriptor<number & import("@typeberry/numbers").WithBytesRepresentation<1> & import("@typeberry/utils").WithOpaque<"TicketAttempt[u8]">, import("@typeberry/numbers").U32>;
                     signature: import("@typeberry/codec").Descriptor<import("@typeberry/bytes").Bytes<784> & import("@typeberry/utils").WithOpaque<"BandersnatchRingSignature">, import("@typeberry/bytes").Bytes<784>>;
                 }>>>;
                 preimages: import("@typeberry/codec").Descriptor<import("@typeberry/block").Preimage[], import("@typeberry/codec").SequenceView<import("@typeberry/block").Preimage, import("@typeberry/codec").ViewOf<import("@typeberry/block").Preimage, {

package/packages/workers/block-authorship/ticket-generator.d.ts

@@ -1,6 +1,5 @@
 import type { EntropyHash } from "#@typeberry/block";
 import type { SignedTicket } from "#@typeberry/block/tickets.js";
-import type { ChainSpec } from "#@typeberry/config";
 import type { BandersnatchKey, BandersnatchSecretSeed } from "#@typeberry/crypto";
 import type { BandernsatchWasm } from "#@typeberry/safrole/bandersnatch-wasm.js";
 import { Result } from "#@typeberry/utils";
@@ -18,5 +17,5 @@ export type ValidatorKey = {
  * Each validator key produces `ticketsPerValidator` tickets using ring VRF proofs.
  * The ring keys define the anonymous set - only members can produce valid proofs.
  */
-export declare function generateTickets(bandersnatch: BandernsatchWasm, ringKeys: BandersnatchKey[], validatorKeys: ValidatorKey[], entropy: EntropyHash, ticketsPerValidator: number, chainSpec: ChainSpec): Promise<Result<SignedTicket[], TicketGeneratorError>>;
+export declare function generateTickets(bandersnatch: BandernsatchWasm, ringKeys: BandersnatchKey[], validatorKeys: ValidatorKey[], entropy: EntropyHash, ticketsPerValidator: number): Promise<Result<SignedTicket[], TicketGeneratorError>>;
 //# sourceMappingURL=ticket-generator.d.ts.map