@typeberry/lib 0.10.0 → 0.11.0-411c828

package/packages/jam/database-fjall/root.test.d.ts

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

package/packages/jam/database-fjall/root.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.test.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/root.test.ts"],"names":[],"mappings":""}

package/packages/jam/database-fjall/root.test.js

@@ -0,0 +1,23 @@
+import assert from "node:assert";
+import * as fs from "node:fs";
+import { describe, it } from "node:test";
+import { FjallRoot } from "./root.js";
+const key = Buffer.from("key");
+const value = Buffer.from("value");
+describe("FjallRoot", () => {
+    it("deletes a partition and recreates it empty", async () => {
+        const dbPath = fs.mkdtempSync("typeberry-fjall-root-");
+        const root = await FjallRoot.open(dbPath, { ephemeral: true });
+        try {
+            const first = await root.writablePartition("scratch");
+            await first.insert(key, value);
+            await root.deletePartition("scratch");
+            const second = await root.writablePartition("scratch");
+            assert.strictEqual(second.get(key), null);
+        }
+        finally {
+            await root.close();
+            fs.rmSync(dbPath, { recursive: true, force: true });
+        }
+    });
+});

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

@@ -16,6 +16,7 @@ export declare class FjallStates implements StatesDb<SerializedState<LeafDb>>, I
     private readonly values;
     static open(spec: ChainSpec, blake2b: Blake2b, root: FjallRoot): Promise<FjallStates>;
     private readonly valuesDb;
+    private pendingPrune;
     private constructor();
     insertInitialState(headerHash: HeaderHash, entries: StateEntries): Promise<Result<OK, StateUpdateError>>;
     updateAndSetState(headerHash: HeaderHash, state: SerializedState<LeafDb>, update: Partial<State & ServicesUpdate>): Promise<Result<OK, StateUpdateError>>;

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

