@typeberry/lib 0.10.0 → 0.11.0-829b7ea

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeberry/lib",
-  "version": "0.10.0",
+  "version": "0.11.0-829b7ea",
   "description": "Typeberry Library",
   "main": "./bin/lib/index.js",
   "types": "./bin/lib/index.d.ts",
@@ -152,8 +152,6 @@
     "#@typeberry/lib/*": "./bin/lib/*",
     "#@typeberry/pvm": "./bin/pvm/index.js",
     "#@typeberry/pvm/*": "./bin/pvm/*",
-    "#@typeberry/rpc": "./bin/rpc/index.js",
-    "#@typeberry/rpc/*": "./bin/rpc/*",
     "#@typeberry/test-runner": "./bin/test-runner/index.js",
     "#@typeberry/test-runner/*": "./bin/test-runner/*",
     "#@typeberry/configs": "./packages/configs/index.js",
@@ -216,8 +214,6 @@
     "#@typeberry/database/*": "./packages/jam/database/*",
     "#@typeberry/database-fjall": "./packages/jam/database-fjall/index.js",
     "#@typeberry/database-fjall/*": "./packages/jam/database-fjall/*",
-    "#@typeberry/database-lmdb": "./packages/jam/database-lmdb/index.js",
-    "#@typeberry/database-lmdb/*": "./packages/jam/database-lmdb/*",
     "#@typeberry/executor": "./packages/jam/executor/index.js",
     "#@typeberry/executor/*": "./packages/jam/executor/*",
     "#@typeberry/fuzz-proto": "./packages/jam/fuzz-proto/index.js",
@@ -230,6 +226,8 @@
     "#@typeberry/jamnp-s/*": "./packages/jam/jamnp-s/*",
     "#@typeberry/node": "./packages/jam/node/index.js",
     "#@typeberry/node/*": "./packages/jam/node/*",
+    "#@typeberry/rpc": "./packages/jam/rpc/index.js",
+    "#@typeberry/rpc/*": "./packages/jam/rpc/*",
     "#@typeberry/rpc-client": "./packages/jam/rpc-client/index.js",
     "#@typeberry/rpc-client/*": "./packages/jam/rpc-client/*",
     "#@typeberry/rpc-validation": "./packages/jam/rpc-validation/index.js",

package/packages/configs/index.d.ts

@@ -33,6 +33,9 @@ export declare const configs: {
             };
         };
         database_base_path: string;
+        rpc: {
+            port: number;
+        };
     };
     devTiny: {
         $schema: string;
@@ -67,6 +70,9 @@ export declare const configs: {
                 ff000000000000000000000000000000000000000000000000000000000000: string;
             };
         };
+        rpc: {
+            port: number;
+        };
     };
     devFull: {
         $schema: string;
@@ -96,6 +102,9 @@ export declare const configs: {
                 "10000000000000000000000000000000000000000000000000000000000000": string;
             };
         };
+        rpc: {
+            port: number;
+        };
     };
 };
 //# sourceMappingURL=index.d.ts.map

package/packages/configs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/configs/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/configs/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInB,CAAC"}

package/packages/configs/typeberry-default.json

@@ -34,5 +34,8 @@
             "ff000000000000000000000000000000000000000000000000000000000000": "00d1b097b4410b3a63446d7c57d093972a9744fcd2d74f4a5e2ec163610e6d6327ffffffffffffffff0a000000000000000a000000000000003418020000000000ffffffffffffffff04000000000000000000000000000000"
         }
     },
-    "database_base_path": "./database"
+    "database_base_path": "./database",
+    "rpc": {
+        "port": 19800
+    }
 }

package/packages/configs/typeberry-dev-full.json

@@ -25,5 +25,8 @@
             "0f000000000000000000000000000000000000000000000000000000000000": "000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
             "10000000000000000000000000000000000000000000000000000000000000": "00"
         }
+    },
+    "rpc": {
+        "port": 19800
     }
 }

package/packages/configs/typeberry-dev-tiny.json

@@ -30,5 +30,8 @@
             "10000000000000000000000000000000000000000000000000000000000000": "00",
             "ff000000000000000000000000000000000000000000000000000000000000": "00d1b097b4410b3a63446d7c57d093972a9744fcd2d74f4a5e2ec163610e6d6327ffffffffffffffff0a000000000000000a000000000000003418020000000000ffffffffffffffff04000000000000000000000000000000"
         }
