@fluffylabs/anan-as 1.0.0 → 1.1.0

package/build/release-stub.d.ts

@@ -0,0 +1,218 @@
+/** Exported memory */
+export declare const memory: WebAssembly.Memory;
+// Exported runtime interface
+export declare function __new(size: number, id: number): number;
+export declare function __pin(ptr: number): number;
+export declare function __unpin(ptr: number): void;
+export declare function __collect(): void;
+export declare const __rtti_base: number;
+/**
+ * assembly/api-internal/getAssembly
+ * @param p `assembly/program/Program`
+ * @returns `~lib/string/String`
+ */
+export declare function getAssembly(p: __Internref26): 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>`
+ * @param pc `f64`
+ * @param initialGas `i64`
+ * @param args `~lib/array/Array<u8>`
+ * @param hasMetadata `bool`
+ */
+export declare function resetJAM(program: Array<number>, pc: number, initialGas: bigint, args: Array<number>, hasMetadata?: boolean): void;
+/**
+ * assembly/api-debugger/resetGeneric
+ * @param program `~lib/array/Array<u8>`
+ * @param flatRegisters `~lib/array/Array<u8>`
+ * @param initialGas `i64`
+ * @param hasMetadata `bool`
+ */
+export declare function resetGeneric(program: Array<number>, flatRegisters: Array<number>, initialGas: bigint, hasMetadata?: boolean): void;
+/**
+ * assembly/api-debugger/resetGenericWithMemory
+ * @param program `~lib/array/Array<u8>`
+ * @param flatRegisters `~lib/array/Array<u8>`
+ * @param pageMap `~lib/typedarray/Uint8Array`
+ * @param chunks `~lib/typedarray/Uint8Array`
+ * @param initialGas `i64`
+ * @param hasMetadata `bool`
+ */
+export declare function resetGenericWithMemory(program: Array<number>, flatRegisters: Array<number>, pageMap: Uint8Array, chunks: Uint8Array, initialGas: bigint, hasMetadata?: boolean): void;
+/**
+ * assembly/api-debugger/nextStep
+ * @returns `bool`
+ */
+export declare function nextStep(): boolean;
+/**
+ * assembly/api-debugger/nSteps
+ * @param steps `u32`
+ * @returns `bool`
+ */
+export declare function nSteps(steps: number): boolean;
+/**
+ * assembly/api-debugger/getProgramCounter
+ * @returns `u32`
+ */
+export declare function getProgramCounter(): number;
+/**
+ * assembly/api-debugger/setNextProgramCounter
+ * @param pc `u32`
+ */
+export declare function setNextProgramCounter(pc: number): void;
+/**
+ * assembly/api-debugger/getStatus
+ * @returns `u8`
+ */
+export declare function getStatus(): number;
+/**
+ * assembly/api-debugger/getExitArg
+ * @returns `u32`
+ */
+export declare function getExitArg(): number;
+/**
+ * assembly/api-debugger/getGasLeft
+ * @returns `i64`
+ */
+export declare function getGasLeft(): bigint;
+/**
+ * assembly/api-debugger/setGasLeft
+ * @param gas `i64`
+ */
+export declare function setGasLeft(gas: bigint): void;
+/**
+ * assembly/api-debugger/getRegisters
+ * @returns `~lib/typedarray/Uint8Array`
+ */
+export declare function getRegisters(): Uint8Array;
+/**
+ * assembly/api-debugger/setRegisters
+ * @param flatRegisters `~lib/array/Array<u8>`
+ */
+export declare function setRegisters(flatRegisters: Array<number>): void;
+/**
+ * assembly/api-debugger/getPageDump
+ * @param index `u32`
+ * @returns `~lib/typedarray/Uint8Array`
+ */
+export declare function getPageDump(index: number): Uint8Array;
+/**
+ * assembly/api-debugger/getMemory
+ * @param address `u32`
+ * @param length `u32`
+ * @returns `~lib/typedarray/Uint8Array | null`
+ */
+export declare function getMemory(address: number, length: number): Uint8Array | null;
+/**
+ * assembly/api-debugger/setMemory
+ * @param address `u32`
+ * @param data `~lib/typedarray/Uint8Array`
+ * @returns `bool`
+ */
+export declare function setMemory(address: number, data: Uint8Array): boolean;
+/** assembly/api-utils/InputKind */
+export declare enum InputKind {
+  /** @type `i32` */
+  Generic,
+  /** @type `i32` */
+  SPI,
+}
+/** assembly/api-utils/HasMetadata */
+export declare enum HasMetadata {
+  /** @type `i32` */
+  Yes,
+  /** @type `i32` */
+  No,
+}
+/**
+ * assembly/api-utils/getGasCosts
+ * @param input `~lib/array/Array<u8>`
+ * @param kind `i32`
+ * @param withMetadata `i32`
+ * @returns `~lib/array/Array<assembly/gas-costs/BlockGasCost>`
+ */
+export declare function getGasCosts(input: Array<number>, kind: number, withMetadata: number): Array<__Record50<never>>;
+/**
+ * assembly/api-utils/disassemble
+ * @param input `~lib/array/Array<u8>`
+ * @param kind `i32`
+ * @param withMetadata `i32`
+ * @returns `~lib/string/String`
+ */
+export declare function disassemble(input: Array<number>, kind: number, withMetadata: number): string;
+/**
+ * assembly/api-utils/prepareProgram
+ * @param kind `i32`
+ * @param hasMetadata `i32`
+ * @param program `~lib/array/Array<u8>`
+ * @param initialRegisters `~lib/array/Array<u64>`
+ * @param initialPageMap `~lib/array/Array<assembly/api-internal/InitialPage>`
+ * @param initialMemory `~lib/array/Array<assembly/api-internal/InitialChunk>`
+ * @param args `~lib/array/Array<u8>`
+ * @returns `assembly/spi/StandardProgram`
+ */
+export declare function prepareProgram(kind: number, hasMetadata: number, program: Array<number>, initialRegisters: Array<bigint>, initialPageMap: Array<__Record46<undefined>>, initialMemory: Array<__Record48<undefined>>, args: Array<number>): __Internref42;
+/**
+ * assembly/api-utils/runProgram
+ * @param program `assembly/spi/StandardProgram`
+ * @param initialGas `i64`
+ * @param programCounter `u32`
+ * @param logs `bool`
+ * @param useSbrkGas `bool`
+ * @returns `assembly/api-internal/VmOutput`
+ */
+export declare function runProgram(program: __Internref42, initialGas?: bigint, programCounter?: number, logs?: boolean, useSbrkGas?: boolean): __Record55<never>;
+/** assembly/program/Program */
+declare class __Internref26 extends Number {
+  private __nominal26: symbol;
+  private __nominal0: symbol;
+}
+/** assembly/gas-costs/BlockGasCost */
+declare interface __Record50<TOmittable> {
+  /** @type `u32` */
+  pc: number | TOmittable;
+  /** @type `u64` */
+  gas: bigint | TOmittable;
+}
+/** assembly/api-internal/InitialPage */
+declare interface __Record46<TOmittable> {
+  /** @type `u32` */
+  address: number | TOmittable;
+  /** @type `u32` */
+  length: number | TOmittable;
+  /** @type `i32` */
+  access: number | TOmittable;
+}
+/** assembly/api-internal/InitialChunk */
+declare interface __Record48<TOmittable> {
+  /** @type `u32` */
+  address: number | TOmittable;
+  /** @type `~lib/array/Array<u8>` */
+  data: Array<number>;
+}
+/** assembly/spi/StandardProgram */
+declare class __Internref42 extends Number {
+  private __nominal42: symbol;
+  private __nominal0: symbol;
+}
+/** assembly/api-internal/VmOutput */
+declare interface __Record55<TOmittable> {
+  /** @type `i32` */
+  status: number | TOmittable;
+  /** @type `~lib/array/Array<u64>` */
+  registers: Array<bigint>;
+  /** @type `u32` */
+  pc: number | TOmittable;
+  /** @type `~lib/array/Array<assembly/api-internal/InitialChunk>` */
+  memory: Array<__Record48<never>>;
+  /** @type `i64` */
+  gas: bigint | TOmittable;
+  /** @type `u32` */
+  exitCode: number | TOmittable;
+}

package/build/{release-raw.js → release-stub.js}

@@ -1,4 +1,4 @@
-export async function instantiate(module, imports = {}) {
+async function instantiate(module, imports = {}) {
   const adaptedImports = {
     env: Object.setPrototypeOf({
       abort(message, fileName, lineNumber, columnNumber) {
@@ -109,10 +109,14 @@ export async function instantiate(module, imports = {}) {
       // assembly/api-debugger/getPageDump(u32) => ~lib/typedarray/Uint8Array
       return __liftTypedArray(Uint8Array, exports.getPageDump(index) >>> 0);
     },
+    getMemory(address, length) {
+      // assembly/api-debugger/getMemory(u32, u32) => ~lib/typedarray/Uint8Array | null
+      return __liftTypedArray(Uint8Array, exports.getMemory(address, length) >>> 0);
+    },
     setMemory(address, data) {
-      // assembly/api-debugger/setMemory(u32, ~lib/typedarray/Uint8Array) => void
+      // assembly/api-debugger/setMemory(u32, ~lib/typedarray/Uint8Array) => bool
       data = __lowerTypedArray(Uint8Array, 10, 0, data) || __notnull();
-      exports.setMemory(address, data);
+      return exports.setMemory(address, data) != 0;
     },
     InputKind: (values => (
       // assembly/api-utils/InputKind
@@ -370,3 +374,42 @@ export async function instantiate(module, imports = {}) {
   }
   return adaptedExports;
 }
+export const {
+  memory,
+  __new,
+  __pin,
+  __unpin,
+  __collect,
+  __rtti_base,
+  getAssembly,
+  wrapAsProgram,
+  resetJAM,
+  resetGeneric,
+  resetGenericWithMemory,
+  nextStep,
+  nSteps,
+  getProgramCounter,
+  setNextProgramCounter,
+  getStatus,
+  getExitArg,
+  getGasLeft,
+  setGasLeft,
+  getRegisters,
+  setRegisters,
+  getPageDump,
+  getMemory,
+  setMemory,
+  InputKind,
+  HasMetadata,
+  getGasCosts,
+  disassemble,
+  prepareProgram,
+  runProgram,
+} = await (async url => instantiate(
+  await (async () => {
+    const isNodeOrBun = typeof process != "undefined" && process.versions != null && (process.versions.node != null || process.versions.bun != null);
+    if (isNodeOrBun) { return globalThis.WebAssembly.compile(await (await import("node:fs/promises")).readFile(url)); }
+    else { return await globalThis.WebAssembly.compileStreaming(globalThis.fetch(url)); }
+  })(), {
+  }
+))(new URL("release-stub.wasm", import.meta.url));

package/build/release.d.ts

@@ -96,12 +96,20 @@ export declare function setRegisters(flatRegisters: Array<number>): void;
  * @returns `~lib/typedarray/Uint8Array`
  */
 export declare function getPageDump(index: number): Uint8Array;
+/**
+ * assembly/api-debugger/getMemory
+ * @param address `u32`
+ * @param length `u32`
+ * @returns `~lib/typedarray/Uint8Array | null`
+ */
+export declare function getMemory(address: number, length: number): Uint8Array | null;
 /**
  * assembly/api-debugger/setMemory
  * @param address `u32`
  * @param data `~lib/typedarray/Uint8Array`
+ * @returns `bool`
  */
-export declare function setMemory(address: number, data: Uint8Array): void;
+export declare function setMemory(address: number, data: Uint8Array): boolean;
 /** assembly/api-utils/InputKind */
 export declare enum InputKind {
   /** @type `i32` */

package/build/release.js

@@ -109,10 +109,14 @@ async function instantiate(module, imports = {}) {
       // assembly/api-debugger/getPageDump(u32) => ~lib/typedarray/Uint8Array
       return __liftTypedArray(Uint8Array, exports.getPageDump(index) >>> 0);
     },
+    getMemory(address, length) {
+      // assembly/api-debugger/getMemory(u32, u32) => ~lib/typedarray/Uint8Array | null
+      return __liftTypedArray(Uint8Array, exports.getMemory(address, length) >>> 0);
+    },
     setMemory(address, data) {
-      // assembly/api-debugger/setMemory(u32, ~lib/typedarray/Uint8Array) => void
+      // assembly/api-debugger/setMemory(u32, ~lib/typedarray/Uint8Array) => bool
       data = __lowerTypedArray(Uint8Array, 10, 0, data) || __notnull();
-      exports.setMemory(address, data);
+      return exports.setMemory(address, data) != 0;
     },
     InputKind: (values => (
       // assembly/api-utils/InputKind
@@ -388,6 +392,7 @@ export const {
   getRegisters,
   setRegisters,
   getPageDump,
+  getMemory,
   setMemory,
   InputKind,
   HasMetadata,