@typeberry/lib 0.5.2 → 0.5.3-5a6cfcc

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":""}

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

@@ -0,0 +1,231 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { tryAsU32, tryAsU64 } from "#@typeberry/numbers";
+import { NO_OF_REGISTERS, REGISTER_BYTE_SIZE, tryAsSmallGas } from "#@typeberry/pvm-interface";
+import { EcalliTraceLogger, IoTraceTracker } from "./ecalli-trace-logger.js";
+import { tryAsHostCallIndex } from "./host-call-handler.js";
+import { HostCallRegisters } from "./host-call-registers.js";
+/** Helper to create HostCallRegisters with specific values set. */
+function createRegisters(values) {
+    const bytes = new Uint8Array(NO_OF_REGISTERS * REGISTER_BYTE_SIZE);
+    const view = new DataView(bytes.buffer);
+    for (const [idx, value] of values) {
+        view.setBigUint64(idx * REGISTER_BYTE_SIZE, value, true);
+    }
+    return new HostCallRegisters(bytes);
+}
+describe("IoTraceLogger", () => {
+    describe("logProgram", () => {
+        it("formats program blob as hex", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logProgram(new Uint8Array([0x01, 0x02, 0xaa, 0xbb]), new Uint8Array());
+            assert.strictEqual(lines.length, 1);
+            assert.strictEqual(lines[0], "program 0x0102aabb");
+        });
+        it("handles empty program", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logProgram(new Uint8Array([]), new Uint8Array());
+            assert.strictEqual(lines[0], "program 0x");
+        });
+        it("logs args as initial memory write", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logProgram(new Uint8Array([0x01]), new Uint8Array([0x00, 0x01, 0x02]));
+            assert.strictEqual(lines.length, 2);
+            assert.strictEqual(lines[0], "program 0x01");
+            assert.strictEqual(lines[1], "memwrite 0xfeff0000 len=3 <- 0x000102");
+        });
+    });
+    describe("logStart", () => {
+        it("formats start with register dump", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map([
+                [7, 0x10n],
+                [9, 0x10000n],
+            ]));
+            logger.logStart(0, tryAsSmallGas(10000), regs);
+            assert.strictEqual(lines[0], "start pc=0 gas=10000 r07=10 r09=10000");
+        });
+        it("handles no non-zero registers", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map());
+            logger.logStart(42, tryAsSmallGas(5000), regs);
+            assert.strictEqual(lines[0], "start pc=42 gas=5000 ");
+        });
+    });
+    describe("logEcalli", () => {
+        it("formats ecalli with register dump", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map([
+                [1, 0x1n],
+                [3, 0x1000n],
+            ]));
+            logger.logEcalli(tryAsHostCallIndex(10), 42, tryAsSmallGas(10000), regs);
+            assert.strictEqual(lines[0], "ecalli=10 pc=42 gas=10000 r01=1 r03=1000");
+        });
+        it("omits zero registers", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map([
+                [0, 0n],
+                [1, 1n],
+            ]));
+            logger.logEcalli(tryAsHostCallIndex(5), 0, tryAsSmallGas(5000), regs);
+            assert.strictEqual(lines[0], "ecalli=5 pc=0 gas=5000 r01=1");
+        });
+        it("handles no non-zero registers", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map());
+            logger.logEcalli(tryAsHostCallIndex(0), 0, tryAsSmallGas(100), regs);
+            assert.strictEqual(lines[0], "ecalli=0 pc=0 gas=100 ");
+        });
+    });
+    describe("logMemRead", () => {
+        it("formats memory read", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logMemRead(0x1000, 4, "0x01020304");
+            assert.strictEqual(lines[0], "memread 0x00001000 len=4 -> 0x01020304");
+        });
+    });
+    describe("logMemWrite", () => {
+        it("formats memory write", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logMemWrite(0x2000, 2, "0xffee");
+            assert.strictEqual(lines[0], "memwrite 0x00002000 len=2 <- 0xffee");
+        });
+    });
+    describe("logSetReg", () => {
+        it("formats register write with padded index", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logSetReg(0, 0x100n);
+            assert.strictEqual(lines[0], "setreg r00 <- 100");
+        });
+        it("formats two-digit register index", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logSetReg(12, 0x4n);
+            assert.strictEqual(lines[0], "setreg r12 <- 4");
+        });
+    });
+    describe("logSetGas", () => {
+        it("formats gas write", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            logger.logSetGas(tryAsSmallGas(9950));
+            assert.strictEqual(lines[0], "setgas <- 9950");
+        });
+    });
+    describe("logHostActions", () => {
+        it("logs actions in correct order: reads, writes, regs, gas", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const tracker = new IoTraceTracker();
+            tracker.memWrite(tryAsU32(0x2000), new Uint8Array([0xab]));
+            tracker.memRead(tryAsU32(0x1000), new Uint8Array([0xcd]));
+            tracker.setReg(0, tryAsU64(0x100n));
+            logger.logHostActions(tracker, tryAsSmallGas(10000), tryAsSmallGas(9950));
+            assert.strictEqual(lines.length, 4);
+            assert.strictEqual(lines[0], "memread 0x00001000 len=1 -> 0xcd");
+            assert.strictEqual(lines[1], "memwrite 0x00002000 len=1 <- 0xab");
+            assert.strictEqual(lines[2], "setreg r00 <- 100");
+            assert.strictEqual(lines[3], "setgas <- 9950");
+        });
+        it("sorts reads by address", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const tracker = new IoTraceTracker();
+            tracker.memRead(tryAsU32(0x2000), new Uint8Array([0x01]));
+            tracker.memRead(tryAsU32(0x1000), new Uint8Array([0x02]));
+            logger.logHostActions(tracker, tryAsSmallGas(100), tryAsSmallGas(100));
+            assert.strictEqual(lines[0], "memread 0x00001000 len=1 -> 0x02");
+            assert.strictEqual(lines[1], "memread 0x00002000 len=1 -> 0x01");
+        });
+        it("skips setgas if unchanged", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const tracker = new IoTraceTracker();
+            logger.logHostActions(tracker, tryAsSmallGas(100), tryAsSmallGas(100));
+            assert.strictEqual(lines.length, 0);
+        });
+    });
+    describe("termination logging", () => {
+        it("logs HALT", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map([[0, 0x100n]]));
+            logger.logHalt(42, tryAsSmallGas(9920), regs);
+            assert.strictEqual(lines[0], "HALT pc=42 gas=9920 r00=100");
+        });
+        it("logs OOG", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map());
+            logger.logOog(100, tryAsSmallGas(0), regs);
+            assert.strictEqual(lines[0], "OOG pc=100 gas=0 ");
+        });
+        it("logs PANIC with argument", () => {
+            const lines = [];
+            const logger = EcalliTraceLogger.new((line) => lines.push(line));
+            const regs = createRegisters(new Map());
+            logger.logPanic(1, 50, tryAsSmallGas(500), regs);
+            assert.strictEqual(lines[0], "PANIC=1 pc=50 gas=500 ");
+        });
+    });
+    describe("noop logger", () => {
+        it("does not throw and produces no output", () => {
+            const logger = EcalliTraceLogger.noop();
+            logger.logContext("test");
+            logger.logProgram(new Uint8Array([1, 2, 3]), new Uint8Array());
+            logger.logSetGas(tryAsSmallGas(100));
+        });
+        it("returns null tracker", () => {
+            const logger = EcalliTraceLogger.noop();
+            const tracker = logger.tracker();
+            assert.strictEqual(tracker, null);
+        });
+    });
+    describe("IoTraceTracker", () => {
+        it("tracks memory reads", () => {
+            const tracker = new IoTraceTracker();
+            tracker.memRead(tryAsU32(0x1000), new Uint8Array([0x01, 0x02]));
+            tracker.memRead(tryAsU32(0x2000), new Uint8Array([0x03]));
+            assert.strictEqual(tracker.reads.length, 2);
+            assert.strictEqual(tracker.reads[0].address, 0x1000);
+            assert.strictEqual(tracker.reads[0].hex, "0x0102");
+        });
+        it("tracks memory writes", () => {
+            const tracker = new IoTraceTracker();
+            tracker.memWrite(tryAsU32(0x3000), new Uint8Array([0xaa, 0xbb]));
+            assert.strictEqual(tracker.writes.length, 1);
+            assert.strictEqual(tracker.writes[0].address, 0x3000);
+            assert.strictEqual(tracker.writes[0].hex, "0xaabb");
+        });
+        it("tracks register writes", () => {
+            const tracker = new IoTraceTracker();
+            tracker.setReg(5, tryAsU64(0x42n));
+            tracker.setReg(7, tryAsU64(0x100n));
+            assert.strictEqual(tracker.registers.size, 2);
+            assert.strictEqual(tracker.registers.get(5), tryAsU64(0x42n));
+            assert.strictEqual(tracker.registers.get(7), tryAsU64(0x100n));
+        });
+        it("clears all tracked data", () => {
+            const tracker = new IoTraceTracker();
+            tracker.memRead(tryAsU32(0x1000), new Uint8Array([0x01]));
+            tracker.memWrite(tryAsU32(0x2000), new Uint8Array([0x02]));
+            tracker.setReg(0, tryAsU64(0x100n));
+            tracker.clear();
+            assert.strictEqual(tracker.reads.length, 0);
+            assert.strictEqual(tracker.writes.length, 0);
+            assert.strictEqual(tracker.registers.size, 0);
+        });
+    });
+});