@@ -1 +1 @@
-{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/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,EACL,KAAK,YAAY,EACjB,MAAM,EACN,KAAK,QAAQ,EACb,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAC7B,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;AAE/G,OAAO,EAAE,EAAE,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAuB,KAAK,SAAS,EAAgC,MAAM,WAAW,CAAC;AAI9F,0DAA0D;AAC1D,qBAAa,WAAY,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAS7F,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;WAZZ,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO;IAUD,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAQxG,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;IAUlC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAahE,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAK7C,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAMxC,eAAe,IAAI,MAAM,GAAG,IAAI;IAI1B,KAAK;YAEG,eAAe;IAyB7B,OAAO,CAAC,SAAS;CAOlB"}
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/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,EACL,KAAK,YAAY,EACjB,MAAM,EACN,KAAK,QAAQ,EACb,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAC7B,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;AAE/G,OAAO,EAAE,EAAE,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAuB,KAAK,SAAS,EAAgC,MAAM,WAAW,CAAC;AAI9F,0DAA0D;AAC1D,qBAAa,WAAY,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAU7F,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;WAbZ,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,YAAY,CAAuC;IAE3D,OAAO;IAUD,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAQxG,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;IAUlC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAahE,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAK7C,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAMxC,eAAe,IAAI,MAAM,GAAG,IAAI;IAI1B,KAAK;YAIG,eAAe;IAyB7B,OAAO,CAAC,SAAS;CAOlB"}

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

@@ -19,6 +19,7 @@ export class FjallStates {
         return new FjallStates(spec, blake2b, root, states, values);
     }
     valuesDb;
+    pendingPrune = Promise.resolve();
     constructor(spec, blake2b, root, states, values) {
         this.spec = spec;
         this.blake2b = blake2b;
@@ -58,14 +59,16 @@ export class FjallStates {
         // would need counts persisted (and crash-consistent) alongside the values.
     }
     markUnused(headerHash) {
-        void writable(this.states, this.root)
-            .remove(headerHash.raw)
+        this.pendingPrune = this.pendingPrune
+            .then(() => writable(this.states, this.root).remove(headerHash.raw))
             .catch((e) => logger.warn `Failed to prune state ${headerHash}: ${e}`);
     }
     diskSizeInBytes() {
         return this.root.sizeInBytes();
     }
-    async close() { }
+    async close() {
+        await this.pendingPrune;
+    }
     async updateAndCommit(headerHash, leafs, data) {
         const { values } = updateLeafs(leafs, this.blake2b, data);
         const stateLeafs = BytesBlob.blobFromParts(leafs.array.map((x) => x.node.raw));

package/packages/jam/node/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/export.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAsB,YAAY,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,iBAoG9G"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/export.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAsB,YAAY,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,iBA2F9G"}

package/packages/jam/node/export.js

@@ -3,10 +3,9 @@ import path from "node:path";
 import { Block as BlockCodec } from "#@typeberry/block";
 import { Bytes } from "#@typeberry/bytes";
 import { Encoder } from "#@typeberry/codec";
-import { RegularStateBackend } from "#@typeberry/config-node";
 import { Blake2b, HASH_SIZE } from "#@typeberry/hash";
 import { Logger } from "#@typeberry/logger";
-import { FjallWorkerConfig, LmdbWorkerConfig } from "#@typeberry/workers-api-node";
+import { FjallWorkerConfig } from "#@typeberry/workers-api-node";
 import { getChainSpec, getDatabasePath } from "./common.js";
 export async function exportBlocks(jamNodeConfig, output, withRelPath) {
     const logger = Logger.new(import.meta.filename, "export");
@@ -30,21 +29,13 @@ export async function exportBlocks(jamNodeConfig, output, withRelPath) {
     const blake2b = await Blake2b.createHasher();
     const chainSpec = getChainSpec(jamNodeConfig.node.flavor);
     const { dbPath } = getDatabasePath(blake2b, jamNodeConfig.nodeName, jamNodeConfig.node.chainSpec.genesisHeader, withRelPath(jamNodeConfig.node.databaseBasePath));
-    const config = jamNodeConfig.node.stateBackend === RegularStateBackend.Fjall
-        ? FjallWorkerConfig.new({
-            nodeName: jamNodeConfig.nodeName,
-            chainSpec,
-            blake2b,
-            dbPath,
-            workerParams: undefined,
-        })
-        : LmdbWorkerConfig.new({
-            nodeName: jamNodeConfig.nodeName,
-            chainSpec,
-            blake2b,
-            dbPath,
-            workerParams: undefined,
-        });
+    const config = FjallWorkerConfig.new({
+        nodeName: jamNodeConfig.nodeName,
+        chainSpec,
+        blake2b,
+        dbPath,
+        workerParams: undefined,
+    });
     const rootDb = await config.openDatabase();
     const blocks = rootDb.getBlocksDb();
     logger.info `📖 Gathering blocks...`;

package/packages/jam/node/jam-config.d.ts

@@ -26,11 +26,13 @@ export declare class JamConfig {
     readonly dev: DevConfig | null;
     /** Networking options. */
     readonly network: NetworkConfig | null;
+    /** RPC WebSocket port. When set, an in-process RPC server is started. */
+    readonly rpcPort: number | null;
     /** Optional pre-genesis ancestry information. */
     readonly ancestry: [HeaderHash, TimeSlot][];
     /** Validator index for dev mode authorship. Use "all" to author as all validators. */
     readonly devValidatorIndex: U16 | "all" | null;
-    static new({ isAuthoring, isFastForward, nodeName, nodeConfig, pvmBackend, devConfig, networkConfig, ancestry, devValidatorIndex, }: {
+    static new({ isAuthoring, isFastForward, nodeName, nodeConfig, pvmBackend, devConfig, networkConfig, rpcPort, ancestry, devValidatorIndex, }: {
         isAuthoring?: boolean;
         isFastForward?: boolean;
         nodeName: string;
@@ -38,6 +40,8 @@ export declare class JamConfig {
         pvmBackend: PvmBackend;
         devConfig?: DevConfig | null;
         networkConfig?: NetworkConfig | null;
+        /** RPC WebSocket port. When set, an in-process RPC server is started. */
+        rpcPort?: number | null;
         ancestry?: [HeaderHash, TimeSlot][];
         /** Validator index for dev mode authorship. Use "all" to author as all validators. */
         devValidatorIndex?: U16 | "all" | null;

package/packages/jam/node/jam-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jam-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/jam-config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EAGb,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IAqClB,6CAA6C;aAC7B,WAAW,EAAE,OAAO;IACpC,6FAA6F;aAC7E,aAAa,EAAE,OAAO;IACtC,iBAAiB;aACD,QAAQ,EAAE,MAAM;IAChC,mCAAmC;aACnB,IAAI,EAAE,iBAAiB;IACvC,4BAA4B;aACZ,UAAU,EAAE,UAAU;IACtC,wCAAwC;aACxB,GAAG,EAAE,SAAS,GAAG,IAAI;IACrC,0BAA0B;aACV,OAAO,EAAE,aAAa,GAAG,IAAI;IAC7C,iDAAiD;aACjC,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;IAClD,sFAAsF;aACtE,iBAAiB,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI;IArDvD,MAAM,CAAC,GAAG,CAAC,EACT,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAgB,EAChB,aAAoB,EACpB,QAAa,EACb,iBAAwB,GACzB,EAAE;QACD,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,UAAU,EAAE,UAAU,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;QAC7B,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpC,sFAAsF;QACtF,iBAAiB,CAAC,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;KACxC;IAcD,OAAO;CAoBR;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG;IAGtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,wCAAwC;IACxC,cAAc,EAAE,cAAc,CAAC;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG;IAC1B,2BAA2B;IAC3B,GAAG,EAAE,iBAAiB,CAAC;IACvB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC"}
+{"version":3,"file":"jam-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/jam-config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EAGb,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IAyClB,6CAA6C;aAC7B,WAAW,EAAE,OAAO;IACpC,6FAA6F;aAC7E,aAAa,EAAE,OAAO;IACtC,iBAAiB;aACD,QAAQ,EAAE,MAAM;IAChC,mCAAmC;aACnB,IAAI,EAAE,iBAAiB;IACvC,4BAA4B;aACZ,UAAU,EAAE,UAAU;IACtC,wCAAwC;aACxB,GAAG,EAAE,SAAS,GAAG,IAAI;IACrC,0BAA0B;aACV,OAAO,EAAE,aAAa,GAAG,IAAI;IAC7C,yEAAyE;aACzD,OAAO,EAAE,MAAM,GAAG,IAAI;IACtC,iDAAiD;aACjC,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;IAClD,sFAAsF;aACtE,iBAAiB,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI;IA3DvD,MAAM,CAAC,GAAG,CAAC,EACT,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAgB,EAChB,aAAoB,EACpB,OAAc,EACd,QAAa,EACb,iBAAwB,GACzB,EAAE;QACD,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,UAAU,EAAE,UAAU,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;QAC7B,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,yEAAyE;QACzE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpC,sFAAsF;QACtF,iBAAiB,CAAC,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;KACxC;IAeD,OAAO;CAsBR;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG;IAGtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,wCAAwC;IACxC,cAAc,EAAE,cAAc,CAAC;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG;IAC1B,2BAA2B;IAC3B,GAAG,EAAE,iBAAiB,CAAC;IACvB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC"}

package/packages/jam/node/jam-config.js

@@ -15,10 +15,11 @@ export class JamConfig {
     pvmBackend;
     dev;
     network;
+    rpcPort;
     ancestry;
     devValidatorIndex;
-    static new({ isAuthoring, isFastForward, nodeName, nodeConfig, pvmBackend, devConfig = null, networkConfig = null, ancestry = [], devValidatorIndex = null, }) {
-        return new JamConfig(isAuthoring ?? false, isFastForward ?? false, nodeName, nodeConfig, pvmBackend, devConfig, networkConfig, ancestry, devValidatorIndex);
+    static new({ isAuthoring, isFastForward, nodeName, nodeConfig, pvmBackend, devConfig = null, networkConfig = null, rpcPort = null, ancestry = [], devValidatorIndex = null, }) {
+        return new JamConfig(isAuthoring ?? false, isFastForward ?? false, nodeName, nodeConfig, pvmBackend, devConfig, networkConfig, rpcPort, ancestry, devValidatorIndex);
     }
     constructor(
     /** Whether we should be authoring blocks. */
@@ -35,6 +36,8 @@ export class JamConfig {
     dev, 
     /** Networking options. */
     network, 
+    /** RPC WebSocket port. When set, an in-process RPC server is started. */
+    rpcPort, 
     /** Optional pre-genesis ancestry information. */
     ancestry, 
     /** Validator index for dev mode authorship. Use "all" to author as all validators. */
@@ -46,6 +49,7 @@ export class JamConfig {
         this.pvmBackend = pvmBackend;
         this.dev = dev;
         this.network = network;
+        this.rpcPort = rpcPort;
         this.ancestry = ancestry;
         this.devValidatorIndex = devValidatorIndex;
     }

package/packages/jam/node/main-fuzz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main-fuzz.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main-fuzz.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EAAE,KAAK,MAAM,EAAoC,MAAM,kBAAkB,CAAC;AAGjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uBAAuB,EAAE,OAAO,CAAC;CAClC,CAAC;AAoBF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpF;AAED,iFAAiF;AACjF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAgB,cAAc;;;;EAM7B;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgLrH"}
+{"version":3,"file":"main-fuzz.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main-fuzz.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EAAE,KAAK,MAAM,EAAoC,MAAM,kBAAkB,CAAC;AAGjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uBAAuB,EAAE,OAAO,CAAC;CAClC,CAAC;AAoBF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpF;AAED,iFAAiF;AACjF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAgB,cAAc;;;;EAM7B;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmMrH"}

package/packages/jam/node/main-fuzz.js

@@ -8,23 +8,23 @@ import { v1 as fuzzV1 } from "#@typeberry/fuzz-proto";
 import { HASH_SIZE } from "#@typeberry/hash";
 import { Logger } from "#@typeberry/logger";
 import { CURRENT_VERSION, Result, version } from "#@typeberry/utils";
-import { FjallValuesSession, logHostEnvironment } from "#@typeberry/workers-api-node";
+import { FjallRoot, logHostEnvironment } from "#@typeberry/workers-api-node";
 import { getChainSpec } from "./common.js";
 import { mainImporter } from "./main-importer.js";
 const logger = Logger.new(import.meta.filename, "fuzztarget");
 /** Dedicated subdirectory under the configured base path that the fuzzer owns and wipes. */
 const FUZZ_DB_SUBDIR = "typeberry-fuzz-db";
 const FUZZ_DB_FJALL = "fjall-hybrid";
-const FUZZ_DB_LMDB = "lmdb-hybrid";
-const FUZZ_DB_OPTIONS = [FUZZ_DB_FJALL, FUZZ_DB_LMDB];
-/** Subdirectory (under the fuzzer's db dir) holding the reused fjall values keyspace. */
-const FUZZ_FJALL_VALUES_SUBDIR = "values-session";
+const FUZZ_DB_OPTIONS = [FUZZ_DB_FJALL, "fjall"];
+/** The partitions used by FjallBlocks and FjallStates in the full-fjall backend. */
+const FUZZ_FJALL_PARTITIONS = ["headers", "extrinsics", "postStateRoots", "states", "values"];
 /**
- * Size of the fjall block-cache for the fuzz session. Values pile up across
- * resets (for fjall we do not wipe between them), so this cache is what keeps
- * the resident memory bounded.
+ * Size of the fjall block-cache for the fuzz session. The keyspace stays open
+ * across resets, so this cache is what keeps the resident memory bounded.
  */
 const FUZZ_FJALL_CACHE_BYTES = 128 * 1024 * 1024;
+/** Rebuild the fjall-hybrid keyspace every N resets to limit LSM read amplification. */
+const REBUILD_FJALL_HYBRID_KEYSPACE_EVERY = 50;
 /**
  * Resolve the directory the fuzzer should use for its on-disk database, or
  * `undefined` for an in-memory database. The dedicated `FUZZ_DB_SUBDIR` is
@@ -62,7 +62,6 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
     const { jamNodeConfig: config } = fuzzConfig;
     const fuzzDbBase = resolveFuzzDbBase(config.node.databaseBasePath);
     const rawFuzzDb = process.env.JAM_FUZZ_DB?.trim() ?? "";
-    // Using experimental fjall-hybrid by default, with an option to test lmdb as well.
     const hybridStateBackend = rawFuzzDb === "" ? FUZZ_DB_FJALL : rawFuzzDb;
     if (!isValidStateBackend(hybridStateBackend)) {
         throw new Error(`JAM_FUZZ_DB must be one of: ${FUZZ_DB_OPTIONS} (got: "${rawFuzzDb}").`);
@@ -71,10 +70,11 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
         logger.info `🗄️ Fuzz persistent backend: ${hybridStateBackend}.`;
     }
     let runningNode = null;
-    // The fjall values keyspace is opened once per fuzz session and reused on
-    // every reset, because opening it is the slow part. Only the in-memory blocks
-    // and leaf sets are rebuilt for each vector. fjall-hybrid only.
-    let fjallSession = null;
+    // The fjall keyspace is opened once per fuzz session and reused on every
+    // reset, because opening it is the slow part.
+    let fjallKeyspace = null;
+    // Track how many times resetState has been called for periodic fjall keyspace rebuilds.
+    let resetCount = 0;
     // Set when close() starts. Guards resetState so a fuzz command arriving
     // mid-shutdown can't build a fresh node that close() then orphans.
     let isClosing = false;
@@ -112,6 +112,8 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
                     runningNode = null;
                     await finish;
                 }
+                // Increment reset counter for periodic fjall session rebuilds.
+                resetCount++;
                 const buildNode = (databaseBasePath) => {
                     const isPersistent = databaseBasePath !== undefined;
                     return mainImporter({
@@ -138,37 +140,55 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
                         // also turns on compression further down, so the big values do not grow the
                         // db too much. Tiny stays uncompressed, its db is small and speed matters more.
                         ephemeral: isPersistent,
-                        stateBackend: isPersistent ? hybridStateBackend : "lmdb",
-                        // Reuse the session keyspace (fjall-hybrid only, other backends
-                        // ignore it). Nothing to pass for the in-memory fallback.
-                        sharedFjallSession: isPersistent ? (fjallSession ?? undefined) : undefined,
+                        stateBackend: isPersistent ? hybridStateBackend : "fjall",
+                        // Reuse the keyspace for both fjall backends. Nothing to pass for
+                        // the in-memory fallback.
+                        sharedFjallKeyspace: fjallKeyspace ?? undefined,
                     });
                 };
                 if (fuzzDbBase !== undefined) {
                     try {
+                        const fjallKeyspacePath = withRelPath(fuzzDbBase);
                         if (hybridStateBackend === FUZZ_DB_FJALL) {
-                            // fjall-hybrid: open the values keyspace once and reuse it on every
-                            // reset. The values partition is content-addressed and immutable, so
-                            // it is fine that values pile up across resets, the unreferenced ones
-                            // just sit there. `initializeDatabase` decides whether the db is
-                            // already initialized from the in-memory blocks, which we rebuild on
-                            // every reset, not from the values store, so reusing it does not
-                            // resume the previous run.
-                            if (fjallSession === null) {
-                                // Start from a clean slate once, then keep the keyspace open.
+                            // fjall-hybrid: values pile up across resets, so rebuild the
+                            // keyspace periodically to avoid LSM read amplification.
+                            if (resetCount === 1 || fjallKeyspace === null) {
+                                // First reset: start from a clean slate.
                                 await wipeFuzzDb(fuzzDbBase);
-                                fjallSession = await FjallValuesSession.open(`${withRelPath(fuzzDbBase)}/${FUZZ_FJALL_VALUES_SUBDIR}`, {
+                                fjallKeyspace = await FjallRoot.open(fjallKeyspacePath, {
                                     ephemeral: true,
                                     cacheSizeBytes: FUZZ_FJALL_CACHE_BYTES,
                                 });
-                                logger.info `🗄️ Opened reusable fjall values session at ${withRelPath(fuzzDbBase)}/${FUZZ_FJALL_VALUES_SUBDIR}`;
+                                logger.info `🗄️ Opened reusable fjall keyspace at ${fjallKeyspacePath}`;
+                            }
+                            else if (resetCount % REBUILD_FJALL_HYBRID_KEYSPACE_EVERY === 0) {
+                                // Periodic rebuild: close, wipe keyspace dir, and reopen.
+                                const keyspace = fjallKeyspace;
+                                fjallKeyspace = null;
+                                await keyspace.close().catch(() => { });
+                                await wipeFuzzDb(fuzzDbBase).catch(() => { });
+                                fjallKeyspace = await FjallRoot.open(fjallKeyspacePath, {
+                                    ephemeral: true,
+                                    cacheSizeBytes: FUZZ_FJALL_CACHE_BYTES,
+                                });
+                                logger.info `🗄️ Rebuilt reusable fjall keyspace at ${fjallKeyspacePath}`;
                             }
                         }
                         else {
-                            // lmdb-hybrid: keep the old behaviour, wipe and reopen on every
-                            // reset. A fresh db each reset makes `initializeDatabase` set up
-                            // genesis again instead of resuming the previous run.
-                            await wipeFuzzDb(fuzzDbBase);
+                            // full-fjall: keep one keyspace open and recycle only the five
+                            // partitions used by FjallBlocks/FjallStates.
+                            if (resetCount === 1 || fjallKeyspace === null) {
+                                await wipeFuzzDb(fuzzDbBase);
+                                fjallKeyspace = await FjallRoot.open(fjallKeyspacePath, {
+                                    ephemeral: true,
+                                    cacheSizeBytes: FUZZ_FJALL_CACHE_BYTES,
+                                });
+                                logger.info `🗄️ Opened reusable fjall keyspace at ${fjallKeyspacePath}`;
+                            }
+                            else if (fjallKeyspace !== null) {
+                                const keyspace = fjallKeyspace;
+                                await Promise.all(FUZZ_FJALL_PARTITIONS.map((name) => keyspace.deletePartition(name)));
+                            }
                         }
                         runningNode = await buildNode(fuzzDbBase);
                         return await runningNode.getBestStateRootHash();
@@ -197,9 +217,9 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
             isClosing = true;
             // Stop accepting connections + unlink the socket.
             closeFuzzTarget();
-            // Drain the active session (flush + close DB). Swallow errors so a
+            // Drain the active reset (flush + close DB). Swallow errors so a
             // failing close still lets the process exit 0; the db is wiped next.
-            // The node references the shared fjall session, so it must close first.
+            // The node references the shared fjall keyspace, so it must close first.
             if (activeReset !== null) {
                 await activeReset.catch((e) => logger.error `Error waiting for fuzz reset: ${e}`);
             }
@@ -208,11 +228,11 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
                 runningNode = null;
                 await node.close().catch((e) => logger.error `Error closing fuzz node: ${e}`);
             }
-            // Release the reused fjall values keyspace before wiping its files.
-            if (fjallSession !== null) {
-                const session = fjallSession;
-                fjallSession = null;
-                await session.close().catch((e) => logger.error `Error closing fjall session: ${e}`);
+            // Release the reused fjall keyspace before wiping its files.
+            if (fjallKeyspace !== null) {
+                const keyspace = fjallKeyspace;
+                fjallKeyspace = null;
+                await keyspace.close().catch((e) => logger.error `Error closing fjall keyspace: ${e}`);
             }
             if (fuzzDbBase !== undefined) {
                 await wipeFuzzDb(fuzzDbBase).catch(() => { });

package/packages/jam/node/main-importer.d.ts

@@ -1,25 +1,20 @@
-import { type FjallValuesSession } from "#@typeberry/workers-api-node";
+import { type FjallRoot } from "#@typeberry/workers-api-node";
 import type { JamConfig } from "./jam-config.js";
 import type { NodeApi } from "./main.js";
-export type StateBackend = "lmdb" | "fjall" | "lmdb-hybrid" | "fjall-hybrid";
+export type StateBackend = "fjall" | "fjall-hybrid";
 export type ImporterOptions = {
     initGenesisFromAncestry?: boolean;
     dummyFinalityDepth?: number;
     pruneBlocks?: boolean;
     /** Open the database without fsync/compression. Only safe for throwaway dbs (e.g. fuzzing). */
     ephemeral?: boolean;
-    /**
-     * Persistent backend used when `databaseBasePath` is set. Defaults to config's backend (fjall unless overridden).
-     *
-     * lmdb and lmdb-hybrid are deprecated and retained as explicit fallbacks.
-     */
+    /** Persistent backend used when `databaseBasePath` is set. Defaults to fjall. */
     stateBackend?: StateBackend;
     /**
-     * Reuse an already-open fjall values session instead of opening a fresh
-     * keyspace. Only used when `stateBackend === "fjall-hybrid"`. The fuzz target
-     * opens one per run and reuses it across resets.
+     * Reuse an already-open fjall keyspace instead of opening a fresh keyspace
+     * from `dbPath`. Used by fjall and fjall-hybrid fuzz targets.
      */
-    sharedFjallSession?: FjallValuesSession;
+    sharedFjallKeyspace?: FjallRoot;
 };
 export declare function mainImporter(config: JamConfig, withRelPath: (v: string) => string, options?: ImporterOptions): Promise<NodeApi>;
 //# sourceMappingURL=main-importer.d.ts.map

package/packages/jam/node/main-importer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main-importer.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main-importer.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAC;AAE7E,MAAM,MAAM,eAAe,GAAG;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC;AAEF,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAqHlB"}
+{"version":3,"file":"main-importer.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main-importer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAA4D,MAAM,6BAA6B,CAAC;AAEvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,SAAS,CAAC;CACjC,CAAC;AAEF,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAqGlB"}

package/packages/jam/node/main-importer.js

@@ -1,12 +1,12 @@
 import { Bytes } from "#@typeberry/bytes";
 import { PvmBackend } from "#@typeberry/config";
-import { KnownChainSpec, RegularStateBackend } from "#@typeberry/config-node";
+import { KnownChainSpec } from "#@typeberry/config-node";
 import { bandersnatch, initWasm } from "#@typeberry/crypto";
 import { Blake2b, HASH_SIZE } from "#@typeberry/hash";
 import { createImporter, ImporterConfig } from "#@typeberry/importer";
 import { tryAsU16 } from "#@typeberry/numbers";
 import { CURRENT_SUITE, CURRENT_VERSION, Result, resultToString, version } from "#@typeberry/utils";
-import { FjallWorkerConfig, HybridWorkerConfig, InMemWorkerConfig, LmdbWorkerConfig, } from "#@typeberry/workers-api-node";
+import { FjallWorkerConfig, HybridWorkerConfig, InMemWorkerConfig } from "#@typeberry/workers-api-node";
 import { getChainSpec, getDatabasePath, initializeDatabase, logger } from "./common.js";
 const zeroHash = Bytes.zero(HASH_SIZE).asOpaque();
 export async function mainImporter(config, withRelPath, options = {}) {
@@ -18,13 +18,8 @@ export async function mainImporter(config, withRelPath, options = {}) {
     logger.info `🐇 Bandersnatch ${bandesnatchNative.isOk ? "native 🚀" : `using wasm: ${bandesnatchNative.error}`}`;
     // Single source of truth for the states db backend: drives both the log line
     // below and the worker config picked further down.
-    const dbBackend = config.node.databaseBasePath === undefined
-        ? "in-memory"
-        : (options.stateBackend ?? config.node.stateBackend ?? RegularStateBackend.Fjall);
+    const dbBackend = config.node.databaseBasePath === undefined ? "in-memory" : (options.stateBackend ?? "fjall");
     logger.info `🗄️ States DB: ${dbBackend}.`;
-    if (dbBackend === "lmdb" || dbBackend === "lmdb-hybrid") {
-        logger.warn `🗄️ The ${dbBackend} state backend is deprecated. Use fjall unless you need a temporary fallback.`;
-    }
     const chainSpec = getChainSpec(config.node.flavor);
     const blake2b = await Blake2b.createHasher();
     const nodeName = config.nodeName;
@@ -44,7 +39,7 @@ export async function mainImporter(config, withRelPath, options = {}) {
             blake2b,
             workerParams,
         })
-        : dbBackend === "lmdb-hybrid" || dbBackend === "fjall-hybrid"
+        : dbBackend === "fjall-hybrid"
             ? await HybridWorkerConfig.new({
                 nodeName,
                 chainSpec,
@@ -53,35 +48,26 @@ export async function mainImporter(config, withRelPath, options = {}) {
                 workerParams,
                 ephemeral,
                 compression,
-                backend: dbBackend === "lmdb-hybrid" ? "lmdb" : "fjall",
-                sharedFjallSession: options.sharedFjallSession,
+                sharedFjallKeyspace: options.sharedFjallKeyspace,
             })
-            : dbBackend === "fjall"
-                ? FjallWorkerConfig.new({
-                    nodeName,
-                    chainSpec,
-                    blake2b,
-                    dbPath,
-                    workerParams,
-                    ephemeral,
-                })
-                : LmdbWorkerConfig.new({
-                    nodeName,
-                    chainSpec,
-                    blake2b,
-                    dbPath,
-                    workerParams,
-                    ephemeral,
-                });
+            : FjallWorkerConfig.new({
+                nodeName,
+                chainSpec,
+                blake2b,
+                dbPath,
+                workerParams,
+                ephemeral,
+                sharedFjallKeyspace: options.sharedFjallKeyspace,
+            });
     // Initialize the database with genesis state and block if there isn't one.
     logger.info `🛢️ Opening database at ${dbPath}`;
     const rootDb = await workerConfig.openDatabase({ readonly: false });
     await initializeDatabase(chainSpec, blake2b, genesisHeaderHash, rootDb, config.node.chainSpec, config.ancestry, {
         initGenesisFromAncestry: options.initGenesisFromAncestry,
     });
-    await rootDb.close();
     const { db, importer } = await createImporter(workerConfig, {
         initGenesisFromAncestry: options.initGenesisFromAncestry,
+        db: rootDb,
     });
     await importer.prepareForNextEpoch();
     const api = {

package/packages/jam/node/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAc,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,mBAAmB,CAAC;AAgB/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAkC,MAAM,EAAW,MAAM,kBAAkB,CAAC;AAYnF,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAWhE,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAsB,IAAI,CACxB,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,OAAO,CAAC,OAAO,CAAC,CA2LlB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/node/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAc,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,mBAAmB,CAAC;AAe/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAkC,MAAM,EAAW,MAAM,kBAAkB,CAAC;AAWnF,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAWhE,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAsB,IAAI,CACxB,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,OAAO,CAAC,OAAO,CAAC,CAuLlB"}

package/packages/jam/node/main.js

@@ -1,7 +1,6 @@
 import { isMainThread } from "node:worker_threads";
 import { AUTHORSHIP_NETWORK_PORT } from "#@typeberry/comms-authorship-network";
 import { PvmBackend } from "#@typeberry/config";
-import { RegularStateBackend } from "#@typeberry/config-node";
 import { initWasm } from "#@typeberry/crypto";
 import { deriveBandersnatchSecretKey, deriveEd25519SecretKey, trivialSeed, } from "#@typeberry/crypto/key-derivation.js";
 import { Blake2b } from "#@typeberry/hash";
@@ -11,7 +10,7 @@ import { Listener } from "#@typeberry/listener";
 import { tryAsU16, tryAsU32 } from "#@typeberry/numbers";
 import { CURRENT_SUITE, CURRENT_VERSION, Result, version } from "#@typeberry/utils";
 import { DirectPort, DirectWorkerConfig } from "#@typeberry/workers-api";
-import { FjallWorkerConfig, InMemWorkerConfig, LmdbWorkerConfig, logHostEnvironment, ThreadPort, } from "#@typeberry/workers-api-node";
+import { FjallWorkerConfig, InMemWorkerConfig, logHostEnvironment, ThreadPort, } from "#@typeberry/workers-api-node";
 import { getChainSpec, getDatabasePath, initializeDatabase, logger } from "./common.js";
 import { initializeExtensions } from "./extensions.js";
 import * as metrics from "./metrics.js";
@@ -30,12 +29,9 @@ export async function main(config, withRelPath, telemetry) {
     const blake2b = await Blake2b.createHasher();
     const nodeName = config.nodeName;
     const isInMemory = config.node.databaseBasePath === undefined;
-    logger.info `🗄️ States DB: ${isInMemory ? "in-memory" : config.node.stateBackend}.`;
-    if (!isInMemory && config.node.stateBackend === RegularStateBackend.Lmdb) {
-        logger.warn `🗄️ The lmdb state backend is deprecated. Use state_backend="fjall" unless you need a temporary fallback.`;
-    }
+    logger.info `🗄️ States DB: ${isInMemory ? "in-memory" : "fjall"}.`;
     const { dbPath, genesisHeaderHash } = getDatabasePath(blake2b, nodeName, config.node.chainSpec.genesisHeader, withRelPath(config.node.databaseBasePath ?? "<in-memory>"));
-    const baseConfig = { nodeName, chainSpec, blake2b, dbPath, stateBackend: config.node.stateBackend };
+    const baseConfig = { nodeName, chainSpec, blake2b, dbPath };
     const importerParams = {
         ...baseConfig,
         workerParams: ImporterConfig.create({
@@ -63,9 +59,8 @@ export async function main(config, withRelPath, telemetry) {
         throw e;
     }
     // fjall-js shares the engine explicitly and requires every handle to close.
-    // Keep lmdb's historical main-thread handle open until shutdown.
     let mainRootDb = rootDb;
-    if (!importerConfig.isInMemory && config.node.stateBackend === RegularStateBackend.Fjall) {
+    if (!importerConfig.isInMemory) {
         await rootDb.close();
         mainRootDb = null;
     }
@@ -241,11 +236,6 @@ const initNetwork = async (importer, params, baseConfig, genesisHeaderHash, netw
     });
     return { closeNetwork: finish, networkApi: network, networkWorker: worker };
 };
-function createPersistentWorkerConfig({ stateBackend, ...params }) {
-    switch (stateBackend) {
-        case RegularStateBackend.Fjall:
-            return FjallWorkerConfig.new(params);
-        case RegularStateBackend.Lmdb:
-            return LmdbWorkerConfig.new(params);
-    }
+function createPersistentWorkerConfig(params) {
+    return FjallWorkerConfig.new(params);
 }

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

@@ -0,0 +1,3 @@
+export { handlers as rpcHandlers } from "./src/handlers.js";
+export { RpcServer } from "./src/server.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/packages/jam/rpc/index.js

@@ -0,0 +1,2 @@
+export { handlers as rpcHandlers } from "./src/handlers.js";
+export { RpcServer } from "./src/server.js";

package/packages/jam/rpc/src/handlers/best-block.d.ts

@@ -0,0 +1,6 @@
+import { type Handler } from "#@typeberry/rpc-validation";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/772ce90bfc33f4e1de9de3bbe10c561753cc0d41/JIP-2.md#bestblock
+ */
+export declare const bestBlock: Handler<"bestBlock">;
+//# sourceMappingURL=best-block.d.ts.map

package/packages/jam/rpc/src/handlers/best-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-block.d.ts","sourceRoot":"","sources":["../../../../../../../packages/jam/rpc/src/handlers/best-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAsC,MAAM,2BAA2B,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,WAAW,CAgB1C,CAAC"}

package/packages/jam/rpc/src/handlers/best-block.js

@@ -0,0 +1,15 @@
+import { RpcError, RpcErrorCode, validation } from "#@typeberry/rpc-validation";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/772ce90bfc33f4e1de9de3bbe10c561753cc0d41/JIP-2.md#bestblock
+ */
+export const bestBlock = async (_params, { db }) => {
+    const headerHash = db.blocks.getBestHeaderHash();
+    const header = db.blocks.getHeader(headerHash);
+    if (header === null) {
+        throw new RpcError(RpcErrorCode.BlockUnavailable, `Best header not found with hash: ${headerHash.toString()}`, validation.hash.encode(headerHash.raw));
+    }
+    return {
+        header_hash: headerHash.raw,
+        slot: header.timeSlotIndex.materialize(),
+    };
+};

package/packages/jam/rpc/src/handlers/finalized-block.d.ts

@@ -0,0 +1,6 @@
+import type { Handler } from "#@typeberry/rpc-validation";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/772ce90bfc33f4e1de9de3bbe10c561753cc0d41/JIP-2.md#finalizedblock
+ */
+export declare const finalizedBlock: Handler<"finalizedBlock">;
+//# sourceMappingURL=finalized-block.d.ts.map

package/packages/jam/rpc/src/handlers/finalized-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalized-block.d.ts","sourceRoot":"","sources":["../../../../../../../packages/jam/rpc/src/handlers/finalized-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGzD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAEpD,CAAC"}