@typeberry/lib 0.9.0-6850f84 → 0.9.0-a723180

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeberry/lib",
-  "version": "0.9.0-6850f84",
+  "version": "0.9.0-a723180",
   "description": "Typeberry Library",
   "main": "./bin/lib/index.js",
   "types": "./bin/lib/index.d.ts",

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

@@ -1,4 +1,3 @@
-import type { JsonObject } from "#@typeberry/block-json";
 import { PvmBackend } from "#@typeberry/config";
 import { type FromJson } from "#@typeberry/json-parser";
 import { AuthorshipOptions } from "./authorship.js";
@@ -20,7 +19,23 @@ 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;
+};
 export declare class NodeConfiguration {
     readonly $schema: string;
     readonly version: number;
@@ -28,10 +43,13 @@ 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;
     static fromJson: import("@typeberry/json-parser").FromJsonWithParser<unknown, NodeConfiguration>;
-    static new({ $schema, version, flavor, chain_spec, database_base_path, authorship }: JsonObject<NodeConfiguration>): NodeConfiguration;
+    static new({ $schema, version, flavor, chain_spec, database_base_path, state_backend, authorship, }: NodeConfigurationJson): NodeConfiguration;
     private constructor();
 }
 export declare function loadConfig(config: string[], withRelPath: (p: string) => string): NodeConfiguration;
+export {};
 //# sourceMappingURL=node-config.d.ts.map

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,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,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,eAAO,MAAM,sBAAsB,EAS7B,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE/B,qBAAa,iBAAiB;aAqBV,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;IA1B/C,MAAM,CAAC,QAAQ,kFAUb;IAEF,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,iBAAiB,CAAC;IAOlH,OAAO;CASR;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;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"}

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