package/packages/core/pvm-host-calls/host-call-memory.d.ts

@@ -1,8 +1,10 @@
 import { type U64 } from "#@typeberry/numbers";
 import type { IMemory, PageFault } from "#@typeberry/pvm-interface";
 import { OK, Result } from "#@typeberry/utils";
+import type { IoTracker } from "./ecalli-io-tracker.js";
 export declare class HostCallMemory {
     private readonly memory;
+    ioTracker: IoTracker | null;
     constructor(memory: IMemory);
     /**
      * Save some bytes into memory under given address.

package/packages/core/pvm-host-calls/host-call-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-call-memory.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9C,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAYpE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAWrE"}
+{"version":3,"file":"host-call-memory.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF5B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEb,MAAM,EAAE,OAAO;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;IAgBpE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC;CAerE"}

package/packages/core/pvm-host-calls/host-call-memory.js

@@ -2,6 +2,8 @@ import { tryAsU32 } from "#@typeberry/numbers";
 import { OK, Result } from "#@typeberry/utils";
 export class HostCallMemory {
     memory;
+    // Track successful memory reads and writes.
+    ioTracker = null;
     constructor(memory) {
         this.memory = memory;
     }
@@ -19,7 +21,11 @@ export class HostCallMemory {
         //
         // https://graypaper.fluffylabs.dev/#/ab2cdbd/25ed0025ed00?v=0.7.2
         const address = tryAsU32(Number(regAddress & 0xffffffffn));
-        return this.memory.store(address, bytes);
+        const result = this.memory.store(address, bytes);
+        if (result.isOk && this.ioTracker !== null) {
+            this.ioTracker.memWrite(address, bytes);
+        }
+        return result;
     }
     /**
      * Read some bytes from memory under given address.
@@ -35,6 +41,10 @@ export class HostCallMemory {
         //
         // NOTE we are taking the the lower U32 part of the register, hence it's safe.
         const address = tryAsU32(Number(regAddress & 0xffffffffn));
-        return this.memory.read(address, output);
+        const result = this.memory.read(address, output);
+        if (result.isOk && this.ioTracker !== null) {
+            this.ioTracker.memRead(address, output);
+        }
+        return result;
     }
 }

package/packages/core/pvm-host-calls/host-call-registers.d.ts

@@ -1,7 +1,10 @@
 import { type U64 } from "#@typeberry/numbers";
+import type { IoTracker } from "./ecalli-io-tracker.js";
 export declare class HostCallRegisters {
     private readonly bytes;
+    private readonly raw;
     private readonly registers;
+    ioTracker: IoTracker | null;
     constructor(bytes: Uint8Array);
     /** Get U64 register value. */
     get(registerIndex: number): U64;
@@ -9,5 +12,8 @@ export declare class HostCallRegisters {
     set(registerIndex: number, value: U64): void;
     /** Get all registers encoded into little-endian bytes. */
     getEncoded(): Uint8Array;
+    /** Ovewrite all encoded registers. */
+    setEncoded(bytes: Uint8Array): void;
+    toString(): string;
 }
 //# sourceMappingURL=host-call-registers.d.ts.map

package/packages/core/pvm-host-calls/host-call-registers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-call-registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGxD,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAER,KAAK,EAAE,UAAU;IAI9C,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG;IAI/B,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAIrC,0DAA0D;IAC1D,UAAU,IAAI,UAAU;CAGzB"}
+{"version":3,"file":"host-call-registers.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-call-registers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,iBAAiB;IAMhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IAE9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEb,KAAK,EAAE,UAAU;IAK9C,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG;IAI/B,8BAA8B;IAC9B,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAOrC,0DAA0D;IAC1D,UAAU,IAAI,UAAU;IAIxB,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,UAAU;IAK5B,QAAQ;CAWT"}

package/packages/core/pvm-host-calls/host-call-registers.js

@@ -1,10 +1,15 @@
 import { tryAsU64 } from "#@typeberry/numbers";
 import { REGISTER_BYTE_SIZE } from "#@typeberry/pvm-interface";
+import { check } from "#@typeberry/utils";
 export class HostCallRegisters {
     bytes;
+    raw;
     registers;
+    // Track register modifications.
+    ioTracker = null;
     constructor(bytes) {
         this.bytes = bytes;
+        this.raw = bytes;
         this.registers = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     }
     /** Get U64 register value. */
@@ -14,9 +19,28 @@ export class HostCallRegisters {
     /** Set U64 register value. */
     set(registerIndex, value) {
         this.registers.setBigUint64(registerIndex * REGISTER_BYTE_SIZE, value, true);
+        if (this.ioTracker !== null) {
+            this.ioTracker.setReg(registerIndex, value);
+        }
     }
     /** Get all registers encoded into little-endian bytes. */
     getEncoded() {
         return this.bytes;
     }
+    /** Ovewrite all encoded registers. */
+    setEncoded(bytes) {
+        check `${bytes.length === this.raw.length} Invalid registers array: ${bytes.length} vs ${this.raw.length}`;
+        this.raw.set(bytes, 0);
+    }
+    toString() {
+        const elementCount = this.raw.byteLength / REGISTER_BYTE_SIZE;
+        const values = new BigUint64Array(this.raw.buffer, this.raw.byteOffset, elementCount);
+        const entries = [];
+        for (const [idx, value] of values.entries()) {
+            if (value !== 0n) {
+                entries.push(`r${idx.toString().padStart(2, "0")}=${value.toString(16)}`);
+            }
+        }
+        return entries.join(" ");
+    }
 }

package/packages/core/pvm-host-calls/host-calls-executor.d.ts

@@ -0,0 +1,37 @@
+import { type Gas } from "#@typeberry/pvm-interface";
+import { EcalliTraceLogger } from "./ecalli-trace-logger.js";
+import type { HostCalls } from "./host-calls.js";
+import type { PvmInstanceManager } from "./pvm-instance-manager.js";
+/**
+ * Outer VM return status.
+ *
+ * This is a limited status returned by outer VM.
+ *
+ * https://graypaper.fluffylabs.dev/#/ab2cdbd/24a10124a101?v=0.7.2
+ */
+export declare enum ReturnStatus {
+    /** Execution succesful. */
+    OK = 0,
+    /** Execution went out of gas. */
+    OOG = 1,
+    /** Execution trapped or panicked. */
+    PANIC = 2
+}
+export type ReturnValue<TGas = Gas> = {
+    consumedGas: TGas;
+} & ({
+    status: ReturnStatus.OK;
+    memorySlice: Uint8Array;
+} | {
+    status: ReturnStatus.OOG | ReturnStatus.PANIC;
+});
+export declare class HostCallsExecutor {
+    private pvmInstanceManager;
+    private hostCalls;
+    private ioTracer;
+    constructor(pvmInstanceManager: PvmInstanceManager, hostCalls: HostCalls, ioTracer?: EcalliTraceLogger | null);
+    private getReturnValue;
+    private execute;
+    runProgram(program: Uint8Array, args: Uint8Array, initialPc: number, initialGas: Gas): Promise<ReturnValue>;
+}
+//# sourceMappingURL=host-calls-executor.d.ts.map

package/packages/core/pvm-host-calls/host-calls-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-calls-executor.d.ts","sourceRoot":"","sources":["../../../../../packages/core/pvm-host-calls/host-calls-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;GAMG;AACH,oBAAY,YAAY;IACtB,2BAA2B;IAC3B,EAAE,IAAI;IACN,iCAAiC;IACjC,GAAG,IAAI;IACP,qCAAqC;IACrC,KAAK,IAAI;CACV;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,GAAG,GAAG,IAAI;IACpC,WAAW,EAAE,IAAI,CAAC;CACnB,GAAG,CACA;IACE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;CACzB,GACD;IACE,MAAM,EAAE,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC;CAC/C,CACJ,CAAC;AAEF,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;gBAFR,kBAAkB,EAAE,kBAAkB,EACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,iBAAiB,GAAG,IAAiC;IAGzE,OAAO,CAAC,cAAc;YAqCR,OAAO;IAkFf,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;CAWlH"}