+    },
+    "rpc": {
+        "port": 19800
     }
 }

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

@@ -1,3 +1,4 @@
 export * from "./jip-chain-spec.js";
 export * from "./node-config.js";
+export * from "./rpc.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC"}

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

@@ -1,2 +1,3 @@
 export * from "./jip-chain-spec.js";
 export * from "./node-config.js";
+export * from "./rpc.js";

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

@@ -2,6 +2,7 @@ import { PvmBackend } from "#@typeberry/config";
 import { type FromJson } from "#@typeberry/json-parser";
 import { AuthorshipOptions } from "./authorship.js";
 import { JipChainSpec } from "./jip-chain-spec.js";
+import { RpcOptions } from "./rpc.js";
 /** Development config. Will accept unsealed blocks for now. */
 export declare const DEV_TINY_CONFIG = "dev";
 export declare const DEV_FULL_CONFIG = "dev-full";
@@ -19,22 +20,15 @@ export declare enum KnownChainSpec {
     /** Full chain spec. */
     Full = "full"
 }
-/** Persistent regular-node database backend. */
-export declare enum RegularStateBackend {
-    /** @deprecated lmdb remains available as an explicit fallback, but fjall is the default backend. */
-    Lmdb = "lmdb",
-    Fjall = "fjall"
-}
 export declare const knownChainSpecFromJson: FromJson<KnownChainSpec>;
-export declare const regularStateBackendFromJson: FromJson<RegularStateBackend>;
 type NodeConfigurationJson = {
     $schema: string;
     version: number;
     flavor: KnownChainSpec;
     chain_spec: JipChainSpec;
     database_base_path?: string;
-    state_backend?: RegularStateBackend;
     authorship: AuthorshipOptions;
+    rpc?: RpcOptions;
 };
 export declare class NodeConfiguration {
     readonly $schema: string;
@@ -43,11 +37,11 @@ export declare class NodeConfiguration {
     readonly chainSpec: JipChainSpec;
     /** If database path is not provided, we load an in-memory db. */
     readonly databaseBasePath: string | undefined;
-    /** Persistent database backend used when `databaseBasePath` is set. */
-    readonly stateBackend: RegularStateBackend;
     readonly authorship: AuthorshipOptions;
+    /** Optional RPC server configuration. When present, an in-process RPC server is started. */
+    readonly rpc: RpcOptions | undefined;
     static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, NodeConfiguration>;
-    static new({ $schema, version, flavor, chain_spec, database_base_path, state_backend, authorship, }: NodeConfigurationJson): NodeConfiguration;
+    static new({ $schema, version, flavor, chain_spec, database_base_path, authorship, rpc }: NodeConfigurationJson): NodeConfiguration;
     private constructor();
 }
 export declare function loadConfig(config: string[], withRelPath: (p: string) => string): NodeConfiguration;

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

@@ -1 +1 @@
-{"version":3,"file":"node-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/node-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,+DAA+D;AAC/D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,2BAA2B;AAC3B,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,0BAA0B;AAC1B,oBAAY,cAAc;IACxB,uBAAuB;IACvB,IAAI,SAAS;IACb,uBAAuB;IACvB,IAAI,SAAS;CACd;AAED,gDAAgD;AAChD,oBAAY,mBAAmB;IAC7B,oGAAoG;IACpG,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,sBAAsB,EAS7B,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE/B,eAAO,MAAM,2BAA2B,EASlC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAEpC,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,qBAAa,iBAAiB;aAsCV,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,cAAc;aACtB,SAAS,EAAE,YAAY;IACvC,iEAAiE;aACjD,gBAAgB,EAAE,MAAM,GAAG,SAAS;IACpD,uEAAuE;aACvD,YAAY,EAAE,mBAAmB;aACjC,UAAU,EAAE,iBAAiB;IA7C/C,MAAM,CAAC,QAAQ,kFAWb;IAEF,MAAM,CAAC,GAAG,CAAC,EACT,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,EAAE,qBAAqB;IAexB,OAAO;CAWR;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,iBAAiB,CAuDlG"}
+{"version":3,"file":"node-config.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/node-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,+DAA+D;AAC/D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,2BAA2B;AAC3B,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,0BAA0B;AAC1B,oBAAY,cAAc;IACxB,uBAAuB;IACvB,IAAI,SAAS;IACb,uBAAuB;IACvB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,sBAAsB,EAS7B,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE/B,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,qBAAa,iBAAiB;aA8BV,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,cAAc;aACtB,SAAS,EAAE,YAAY;IACvC,iEAAiE;aACjD,gBAAgB,EAAE,MAAM,GAAG,SAAS;aACpC,UAAU,EAAE,iBAAiB;IAC7C,4FAA4F;aAC5E,GAAG,EAAE,UAAU,GAAG,SAAS;IArC7C,MAAM,CAAC,QAAQ,kFAWb;IAEF,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,qBAAqB;IAe/G,OAAO;CAWR;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,iBAAiB,CAuDlG"}

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

@@ -7,6 +7,7 @@ import { Logger } from "#@typeberry/logger";
 import { isBrowser } from "#@typeberry/utils";
 import { AuthorshipOptions } from "./authorship.js";
 import { JipChainSpec } from "./jip-chain-spec.js";
+import { RpcOptions } from "./rpc.js";
 const logger = Logger.new(import.meta.filename, "config");
 /** Development config. Will accept unsealed blocks for now. */
 export const DEV_TINY_CONFIG = "dev";
@@ -26,13 +27,6 @@ export var KnownChainSpec;
     /** Full chain spec. */
     KnownChainSpec["Full"] = "full";
 })(KnownChainSpec || (KnownChainSpec = {}));