@@ -26,6 +26,13 @@ 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:
@@ -36,12 +43,23 @@ 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;
     static fromJson = json.object({
         $schema: "string",
@@ -49,22 +67,26 @@ export class NodeConfiguration {
         flavor: knownChainSpecFromJson,
         chain_spec: JipChainSpec.fromJson,
         database_base_path: json.optional("string"),
+        state_backend: json.optional(regularStateBackendFromJson),
         authorship: AuthorshipOptions.fromJson,
     }, NodeConfiguration.new);
-    static new({ $schema, version, flavor, chain_spec, database_base_path, authorship }) {
+    static new({ $schema, version, flavor, chain_spec, database_base_path, state_backend, authorship, }) {
         if (version !== 1) {
             throw new Error("Only version=1 config is supported.");
         }
-        return new NodeConfiguration($schema, version, flavor, chain_spec, database_base_path ?? undefined, authorship);
+        return new NodeConfiguration($schema, version, flavor, chain_spec, database_base_path ?? undefined, state_backend ?? RegularStateBackend.Fjall, authorship);
     }
     constructor($schema, version, flavor, chainSpec, 
     /** If database path is not provided, we load an in-memory db. */
-    databaseBasePath, authorship) {
+    databaseBasePath, 
+    /** Persistent database backend used when `databaseBasePath` is set. */
+    stateBackend, authorship) {
         this.$schema = $schema;
         this.version = version;
         this.flavor = flavor;
         this.chainSpec = chainSpec;
         this.databaseBasePath = databaseBasePath;
+        this.stateBackend = stateBackend;
         this.authorship = authorship;
     }
 }

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

@@ -5,7 +5,7 @@ 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 } from "./node-config.js";
+import { KnownChainSpec, loadConfig, NodeConfiguration, RegularStateBackend } from "./node-config.js";
 const withRelPath = workspacePathFix(`${import.meta.dirname}/../..`);
 const NODE_CONFIG_TEST = {
     $schema: "https://typeberry.dev/schemas/config-v1.schema.json",
@@ -40,6 +40,13 @@ 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("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 the chain spec", () => {
         assert.deepStrictEqual(config.chainSpec.id, "testnet");
         assert(config.chainSpec.bootnodes !== undefined);

package/packages/jam/database/serialized-states-db.d.ts

@@ -15,6 +15,8 @@ export declare class InMemorySerializedStates implements StatesDb<SerializedStat
     private readonly blake2b;
     private readonly db;
     private readonly valuesDb;
+    private readonly refsStore;
+    private readonly refs;
     static new({ chainSpec }: {
         chainSpec: ChainSpec;
     }): Promise<InMemorySerializedStates>;
@@ -27,8 +29,9 @@ export declare class InMemorySerializedStates implements StatesDb<SerializedStat
     getStateRoot(state: SerializedState<LeafDb>): Promise<StateRootHash>;
     updateAndSetState(header: HeaderHash, state: SerializedState<LeafDb>, update: Partial<State & ServicesUpdate>): Promise<Result<OK, StateUpdateError>>;
     getState(header: HeaderHash): SerializedState<LeafDb> | null;
-    commitFinalized(_headers: HeaderHash[]): void;
+    commitFinalized(headers: HeaderHash[]): void;
     markUnused(header: HeaderHash): void;
+    private applyRefs;
     close(): Promise<void>;
 }
 //# sourceMappingURL=serialized-states-db.d.ts.map

package/packages/jam/database/serialized-states-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialized-states-db.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/serialized-states-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EAGlB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE5E,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAEhG,sCAAsC;AACtC,qBAAa,wBAAyB,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAc1G,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAyE;IAC5F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8D;WAE1E,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE;IAKxD,MAAM,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAIpF,OAAO;IAKD,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAiBxG,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpE,iBAAiB,CACrB,MAAM,EAAE,UAAU,EAClB,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;IAsBxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAkB5D,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAK7C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI9B,KAAK;CACZ"}
+{"version":3,"file":"serialized-states-db.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database/serialized-states-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EAGlB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG5E,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAEhG,sCAAsC;AACtC,qBAAa,wBAAyB,YAAW,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;IAgB1G,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAyE;IAC5F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8D;IACvF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;WAEzC,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE;IAKxD,MAAM,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAIpF,OAAO;IAKD,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAkBxG,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpE,iBAAiB,CACrB,MAAM,EAAE,UAAU,EAClB,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;IAwBxC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IAkB5D,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAI5C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKpC,OAAO,CAAC,SAAS;IAOX,KAAK;CACZ"}

package/packages/jam/database/serialized-states-db.js

@@ -5,12 +5,15 @@ import { leafComparator } from "#@typeberry/trie";
 import { OK, Result } from "#@typeberry/utils";
 import { LeafDb } from "./leaf-db.js";
 import { updateLeafs } from "./leaf-db-update.js";
+import { InMemoryValueRefsStore, ValueRefs } from "./value-refs.js";
 /** In-memory serialized-states db. */
 export class InMemorySerializedStates {
     spec;
     blake2b;
     db = HashDictionary.new();
     valuesDb = HashDictionary.new();
+    refsStore = new InMemoryValueRefsStore();
+    refs = new ValueRefs(this.refsStore);
     static async new({ chainSpec }) {
         const blake2b = await Blake2b.createHasher();
         return new InMemorySerializedStates(chainSpec, blake2b);
@@ -30,6 +33,7 @@ export class InMemorySerializedStates {
             this.valuesDb.set(val[0], val[1]);
         }
         this.db.set(headerHash, leafs);
+        this.applyRefs(this.refs.onInitial(values.map((v) => v[0])));
         return Result.ok(OK);
     }
     async getStateRoot(state) {
@@ -40,17 +44,19 @@ export class InMemorySerializedStates {
         const updatedValues = serializeStateUpdate(this.spec, blake2b, update);
         // make sure to clone the leafs before writing, since the collection is re-used.
         const newLeafs = SortedSet.fromSortedArray(leafComparator, state.backend.leafs.array);
-        const { values, leafs } = updateLeafs(newLeafs, blake2b, updatedValues);
+        const { values, removed, leafs } = updateLeafs(newLeafs, blake2b, updatedValues);
         // make sure to reset the cache and re-create leafsdb lookup
         state.updateBackend(LeafDb.fromLeaves(leafs, state.backend.db));
         // insert values to the db
         // valuesdb can be shared between all states because it's just
-        // <valuehash> -> <value> mapping and existence is managed by trie leafs.
+        // <valuehash> -> <value> mapping and existence is managed by value
+        // refcounting, driven by the per-block deltas recorded below.
         for (const val of values) {
             this.valuesDb.set(val[0], val[1]);
         }
         // store new set of leaves
         this.db.set(header, leafs);
+        this.applyRefs(this.refs.onImport(header, { inserted: values.map((v) => v[0]), removed }));
         return Result.ok(OK);
     }
     getState(header) {
@@ -70,12 +76,18 @@ export class InMemorySerializedStates {
         });
         return SerializedState.new(this.spec, this.blake2b, leafDb);
     }
-    commitFinalized(_headers) {
-        // No value pruning here: this in-memory db keeps every value in a plain map
-        // and is not the long-running fuzz target the refcounting is meant for.
+    commitFinalized(headers) {
+        this.applyRefs(this.refs.commitFinalized(headers));
     }
     markUnused(header) {
+        this.applyRefs(this.refs.releaseUnfinalized(header));
         this.db.delete(header);
     }
+    applyRefs(update) {
+        this.refsStore.apply(update);
+        for (const v of update.removeValues) {
+            this.valuesDb.delete(v);
+        }
+    }
     async close() { }
 }

package/packages/jam/database/serialized-states-db.test.d.ts

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

package/packages/jam/database/serialized-states-db.test.d.ts.map

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

package/packages/jam/database/serialized-states-db.test.js

@@ -0,0 +1,109 @@
+import assert from "node:assert";
+import { before, describe, it } from "node:test";
+import { tryAsServiceId } from "#@typeberry/block";
+import { Bytes, BytesBlob } from "#@typeberry/bytes";
+import { tinyChainSpec } from "#@typeberry/config";
+import { Blake2b, HASH_SIZE } from "#@typeberry/hash";
+import { StorageItem, UpdateStorage } from "#@typeberry/state";
+import { testState } from "#@typeberry/state/test.utils.js";
+import { StateEntries } from "#@typeberry/state-merkleization";
+import { asOpaqueType, deepEqual, OK, Result } from "#@typeberry/utils";
+import { InMemorySerializedStates } from "./serialized-states-db.js";
+let blake2b;
+before(async () => {
+    blake2b = await Blake2b.createHasher();
+});
+const spec = tinyChainSpec;
+function hh(n) {
+    return Bytes.fill(HASH_SIZE, n).asOpaque();
+}
+const storageKey = asOpaqueType(BytesBlob.blobFromString("test-key"));
+/** A state update writing a single large (non-embedded) value under `storageKey`. */
+function storageUpdate(value) {
+    const item = StorageItem.create({ key: storageKey, value: BytesBlob.blobFromString(value) });
+    return {
+        storage: new Map([[tryAsServiceId(0), [UpdateStorage.set({ storage: item })]]]),
+    };
+}
+// > 32 bytes => stored in the values db (not embedded in the leaf).
+const BIG_1 = "a".repeat(100);
+const BIG_2 = "b".repeat(100);
+async function newStates() {
+    const states = InMemorySerializedStates.withHasher({ chainSpec: spec, blake2b });
+    const res = await states.insertInitialState(hh(0), StateEntries.serializeInMemory(spec, blake2b, testState()));
+    deepEqual(res, Result.ok(OK));
+    return states;
+}
+/** `true` if every value referenced by the state can still be resolved. */
+function canReadFully(state) {
+    if (state === null) {
+        return false;
+    }
+    try {
+        state.backend.intoStateEntries();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe("InMemorySerializedStates value refcounting", () => {
+    it("keeps a replaced value until the block replacing it finalizes", async () => {
+        const states = await newStates();
+        const s0 = states.getState(hh(0));
+        assert.ok(s0 !== null);
+        await states.updateAndSetState(hh(1), s0, storageUpdate(BIG_1));
+        // a handle to the post-1 state, surviving the pruning below
+        const stale1 = states.getState(hh(1));
+        const s1 = states.getState(hh(1));
+        assert.ok(s1 !== null);
+        await states.updateAndSetState(hh(2), s1, storageUpdate(BIG_2));
+        states.commitFinalized([hh(1)]);
+        assert.ok(canReadFully(stale1), "still referenced by the finalized tip");
+        states.commitFinalized([hh(2)]);
+        assert.ok(!canReadFully(stale1), "replaced value is dropped once the replacement finalizes");
+        assert.ok(canReadFully(states.getState(hh(2))), "the new finalized tip stays fully readable");
+    });
+    it("collects values of a pruned dead fork and keeps the surviving chain intact", async () => {
+        const states = await newStates();
+        const s0 = states.getState(hh(0));
+        assert.ok(s0 !== null);
+        await states.updateAndSetState(hh(1), s0, storageUpdate(BIG_1));
+        // a dead fork on top of genesis, inserting a different value
+        const fork = states.getState(hh(0));
+        assert.ok(fork !== null);
+        await states.updateAndSetState(hh(0xaa), fork, storageUpdate(BIG_2));
+        const staleFork = states.getState(hh(0xaa));
+        states.markUnused(hh(0xaa));
+        assert.strictEqual(states.getState(hh(0xaa)), null);
+        assert.ok(!canReadFully(staleFork), "fork-only value is collected");
+        assert.ok(canReadFully(states.getState(hh(1))), "surviving chain is unaffected");
+    });
+    it("does not collect a value shared with a pruned fork", async () => {
+        const states = await newStates();
+        const s0 = states.getState(hh(0));
+        assert.ok(s0 !== null);
+        await states.updateAndSetState(hh(1), s0, storageUpdate(BIG_1));
+        // the fork writes the very same value
+        const fork = states.getState(hh(0));
+        assert.ok(fork !== null);
+        await states.updateAndSetState(hh(0xaa), fork, storageUpdate(BIG_1));
+        states.markUnused(hh(0xaa));
+        assert.ok(canReadFully(states.getState(hh(1))), "value still referenced by the surviving chain");
+    });
+    it("follows the importer lifecycle: commit finalized, then prune", async () => {
+        const states = await newStates();
+        const s0 = states.getState(hh(0));
+        assert.ok(s0 !== null);
+        await states.updateAndSetState(hh(1), s0, storageUpdate(BIG_1));
+        const s1 = states.getState(hh(1));
+        assert.ok(s1 !== null);
+        await states.updateAndSetState(hh(2), s1, storageUpdate(BIG_2));
+        // finality round: 1 and 2 finalized, genesis and 1 pruned
+        states.commitFinalized([hh(1), hh(2)]);
+        states.markUnused(hh(0));
+        states.markUnused(hh(1));
+        assert.strictEqual(states.getState(hh(1)), null);
+        assert.ok(canReadFully(states.getState(hh(2))), "finalized tip fully readable after pruning");
+    });
+});

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

@@ -0,0 +1,25 @@
+import { type BlockView, type ExtrinsicView, type HeaderHash, type HeaderView, type StateRootHash } from "#@typeberry/block";
+import type { ChainSpec } from "#@typeberry/config";
+import type { BlocksDb } from "#@typeberry/database/blocks.js";
+import { type WithHash } from "#@typeberry/hash";
+import { type FjallRoot } from "./root.js";
+/** fjall-backed block storage. */
+export declare class FjallBlocks implements BlocksDb {
+    private readonly chainSpec;
+    private readonly root;
+    private readonly headers;
+    private readonly extrinsics;
+    private readonly postStateRoots;
+    static open(chainSpec: ChainSpec, root: FjallRoot): Promise<FjallBlocks>;
+    private constructor();
+    setPostStateRoot(hash: HeaderHash, postStateRoot: StateRootHash): Promise<void>;
+    getPostStateRoot(hash: HeaderHash): StateRootHash | null;
+    insertBlock(block: WithHash<HeaderHash, BlockView>): Promise<void>;
+    setBestHeaderHash(hash: HeaderHash): Promise<void>;
+    getBestHeaderHash(): HeaderHash;
+    getHeader(hash: HeaderHash): HeaderView | null;
+    getExtrinsic(hash: HeaderHash): ExtrinsicView | null;
+    markUnused(hash: HeaderHash): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=blocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAuB,KAAK,SAAS,EAAgC,MAAM,WAAW,CAAC;AAK9F,kCAAkC;AAClC,qBAAa,WAAY,YAAW,QAAQ;IAWxC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;WAdpB,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAS9E,OAAO;IAQD,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAQlD,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,iBAAiB,IAAI,UAAU;IAQ/B,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAQ9C,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAQpD,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQ5B,KAAK;CACZ"}

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

@@ -0,0 +1,86 @@
+import { Extrinsic, Header, } from "#@typeberry/block";
+import { Bytes } from "#@typeberry/bytes";
+import { Decoder } from "#@typeberry/codec";
+import { HASH_SIZE } from "#@typeberry/hash";
+import { Logger } from "#@typeberry/logger";
+import { toUint8Array } from "./root.js";
+const BEST_BLOCK = new TextEncoder().encode("best hash and posterior state root");
+const logger = Logger.new(import.meta.filename, "db");
+/** fjall-backed block storage. */
+export class FjallBlocks {
+    chainSpec;
+    root;
+    headers;
+    extrinsics;
+    postStateRoots;
+    static async open(chainSpec, root) {
+        const [headers, extrinsics, postStateRoots] = await Promise.all([
+            root.partition("headers"),
+            root.partition("extrinsics"),
+            root.partition("postStateRoots"),
+        ]);
+        return new FjallBlocks(chainSpec, root, headers, extrinsics, postStateRoots);
+    }
+    constructor(chainSpec, root, headers, extrinsics, postStateRoots) {
+        this.chainSpec = chainSpec;
+        this.root = root;
+        this.headers = headers;
+        this.extrinsics = extrinsics;
+        this.postStateRoots = postStateRoots;
+    }
+    async setPostStateRoot(hash, postStateRoot) {
+        await writable(this.postStateRoots, this.root).insert(hash.raw, postStateRoot.raw);
+    }
+    getPostStateRoot(hash) {
+        const postStateRoot = toUint8Array(this.postStateRoots.get(hash.raw));
+        if (postStateRoot === null) {
+            return null;
+        }
+        return Bytes.fromBlob(postStateRoot, HASH_SIZE).asOpaque();
+    }
+    async insertBlock(block) {
+        await Promise.all([
+            writable(this.headers, this.root).insert(block.hash.raw, block.data.header.view().encoded().raw),
+            writable(this.extrinsics, this.root).insert(block.hash.raw, block.data.extrinsic.view().encoded().raw),
+        ]);
+    }
+    async setBestHeaderHash(hash) {
+        await writable(this.headers, this.root).insert(BEST_BLOCK, hash.raw);
+        await this.root.persist();
+    }
+    getBestHeaderHash() {
+        const bestHeaderHash = toUint8Array(this.headers.get(BEST_BLOCK));
+        if (bestHeaderHash === null) {
+            return Bytes.zero(HASH_SIZE).asOpaque();
+        }
+        return Bytes.fromBlob(bestHeaderHash, HASH_SIZE).asOpaque();
+    }
+    getHeader(hash) {
+        const data = toUint8Array(this.headers.get(hash.raw));
+        if (data === null) {
+            return null;
+        }
+        return Decoder.decodeObject(Header.Codec.View, data, this.chainSpec);
+    }
+    getExtrinsic(hash) {
+        const data = toUint8Array(this.extrinsics.get(hash.raw));
+        if (data === null) {
+            return null;
+        }
+        return Decoder.decodeObject(Extrinsic.Codec.View, data, this.chainSpec);
+    }
+    markUnused(hash) {
+        void Promise.all([
+            writable(this.headers, this.root).remove(hash.raw),
+            writable(this.extrinsics, this.root).remove(hash.raw),
+            writable(this.postStateRoots, this.root).remove(hash.raw),
+        ]).catch((e) => logger.warn `Failed to prune block ${hash}: ${e}`);
+    }
+    async close() { }
+}
+function writable(partition, root) {
+    if (root.readOnly) {
+        throw new Error("Cannot write through a read-only fjall partition.");
+    }
+    return partition;
+}

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

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

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

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

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

@@ -0,0 +1,62 @@
+import assert from "node:assert";
+import * as fs from "node:fs";
+import { afterEach, before, beforeEach, describe, it } from "node:test";
+import { testBlockView } from "#@typeberry/block/test-helpers.js";
+import { Bytes } from "#@typeberry/bytes";
+import { tinyChainSpec } from "#@typeberry/config";
+import { Blake2b, HASH_SIZE, WithHash } from "#@typeberry/hash";
+import { FjallBlocks } from "./blocks.js";
+import { FjallRoot } from "./root.js";
+let blake2b;
+before(async () => {
+    blake2b = await Blake2b.createHasher();
+});
+describe("Fjall blocks database", () => {
+    let tmpDir = "";
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync("typeberry-fjall-blocks-");
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("sets and retrieves the best header hash", async () => {
+        const root = await FjallRoot.open(tmpDir, { ephemeral: true });
+        const blocks = await FjallBlocks.open(tinyChainSpec, root);
+        try {
+            await blocks.setBestHeaderHash(Bytes.fill(HASH_SIZE, 5).asOpaque());
+            assert.strictEqual(blocks.getBestHeaderHash().toString(), "0x0505050505050505050505050505050505050505050505050505050505050505");
+        }
+        finally {
+            await blocks.close();
+            await root.close();
+        }
+    });
+    it("sets and retrieves post state roots", async () => {
+        const root = await FjallRoot.open(tmpDir, { ephemeral: true });
+        const blocks = await FjallBlocks.open(tinyChainSpec, root);
+        try {
+            await blocks.setPostStateRoot(Bytes.fill(HASH_SIZE, 5).asOpaque(), Bytes.fill(HASH_SIZE, 10).asOpaque());
+            assert.strictEqual(blocks.getPostStateRoot(Bytes.fill(HASH_SIZE, 1).asOpaque())?.toString(), undefined);
+            assert.strictEqual(blocks.getPostStateRoot(Bytes.fill(HASH_SIZE, 5).asOpaque())?.toString(), "0x0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a");
+        }
+        finally {
+            await blocks.close();
+            await root.close();
+        }
+    });
+    it("stores and retrieves a block", async () => {
+        const root = await FjallRoot.open(tmpDir, { ephemeral: true });
+        const blocks = await FjallBlocks.open(tinyChainSpec, root);
+        try {
+            const block = testBlockView();
+            const headerHash = blake2b.hashBytes(block.header.view().encoded()).asOpaque();
+            await blocks.insertBlock(WithHash.new(headerHash, block));
+            assert.deepStrictEqual(blocks.getHeader(headerHash)?.materialize(), block.header.materialize());
+            assert.deepStrictEqual(blocks.getExtrinsic(headerHash)?.materialize(), block.extrinsic.materialize());
+        }
+        finally {
+            await blocks.close();
+            await root.close();
+        }
+    });
+});

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

@@ -1 +1 @@
-{"version":3,"file":"hybrid-states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/hybrid-states.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hybrid-states.d.ts","sourceRoot":"","sources":["../../../../../packages/jam/database-fjall/hybrid-states.ts"],"names":[],"mappings":"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"}

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

@@ -27,9 +27,18 @@ export class FjallValuesSession {
     }
     /** Open (or create) the keyspace at `dbPath` and its `values` partition. */
     static async open(dbPath, options = {}) {
+        if (options.readOnly === true) {
+            throw new Error("FjallValuesSession requires a writable keyspace.");
+        }
         const root = await FjallRoot.open(dbPath, options);
-        const values = await root.partition("values");
-        return new FjallValuesSession(root, values);
+        try {
+            const values = await root.writablePartition("values");
+            return new FjallValuesSession(root, values);
+        }
+        catch (e) {
+            await root.close();
+            throw e;
+        }
     }
     /** Flush the journal to disk (a no-op for ephemeral keyspaces). */
     async persist() {