@typeberry/lib 0.5.10-6cb1bd5 → 0.5.10-7338c21

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

@@ -6,7 +6,7 @@ import { asKnownSize, FixedSizeArray, HashDictionary } from "#@typeberry/collect
 import { tinyChainSpec } from "#@typeberry/config";
 import { BANDERSNATCH_KEY_BYTES, BLS_KEY_BYTES, ED25519_KEY_BYTES } from "#@typeberry/crypto";
 import { Blake2b, HASH_SIZE } from "#@typeberry/hash";
-import { EjectError, ForgetPreimageError, NewServiceError, PartiallyUpdatedState, PendingTransfer, PreimageStatusKind, ProvidePreimageError, RequestPreimageError, TRANSFER_MEMO_BYTES, TransferError, UnprivilegedError, UpdatePrivilegesError, writeServiceIdAsLeBytes, } from "#@typeberry/jam-host-calls";
+import { CURRENT_SERVICE_ID, EjectError, ForgetPreimageError, NewServiceError, PartiallyUpdatedState, PendingTransfer, PreimageStatusKind, ProvidePreimageError, RequestPreimageError, TRANSFER_MEMO_BYTES, TransferError, UnprivilegedError, UpdatePrivilegesError, writeServiceIdAsLeBytes, } from "#@typeberry/jam-host-calls";
 import { tryAsU32, tryAsU64 } from "#@typeberry/numbers";
 import { AUTHORIZATION_QUEUE_SIZE, InMemoryService, InMemoryState, LookupHistoryItem, PreimageItem, PrivilegedServices, ServiceAccountInfo, StorageItem, tryAsLookupHistorySlots, tryAsPerCore, UpdatePreimage, UpdateService, VALIDATOR_META_BYTES, ValidatorData, } from "#@typeberry/state";
 import { testState } from "#@typeberry/state/test.utils.js";