-/** Persistent regular-node database backend. */
-export var RegularStateBackend;
-(function (RegularStateBackend) {
-    /** @deprecated lmdb remains available as an explicit fallback, but fjall is the default backend. */
-    RegularStateBackend["Lmdb"] = "lmdb";
-    RegularStateBackend["Fjall"] = "fjall";
-})(RegularStateBackend || (RegularStateBackend = {}));
 export const knownChainSpecFromJson = json.fromString((input, ctx) => {
     switch (input) {
         case KnownChainSpec.Tiny:
@@ -43,51 +37,41 @@ export const knownChainSpecFromJson = json.fromString((input, ctx) => {
             throw Error(`unknown network flavor: ${input} at ${ctx}`);
     }
 });
-export const regularStateBackendFromJson = json.fromString((input, ctx) => {
-    switch (input) {
-        case RegularStateBackend.Lmdb:
-            return RegularStateBackend.Lmdb;
-        case RegularStateBackend.Fjall:
-            return RegularStateBackend.Fjall;
-        default:
-            throw Error(`unknown state backend: ${input} at ${ctx}`);
-    }
-});
 export class NodeConfiguration {
     $schema;
     version;
     flavor;
     chainSpec;
     databaseBasePath;
-    stateBackend;
     authorship;
+    rpc;
     static fromJson = json.object({
         $schema: "string",
         version: "number",
         flavor: knownChainSpecFromJson,
         chain_spec: JipChainSpec.fromJson,
         database_base_path: json.optional("string"),
-        state_backend: json.optional(regularStateBackendFromJson),
         authorship: AuthorshipOptions.fromJson,
+        rpc: json.optional(RpcOptions.fromJson),
     }, NodeConfiguration.new);
-    static new({ $schema, version, flavor, chain_spec, database_base_path, state_backend, authorship, }) {
+    static new({ $schema, version, flavor, chain_spec, database_base_path, authorship, rpc }) {
         if (version !== 1) {
             throw new Error("Only version=1 config is supported.");
         }
-        return new NodeConfiguration($schema, version, flavor, chain_spec, database_base_path ?? undefined, state_backend ?? RegularStateBackend.Fjall, authorship);
+        return new NodeConfiguration($schema, version, flavor, chain_spec, database_base_path ?? undefined, authorship, rpc ?? undefined);
     }
     constructor($schema, version, flavor, chainSpec, 
     /** If database path is not provided, we load an in-memory db. */
-    databaseBasePath, 
-    /** Persistent database backend used when `databaseBasePath` is set. */
-    stateBackend, authorship) {
+    databaseBasePath, authorship, 
+    /** Optional RPC server configuration. When present, an in-process RPC server is started. */
+    rpc) {
         this.$schema = $schema;
         this.version = version;
         this.flavor = flavor;
         this.chainSpec = chainSpec;
         this.databaseBasePath = databaseBasePath;
-        this.stateBackend = stateBackend;
         this.authorship = authorship;
+        this.rpc = rpc;
     }
 }
 export function loadConfig(config, withRelPath) {

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

@@ -5,7 +5,8 @@ import { configs } from "#@typeberry/configs";
 import polkajamConfig from "#@typeberry/configs/typeberry-polkajam-dev.json" with { type: "json" };
 import { parseFromJson } from "#@typeberry/json-parser";
 import { workspacePathFix } from "#@typeberry/utils";
-import { KnownChainSpec, loadConfig, NodeConfiguration, RegularStateBackend } from "./node-config.js";
+import { KnownChainSpec, loadConfig, NodeConfiguration } from "./node-config.js";
+import { RpcOptions } from "./rpc.js";
 const withRelPath = workspacePathFix(`${import.meta.dirname}/../..`);
 const NODE_CONFIG_TEST = {
     $schema: "https://typeberry.dev/schemas/config-v1.schema.json",
@@ -40,12 +41,15 @@ describe("Importing Node Configuration", () => {
     it("should read the database base path", () => {
         assert.deepStrictEqual(config.databaseBasePath, "/tmp/jam-node-db");
     });
-    it("defaults to the fjall state backend", () => {
-        assert.deepStrictEqual(config.stateBackend, RegularStateBackend.Fjall);
+    it("defaults to no rpc config", () => {
+        assert.deepStrictEqual(config.rpc, undefined);
     });
-    it("should read the state backend", () => {
-        const lmdbConfig = parseFromJson({ ...NODE_CONFIG_TEST, state_backend: "lmdb" }, NodeConfiguration.fromJson);
-        assert.deepStrictEqual(lmdbConfig.stateBackend, RegularStateBackend.Lmdb);
+    it("should read rpc config when present", () => {
+        const withRpc = parseFromJson({ ...NODE_CONFIG_TEST, rpc: { port: 9999 } }, NodeConfiguration.fromJson);
+        assert.deepStrictEqual(withRpc.rpc, RpcOptions.new({ port: 9999 }));
+    });
+    it("should reject unknown config keys", () => {
+        assert.throws(() => parseFromJson({ ...NODE_CONFIG_TEST, state_backend: "fjall" }, NodeConfiguration.fromJson));
     });
     it("should read the chain spec", () => {
         assert.deepStrictEqual(config.chainSpec.id, "testnet");
@@ -74,6 +78,7 @@ describe("loadConfig", () => {
     it("should load default config", () => {
         const config = loadConfig(["default"], withRelPath);
         assert.deepStrictEqual(config, parseFromJson(configs.default, NodeConfiguration.fromJson));
+        assert.deepStrictEqual(config.rpc, RpcOptions.new({ port: 19800 }));
     });
     it("should load dev config", () => {
         const config = loadConfig(["dev"], withRelPath);

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

@@ -0,0 +1,11 @@
+/** RPC server options. */
+export declare class RpcOptions {
+    /** Port for the JSON-RPC WebSocket server. */
+    readonly port: number;
+    static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, RpcOptions>;
+    static new({ port }: {
+        port: number;
+    }): RpcOptions;
+    private constructor();
+}
+//# sourceMappingURL=rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/config-node/rpc.ts"],"names":[],"mappings":"AAGA,0BAA0B;AAC1B,qBAAa,UAAU;IAanB,8CAA8C;aAC9B,IAAI,EAAE,MAAM;IAb9B,MAAM,CAAC,QAAQ,2EAKb;IAEF,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAIrC,OAAO;CAIR"}

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

@@ -0,0 +1,16 @@
+import { json } from "#@typeberry/json-parser";
+/** RPC server options. */
+export class RpcOptions {
+    port;
+    static fromJson = json.object({
+        port: "number",
+    }, RpcOptions.new);
+    static new({ port }) {
+        return new RpcOptions(port);
+    }
+    constructor(
+    /** Port for the JSON-RPC WebSocket server. */
+    port) {
+        this.port = port;
+    }
+}

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

@@ -14,14 +14,7 @@ export interface InitStatesDb<T = State> {
     /** Insert a pre-defined initial state directly into the database. */
     insertInitialState(headerHash: HeaderHash, initialState: T): Promise<Result<OK, StateUpdateError>>;
 }
-/**
- * Interface for accessing states stored in the database.
- *
- * NOTE that the design of this interface is heavily influenced
- * by the LMDB implementation, so that we can implement it efficiently.
- *
- * See the documentation there for more detailed reasoning.
- */
+/** Interface for accessing states stored in the database. */
 export interface StatesDb<T extends State = State> {
     /** Compute a state root for given state. */
     getStateRoot(state: T): Promise<StateRootHash>;

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

@@ -1 +1 @@
-{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAe,MAAM,kBAAkB,CAAC;AAE/F,OAAO,EAAe,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE3D,0DAA0D;AAC1D,oBAAY,gBAAgB;IAC1B,oDAAoD;IACpD,QAAQ,IAAI;IACZ,iDAAiD;IACjD,MAAM,IAAI;CACX;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,KAAK;IACrC,qEAAqE;IACrE,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACpG;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC/C,4CAA4C;IAC5C,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/C;;;;OAIG;IACH,iBAAiB,CACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEzC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC;IAEvC;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE7C,4EAA4E;IAC5E,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;IAElC,6CAA6C;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,cAAe,YAAW,QAAQ,CAAC,aAAa,CAAC;IAQxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPzC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmE;IACtF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS;IAI1B,OAAO;IAID,iBAAiB,CACrB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAgBlC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAKhE,6CAA6C;IACvC,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAM7G,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAStD,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAI7C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI9B,KAAK;CACZ"}
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAe,MAAM,kBAAkB,CAAC;AAE/F,OAAO,EAAe,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE3D,0DAA0D;AAC1D,oBAAY,gBAAgB;IAC1B,oDAAoD;IACpD,QAAQ,IAAI;IACZ,iDAAiD;IACjD,MAAM,IAAI;CACX;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,KAAK;IACrC,qEAAqE;IACrE,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACpG;AAED,6DAA6D;AAC7D,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC/C,4CAA4C;IAC5C,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/C;;;;OAIG;IACH,iBAAiB,CACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEzC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC;IAEvC;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE7C,4EAA4E;IAC5E,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;IAElC,6CAA6C;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,cAAe,YAAW,QAAQ,CAAC,aAAa,CAAC;IAQxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPzC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmE;IACtF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS;IAI1B,OAAO;IAID,iBAAiB,CACrB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAgBlC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAKhE,6CAA6C;IACvC,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAM7G,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAStD,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAI7C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI9B,KAAK;CACZ"}

package/packages/jam/database/value-refs.d.ts

@@ -10,10 +10,9 @@ export interface ValueDelta {
 /**
  * Synchronous, read-only view of the persisted refcounting state.
  *
- * Both LMDB and fjall offer synchronous reads, so reads can go straight
- * to the backing store. All writes go through `ValueRefsUpdate` batches
- * instead, since persistent backends can only write asynchronously
- * (LMDB transactions, fjall inserts + persist).
+ * fjall offers synchronous reads, so reads can go straight to the backing
+ * store. All writes go through `ValueRefsUpdate` batches instead, since
+ * persistent backends can only write asynchronously (fjall inserts + persist).
  */
 export interface ValueRefsReader {
     /** How many leaves of the finalized-tip state reference the value. Missing keys read as `0`. */
@@ -28,7 +27,7 @@ export interface ValueRefsReader {
  *
  * The backend is responsible for applying the batch using its own write
  * primitive - ideally atomically with the state write that triggered it
- * (one LMDB transaction, one fjall persist).
+ * (one fjall persist).
  *
  * Counts are absolute values rather than increments, so applying the same
  * update more than once (e.g. on crash-replay) is harmless.

package/packages/jam/database/value-refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-refs.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/value-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,sEAAsE;IACtE,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3C,iGAAiG;IACjG,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IACvC,gFAAgF;IAChF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IACrC,oDAAoD;IACpD,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;IACtC,uDAAuD;IACvD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,kFAAkF;IAClF,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAQ9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD,yEAAyE;IACzE,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe;IAQjD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe;IAYhE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe;IAoBvD;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe;CAYxD;AA0ED;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;IACrF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgE;IAEvF,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI1C,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS;IAIpD,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAUrC"}
+{"version":3,"file":"value-refs.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/value-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,sEAAsE;IACtE,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3C,iGAAiG;IACjG,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IACvC,gFAAgF;IAChF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IACrC,oDAAoD;IACpD,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;IACtC,uDAAuD;IACvD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,kFAAkF;IAClF,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAQ9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD,yEAAyE;IACzE,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe;IAQjD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe;IAYhE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe;IAoBvD;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe;CAYxD;AA0ED;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;IACrF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgE;IAEvF,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI1C,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS;IAIpD,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAUrC"}

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;AAqBF;;;;;;;;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,CA6LrH"}

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

@@ -15,8 +15,7 @@ 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];
+const FUZZ_DB_OPTIONS = [FUZZ_DB_FJALL, "fjall"];
 /** Subdirectory (under the fuzzer's db dir) holding the reused fjall values keyspace. */
 const FUZZ_FJALL_VALUES_SUBDIR = "values-session";
 /**
@@ -25,6 +24,8 @@ const FUZZ_FJALL_VALUES_SUBDIR = "values-session";
  * the resident memory bounded.
  */
 const FUZZ_FJALL_CACHE_BYTES = 128 * 1024 * 1024;
+/** Rebuild the fjall-hybrid values session every N resets to limit LSM read amplification. */
+const REBUILD_FJALL_SESSION_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 +63,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}").`);
@@ -75,6 +75,8 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
     // 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;
+    // Track how many times resetState has been called for periodic fjall session 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 +114,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,36 +142,45 @@ 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",
+                        stateBackend: isPersistent ? hybridStateBackend : "fjall",
                         // Reuse the session keyspace (fjall-hybrid only, other backends
                         // ignore it). Nothing to pass for the in-memory fallback.
-                        sharedFjallSession: isPersistent ? (fjallSession ?? undefined) : undefined,
+                        sharedFjallSession: hybridStateBackend === "fjall-hybrid" ? (fjallSession ?? undefined) : undefined,
                     });
                 };
                 if (fuzzDbBase !== undefined) {
                     try {
                         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: manage a reused values session.
+                            // Rebuild it periodically to avoid LSM read amplification.
+                            const fjallSessionPath = `${withRelPath(fuzzDbBase)}/${FUZZ_FJALL_VALUES_SUBDIR}`;
+                            if (resetCount === 1) {
+                                // First reset: start from a clean slate.
                                 await wipeFuzzDb(fuzzDbBase);
-                                fjallSession = await FjallValuesSession.open(`${withRelPath(fuzzDbBase)}/${FUZZ_FJALL_VALUES_SUBDIR}`, {
+                                fjallSession = await FjallValuesSession.open(fjallSessionPath, {
+                                    ephemeral: true,
+                                    cacheSizeBytes: FUZZ_FJALL_CACHE_BYTES,
+                                });
+                                logger.info `🗄️ Opened reusable fjall values session at ${fjallSessionPath}`;
+                            }
+                            if (resetCount % REBUILD_FJALL_SESSION_EVERY === 0 && fjallSession !== null) {
+                                // Periodic rebuild: close, wipe session dir, and reopen.
+                                const session = fjallSession;
+                                fjallSession = null;
+                                await session.close().catch(() => { });
+                                await wipeFuzzDb(fjallSessionPath).catch(() => { });
+                            }
+                            if (fjallSession === null) {
+                                // No active session: create a fresh one.
+                                fjallSession = await FjallValuesSession.open(fjallSessionPath, {
                                     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 values session at ${fjallSessionPath}`;
                             }
                         }
                         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.
+                            // Other backends ("fjall"): wipe and reopen on every reset.
                             await wipeFuzzDb(fuzzDbBase);
                         }
                         runningNode = await buildNode(fuzzDbBase);