@typeberry/lib 0.10.0 → 0.11.0-6310ba4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeberry/lib",
-  "version": "0.10.0",
+  "version": "0.11.0-6310ba4",
   "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",
@@ -230,6 +228,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";
@@ -35,6 +36,7 @@ type NodeConfigurationJson = {
     database_base_path?: string;
     state_backend?: RegularStateBackend;
     authorship: AuthorshipOptions;
+    rpc?: RpcOptions;
 };
 export declare class NodeConfiguration {
     readonly $schema: string;
@@ -46,8 +48,10 @@ export declare class NodeConfiguration {
     /** 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, state_backend, 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,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;IAC9B,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,qBAAa,iBAAiB;aAyCV,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;IAC7C,4FAA4F;aAC5E,GAAG,EAAE,UAAU,GAAG,SAAS;IAlD7C,MAAM,CAAC,QAAQ,kFAYb;IAEF,MAAM,CAAC,GAAG,CAAC,EACT,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,GAAG,GACJ,EAAE,qBAAqB;IAgBxB,OAAO;CAaR;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";
@@ -61,6 +62,7 @@ export class NodeConfiguration {
     databaseBasePath;
     stateBackend;
     authorship;
+    rpc;
     static fromJson = json.object({
         $schema: "string",
         version: "number",
@@ -69,18 +71,21 @@ export class NodeConfiguration {
         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, state_backend, 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, state_backend ?? RegularStateBackend.Fjall, 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) {
+    stateBackend, authorship, 
+    /** Optional RPC server configuration. When present, an in-process RPC server is started. */
+    rpc) {
         this.$schema = $schema;
         this.version = version;
         this.flavor = flavor;
@@ -88,6 +93,7 @@ export class NodeConfiguration {
         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

@@ -6,6 +6,7 @@ import polkajamConfig from "#@typeberry/configs/typeberry-polkajam-dev.json" wit
 import { parseFromJson } from "#@typeberry/json-parser";
 import { workspacePathFix } from "#@typeberry/utils";
 import { KnownChainSpec, loadConfig, NodeConfiguration, RegularStateBackend } 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",
@@ -43,6 +44,13 @@ describe("Importing Node Configuration", () => {
     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 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 read the state backend", () => {
         const lmdbConfig = parseFromJson({ ...NODE_CONFIG_TEST, state_backend: "lmdb" }, NodeConfiguration.fromJson);
         assert.deepStrictEqual(lmdbConfig.stateBackend, RegularStateBackend.Lmdb);
@@ -74,6 +82,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/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;AAsBF;;;;;;;;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,CA8LrH"}

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

@@ -16,7 +16,7 @@ const logger = Logger.new(import.meta.filename, "fuzztarget");
 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, FUZZ_DB_LMDB, "fjall", "lmdb"];
 /** Subdirectory (under the fuzzer's db dir) holding the reused fjall values keyspace. */
 const FUZZ_FJALL_VALUES_SUBDIR = "values-session";
 /**
@@ -25,6 +25,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
@@ -75,6 +77,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 +116,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({
@@ -141,33 +147,42 @@ export async function mainFuzz(fuzzConfig, withRelPath) {
                         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,
+                        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.
+                            // All other backends ("fjall", "lmdb", "lmdb-hybrid"): wipe and reopen on every reset.
                             await wipeFuzzDb(fuzzDbBase);
                         }
                         runningNode = await buildNode(fuzzDbBase);

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,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,CAoHlB"}

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

@@ -79,9 +79,9 @@ export async function mainImporter(config, withRelPath, options = {}) {
     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/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"}

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

@@ -0,0 +1,7 @@
+import { bestBlock } from "./best-block.js";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/772ce90bfc33f4e1de9de3bbe10c561753cc0d41/JIP-2.md#finalizedblock
+ */
+export const finalizedBlock = async (params, context) => {
+    return bestBlock(params, context); // todo [seko] implement finalized block logic once finality is there
+};

package/packages/jam/rpc/src/handlers/list-services.d.ts

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

package/packages/jam/rpc/src/handlers/list-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-services.d.ts","sourceRoot":"","sources":["../../../../../../../packages/jam/rpc/src/handlers/list-services.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,OAAO,EAA0B,MAAM,2BAA2B,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,cAAc,CAWhD,CAAC"}

package/packages/jam/rpc/src/handlers/list-services.js

@@ -0,0 +1,15 @@
+import { Bytes } from "#@typeberry/bytes";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { RpcError, RpcErrorCode } from "#@typeberry/rpc-validation";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/772ce90bfc33f4e1de9de3bbe10c561753cc0d41/JIP-2.md#listservicesheader_hash
+ */
+export const listServices = async ([headerHash], { db }) => {
+    const hashOpaque = Bytes.fromBlob(headerHash, HASH_SIZE).asOpaque();
+    const state = db.states.getState(hashOpaque);
+    if (state === null) {
+        throw new RpcError(RpcErrorCode.Other, `Posterior state not found for block: ${hashOpaque.toString()}`);
+    }
+    const serviceIds = state.recentServiceIds();
+    return [...serviceIds];
+};

package/packages/jam/rpc/src/handlers/not-implemented.d.ts

@@ -0,0 +1,4 @@
+import { type GenericHandler, type validation } from "#@typeberry/rpc-validation";
+import type z from "zod";
+export declare const notImplemented: GenericHandler<z.infer<typeof validation.notImplementedSchema.input>, z.infer<typeof validation.notImplementedSchema.output>>;
+//# sourceMappingURL=not-implemented.d.ts.map

package/packages/jam/rpc/src/handlers/not-implemented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented.d.ts","sourceRoot":"","sources":["../../../../../../../packages/jam/rpc/src/handlers/not-implemented.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA0B,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACzG,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,cAAc,EAAE,cAAc,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,EACrD,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAGvD,CAAC"}

package/packages/jam/rpc/src/handlers/not-implemented.js

@@ -0,0 +1,4 @@
+import { RpcError, RpcErrorCode } from "#@typeberry/rpc-validation";
+export const notImplemented = () => {
+    throw new RpcError(RpcErrorCode.Other, "Method not implemented");
+};

package/packages/jam/rpc/src/handlers/parameters.d.ts

@@ -0,0 +1,7 @@
+import type { Handler } from "#@typeberry/rpc-validation";
+/**
+ * https://github.com/polkadot-fellows/JIPs/blob/77cba2dcc1887233d4b19371c05284ff761a5fa6/JIP-2.md#chain-parameters
+ * Returns the parameters of the current node/chain.
+ */
+export declare const parameters: Handler<"parameters">;
+//# sourceMappingURL=parameters.d.ts.map

package/packages/jam/rpc/src/handlers/parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../../../../../packages/jam/rpc/src/handlers/parameters.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAUzD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,YAAY,CA0C5C,CAAC"}