@fluffylabs/anan-as 1.2.0-e8a5af8 → 1.2.0-ef04361

package/dist/build/debug.d.ts

@@ -1,5 +1,17 @@
 /** Exported memory */
 export declare const memory: WebAssembly.Memory;
+/**
+ * assembly/api-internal/getAssembly
+ * @param p `assembly/program/Program`
+ * @returns `~lib/string/String`
+ */
+export declare function getAssembly(p: __Internref28): string;
+/**
+ * assembly/program-build/wrapAsProgram
+ * @param bytecode `~lib/typedarray/Uint8Array`
+ * @returns `~lib/typedarray/Uint8Array`
+ */
+export declare function wrapAsProgram(bytecode: Uint8Array): Uint8Array;
 /**
  * assembly/api-debugger/resetJAM
  * @param program `~lib/array/Array<u8>`
@@ -104,47 +116,6 @@ export declare function getMemory(address: number, length: number): Uint8Array |
  * @returns `bool`
  */
 export declare function setMemory(address: number, data: Uint8Array): boolean;
-/**
- * assembly/api-internal/getAssembly
- * @param p `assembly/program/Program`
- * @returns `~lib/string/String`
- */
-export declare function getAssembly(p: __Internref26): string;
-/**
- * assembly/api-internal/buildMemory
- * @param builder `assembly/memory/MemoryBuilder`
- * @param pages `~lib/array/Array<assembly/api-types/InitialPage>`
- * @param chunks `~lib/array/Array<assembly/api-types/InitialChunk>`
- * @returns `assembly/memory/Memory`
- */
-export declare function buildMemory(builder: __Internref41, pages: Array<__Record44<undefined>>, chunks: Array<__Record46<undefined>>): __Internref15;
-/**
- * assembly/api-internal/vmInit
- * @param input `assembly/api-types/VmInput`
- * @param useSbrkGas `bool`
- * @returns `assembly/interpreter/Interpreter`
- */
-export declare function vmInit(input: __Internref49, useSbrkGas?: boolean): __Internref25;
-/**
- * assembly/api-internal/vmRunOnce
- * @param input `assembly/api-types/VmInput`
- * @param options `assembly/api-types/VmRunOptions`
- * @returns `assembly/api-types/VmOutput`
- */
-export declare function vmRunOnce(input: __Internref49, options: __Record50<undefined>): __Record51<never>;
-/**
- * assembly/api-internal/vmExecute
- * @param int `assembly/interpreter/Interpreter`
- * @param logs `bool`
- */
-export declare function vmExecute(int: __Internref25, logs?: boolean): void;
-/**
- * assembly/api-internal/vmDestroy
- * @param int `assembly/interpreter/Interpreter`
- * @param dumpMemory `bool`
- * @returns `assembly/api-types/VmOutput`
- */
-export declare function vmDestroy(int: __Internref25, dumpMemory?: boolean): __Record51<never>;
 /** assembly/api-utils/InputKind */
 export declare enum InputKind {
   /** @type `i32` */
@@ -166,7 +137,7 @@ export declare enum HasMetadata {
  * @param withMetadata `i32`
  * @returns `~lib/array/Array<assembly/gas-costs/BlockGasCost>`
  */
-export declare function getGasCosts(input: Array<number>, kind: number, withMetadata: number): Array<__Record56<never>>;
+export declare function getGasCosts(input: Array<number>, kind: number, withMetadata: number): Array<__Record53<never>>;
 /**
  * assembly/api-utils/disassemble
  * @param input `~lib/array/Array<u8>`
@@ -187,7 +158,7 @@ export declare function disassemble(input: Array<number>, kind: number, withMeta
  * @param preallocateMemoryPages `u32`
  * @returns `assembly/spi/StandardProgram`
  */
-export declare function prepareProgram(kind: number, hasMetadata: number, program: Array<number>, initialRegisters: Array<bigint>, initialPageMap: Array<__Record44<undefined>>, initialMemory: Array<__Record46<undefined>>, args: Array<number>, preallocateMemoryPages: number): __Internref40;
+export declare function prepareProgram(kind: number, hasMetadata: number, program: Array<number>, initialRegisters: Array<bigint>, initialPageMap: Array<__Record49<undefined>>, initialMemory: Array<__Record51<undefined>>, args: Array<number>, preallocateMemoryPages: number): __Internref45;
 /**
  * assembly/api-utils/runProgram
  * @param program `assembly/spi/StandardProgram`
@@ -198,20 +169,20 @@ export declare function prepareProgram(kind: number, hasMetadata: number, progra
  * @param dumpMemory `bool`
  * @returns `assembly/api-types/VmOutput`
  */
-export declare function runProgram(program: __Internref40, initialGas?: bigint, programCounter?: number, logs?: boolean, useSbrkGas?: boolean, dumpMemory?: boolean): __Record51<never>;
+export declare function runProgram(program: __Internref45, initialGas?: bigint, programCounter?: number, logs?: boolean, useSbrkGas?: boolean, dumpMemory?: boolean): __Record58<never>;
 /**
  * assembly/api-utils/pvmStart
  * @param program `assembly/spi/StandardProgram`
  * @param useSbrkGas `bool`
  * @returns `u32`
  */
-export declare function pvmStart(program: __Internref40, useSbrkGas?: boolean): number;
+export declare function pvmStart(program: __Internref45, useSbrkGas?: boolean): number;
 /**
  * assembly/api-utils/pvmDestroy
  * @param pvmId `u32`
  * @returns `assembly/api-types/VmOutput | null`
  */
-export declare function pvmDestroy(pvmId: number): __Record51<never> | null;
+export declare function pvmDestroy(pvmId: number): __Record58<never> | null;
 /**
  * assembly/api-utils/pvmSetRegisters
  * @param pvmId `u32`
@@ -249,25 +220,21 @@ export declare function pvmWriteMemory(pvmId: number, address: number, data: Uin
  * @param logs `bool`
  * @returns `assembly/api-types/VmPause | null`
  */
-export declare function pvmResume(pvmId: number, gas: bigint, pc: number, logs?: boolean): __Record60<never> | null;
-/**
- * assembly/program-build/wrapAsProgram
- * @param bytecode `~lib/typedarray/Uint8Array`
- * @returns `~lib/typedarray/Uint8Array`
- */
-export declare function wrapAsProgram(bytecode: Uint8Array): Uint8Array;
+export declare function pvmResume(pvmId: number, gas: bigint, pc: number, logs?: boolean): __Record64<never> | null;
 /** assembly/program/Program */
-declare class __Internref26 extends Number {
-  private __nominal26: symbol;
+declare class __Internref28 extends Number {
+  private __nominal28: symbol;
   private __nominal0: symbol;
 }
-/** assembly/memory/MemoryBuilder */
-declare class __Internref41 extends Number {
-  private __nominal41: symbol;
-  private __nominal0: symbol;
+/** assembly/gas-costs/BlockGasCost */
+declare interface __Record53<TOmittable> {
+  /** @type `u32` */
+  pc: number | TOmittable;
+  /** @type `u64` */
+  gas: bigint | TOmittable;
 }
 /** assembly/api-types/InitialPage */
-declare interface __Record44<TOmittable> {
+declare interface __Record49<TOmittable> {
   /** @type `u32` */
   address: number | TOmittable;
   /** @type `u32` */
@@ -276,38 +243,19 @@ declare interface __Record44<TOmittable> {
   access: number | TOmittable;
 }
 /** assembly/api-types/InitialChunk */
-declare interface __Record46<TOmittable> {
+declare interface __Record51<TOmittable> {
   /** @type `u32` */
   address: number | TOmittable;
   /** @type `~lib/array/Array<u8>` */
   data: Array<number>;
 }
-/** assembly/memory/Memory */
-declare class __Internref15 extends Number {
-  private __nominal15: symbol;
-  private __nominal0: symbol;
-}
-/** assembly/api-types/VmInput */
-declare class __Internref49 extends Number {
-  private __nominal49: symbol;
-  private __nominal0: symbol;
-}
-/** assembly/interpreter/Interpreter */
-declare class __Internref25 extends Number {
-  private __nominal25: symbol;
+/** assembly/spi/StandardProgram */
+declare class __Internref45 extends Number {
+  private __nominal45: symbol;
   private __nominal0: symbol;
 }
-/** assembly/api-types/VmRunOptions */
-declare interface __Record50<TOmittable> {
-  /** @type `bool` */
-  useSbrkGas: boolean | TOmittable;
-  /** @type `bool` */
-  logs: boolean | TOmittable;
-  /** @type `bool` */
-  dumpMemory: boolean | TOmittable;
-}
 /** assembly/api-types/VmOutput */
-declare interface __Record51<TOmittable> {
+declare interface __Record58<TOmittable> {
   /** @type `i32` */
   status: number | TOmittable;
   /** @type `u32` */
@@ -321,22 +269,10 @@ declare interface __Record51<TOmittable> {
   /** @type `~lib/array/Array<u64>` */
   registers: Array<bigint>;
   /** @type `~lib/array/Array<assembly/api-types/InitialChunk>` */
-  memory: Array<__Record46<never>>;
-}
-/** assembly/gas-costs/BlockGasCost */
-declare interface __Record56<TOmittable> {
-  /** @type `u32` */
-  pc: number | TOmittable;
-  /** @type `u64` */
-  gas: bigint | TOmittable;
-}
-/** assembly/spi/StandardProgram */
-declare class __Internref40 extends Number {
-  private __nominal40: symbol;
-  private __nominal0: symbol;
+  memory: Array<__Record51<never>>;
 }
 /** assembly/api-types/VmPause */
-declare interface __Record60<TOmittable> {
+declare interface __Record64<TOmittable> {
   /** @type `i32` */
   status: number | TOmittable;
   /** @type `u32` */

package/dist/build/debug.js

@@ -22,11 +22,21 @@ async function instantiate(module, imports = {}) {
   const { exports } = await WebAssembly.instantiate(module, adaptedImports);
   const memory = exports.memory || imports.env.memory;
   const adaptedExports = Object.setPrototypeOf({
+    getAssembly(p) {
+      // assembly/api-internal/getAssembly(assembly/program/Program) => ~lib/string/String
+      p = __lowerInternref(p) || __notnull();
+      return __liftString(exports.getAssembly(p) >>> 0);
+    },
+    wrapAsProgram(bytecode) {
+      // assembly/program-build/wrapAsProgram(~lib/typedarray/Uint8Array) => ~lib/typedarray/Uint8Array
+      bytecode = __lowerTypedArray(Uint8Array, 12, 0, bytecode) || __notnull();
+      return __liftTypedArray(Uint8Array, exports.wrapAsProgram(bytecode) >>> 0);
+    },
     resetJAM(program, pc, initialGas, args, hasMetadata) {
       // assembly/api-debugger/resetJAM(~lib/array/Array<u8>, u32, i64, ~lib/array/Array<u8>, bool?) => void
-      program = __retain(__lowerArray(__setU8, 6, 0, program) || __notnull());
+      program = __retain(__lowerArray(__setU8, 7, 0, program) || __notnull());
       initialGas = initialGas || 0n;
-      args = __lowerArray(__setU8, 6, 0, args) || __notnull();
+      args = __lowerArray(__setU8, 7, 0, args) || __notnull();
       hasMetadata = hasMetadata ? 1 : 0;
       try {
         exports.__setArgumentsLength(arguments.length);
@@ -37,8 +47,8 @@ async function instantiate(module, imports = {}) {
     },
     resetGeneric(program, flatRegisters, initialGas, hasMetadata) {
       // assembly/api-debugger/resetGeneric(~lib/array/Array<u8>, ~lib/array/Array<u8>, i64, bool?) => void
-      program = __retain(__lowerArray(__setU8, 6, 0, program) || __notnull());
-      flatRegisters = __lowerArray(__setU8, 6, 0, flatRegisters) || __notnull();
+      program = __retain(__lowerArray(__setU8, 7, 0, program) || __notnull());
+      flatRegisters = __lowerArray(__setU8, 7, 0, flatRegisters) || __notnull();
       initialGas = initialGas || 0n;
       hasMetadata = hasMetadata ? 1 : 0;
       try {
@@ -50,10 +60,10 @@ async function instantiate(module, imports = {}) {
     },
     resetGenericWithMemory(program, flatRegisters, pageMap, chunks, initialGas, hasMetadata) {
       // assembly/api-debugger/resetGenericWithMemory(~lib/array/Array<u8>, ~lib/array/Array<u8>, ~lib/typedarray/Uint8Array, ~lib/typedarray/Uint8Array, i64, bool?) => void
-      program = __retain(__lowerArray(__setU8, 6, 0, program) || __notnull());
-      flatRegisters = __retain(__lowerArray(__setU8, 6, 0, flatRegisters) || __notnull());
-      pageMap = __retain(__lowerTypedArray(Uint8Array, 10, 0, pageMap) || __notnull());
-      chunks = __lowerTypedArray(Uint8Array, 10, 0, chunks) || __notnull();
+      program = __retain(__lowerArray(__setU8, 7, 0, program) || __notnull());
+      flatRegisters = __retain(__lowerArray(__setU8, 7, 0, flatRegisters) || __notnull());
+      pageMap = __retain(__lowerTypedArray(Uint8Array, 12, 0, pageMap) || __notnull());
+      chunks = __lowerTypedArray(Uint8Array, 12, 0, chunks) || __notnull();
       initialGas = initialGas || 0n;
       hasMetadata = hasMetadata ? 1 : 0;
       try {
@@ -92,7 +102,7 @@ async function instantiate(module, imports = {}) {
     },
     setRegisters(flatRegisters) {
       // assembly/api-debugger/setRegisters(~lib/array/Array<u8>) => void
-      flatRegisters = __lowerArray(__setU8, 6, 0, flatRegisters) || __notnull();
+      flatRegisters = __lowerArray(__setU8, 7, 0, flatRegisters) || __notnull();
       exports.setRegisters(flatRegisters);
     },
     getPageDump(index) {
@@ -109,57 +119,9 @@ async function instantiate(module, imports = {}) {
     },
     setMemory(address, data) {
       // assembly/api-debugger/setMemory(u32, ~lib/typedarray/Uint8Array) => bool
-      data = __lowerTypedArray(Uint8Array, 10, 0, data) || __notnull();
+      data = __lowerTypedArray(Uint8Array, 12, 0, data) || __notnull();
       return exports.setMemory(address, data) != 0;
     },
-    getAssembly(p) {
-      // assembly/api-internal/getAssembly(assembly/program/Program) => ~lib/string/String
-      p = __lowerInternref(p) || __notnull();
-      return __liftString(exports.getAssembly(p) >>> 0);
-    },
-    buildMemory(builder, pages, chunks) {
-      // assembly/api-internal/buildMemory(assembly/memory/MemoryBuilder, ~lib/array/Array<assembly/api-types/InitialPage>, ~lib/array/Array<assembly/api-types/InitialChunk>) => assembly/memory/Memory
-      builder = __retain(__lowerInternref(builder) || __notnull());
-      pages = __retain(__lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord44(value) || __notnull()); }, 45, 2, pages) || __notnull());
-      chunks = __lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord46(value) || __notnull()); }, 47, 2, chunks) || __notnull();
-      try {
-        return __liftInternref(exports.buildMemory(builder, pages, chunks) >>> 0);
-      } finally {
-        __release(builder);
-        __release(pages);
-      }
-    },
-    vmInit(input, useSbrkGas) {
-      // assembly/api-internal/vmInit(assembly/api-types/VmInput, bool?) => assembly/interpreter/Interpreter
-      input = __lowerInternref(input) || __notnull();
-      useSbrkGas = useSbrkGas ? 1 : 0;
-      exports.__setArgumentsLength(arguments.length);
-      return __liftInternref(exports.vmInit(input, useSbrkGas) >>> 0);
-    },
-    vmRunOnce(input, options) {
-      // assembly/api-internal/vmRunOnce(assembly/api-types/VmInput, assembly/api-types/VmRunOptions) => assembly/api-types/VmOutput
-      input = __retain(__lowerInternref(input) || __notnull());
-      options = __lowerRecord50(options) || __notnull();
-      try {
-        return __liftRecord51(exports.vmRunOnce(input, options) >>> 0);
-      } finally {
-        __release(input);
-      }
-    },
-    vmExecute(int, logs) {
-      // assembly/api-internal/vmExecute(assembly/interpreter/Interpreter, bool?) => void
-      int = __lowerInternref(int) || __notnull();
-      logs = logs ? 1 : 0;
-      exports.__setArgumentsLength(arguments.length);
-      exports.vmExecute(int, logs);
-    },
-    vmDestroy(int, dumpMemory) {
-      // assembly/api-internal/vmDestroy(assembly/interpreter/Interpreter, bool?) => assembly/api-types/VmOutput
-      int = __lowerInternref(int) || __notnull();
-      dumpMemory = dumpMemory ? 1 : 0;
-      exports.__setArgumentsLength(arguments.length);
-      return __liftRecord51(exports.vmDestroy(int, dumpMemory) >>> 0);
-    },
     InputKind: (values => (
       // assembly/api-utils/InputKind
       values[values.Generic = exports["InputKind.Generic"].valueOf()] = "Generic",
@@ -174,21 +136,21 @@ async function instantiate(module, imports = {}) {
     ))({}),
     getGasCosts(input, kind, withMetadata) {
       // assembly/api-utils/getGasCosts(~lib/array/Array<u8>, i32, i32) => ~lib/array/Array<assembly/gas-costs/BlockGasCost>
-      input = __lowerArray(__setU8, 6, 0, input) || __notnull();
-      return __liftArray(pointer => __liftRecord56(__getU32(pointer)), 2, exports.getGasCosts(input, kind, withMetadata) >>> 0);
+      input = __lowerArray(__setU8, 7, 0, input) || __notnull();
+      return __liftArray(pointer => __liftRecord53(__getU32(pointer)), 2, exports.getGasCosts(input, kind, withMetadata) >>> 0);
     },
     disassemble(input, kind, withMetadata) {
       // assembly/api-utils/disassemble(~lib/array/Array<u8>, i32, i32) => ~lib/string/String
-      input = __lowerArray(__setU8, 6, 0, input) || __notnull();
+      input = __lowerArray(__setU8, 7, 0, input) || __notnull();
       return __liftString(exports.disassemble(input, kind, withMetadata) >>> 0);
     },
     prepareProgram(kind, hasMetadata, program, initialRegisters, initialPageMap, initialMemory, args, preallocateMemoryPages) {
       // assembly/api-utils/prepareProgram(i32, i32, ~lib/array/Array<u8>, ~lib/array/Array<u64>, ~lib/array/Array<assembly/api-types/InitialPage>, ~lib/array/Array<assembly/api-types/InitialChunk>, ~lib/array/Array<u8>, u32) => assembly/spi/StandardProgram
-      program = __retain(__lowerArray(__setU8, 6, 0, program) || __notnull());
-      initialRegisters = __retain(__lowerArray(__setU64, 52, 3, initialRegisters) || __notnull());
-      initialPageMap = __retain(__lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord44(value) || __notnull()); }, 45, 2, initialPageMap) || __notnull());
-      initialMemory = __retain(__lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord46(value) || __notnull()); }, 47, 2, initialMemory) || __notnull());
-      args = __lowerArray(__setU8, 6, 0, args) || __notnull();
+      program = __retain(__lowerArray(__setU8, 7, 0, program) || __notnull());
+      initialRegisters = __retain(__lowerArray(__setU64, 55, 3, initialRegisters) || __notnull());
+      initialPageMap = __retain(__lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord49(value) || __notnull()); }, 50, 2, initialPageMap) || __notnull());
+      initialMemory = __retain(__lowerArray((pointer, value) => { __setU32(pointer, __lowerRecord51(value) || __notnull()); }, 52, 2, initialMemory) || __notnull());
+      args = __lowerArray(__setU8, 7, 0, args) || __notnull();
       try {
         return __liftInternref(exports.prepareProgram(kind, hasMetadata, program, initialRegisters, initialPageMap, initialMemory, args, preallocateMemoryPages) >>> 0);
       } finally {
@@ -206,7 +168,7 @@ async function instantiate(module, imports = {}) {
       useSbrkGas = useSbrkGas ? 1 : 0;
       dumpMemory = dumpMemory ? 1 : 0;
       exports.__setArgumentsLength(arguments.length);
-      return __liftRecord51(exports.runProgram(program, initialGas, programCounter, logs, useSbrkGas, dumpMemory) >>> 0);
+      return __liftRecord58(exports.runProgram(program, initialGas, programCounter, logs, useSbrkGas, dumpMemory) >>> 0);
     },
     pvmStart(program, useSbrkGas) {
       // assembly/api-utils/pvmStart(assembly/spi/StandardProgram, bool?) => u32
@@ -217,11 +179,11 @@ async function instantiate(module, imports = {}) {
     },
     pvmDestroy(pvmId) {
       // assembly/api-utils/pvmDestroy(u32) => assembly/api-types/VmOutput | null
-      return __liftRecord51(exports.pvmDestroy(pvmId) >>> 0);
+      return __liftRecord58(exports.pvmDestroy(pvmId) >>> 0);
     },
     pvmSetRegisters(pvmId, registers) {
       // assembly/api-utils/pvmSetRegisters(u32, ~lib/array/Array<u64>) => void
-      registers = __lowerArray(__setU64, 52, 3, registers) || __notnull();
+      registers = __lowerArray(__setU64, 55, 3, registers) || __notnull();
       exports.pvmSetRegisters(pvmId, registers);
     },
     pvmReadMemory(pvmId, address, length) {
@@ -234,7 +196,7 @@ async function instantiate(module, imports = {}) {
     },
     pvmWriteMemory(pvmId, address, data) {
       // assembly/api-utils/pvmWriteMemory(u32, u32, ~lib/typedarray/Uint8Array) => bool
-      data = __lowerTypedArray(Uint8Array, 10, 0, data) || __notnull();
+      data = __lowerTypedArray(Uint8Array, 12, 0, data) || __notnull();
       return exports.pvmWriteMemory(pvmId, address, data) != 0;
     },
     pvmResume(pvmId, gas, pc, logs) {
@@ -242,47 +204,40 @@ async function instantiate(module, imports = {}) {
       gas = gas || 0n;
       logs = logs ? 1 : 0;
       exports.__setArgumentsLength(arguments.length);
-      return __liftRecord60(exports.pvmResume(pvmId, gas, pc, logs) >>> 0);
-    },
-    wrapAsProgram(bytecode) {
-      // assembly/program-build/wrapAsProgram(~lib/typedarray/Uint8Array) => ~lib/typedarray/Uint8Array
-      bytecode = __lowerTypedArray(Uint8Array, 10, 0, bytecode) || __notnull();
-      return __liftTypedArray(Uint8Array, exports.wrapAsProgram(bytecode) >>> 0);
+      return __liftRecord64(exports.pvmResume(pvmId, gas, pc, logs) >>> 0);
     },
   }, exports);
-  function __lowerRecord44(value) {
+  function __liftRecord53(pointer) {
+    // assembly/gas-costs/BlockGasCost
+    // Hint: Opt-out from lifting as a record by providing an empty constructor
+    if (!pointer) return null;
+    return {
+      pc: __getU32(pointer + 0),
+      gas: __getU64(pointer + 8),
+    };
+  }
+  function __lowerRecord49(value) {
     // assembly/api-types/InitialPage
     // Hint: Opt-out from lowering as a record by providing an empty constructor
     if (value == null) return 0;
-    const pointer = exports.__pin(exports.__new(12, 44));
+    const pointer = exports.__pin(exports.__new(12, 49));
     __setU32(pointer + 0, value.address);
     __setU32(pointer + 4, value.length);
     __setU32(pointer + 8, value.access);
     exports.__unpin(pointer);
     return pointer;
   }
-  function __lowerRecord46(value) {
+  function __lowerRecord51(value) {
     // assembly/api-types/InitialChunk
     // Hint: Opt-out from lowering as a record by providing an empty constructor
     if (value == null) return 0;
-    const pointer = exports.__pin(exports.__new(8, 46));
+    const pointer = exports.__pin(exports.__new(8, 51));
     __setU32(pointer + 0, value.address);
-    __setU32(pointer + 4, __lowerArray(__setU8, 6, 0, value.data) || __notnull());
+    __setU32(pointer + 4, __lowerArray(__setU8, 7, 0, value.data) || __notnull());
     exports.__unpin(pointer);
     return pointer;
   }
-  function __lowerRecord50(value) {
-    // assembly/api-types/VmRunOptions
-    // Hint: Opt-out from lowering as a record by providing an empty constructor
-    if (value == null) return 0;
-    const pointer = exports.__pin(exports.__new(3, 50));
-    __setU8(pointer + 0, value.useSbrkGas ? 1 : 0);
-    __setU8(pointer + 1, value.logs ? 1 : 0);
-    __setU8(pointer + 2, value.dumpMemory ? 1 : 0);
-    exports.__unpin(pointer);
-    return pointer;
-  }
-  function __liftRecord46(pointer) {
+  function __liftRecord51(pointer) {
     // assembly/api-types/InitialChunk
     // Hint: Opt-out from lifting as a record by providing an empty constructor
     if (!pointer) return null;
@@ -291,7 +246,7 @@ async function instantiate(module, imports = {}) {
       data: __liftArray(__getU8, 0, __getU32(pointer + 4)),
     };
   }
-  function __liftRecord51(pointer) {
+  function __liftRecord58(pointer) {
     // assembly/api-types/VmOutput
     // Hint: Opt-out from lifting as a record by providing an empty constructor
     if (!pointer) return null;
@@ -302,19 +257,10 @@ async function instantiate(module, imports = {}) {
       gas: __getI64(pointer + 16),
       result: __liftArray(__getU8, 0, __getU32(pointer + 24)),
       registers: __liftArray(pointer => BigInt.asUintN(64, __getU64(pointer)), 3, __getU32(pointer + 28)),
-      memory: __liftArray(pointer => __liftRecord46(__getU32(pointer)), 2, __getU32(pointer + 32)),
+      memory: __liftArray(pointer => __liftRecord51(__getU32(pointer)), 2, __getU32(pointer + 32)),
     };
   }
-  function __liftRecord56(pointer) {
-    // assembly/gas-costs/BlockGasCost
-    // Hint: Opt-out from lifting as a record by providing an empty constructor
-    if (!pointer) return null;
-    return {
-      pc: __getU32(pointer + 0),
-      gas: __getU64(pointer + 8),
-    };
-  }
-  function __liftRecord60(pointer) {
+  function __liftRecord64(pointer) {
     // assembly/api-types/VmPause
     // Hint: Opt-out from lifting as a record by providing an empty constructor
     if (!pointer) return null;
@@ -485,6 +431,8 @@ async function instantiate(module, imports = {}) {
 }
 export const {
   memory,
+  getAssembly,
+  wrapAsProgram,
   resetJAM,
   resetGeneric,
   resetGenericWithMemory,
@@ -502,12 +450,6 @@ export const {
   getPagePointer,
   getMemory,
   setMemory,
-  getAssembly,
-  buildMemory,
-  vmInit,
-  vmRunOnce,
-  vmExecute,
-  vmDestroy,
   InputKind,
   HasMetadata,
   getGasCosts,
@@ -521,7 +463,6 @@ export const {
   pvmGetPagePointer,
   pvmWriteMemory,
   pvmResume,
-  wrapAsProgram,
 } = await (async url => instantiate(
   await (async () => {
     const isNodeOrBun = typeof process != "undefined" && process.versions != null && (process.versions.node != null || process.versions.bun != null);

package/dist/build/js/assembly/api-debugger.d.ts

@@ -0,0 +1,55 @@
+import { Gas } from "./gas";
+export declare function resetJAM(program: u8[], pc: u32, initialGas: Gas, args: u8[], hasMetadata?: boolean): void;
+export declare function resetGeneric(program: u8[], flatRegisters: u8[], initialGas: Gas, hasMetadata?: boolean): void;
+export declare function resetGenericWithMemory(program: u8[], flatRegisters: u8[], pageMap: Uint8Array, chunks: Uint8Array, initialGas: Gas, hasMetadata?: boolean): void;
+export declare function nextStep(): boolean;
+export declare function nSteps(steps: u32): boolean;
+export declare function getProgramCounter(): u32;
+export declare function setNextProgramCounter(pc: u32): void;
+export declare function getStatus(): u8;
+export declare function getExitArg(): u32;
+export declare function getGasLeft(): i64;
+export declare function setGasLeft(gas: i64): void;
+export declare function getRegisters(): Uint8Array;
+export declare function setRegisters(flatRegisters: u8[]): void;
+export declare function getPageDump(index: u32): Uint8Array;
+/**
+ * Returns the WASM linear memory pointer (byte offset) for the backing buffer of the page at `page`.
+ *
+ * Returns `0` if the page does not exist or is not readable (page/access fault).
+ *
+ * Use this instead of `getMemory` to read memory efficiently from the JS side:
+ * ```ts
+ * let pagesRead = 0;
+ * for (let address = start; address < end; address += PAGE_SIZE) {
+ *   const page = address >> PAGE_SIZE_SHIFT;
+ *   const ptr = getPagePointer(page);
+ *   if (ptr === 0) {
+ *     throw new Error(`Page fault at ${page << PAGE_SIZE_SHIFT}`);
+ *   }
+ *   destination.set(
+ *     new Uint8Array(wasm.instance.exports.memory.buffer, ptr, Math.min(end - address, PAGE_SIZE)),
+ *     pagesRead << PAGE_SIZE_SHIFT,
+ *   );
+ *   pagesRead += 1;
+ * }
+ * ```
+ */
+export declare function getPagePointer(page: u32): usize;
+/**
+ * Read a chunk of memory at `[address, address + length)`.
+ *
+ * Returns the requested memory chunk or `null` if reading triggered a page fault.
+ *
+ * @deprecated Getting memory like that is extremely inefficient (copying mulitple times)
+ * and error prone (we may not be able to allocate).
+ * Use `getPagePointer` instead to read memory directly from WASM linear memory on the JS side
+ * with no additional WASM-side allocations.
+ */
+export declare function getMemory(address: u32, length: u32): Uint8Array | null;
+/**
+ * Write given `data` under memory indices `[address, address + data.length)`.
+ *
+ * Returns `true` if the write was successful and `false` if page fault has been triggered.
+ */
+export declare function setMemory(address: u32, data: Uint8Array): boolean;