@@ -663,16 +663,28 @@ describe("PartialState.upgradeService", () => {
     });
 });
 describe("PartialState.updateAuthorizationQueue", () => {
-    it("should update the authorization queue for a given core index", () => {
+    it("should update the authorization queue and transfer the assigner for the given core", () => {
         const state = partiallyUpdatedState();
+        const initialPrivileged = state.state.privilegedServices;
         const partialState = new AccumulateExternalities(tinyChainSpec, blake2b, state, tryAsServiceId(0), tryAsServiceId(10), tryAsTimeSlot(16));
         const coreIndex = tryAsCoreIndex(0);
-        const assigners = tryAsServiceId(0);
+        const newAssigner = tryAsServiceId(99);
         const queue = FixedSizeArray.new(Array.from({ length: AUTHORIZATION_QUEUE_SIZE }, () => Bytes.fill(HASH_SIZE, 0xee).asOpaque()), AUTHORIZATION_QUEUE_SIZE);
         // when
-        partialState.updateAuthorizationQueue(coreIndex, queue, assigners);
+        const result = partialState.updateAuthorizationQueue(coreIndex, queue, newAssigner);
         // then
+        deepEqual(result, Result.ok(OK));
         assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), queue);
+        // the privilegedServices update must be written, with only the targeted
+        // core's assigner transferred; all other fields must be preserved.
+        const updated = state.stateUpdate.privilegedServices;
+        assert.ok(updated !== null, "stateUpdate.privilegedServices should be written");
+        assert.strictEqual(updated.assigners[0], newAssigner);
+        assert.strictEqual(updated.assigners[1], initialPrivileged.assigners[1]);
+        assert.strictEqual(updated.manager, initialPrivileged.manager);
+        assert.strictEqual(updated.delegator, initialPrivileged.delegator);
+        assert.strictEqual(updated.registrar, initialPrivileged.registrar);
+        assert.strictEqual(updated.autoAccumulateServices, initialPrivileged.autoAccumulateServices);
     });
     it("should return InvalidServiceId when given auth manager is invalid", () => {
         const state = partiallyUpdatedState();
@@ -685,6 +697,8 @@ describe("PartialState.updateAuthorizationQueue", () => {
         // then
         deepEqual(result, Result.error(UpdatePrivilegesError.InvalidServiceId, () => "New auth manager is null for core 0"));
         assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), undefined);
+        // no partial privilegedServices write on error
+        assert.strictEqual(state.stateUpdate.privilegedServices, null);
     });
     it("should return UnprivilegedService when current service is not privileged", () => {
         const state = partiallyUpdatedState();
@@ -701,6 +715,8 @@ describe("PartialState.updateAuthorizationQueue", () => {
         // then
         deepEqual(result, Result.error(UpdatePrivilegesError.UnprivilegedService, () => "Service 0 not assigner for core 0 (expected: 1)"));
         assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), undefined);
+        // no partial privilegedServices write on error
+        assert.strictEqual(state.stateUpdate.privilegedServices, null);
     });
     it("should return UnprivilegedService before InvalidServiceId if given auth manager is incorrect, but current servis is also unprivileged", () => {
         const state = partiallyUpdatedState();
@@ -717,6 +733,60 @@ describe("PartialState.updateAuthorizationQueue", () => {
         // then
         deepEqual(result, Result.error(UpdatePrivilegesError.UnprivilegedService, () => "Service 0 not assigner for core 0 (expected: 1)"));
         assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), undefined);
+        // no partial privilegedServices write on error
+        assert.strictEqual(state.stateUpdate.privilegedServices, null);
+    });
+    it("should succeed on a self-transfer using CURRENT_SERVICE_ID", () => {
+        const state = partiallyUpdatedState();
+        // inject a service info for CURRENT_SERVICE_ID so it can act as the
+        // current (and assigning) service on core 0
+        const baseService = state.state.services.get(tryAsServiceId(0));
+        if (baseService === undefined) {
+            throw new Error("Invalid service!");
+        }
+        state.state.services.set(CURRENT_SERVICE_ID, new InMemoryService(CURRENT_SERVICE_ID, {
+            info: baseService.data.info,
+            preimages: HashDictionary.new(),
+            lookupHistory: HashDictionary.new(),
+            storage: new Map(),
+        }));
+        state.state.privilegedServices = PrivilegedServices.create({
+            ...state.state.privilegedServices,
+            assigners: asOpaqueType(FixedSizeArray.new([CURRENT_SERVICE_ID, tryAsServiceId(0)], tinyChainSpec.coresCount)),
+        });
+        const partialState = new AccumulateExternalities(tinyChainSpec, blake2b, state, CURRENT_SERVICE_ID, tryAsServiceId(10), tryAsTimeSlot(16));
+        const coreIndex = tryAsCoreIndex(0);
+        const queue = FixedSizeArray.new(Array.from({ length: AUTHORIZATION_QUEUE_SIZE }, () => Bytes.fill(HASH_SIZE, 0xee).asOpaque()), AUTHORIZATION_QUEUE_SIZE);
+        // when
+        const result = partialState.updateAuthorizationQueue(coreIndex, queue, CURRENT_SERVICE_ID);
+        // then
+        deepEqual(result, Result.ok(OK));
+        assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), queue);
+        const updated = state.stateUpdate.privilegedServices;
+        assert.ok(updated !== null, "stateUpdate.privilegedServices should be written");
+        assert.strictEqual(updated.assigners[0], CURRENT_SERVICE_ID);
+        assert.strictEqual(updated.assigners[1], tryAsServiceId(0));
+    });
+    it("should prevent the previous assigner from re-assigning after transfer", () => {
+        const state = partiallyUpdatedState();
+        const partialState = new AccumulateExternalities(tinyChainSpec, blake2b, state, tryAsServiceId(0), tryAsServiceId(10), tryAsTimeSlot(16));
+        const coreIndex = tryAsCoreIndex(0);
+        const newAssigner = tryAsServiceId(99);
+        const firstQueue = FixedSizeArray.new(Array.from({ length: AUTHORIZATION_QUEUE_SIZE }, () => Bytes.fill(HASH_SIZE, 0xee).asOpaque()), AUTHORIZATION_QUEUE_SIZE);
+        const secondQueue = FixedSizeArray.new(Array.from({ length: AUTHORIZATION_QUEUE_SIZE }, () => Bytes.fill(HASH_SIZE, 0xff).asOpaque()), AUTHORIZATION_QUEUE_SIZE);
+        // when: first call succeeds and transfers the assigner to service 99
+        const first = partialState.updateAuthorizationQueue(coreIndex, firstQueue, newAssigner);
+        // and the previous assigner (service 0) immediately tries to re-assign
+        const second = partialState.updateAuthorizationQueue(coreIndex, secondQueue, tryAsServiceId(0));
+        // then
+        deepEqual(first, Result.ok(OK));
+        deepEqual(second, Result.error(UpdatePrivilegesError.UnprivilegedService, () => "Service 0 not assigner for core 0 (expected: 99)"));
+        // the first queue remains — the failing second call must not overwrite it
+        assert.deepStrictEqual(state.stateUpdate.authorizationQueues.get(coreIndex), firstQueue);
+        // and the transferred assigner is still in place
+        const updated = state.stateUpdate.privilegedServices;
+        assert.ok(updated !== null);
+        assert.strictEqual(updated.assigners[0], newAssigner);
     });
 });
 describe("PartialState.updatePrivilegedServices", () => {

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

@@ -0,0 +1,19 @@
+import type { EntropyHash } from "#@typeberry/block";
+import type { BytesBlob } from "#@typeberry/bytes";
+import type { ChainSpec } from "#@typeberry/config";
+import { general, type PendingTransfer } from "#@typeberry/jam-host-calls";
+import type { U64 } from "#@typeberry/numbers";
+import type { Operand } from "../accumulate/operand.js";
+export declare class AccumulateFetchExternalities implements general.IAccumulateFetch {
+    private readonly entropyHash;
+    private readonly transfers;
+    private readonly operands;
+    private readonly chainSpec;
+    readonly context = general.FetchContext.Accumulate;
+    constructor(entropyHash: EntropyHash, transfers: PendingTransfer[], operands: Operand[], chainSpec: ChainSpec);
+    constants(): BytesBlob;
+    entropy(): EntropyHash;
+    allTransfersAndOperands(): BytesBlob | null;
+    oneTransferOrOperand(index: U64): BytesBlob | null;
+}
+//# sourceMappingURL=accumulate-fetch-externalities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accumulate-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/accumulate-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AASxD,qBAAa,4BAA6B,YAAW,OAAO,CAAC,gBAAgB;IAIzE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,QAAQ,CAAC,OAAO,mCAAmC;gBAGhC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,eAAe,EAAE,EAC5B,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,SAAS;IAGvC,SAAS,IAAI,SAAS;IAItB,OAAO,IAAI,WAAW;IAItB,uBAAuB,IAAI,SAAS,GAAG,IAAI;IAU3C,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAqBnD"}

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,6 @@
 export * from "./accumulate-externalities.js";
+export * from "./accumulate-fetch-externalities.js";
 export * from "./fetch-externalities.js";
+export * from "./is-authorized-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,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}

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

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

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

@@ -0,0 +1,22 @@
+import { 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 IsAuthorizedFetchExternalities implements general.IIsAuthorizedFetch {
+    private readonly chainSpec;
+    private readonly params;
+    readonly context = general.FetchContext.IsAuthorized;
+    constructor(chainSpec: ChainSpec, params: {
+        authToken: BytesBlob;
+        authConfiguration: BytesBlob;
+    });
+    constants(): BytesBlob;
+    workPackage(): BytesBlob;
+    authConfiguration(): BytesBlob;
+    authToken(): BytesBlob;
+    refineContext(): BytesBlob;
+    allWorkItems(): BytesBlob;
+    oneWorkItem(_workItem: U64): BytesBlob | null;
+    workItemPayload(_workItem: U64): BytesBlob | null;
+}
+//# sourceMappingURL=is-authorized-fetch-externalities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is-authorized-fetch-externalities.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/transition/externalities/is-authorized-fetch-externalities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,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;AAG9C,qBAAa,8BAA+B,YAAW,OAAO,CAAC,kBAAkB;IAI7E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,OAAO,qCAAqC;gBAGlC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE;QACvB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,SAAS,CAAC;KAC9B;IAGH,SAAS,IAAI,SAAS;IAKtB,WAAW,IAAI,SAAS;IAIxB,iBAAiB,IAAI,SAAS;IAI9B,SAAS,IAAI,SAAS;IAKtB,aAAa,IAAI,SAAS;IAK1B,YAAY,IAAI,SAAS;IAKzB,WAAW,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAK7C,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;CAGlD"}

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

@@ -0,0 +1,41 @@
+import { BytesBlob } from "#@typeberry/bytes";
+import { general } from "#@typeberry/jam-host-calls";
+import { getEncodedConstants } from "./fetch-externalities.js";
+export class IsAuthorizedFetchExternalities {
+    chainSpec;
+    params;
+    context = general.FetchContext.IsAuthorized;
+    constructor(chainSpec, params) {
+        this.chainSpec = chainSpec;
+        this.params = params;
+    }
+    constants() {
+        return getEncodedConstants(this.chainSpec);
+    }
+    // TODO [ToDr] Return encoded work package E(p)
+    workPackage() {
+        return BytesBlob.empty();
+    }
+    authConfiguration() {
+        return this.params.authConfiguration;
+    }
+    authToken() {
+        return this.params.authToken;
+    }
+    // TODO [ToDr] Return encoded refinement context
+    refineContext() {
+        return BytesBlob.empty();
+    }
+    // TODO [ToDr] Return encoded work items
+    allWorkItems() {
+        return BytesBlob.empty();
+    }
+    // TODO [ToDr] Return single work item summary
+    oneWorkItem(_workItem) {
+        return null;
+    }
+    // TODO [ToDr] Return work item payload
+    workItemPayload(_workItem) {
+        return null;
+    }
+}