feat!: monero.ts rewrite, integration tests

.devcontainer/Dockerfile

@@ -1,5 +1,6 @@
 FROM ghcr.io/cirruslabs/flutter:3.24.3
 # FROM debian:bookworm
+SHELL ["/bin/bash", "-c"]
 
 # Install dependencies
 
@@ -15,11 +16,18 @@ RUN apt update \
 
 RUN bash -c 'if [[ "$(uname -m)" == "aarch64" || "$(uname -m)" == "arm64" ]] then sudo rm -rf /opt/android-sdk-linux/platform-tools; fi'
 
-# Install zsh and configure it
+
+ENV DENO_VERSION=v2.0.3
+RUN if [[ "$(uname -m)" == "aarch64" || "$(uname -m)" == "arm64" ]] then export DENO_ARCH=aarch64-unknown-linux-gnu; fi; \
+    if [[ "$(uname -m)" == "x86_64" || "$(uname -m)" == "amd64" ]] then export DENO_ARCH=x86_64-unknown-linux-gnu; fi; \
+    wget -O /tmp/deno.zip "https://github.com/denoland/deno/releases/download/${DENO_VERSION}/deno-${DENO_ARCH}.zip" && \
+    cd /tmp && \
+    unzip /tmp/deno.zip && \
+    mv deno /usr/local/bin && \
+    rm -rf deno deno.zip
 
 USER ubuntu
 
+RUN git config --global --add safe.directory '*'
 RUN sh -c "$(wget -O- https://github.com/deluan/zsh-in-docker/releases/download/v1.2.0/zsh-in-docker.sh)" \
     -t robbyrussell 
-
-RUN git config --global --add safe.directory '*'

.devcontainer/devcontainer.json

@@ -17,7 +17,8 @@
             },
 			"extensions": [
                 "dart-code.flutter",
-                "dart-code.dart-code"
+                "dart-code.dart-code",
+				"denoland.vscode-deno"
 			]
 		}
 	},

.github/workflows/full_check.yaml

@@ -609,7 +609,38 @@ jobs:
           path: release/${{ matrix.coin }}
 
       - name: Run regression tests
-        run: COIN="${{ matrix.coin }}" deno test -A tests/
+        run: COIN="${{ matrix.coin }}" deno test -A tests/regression.test.ts
+
+  integration_check:
+    strategy:
+      matrix:
+        coin: [monero, wownero]
+    needs: [
+      lib_linux
+    ]
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: linux ${{ matrix.coin }}
+          path: release/${{ matrix.coin }}
+
+      - name: Run integration tests
+        run: COIN="${{ matrix.coin }}" deno test -A tests/integration.test.ts
+        env:
+          SECRET_WALLET_PASSWORD: ${{ secrets.SECRET_WALLET_PASSWORD }}
+          SECRET_WALLET_MNEMONIC: ${{ secrets.SECRET_WALLET_MNEMONIC }}
+          SECRET_WALLET_RESTORE_HEIGHT: ${{ secrets.SECRET_WALLET_RESTORE_HEIGHT }}
+
 
   comment_pr:
     name: comment on pr

.gitignore

@@ -1,5 +1,6 @@
 release/
 build/
 tests/monero-cli
+tests/wownero-cli
 tests/libs
 tests/wallets

impls/monero.ts/README.md

@@ -23,7 +23,7 @@ There are at least two ways to do so:
   loadMoneroDylib();
 
   const wm = await WalletManager.new();
-  const wallet = await Wallet.create(wm, "./my_wallet", "password");
+  const wallet = await wm.createWallet("./my_wallet", "password");
 
   console.log(await wallet.address());
 
@@ -41,7 +41,7 @@ There are at least two ways to do so:
   loadMoneroDylib(lib);
 
   const wm = await WalletManager.new();
-  const wallet = await Wallet.create(wm, "./my_wallet", "password");
+  const wallet = await wm.createWallet("./my_wallet", "password");
 
   console.log(await wallet.address());
 

impls/monero.ts/checksum.ts

@@ -1,6 +1,6 @@
 import { moneroChecksum } from "./checksum_monero.ts";
