@typeberry/lib 0.5.2-7570566 → 0.5.2-ab56433

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeberry/lib",
-  "version": "0.5.2-7570566",
+  "version": "0.5.2-ab56433",
   "description": "Typeberry Library",
   "main": "./bin/lib/index.js",
   "types": "./bin/lib/index.d.ts",
@@ -258,7 +258,7 @@
     "#@typeberry/state-vectors/*": "./packages/jam/state-vectors/*"
   },
   "dependencies": {
-    "@fluffylabs/anan-as": "^1.1.3",
+    "@fluffylabs/anan-as": "^1.1.5",
     "@noble/ed25519": "2.2.3",
     "@typeberry/native": "0.0.4-4c0cd28",
     "hash-wasm": "4.12.0"

package/packages/core/collections/blob-dictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob-dictionary.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/blob-dictionary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blob-dictionary.d.ts","sourceRoot":"","sources":["../../../../../packages/core/collections/blob-dictionary.ts"],"names":[],"mappings":"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"}

package/packages/core/collections/blob-dictionary.js

@@ -172,14 +172,14 @@ export class BlobDictionary extends WithDebug {
         const pathChunksGenerator = key.chunks(CHUNK_SIZE);
         let depth = 0;
         while (node !== undefined) {
-            const maybePathChunk = pathChunksGenerator.next().value;
             if (node.children instanceof ListChildren) {
-                const subkey = BytesBlob.blobFrom(key.raw.subarray(depth * CHUNK_SIZE));
+                const subkey = depth === 0 ? key : BytesBlob.blobFrom(key.raw.subarray(depth * CHUNK_SIZE));
                 const child = node.children.find(subkey);
                 if (child !== null) {
                     return child.value;
                 }
             }
+            const maybePathChunk = pathChunksGenerator.next().value;
             if (maybePathChunk === undefined) {
                 return node.getLeaf()?.value;
             }
@@ -363,7 +363,7 @@ export class ListChildren {
     children = [];
     constructor() { }
     find(key) {
-        const result = this.children.find((item) => item[0].isEqualTo(key));
+        const result = this.children.find((item) => item[0] === key || item[0].isEqualTo(key));
         if (result !== undefined) {
             return result[1];
         }

package/packages/core/pvm-host-calls/bin.js

@@ -1,11 +1,11 @@
 import { PvmBackend } from "#@typeberry/config";
 import { tryAsGas } from "#@typeberry/pvm-interface";
-import { HostCalls } from "./host-calls.js";
-import { HostCallsManager, NoopMissing } from "./host-calls-manager.js";
-import { InterpreterInstanceManager } from "./interpreter-instance-manager.js";
-const hostCalls = new HostCallsManager({ missing: new NoopMissing(), handlers: [] });
-const pvmInstanceManager = await InterpreterInstanceManager.new(PvmBackend.BuiltIn);
-const pvmHostCallExtension = new HostCalls(pvmInstanceManager, hostCalls);
+import { HostCalls, NoopMissing } from "./host-calls.js";
+import { HostCallsExecutor } from "./host-calls-executor.js";
+import { PvmInstanceManager } from "./pvm-instance-manager.js";
+const hostCalls = new HostCalls({ missing: new NoopMissing(), handlers: [] });
+const pvmInstanceManager = await PvmInstanceManager.new(PvmBackend.BuiltIn);
+const pvmHostCallExtension = new HostCallsExecutor(pvmInstanceManager, hostCalls);
 const program = new Uint8Array([
     0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x10, 0x1, 0x0, 0x0, 0xf9, 0x0, 0x0, 0x0, 0x0, 0x0, 0x80, 0xd9, 0x5, 0x12,
     0x0, 0x0, 0x0, 0x5, 0x11, 0x0, 0x0, 0x0, 0x5, 0xa3, 0x0, 0x0, 0x0, 0x5, 0xc6, 0x0, 0x4, 0x7, 0x13, 0x0, 0x2, 0x11,

package/packages/core/pvm-host-calls/ecalli-io-tracker.d.ts

@@ -0,0 +1,32 @@
+import type { U32, U64 } from "#@typeberry/numbers";
+import type { RegisterIndex } from "#@typeberry/pvm-interpreter";
+/**
+ * Interface for tracking PVM I/O operations during host call execution.
+ *
+ * Implementations record memory reads/writes and register modifications
+ * for debugging, tracing, or replay purposes.
+ */
+export interface IoTracker {
+    /** Record a register write operation. */
+    setReg(idx: number, val: U64): void;
+    /** Record a memory read operation. */
+    memRead(address: U32, data: Uint8Array): void;
+    /** Record a memory write operation. */
+    memWrite(address: U32, data: Uint8Array): void;
+    /** Clear all recorded operations. */
+    clear(): void;
+}
+/** Create a no-op tracker that discards all operations. */
+export declare function noopTracker(): NoopIoTracker;
+/**
+ * No-op implementation that discards all tracked operations.
+ * Used when I/O tracing is disabled.
+ */
+declare class NoopIoTracker implements IoTracker {
+    clear(): void;
+    setReg(_idx: RegisterIndex, _val: U64): void;
+    memRead(_address: U32, _data: Uint8Array): void;
+    memWrite(_address: U32, _data: Uint8Array): void;
+}
+export {};
+//# sourceMappingURL=ecalli-io-tracker.d.ts.map

package/packages/core/pvm-host-calls/ecalli-io-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecalli-io-tracker.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/ecalli-io-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACpC,sCAAsC;IACtC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/C,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,kBAE1B;AAED;;;GAGG;AACH,cAAM,aAAc,YAAW,SAAS;IACtC,KAAK,IAAI,IAAI;IACb,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAC5C,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAC/C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;CACjD"}

package/packages/core/pvm-host-calls/ecalli-io-tracker.js

@@ -0,0 +1,14 @@
+/** Create a no-op tracker that discards all operations. */
+export function noopTracker() {
+    return new NoopIoTracker();
+}
+/**
+ * No-op implementation that discards all tracked operations.
+ * Used when I/O tracing is disabled.
+ */
+class NoopIoTracker {
+    clear() { }
+    setReg(_idx, _val) { }
+    memRead(_address, _data) { }
+    memWrite(_address, _data) { }
+}

package/packages/core/pvm-host-calls/ecalli-trace-logger.d.ts

@@ -0,0 +1,139 @@
+import type { U32, U64 } from "#@typeberry/numbers";
+import type { Gas } from "#@typeberry/pvm-interface";
+import type { IoTracker } from "./ecalli-io-tracker.js";
+import type { HostCallIndex } from "./host-call-handler.js";
+import type { HostCallRegisters } from "./host-call-registers.js";
+/**
+ * Output function type for IO trace logging.
+ * Each call should output a single line.
+ */
+export type IoTraceOutput = (line: string) => void;
+/**
+ * Ecalli PVM IO Trace Logger.
+ *
+ * Implements the logging format specified for PVM execution tracing.
+ * This format is designed to be:
+ * - Human-readable, newline-delimited text
+ * - Self-contained for stateless re-execution
+ * - Comparable using simple textual diff tools
+ *
+ * @see https://github.com/tomusdrw/JIPs/pull/2
+ */
+export declare class EcalliTraceLogger {
+    private readonly output;
+    /** Returns a tracker for IO operations. */
+    tracker(): IoTraceTracker | null;
+    /**
+     * Create an IoTraceLogger that outputs to the `ecalli` module logger.
+     *
+     * Returns `null` if the `ecalli` logger is not configured for at least TRACE level.
+     * Enable with: `JAM_LOG=ecalli=trace` or `JAM_LOG=trace`
+     */
+    static create(): EcalliTraceLogger | null;
+    /**
+     * Create a no-op IoTraceLogger that discards all output.
+     * Used when tracing is disabled.
+     */
+    static noop(): EcalliTraceLogger;
+    static new(output: IoTraceOutput): EcalliTraceLogger;
+    private constructor();
+    /**
+     * Log optional context lines (implementation metadata, execution environment).
+     */
+    logContext(context: string): void;
+    /**
+     * Log the program blob being executed and the write data (if any)
+     *
+     * Format: `program {hex-encoded-program-with-metadata}`
+     * Format: `memwrite {hex-encoded-address} len={blob-byte-length} <- {hex-encoded-bytes}`
+     */
+    logProgram(program: Uint8Array, args: Uint8Array): void;
+    /**
+     * Log initial execution state (prelude).
+     *
+     * Format: `start pc={pc} gas={gas} {register-dump}`
+     */
+    logStart(pc: number, gas: Gas, registers: HostCallRegisters): void;
+    /**
+     * Log ecalli invocation with register dump.
+     *
+     * Format: `ecalli={index} pc={pc} gas={gas} {register-dump}`
+     */
+    logEcalli(index: HostCallIndex, pc: number, gas: Gas, registers: HostCallRegisters): void;
+    /**
+     * Log memory read operation.
+     *
+     * Format: `memread {hex-encoded-address} len={blob-byte-length} -> {hex-encoded-data-read}`
+     */
+    logMemRead(address: number, len: number, data: string): void;
+    /**
+     * Log memory write operation.
+     *
+     * Format: `memwrite {hex-encoded-address} len={blob-byte-length} <- {hex-encoded-bytes}`
+     */
+    logMemWrite(address: number, len: number, data: string): void;
+    /**
+     * Log register write operation.
+     *
+     * Format: `setreg r{idx} <- {hex-encoded-value}`
+     */
+    logSetReg(index: number, value: bigint): void;
+    /**
+     * Log gas overwrite operation.
+     *
+     * Format: `setgas <- {gas}`
+     */
+    logSetGas(gas: Gas): void;
+    /**
+     * Log all host actions from a single ecalli invocation.
+     * Actions are logged in the order specified by JIP-6:
+     * 1. Memory reads (sorted by address)
+     * 2. Memory writes (sorted by address)
+     * 3. Register writes (sorted by index)
+     * 4. Gas overwrite
+     */
+    logHostActions(ioTracker: IoTraceTracker | null, gasBefore: Gas, gasAfter: Gas): void;
+    /**
+     * Log PANIC termination.
+     *
+     * Format: `PANIC={argument} pc={pc} gas={gas} {register-dump}`
+     */
+    logPanic(argument: number, pc: number, gas: Gas, registers: HostCallRegisters): void;
+    /**
+     * Log OOG (out of gas) termination.
+     *
+     * Format: `OOG pc={pc} gas={gas} {register-dump}`
+     */
+    logOog(pc: number, gas: Gas, registers: HostCallRegisters): void;
+    /**
+     * Log HALT termination.
+     *
+     * Format: `HALT pc={pc} gas={gas} {register-dump}`
+     */
+    logHalt(pc: number, gas: Gas, registers: HostCallRegisters): void;
+}
+type MemoryOperation = {
+    address: number;
+    hex: string;
+    len: number;
+};
+/**
+ * IoTracker implementation that records all I/O operations for trace logging.
+ *
+ * Stores memory reads, writes, and register modifications as hex-encoded strings
+ * for output via IoTraceLogger.
+ */
+export declare class IoTraceTracker implements IoTracker {
+    /** Recorded memory read operations (address + hex data + len). */
+    reads: MemoryOperation[];
+    /** Recorded memory write operations (address + hex data + len). */
+    writes: MemoryOperation[];
+    /** Recorded register write operations (index -> value). */
+    registers: Map<number, U64>;
+    setReg(idx: number, val: U64): void;
+    memRead(address: U32, data: Uint8Array): void;
+    memWrite(address: U32, data: Uint8Array): void;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=ecalli-trace-logger.d.ts.map

package/packages/core/pvm-host-calls/ecalli-trace-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecalli-trace-logger.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/ecalli-trace-logger.ts"],"names":[],"mappings":"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"}

package/packages/core/pvm-host-calls/ecalli-trace-logger.js

@@ -0,0 +1,209 @@
+import { BytesBlob } from "#@typeberry/bytes";
+import { Level, Logger } from "#@typeberry/logger";
+const ecalliLogger = Logger.new(import.meta.filename, "ecalli");
+const defaultOutput = (line) => {
+    ecalliLogger.trace `${line}`;
+};
+const emptyOutput = () => { };
+/**
+ * Ecalli PVM IO Trace Logger.
+ *
+ * Implements the logging format specified for PVM execution tracing.
+ * This format is designed to be:
+ * - Human-readable, newline-delimited text
+ * - Self-contained for stateless re-execution
+ * - Comparable using simple textual diff tools
+ *
+ * @see https://github.com/tomusdrw/JIPs/pull/2
+ */
+export class EcalliTraceLogger {
+    output;
+    /** Returns a tracker for IO operations. */
+    tracker() {
+        return this.output === emptyOutput ? null : new IoTraceTracker();
+    }
+    /**
+     * Create an IoTraceLogger that outputs to the `ecalli` module logger.
+     *
+     * Returns `null` if the `ecalli` logger is not configured for at least TRACE level.
+     * Enable with: `JAM_LOG=ecalli=trace` or `JAM_LOG=trace`
+     */
+    static create() {
+        if (ecalliLogger.getLevel() > Level.TRACE) {
+            return null;
+        }
+        return EcalliTraceLogger.new(defaultOutput);
+    }
+    /**
+     * Create a no-op IoTraceLogger that discards all output.
+     * Used when tracing is disabled.
+     */
+    static noop() {
+        return new EcalliTraceLogger(emptyOutput);
+    }
+    static new(output) {
+        return new EcalliTraceLogger(output);
+    }
+    constructor(output) {
+        this.output = output;
+    }
+    /**
+     * Log optional context lines (implementation metadata, execution environment).
+     */
+    logContext(context) {
+        this.output(context);
+    }
+    /**
+     * Log the program blob being executed and the write data (if any)
+     *
+     * Format: `program {hex-encoded-program-with-metadata}`
+     * Format: `memwrite {hex-encoded-address} len={blob-byte-length} <- {hex-encoded-bytes}`
+     */
+    logProgram(program, args) {
+        const SPI_ARGS_SEGMENT = 0xfe_ff_00_00;
+        this.output(`program ${BytesBlob.blobFrom(program)}`);
+        if (args.length > 0) {
+            this.output(`memwrite ${toHexAddress(SPI_ARGS_SEGMENT)} len=${args.length} <- ${BytesBlob.blobFrom(args)}`);
+        }
+    }
+    /**
+     * Log initial execution state (prelude).
+     *
+     * Format: `start pc={pc} gas={gas} {register-dump}`
+     */
+    logStart(pc, gas, registers) {
+        const line = `start pc=${pc} gas=${gas} ${registers}`;
+        this.output(line);
+    }
+    /**
+     * Log ecalli invocation with register dump.
+     *
+     * Format: `ecalli={index} pc={pc} gas={gas} {register-dump}`
+     */
+    logEcalli(index, pc, gas, registers) {
+        const line = `ecalli=${index} pc=${pc} gas=${gas} ${registers}`;
+        this.output(line);
+    }
+    /**
+     * Log memory read operation.
+     *
+     * Format: `memread {hex-encoded-address} len={blob-byte-length} -> {hex-encoded-data-read}`
+     */
+    logMemRead(address, len, data) {
+        this.output(`memread ${toHexAddress(address)} len=${len} -> ${data}`);
+    }
+    /**
+     * Log memory write operation.
+     *
+     * Format: `memwrite {hex-encoded-address} len={blob-byte-length} <- {hex-encoded-bytes}`
+     */
+    logMemWrite(address, len, data) {
+        this.output(`memwrite ${toHexAddress(address)} len=${len} <- ${data}`);
+    }
+    /**
+     * Log register write operation.
+     *
+     * Format: `setreg r{idx} <- {hex-encoded-value}`
+     */
+    logSetReg(index, value) {
+        const paddedIdx = index.toString().padStart(2, "0");
+        this.output(`setreg r${paddedIdx} <- ${value.toString(16)}`);
+    }
+    /**
+     * Log gas overwrite operation.
+     *
+     * Format: `setgas <- {gas}`
+     */
+    logSetGas(gas) {
+        this.output(`setgas <- ${gas}`);
+    }
+    /**
+     * Log all host actions from a single ecalli invocation.
+     * Actions are logged in the order specified by JIP-6:
+     * 1. Memory reads (sorted by address)
+     * 2. Memory writes (sorted by address)
+     * 3. Register writes (sorted by index)
+     * 4. Gas overwrite
+     */
+    logHostActions(ioTracker, gasBefore, gasAfter) {
+        if (ioTracker === null) {
+            return;
+        }
+        const reads = ioTracker.reads.sort((a, b) => a.address - b.address);
+        for (const op of reads) {
+            this.logMemRead(op.address, op.len, op.hex);
+        }
+        const writes = ioTracker.writes.sort((a, b) => a.address - b.address);
+        for (const op of writes) {
+            this.logMemWrite(op.address, op.len, op.hex);
+        }
+        const sortedRegWrites = [...ioTracker.registers.entries()].sort((a, b) => a[0] - b[0]);
+        for (const op of sortedRegWrites) {
+            this.logSetReg(op[0], op[1]);
+        }
+        if (gasBefore !== gasAfter) {
+            this.logSetGas(gasAfter);
+        }
+    }
+    /**
+     * Log PANIC termination.
+     *
+     * Format: `PANIC={argument} pc={pc} gas={gas} {register-dump}`
+     */
+    logPanic(argument, pc, gas, registers) {
+        const line = `PANIC=${argument} pc=${pc} gas=${gas} ${registers}`;
+        this.output(line);
+    }
+    /**
+     * Log OOG (out of gas) termination.
+     *
+     * Format: `OOG pc={pc} gas={gas} {register-dump}`
+     */
+    logOog(pc, gas, registers) {
+        const line = `OOG pc=${pc} gas=${gas} ${registers}`;
+        this.output(line);
+    }
+    /**
+     * Log HALT termination.
+     *
+     * Format: `HALT pc={pc} gas={gas} {register-dump}`
+     */
+    logHalt(pc, gas, registers) {
+        const line = `HALT pc=${pc} gas=${gas} ${registers}`;
+        this.output(line);
+    }
+}
+/**
+ * Convert 32-bit address to 0x-prefixed hex string.
+ */
+function toHexAddress(address) {
+    return `0x${address.toString(16).padStart(8, "0")}`;
+}
+/**
+ * IoTracker implementation that records all I/O operations for trace logging.
+ *
+ * Stores memory reads, writes, and register modifications as hex-encoded strings
+ * for output via IoTraceLogger.
+ */
+export class IoTraceTracker {
+    /** Recorded memory read operations (address + hex data + len). */
+    reads = [];
+    /** Recorded memory write operations (address + hex data + len). */
+    writes = [];
+    /** Recorded register write operations (index -> value). */
+    registers = new Map();
+    setReg(idx, val) {
+        this.registers.set(idx, val);
+    }
+    memRead(address, data) {
+        this.reads.push({ address, hex: BytesBlob.blobFrom(data).toString(), len: data.length });
+    }
+    memWrite(address, data) {
+        this.writes.push({ address, hex: BytesBlob.blobFrom(data).toString(), len: data.length });
+    }
+    clear() {
+        this.reads.length = 0;
+        this.writes.length = 0;
+        this.registers.clear();
+    }
+}

package/packages/core/pvm-host-calls/ecalli-trace-logger.test.d.ts

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

package/packages/core/pvm-host-calls/ecalli-trace-logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecalli-trace-logger.test.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/ecalli-trace-logger.test.ts"],"names":[],"mappings":""}