@typeberry/lib 0.5.10 → 0.5.11-1fbacf3

package/packages/jam/database-lmdb/root.js

@@ -2,6 +2,9 @@ import * as lmdb from "lmdb";
 /** A thin abstraction over lmdb database interface. */
 export class LmdbRoot {
     db;
+    static new(dbPath, readOnly = false) {
+        return new LmdbRoot(dbPath, readOnly);
+    }
     constructor(dbPath, readOnly = false) {
         this.db = lmdb.open(dbPath, {
             compression: true,

package/packages/jam/database-lmdb/states.d.ts

@@ -61,7 +61,8 @@ export declare class LmdbStates implements StatesDb<SerializedState<LeafDb>>, In
     private readonly root;
     private readonly states;
     private readonly values;
-    constructor(spec: ChainSpec, blake2b: Blake2b, root: LmdbRoot);
+    static new(spec: ChainSpec, blake2b: Blake2b, root: LmdbRoot): LmdbStates;
+    private constructor();
     insertInitialState(headerHash: HeaderHash, serializedState: StateEntries): Promise<Result<OK, StateUpdateError>>;
     private updateAndCommit;
     updateAndSetState(headerHash: HeaderHash, state: SerializedState<LeafDb>, update: Partial<State & ServicesUpdate>): Promise<Result<OK, StateUpdateError>>;

package/packages/jam/database-lmdb/states.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-lmdb/states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,gBAAgB,EAAe,MAAM,qBAAqB,CAAC;AAC9G,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAgD,MAAM,gCAAgC,CAAC;AAG/G,OAAO,EAAE,EAAE,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,WAAW,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,qBAAa,UAAW,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAK5F,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAGZ,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ;IAM3B,kBAAkB,CACtB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,YAAY,GAC5B,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAQ1B,eAAe;IA0BvB,iBAAiB,CACrB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAC9B,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAWlC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAsB1D,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI9B,KAAK;CAGZ"}
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-lmdb/states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,gBAAgB,EAAe,MAAM,qBAAqB,CAAC;AAC9G,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAgD,MAAM,gCAAgC,CAAC;AAG/G,OAAO,EAAE,EAAE,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,WAAW,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,qBAAa,UAAW,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAS5F,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ;IAI5D,OAAO;IASD,kBAAkB,CACtB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,YAAY,GAC5B,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAQ1B,eAAe;IA0BvB,iBAAiB,CACrB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAC9B,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAWlC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAsB1D,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI9B,KAAK;CAGZ"}

package/packages/jam/database-lmdb/states.js

@@ -60,6 +60,9 @@ export class LmdbStates {
     root;
     states;
     values;
+    static new(spec, blake2b, root) {
+        return new LmdbStates(spec, blake2b, root);
+    }
     constructor(spec, blake2b, root) {
         this.spec = spec;
         this.blake2b = blake2b;

package/packages/jam/database-lmdb/states.test.js

@@ -37,8 +37,8 @@ describe("LMDB States database", () => {
     const headerHash = Bytes.zero(HASH_SIZE).asOpaque();
     const spec = tinyChainSpec;
     it("should import state and read state", async () => {
-        const root = new LmdbRoot(tmpDir);
-        const states = new LmdbStates(spec, blake2b, root);
+        const root = LmdbRoot.new(tmpDir);
+        const states = LmdbStates.new(spec, blake2b, root);
         try {
             const emptyState = InMemoryState.empty(spec);
             const serialized = StateEntries.serializeInMemory(spec, blake2b, emptyState);
@@ -58,15 +58,15 @@ describe("LMDB States database", () => {
         }
     });
     it("should update the state", async () => {
-        const root = new LmdbRoot(tmpDir);
-        const states = new LmdbStates(spec, blake2b, root);
+        const root = LmdbRoot.new(tmpDir);
+        const states = LmdbStates.new(spec, blake2b, root);
         try {
             const state = InMemoryState.empty(spec);
             await states.insertInitialState(headerHash, StateEntries.serializeInMemory(spec, blake2b, state));
             const newState = states.getState(headerHash);
             assert.ok(newState !== null);
             const headerHash2 = Bytes.fill(HASH_SIZE, 2).asOpaque();
-            const lookupHistory = new LookupHistoryItem(Bytes.fill(HASH_SIZE, 0xff).asOpaque(), tryAsU32(5), tryAsLookupHistorySlots([]));
+            const lookupHistory = LookupHistoryItem.new(Bytes.fill(HASH_SIZE, 0xff).asOpaque(), tryAsU32(5), tryAsLookupHistorySlots([]));
             const stateUpdate = {
                 timeslot: tryAsTimeSlot(15),
                 privilegedServices: PrivilegedServices.create({
@@ -142,8 +142,8 @@ describe("LMDB States database", () => {
         deepEqual(Array.from(set), Array.from(SortedSet.fromArray(leafComparator, Array.from(trie.nodes.leaves()))));
     });
     it("should import more complex state", async () => {
-        const root = new LmdbRoot(tmpDir);
-        const states = new LmdbStates(spec, blake2b, root);
+        const root = LmdbRoot.new(tmpDir);
+        const states = LmdbStates.new(spec, blake2b, root);
         try {
             const initialState = testState();
             const initialService = initialState.services.get(tryAsServiceId(0));
@@ -167,8 +167,8 @@ describe("LMDB States database", () => {
         }
     });
     it("should update more complex entries", async () => {
-        const root = new LmdbRoot(tmpDir);
-        const states = new LmdbStates(spec, blake2b, root);
+        const root = LmdbRoot.new(tmpDir);
+        const states = LmdbStates.new(spec, blake2b, root);
         try {
             const state = testState();
             const initialService = state.services.get(tryAsServiceId(0));

package/packages/jam/executor/index.d.ts

@@ -1,4 +1,4 @@
 export type { ReturnValue } from "#@typeberry/pvm-host-calls";
-export { ReturnStatus } from "#@typeberry/pvm-host-calls";
+export { EcalliTraceLogger, ReturnStatus } from "#@typeberry/pvm-host-calls";
 export * from "./pvm-executor.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/jam/executor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/executor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/executor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC5E,cAAc,mBAAmB,CAAC"}

package/packages/jam/executor/index.js

@@ -1,2 +1,2 @@
-export { ReturnStatus } from "#@typeberry/pvm-host-calls";
+export { EcalliTraceLogger, ReturnStatus } from "#@typeberry/pvm-host-calls";
 export * from "./pvm-executor.js";

package/packages/jam/executor/pvm-executor.d.ts

@@ -6,13 +6,16 @@ import type { PartialState } from "#@typeberry/jam-host-calls/externalities/part
 import { type RefineExternalities } from "#@typeberry/jam-host-calls/externalities/refine-externalities.js";
 export type RefineHostCallExternalities = {
     refine: RefineExternalities;
-    fetchExternalities: general.IFetchExternalities;
+    fetchExternalities: general.IRefineFetch;
 };
 export type AccumulateHostCallExternalities = {
     partialState: PartialState;
-    fetchExternalities: general.IFetchExternalities;
+    fetchExternalities: general.IAccumulateFetch;
     serviceExternalities: general.AccountsInfo & general.AccountsLookup & general.AccountsWrite & general.AccountsRead;
 };
+export type IsAuthorizedHostCallExternalities = {
+    fetchExternalities: general.IIsAuthorizedFetch;
+};
 type OnTransferHostCallExternalities = {
     partialState: general.AccountsInfo & general.AccountsLookup & general.AccountsWrite & general.AccountsRead;
     fetchExternalities: general.IFetchExternalities;
@@ -31,6 +34,8 @@ export declare class PvmExecutor {
     private static prepareRefineHostCalls;
     /** Prepare accumulation host call handlers */
     private static prepareAccumulateHostCalls;
+    /** Prepare is-authorized host call handlers */
+    private static prepareIsAuthorizedHostCalls;
     /** Prepare on transfer host call handlers */
     private static prepareOnTransferHostCalls;
     /**
@@ -50,6 +55,8 @@ export declare class PvmExecutor {
     }>;
     /** A utility function that can be used to prepare refine executor */
     static createRefineExecutor(serviceId: ServiceId, serviceCode: BytesBlob, externalities: RefineHostCallExternalities, pvm: PvmBackend): Promise<PvmExecutor>;
+    /** A utility function that can be used to prepare is-authorized executor */
+    static createIsAuthorizedExecutor(serviceId: ServiceId, serviceCode: BytesBlob, externalities: IsAuthorizedHostCallExternalities, pvm: PvmBackend): Promise<PvmExecutor>;
     /** A utility function that can be used to prepare accumulate executor */
     static createAccumulateExecutor(serviceId: ServiceId, serviceCode: BytesBlob, externalities: AccumulateHostCallExternalities, chainSpec: ChainSpec, pvm: PvmBackend): Promise<PvmExecutor>;
     /** A utility function that can be used to prepare on transfer executor */

package/packages/jam/executor/pvm-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pvm-executor.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/executor/pvm-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAc,OAAO,EAAU,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0DAA0D,CAAC;AAC7F,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iEAAiE,CAAC;AAuCzE,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAChD,oBAAoB,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CACpH,CAAC;AAEF,KAAK,+BAA+B,GAAG;IACrC,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3G,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,CAAC;CACjD,CAAC;AAUF;;GAEG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,WAAW;IAEnB,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,SAAS,CAAY;IAE7B,OAAO;mBAac,cAAc;IAInC,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAerC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAuBzC,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAazC;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU;;;;;;;;IAQ1C,qEAAqE;WACxD,oBAAoB,CAC/B,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,2BAA2B,EAC1C,GAAG,EAAE,UAAU;IAOjB,yEAAyE;WAC5D,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,+BAA+B,EAC9C,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,UAAU;IAQjB,0EAA0E;WAC7D,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,+BAA+B,EAC9C,GAAG,EAAE,UAAU;CAMlB"}
+{"version":3,"file":"pvm-executor.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/executor/pvm-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAc,OAAO,EAAU,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0DAA0D,CAAC;AAC7F,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iEAAiE,CAAC;AAuCzE,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC,YAAY,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAC7C,oBAAoB,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CACpH,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,CAAC;CAChD,CAAC;AAEF,KAAK,+BAA+B,GAAG;IACrC,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3G,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,CAAC;CACjD,CAAC;AAUF;;GAEG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,WAAW;IAEnB,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,SAAS,CAAY;IAE7B,OAAO;mBAac,cAAc;IAInC,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAerC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAuBzC,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAU3C,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAazC;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU;;;;;;;;IAQ1C,qEAAqE;WACxD,oBAAoB,CAC/B,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,2BAA2B,EAC1C,GAAG,EAAE,UAAU;IAOjB,4EAA4E;WAC/D,0BAA0B,CACrC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,iCAAiC,EAChD,GAAG,EAAE,UAAU;IAOjB,yEAAyE;WAC5D,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,+BAA+B,EAC9C,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,UAAU;IAQjB,0EAA0E;WAC7D,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,aAAa,EAAE,+BAA+B,EAC9C,GAAG,EAAE,UAAU;CAMlB"}

package/packages/jam/executor/pvm-executor.js

@@ -55,51 +55,60 @@ export class PvmExecutor {
     constructor(serviceCode, hostCallHandlers, entrypoint, pvmInstanceManager) {
         this.serviceCode = serviceCode;
         this.entrypoint = entrypoint;
-        this.hostCalls = new HostCalls({
+        this.hostCalls = HostCalls.new({
             missing: new general.Missing(),
             handlers: hostCallHandlers,
         });
-        this.pvm = new HostCallsExecutor(pvmInstanceManager, this.hostCalls);
+        this.pvm = HostCallsExecutor.new(pvmInstanceManager, this.hostCalls);
     }
     static async prepareBackend(pvm) {
         return PvmInstanceManager.new(pvm);
     }
     /** Prepare refine host call handlers */
     static prepareRefineHostCalls(serviceId, externalities) {
-        const refineHandlers = REFINE_HOST_CALL_CLASSES.map((HandlerClass) => new HandlerClass(externalities.refine));
+        const refineHandlers = REFINE_HOST_CALL_CLASSES.map((HandlerClass) => HandlerClass.new(externalities.refine));
         /** https://graypaper.fluffylabs.dev/#/ab2cdbd/2fa7022fa702?v=0.7.2 */
         const generalHandlers = [
-            new general.LogHostCall(serviceId),
-            new general.GasHostCall(serviceId),
-            new general.Fetch(serviceId, externalities.fetchExternalities),
+            general.LogHostCall.new(serviceId),
+            general.GasHostCall.new(serviceId),
+            general.Fetch.new(serviceId, externalities.fetchExternalities),
         ];
         return refineHandlers.concat(generalHandlers);
     }
     /** Prepare accumulation host call handlers */
     static prepareAccumulateHostCalls(serviceId, externalities, chainSpec) {
-        const accumulateHandlers = ACCUMULATE_HOST_CALL_CLASSES.map((HandlerClass) => new HandlerClass(serviceId, externalities.partialState, chainSpec));
+        const accumulateHandlers = ACCUMULATE_HOST_CALL_CLASSES.map((HandlerClass) => HandlerClass.new(serviceId, externalities.partialState, chainSpec));
         /** https://graypaper.fluffylabs.dev/#/ab2cdbd/30d00130d001?v=0.7.2 */
         const generalHandlers = [
-            new general.LogHostCall(serviceId),
-            new general.GasHostCall(serviceId),
-            new general.Read(serviceId, externalities.serviceExternalities),
-            new general.Write(serviceId, externalities.serviceExternalities),
-            new general.Fetch(serviceId, externalities.fetchExternalities),
-            new general.Lookup(serviceId, externalities.serviceExternalities),
-            new general.Info(serviceId, externalities.serviceExternalities),
+            general.LogHostCall.new(serviceId),
+            general.GasHostCall.new(serviceId),
+            general.Read.new(serviceId, externalities.serviceExternalities),
+            general.Write.new(serviceId, externalities.serviceExternalities),
+            general.Fetch.new(serviceId, externalities.fetchExternalities),
+            general.Lookup.new(serviceId, externalities.serviceExternalities),
+            general.Info.new(serviceId, externalities.serviceExternalities),
         ];
         return accumulateHandlers.concat(generalHandlers);
     }
+    /** Prepare is-authorized host call handlers */
+    static prepareIsAuthorizedHostCalls(serviceId, externalities) {
+        const generalHandlers = [
+            general.LogHostCall.new(serviceId),
+            general.GasHostCall.new(serviceId),
+            general.Fetch.new(serviceId, externalities.fetchExternalities),
+        ];
+        return generalHandlers;
+    }
     /** Prepare on transfer host call handlers */
     static prepareOnTransferHostCalls(serviceId, externalities) {
         const generalHandlers = [
-            new general.LogHostCall(serviceId),
-            new general.GasHostCall(serviceId),
-            new general.Fetch(serviceId, externalities.fetchExternalities),
-            new general.Read(serviceId, externalities.partialState),
-            new general.Write(serviceId, externalities.partialState),
-            new general.Lookup(serviceId, externalities.partialState),
-            new general.Info(serviceId, externalities.partialState),
+            general.LogHostCall.new(serviceId),
+            general.GasHostCall.new(serviceId),
+            general.Fetch.new(serviceId, externalities.fetchExternalities),
+            general.Read.new(serviceId, externalities.partialState),
+            general.Write.new(serviceId, externalities.partialState),
+            general.Lookup.new(serviceId, externalities.partialState),
+            general.Info.new(serviceId, externalities.partialState),
         ];
         return generalHandlers;
     }
@@ -123,6 +132,12 @@ export class PvmExecutor {
         const instances = await PvmExecutor.prepareBackend(pvm);
         return new PvmExecutor(serviceCode, hostCallHandlers, entrypoint.REFINE, instances);
     }
+    /** A utility function that can be used to prepare is-authorized executor */
+    static async createIsAuthorizedExecutor(serviceId, serviceCode, externalities, pvm) {
+        const hostCallHandlers = PvmExecutor.prepareIsAuthorizedHostCalls(serviceId, externalities);
+        const instances = await PvmExecutor.prepareBackend(pvm);
+        return new PvmExecutor(serviceCode, hostCallHandlers, entrypoint.IS_AUTHORIZED, instances);
+    }
     /** A utility function that can be used to prepare accumulate executor */
     static async createAccumulateExecutor(serviceId, serviceCode, externalities, chainSpec, pvm) {
         const hostCallHandlers = PvmExecutor.prepareAccumulateHostCalls(serviceId, externalities, chainSpec);

package/packages/jam/fuzz-proto/v1/handler.d.ts

@@ -31,7 +31,8 @@ export declare class FuzzTarget implements IpcHandler {
     readonly sender: IpcSender;
     readonly spec: ChainSpec;
     private sessionFeatures;
-    constructor(msgHandler: FuzzMessageHandler, sender: IpcSender, spec: ChainSpec);
+    static new(msgHandler: FuzzMessageHandler, sender: IpcSender, spec: ChainSpec): FuzzTarget;
+    private constructor();
     onSocketMessage(msg: Uint8Array): Promise<void>;
     private processAndRespond;
     onClose({ error }: {

package/packages/jam/fuzz-proto/v1/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/fuzz-proto/v1/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EACL,YAAY,EAEZ,KAAK,UAAU,EACf,KAAK,QAAQ,EAKb,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5E,gEAAgE;IAChE,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC5D;AAED,qBAAa,UAAW,YAAW,UAAU;aAIzB,UAAU,EAAE,kBAAkB;aAC9B,MAAM,EAAE,SAAS;aACjB,IAAI,EAAE,SAAS;IALjC,OAAO,CAAC,eAAe,CAAK;gBAGV,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS;IAG3B,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBvC,iBAAiB;IA2H/B,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI;IAI3C,4DAA4D;IAC5D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGrC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/jam/fuzz-proto/v1/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EACL,YAAY,EAEZ,KAAK,UAAU,EACf,KAAK,QAAQ,EAKb,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5E,gEAAgE;IAChE,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC5D;AAED,qBAAa,UAAW,YAAW,UAAU;aAQzB,UAAU,EAAE,kBAAkB;aAC9B,MAAM,EAAE,SAAS;aACjB,IAAI,EAAE,SAAS;IATjC,OAAO,CAAC,eAAe,CAAK;IAE5B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;IAI7E,OAAO;IAMD,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBvC,iBAAiB;IA2H/B,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI;IAI3C,4DAA4D;IAC5D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGrC"}

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/in-core/externalities/is-authorized-fetch.d.ts

@@ -0,0 +1,20 @@
+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 pkg;
+    readonly context = general.FetchContext.IsAuthorized;
+    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;
+}
+//# 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"}