-import { getSymbol, readCString } from "./src/utils.ts";
-import { dylib, loadMoneroDylib } from "./src/bindings.ts";
+import { readCString } from "./src/utils.ts";
+import { fns, loadMoneroDylib } from "./src/bindings.ts";
 
 loadMoneroDylib();
 
@@ -21,7 +21,7 @@ export class ChecksumError extends Error {
  * @returns {ChecksumError} which contains information about why checksum failed
  */
 export async function validateChecksum(): Promise<ChecksumError | null> {
-  const cppHeaderHash = await readCString(await getSymbol("checksum_wallet2_api_c_h")!(), false);
+  const cppHeaderHash = await readCString(await fns.checksum_wallet2_api_c_h!(), false);
   const tsHeaderHash = moneroChecksum.wallet2_api_c_h_sha256;
 
   const errors: string[] = [];
@@ -32,14 +32,14 @@ export async function validateChecksum(): Promise<ChecksumError | null> {
     errorCode++;
   }
 
-  const cppSourceHash = await readCString(await getSymbol("checksum_wallet2_api_c_cpp")!(), false);
+  const cppSourceHash = await readCString(await fns.checksum_wallet2_api_c_cpp!(), false);
   const tsSourceHash = moneroChecksum.wallet2_api_c_cpp_sha256;
   if (cppSourceHash !== tsSourceHash) {
     errors.push(`ERR: CPP source file check mismatch ${cppSourceHash} == ${tsSourceHash}`);
     errorCode++;
   }
 
-  const cppExportHash = await readCString(await getSymbol("checksum_wallet2_api_c_exp")!(), false);
+  const cppExportHash = await readCString(await fns.checksum_wallet2_api_c_exp!(), false);
   const tsExportHash = moneroChecksum.wallet2_api_c_exp_sha256;
   if (cppExportHash !== tsExportHash) {
     if (Deno.build.os !== "darwin") {

impls/monero.ts/mod.ts

@@ -1,6 +1,11 @@
 export * from "./src/bindings.ts";
+export * from "./src/coins.ts";
+export * from "./src/coins_info.ts";
 export * from "./src/pending_transaction.ts";
+export * from "./src/symbols.ts";
 export * from "./src/transaction_history.ts";
 export * from "./src/transaction_info.ts";
+export * from "./src/unsigned_transaction.ts";
+export * from "./src/utils.ts";
 export * from "./src/wallet.ts";
 export * from "./src/wallet_manager.ts";

impls/monero.ts/src/bindings.ts

@@ -1,8 +1,21 @@
-import { type Dylib, moneroSymbols, type MoneroTsDylib, wowneroSymbols, type WowneroTsDylib } from "./symbols.ts";
+import { type MoneroSymbols, moneroSymbols, type SymbolName, type WowneroSymbols, wowneroSymbols } from "./symbols.ts";
+
+export type MoneroDylib = Deno.DynamicLibrary<MoneroSymbols>;
+export type WowneroDylib = Deno.DynamicLibrary<WowneroSymbols>;
+export type Dylib = MoneroDylib | WowneroDylib;
 
 export let dylib: Dylib;
 
-export function loadMoneroDylib(newDylib?: MoneroTsDylib) {
+let dylibPrefix = "MONERO";
+export const fns = new Proxy({} as { [K in SymbolName]: MoneroDylib["symbols"][`MONERO_${K}`] }, {
+  get(_, symbolName: SymbolName) {
+    return dylib.symbols[`${dylibPrefix}_${symbolName}` as keyof Dylib["symbols"]];
+  },
+});
+
+export function loadMoneroDylib(newDylib?: MoneroDylib) {
+  dylibPrefix = "MONERO";
+
   if (newDylib) {
     dylib = newDylib;
     return;
@@ -27,7 +40,9 @@ export function loadMoneroDylib(newDylib?: MoneroTsDylib) {
   dylib = Deno.dlopen(libPath, moneroSymbols);
 }
 
-export function loadWowneroDylib(newDylib?: WowneroTsDylib) {
+export function loadWowneroDylib(newDylib?: WowneroDylib) {
+  dylibPrefix = "WOWNERO";
+
   if (newDylib) {
     dylib = newDylib;
     return;

impls/monero.ts/src/coins.ts

@@ -0,0 +1,53 @@
+import { CoinsInfo, type CoinsInfoPtr } from "./coins_info.ts";
+import { fns } from "./bindings.ts";
+
+export type CoinsPtr = Deno.PointerObject<"coins">;
+
+export class Coins {
+  #ptr: CoinsPtr;
+
+  #coins: CoinsInfo[] = [];
+
+  constructor(ptr: CoinsPtr) {
+    this.#ptr = ptr;
+  }
+
+  async count(): Promise<number> {
+    return await fns.Coins_count(this.#ptr);
+  }
+
+  async coin(index: number): Promise<CoinsInfo | null> {
+    if (this.#coins[index]) {
+      return this.#coins[index];
+    }
+
+    const coinPtr = await fns.Coins_coin(this.#ptr, index);
+    if (!coinPtr) return null;
+
+    return CoinsInfo.new(coinPtr as CoinsInfoPtr);
+  }
+
+  async setFrozen(index: number) {
+    return await fns.Coins_setFrozen(this.#ptr, index);
+  }
+
+  async thaw(index: number) {
+    return await fns.Coins_thaw(this.#ptr, index);
+  }
+
+  async getAllSize(): Promise<number> {
+    return await fns.Coins_getAll_size(this.#ptr);
+  }
+
+  async getAllByIndex(index: number): Promise<unknown> {
+    return await fns.Coins_getAll_byIndex(this.#ptr, index);
+  }
+
+  async refresh(): Promise<void> {
+    await fns.Coins_refresh(this.#ptr);
+
+    for (const coin of this.#coins) {
+      coin.refresh();
+    }
+  }
+}

impls/monero.ts/src/coins_info.ts

@@ -0,0 +1,85 @@
+import { fns } from "./bindings.ts";
+import { readCString } from "./utils.ts";
+
+export type CoinsInfoPtr = Deno.PointerObject<"coinsInfo">;
+
+export class CoinsInfo {
+  #ptr: CoinsInfoPtr;
+
+  #hash!: string | null;
+  #keyImage!: string | null;
+  #blockHeight!: bigint;
+  #amount!: bigint;
+  #spent!: boolean;
+  #spentHeight!: bigint;
+  #frozen!: boolean;
+  #unlocked!: boolean;
+
+  constructor(ptr: CoinsInfoPtr) {
+    this.#ptr = ptr;
+  }
+
+  getPointer(): CoinsInfoPtr {
+    return this.#ptr;
+  }
+
+  static async new(ptr: CoinsInfoPtr): Promise<CoinsInfo> {
+    const instance = new CoinsInfo(ptr);
+    await instance.refresh();
+    return instance;
+  }
+
+  async refresh() {
+    const [hash, keyImage, blockHeight, amount, spent, spentHeight, frozen, unlocked] = await Promise.all([
+      fns.CoinsInfo_hash(this.#ptr).then(readCString),
+      fns.CoinsInfo_keyImage(this.#ptr).then(readCString),
+      fns.CoinsInfo_blockHeight(this.#ptr),
+      fns.CoinsInfo_amount(this.#ptr),
+      fns.CoinsInfo_spent(this.#ptr),
+      fns.CoinsInfo_spentHeight(this.#ptr),
+      fns.CoinsInfo_frozen(this.#ptr),
+      fns.CoinsInfo_unlocked(this.#ptr),
+    ]);
+
+    this.#hash = hash;
+    this.#keyImage = keyImage;
+    this.#blockHeight = blockHeight;
+    this.#amount = amount;
+    this.#spent = spent;
+    this.#spentHeight = spentHeight;
+    this.#frozen = frozen;
+    this.#unlocked = unlocked;
+  }
+
+  get hash(): string | null {
+    return this.#hash;
+  }
+
+  get keyImage(): string | null {
+    return this.#keyImage;
+  }
+
+  get blockHeight(): bigint {
+    return this.#blockHeight;
+  }
+
+  get amount(): bigint {
+    return this.#amount;
+  }
+
+  get spent(): boolean {
+    return this.#spent;
+  }
+
+  get spentHeight(): bigint {
+    return this.#spentHeight;
+  }
+
+  get frozen(): boolean {
+    return this.#frozen;
+  }
+
+  get unlocked(): boolean {
+    return this.#unlocked;
+  }
+}