@spirobel/monero-wallet-api 0.5.1 → 0.5.2

package/dist/scansettings/scanSettingsOpened.js

@@ -0,0 +1,299 @@
+import { LOCAL_NODE_DEFAULT_URL } from "../node-interaction/nodeUrl";
+import { LOGGING_FUNCTIONS } from "../io/logging";
+import { getPathPrefix, makeSpendKeyFromSeed, makeViewKey, openScanSettingsFile, SCAN_SETTINGS_STORE_NAME_DEFAULT, SUB_ADDRESS_INDEX_DEFAULT_VALUE, walletSettingsPlusKeys, writeEnvLineToDotEnvRefresh, writeScanSettings, writeViewKeyToDotEnv, } from "../api";
+export class ScanSettingsOpened {
+    _scan_settings_path;
+    _pathPrefix;
+    /**
+     * open the settings file and return a new ScanSettingsOpened instance.
+     * if the file does not exist, creates one with defaults.
+     */
+    static async create(scan_settings_path = SCAN_SETTINGS_STORE_NAME_DEFAULT, pathPrefix) {
+        pathPrefix = getPathPrefix(scan_settings_path, pathPrefix);
+        let settings = await openScanSettingsFile(scan_settings_path);
+        if (!settings) {
+            settings = {
+                wallets: [],
+                node_url: LOCAL_NODE_DEFAULT_URL,
+                start_height: null,
+            };
+            // persist the defaults so the file exists on disk
+            await writeScanSettings(settings, scan_settings_path);
+        }
+        ScanSettingsOpened._validateLogOptions(settings.logs_include, settings.logs_exclude);
+        return new ScanSettingsOpened(settings, scan_settings_path, pathPrefix);
+    }
+    get node_url() {
+        return this._settings.node_url;
+    }
+    get start_height() {
+        return this._settings.start_height;
+    }
+    get merchant_confirmations() {
+        return this._settings.merchant_confirmations;
+    }
+    get cpu_worker_count() {
+        return this._settings.cpu_worker_count;
+    }
+    get logs() {
+        return this._settings.logs;
+    }
+    get logs_include() {
+        return this._settings.logs_include;
+    }
+    get logs_exclude() {
+        return this._settings.logs_exclude;
+    }
+    get wallets() {
+        return this._settings.wallets;
+    }
+    get scan_settings_path() {
+        return this._scan_settings_path;
+    }
+    get pathPrefix() {
+        return this._pathPrefix;
+    }
+    async setNodeUrl(node_url) {
+        await this.reload();
+        this._settings.node_url = node_url;
+        await this._persist();
+    }
+    async setStartHeight(start_height) {
+        await this.reload();
+        this._settings.start_height = start_height;
+        await this._persist();
+    }
+    async setMerchantConfirmations(merchant_confirmations) {
+        await this.reload();
+        this._settings.merchant_confirmations = merchant_confirmations;
+        if (merchant_confirmations === null)
+            delete this._settings.merchant_confirmations;
+        await this._persist();
+    }
+    async setCpuWorkerCount(cpu_worker_count) {
+        await this.reload();
+        if (cpu_worker_count === null) {
+            delete this._settings.cpu_worker_count;
+        }
+        else {
+            this._settings.cpu_worker_count = cpu_worker_count;
+        }
+        await this._persist();
+    }
+    async setLogSettings(logs, logs_include, logs_exclude) {
+        await this.reload();
+        if (logs === null) {
+            delete this._settings.logs;
+        }
+        else {
+            this._settings.logs = logs;
+        }
+        if (logs_include === null) {
+            delete this._settings.logs_include;
+        }
+        else {
+            this._settings.logs_include = logs_include;
+        }
+        if (logs_exclude === null) {
+            delete this._settings.logs_exclude;
+        }
+        else {
+            this._settings.logs_exclude = logs_exclude;
+        }
+        // validate before persisting
+        ScanSettingsOpened._validateLogOptions(this._settings.logs_include, this._settings.logs_exclude);
+        await this._persist();
+    }
+    /**
+     * get a wallet's settings (without env keys).
+     * returns undefined if not found.
+     */
+    getWallet(primary_address) {
+        return this._settings.wallets.find((w) => w.primary_address === primary_address);
+    }
+    /**
+     * get a wallet's settings merged with env keys.
+     * throws if not found or view key missing.
+     */
+    async getWalletOpened(primary_address) {
+        const wallet = this.getWallet(primary_address);
+        if (!wallet)
+            throw new Error(`wallet not found: ${primary_address} in ${this._scan_settings_path}`);
+        return await walletSettingsPlusKeys({
+            ...wallet,
+            node_url: this._settings.node_url,
+            start_height: this._settings.start_height,
+        });
+    }
+    /**
+     * get all wallets merged with env keys.
+     * wallets missing env keys are skipped.
+     */
+    async getWalletsOpened() {
+        const opened = [];
+        for (const wallet of this._settings.wallets) {
+            try {
+                const withKeys = await walletSettingsPlusKeys({
+                    ...wallet,
+                    node_url: this._settings.node_url,
+                    start_height: this._settings.start_height,
+                });
+                opened.push(withKeys);
+            }
+            catch {
+                // wallet has no view key in env, skip
+            }
+        }
+        return opened;
+    }
+    walletExists(primary_address) {
+        return this._settings.wallets.some((w) => w.primary_address === primary_address);
+    }
+    /**
+     * add a new view wallet to settings and write its view key to env.
+     * if the wallet already exists, updates it instead.
+     */
+    async addViewWallet(primary_address, view_key, fields) {
+        await this.reload();
+        const existing = this.getWallet(primary_address);
+        if (existing) {
+            throw new Error(`wallet already exists: ${primary_address} in ${this._scan_settings_path}`);
+        }
+        primary_address = primary_address.trim();
+        view_key = view_key.trim();
+        // write view key to env first
+        await writeViewKeyToDotEnv(primary_address, view_key);
+        const subaddress_index = fields?.subaddress_index ?? SUB_ADDRESS_INDEX_DEFAULT_VALUE;
+        this._settings.wallets.push({
+            primary_address,
+            ...fields,
+            subaddress_index,
+        });
+        await this._persist();
+    }
+    /**
+     * add a new view wallet to settings and write its view key to env.
+     * if the wallet already exists, updates it instead.
+     */
+    async addSpendWallet(wallet_secret, fields) {
+        //   first part of writeWalletSecretsToDotEnv()
+        const spend_key = await makeSpendKeyFromSeed(wallet_secret.toHex());
+        const view_pair = await makeViewKey(spend_key);
+        const primary_address = view_pair.mainnet_primary;
+        await this.reload();
+        const existing = this.getWallet(primary_address);
+        if (existing) {
+            throw new Error(`wallet already exists: ${primary_address} in ${this._scan_settings_path}`);
+        }
+        // second part of   writeWalletSecretsToDotEnv(),
+        await writeEnvLineToDotEnvRefresh(`vk${primary_address}`, view_pair.view_key);
+        await writeEnvLineToDotEnvRefresh(`sk${primary_address}`, spend_key);
+        const subaddress_index = fields?.subaddress_index ?? SUB_ADDRESS_INDEX_DEFAULT_VALUE;
+        this._settings.wallets.push({
+            primary_address,
+            ...fields,
+            subaddress_index,
+        });
+        await this._persist();
+    }
+    /**
+     * remove a wallet from settings by primary address.
+     * does not remove the view key from env.
+     */
+    async removeWallet(primary_address) {
+        await this.reload();
+        this._settings.wallets = this._settings.wallets.filter((w) => w.primary_address !== primary_address);
+        await this._persist();
+    }
+    /**
+     * update specific fields on an existing wallet.
+     * set a field to null to unset it.
+     */
+    async updateWallet(primary_address, fields) {
+        await this.reload();
+        const wallet = this.getWallet(primary_address);
+        if (!wallet)
+            throw new Error(`wallet not found: ${primary_address} in ${this._scan_settings_path}`);
+        wallet.wallet_name = fields.wallet_name ?? wallet.wallet_name;
+        wallet.wallet_slot = fields.wallet_slot ?? wallet.wallet_slot;
+        wallet.wallet_route = fields.wallet_route ?? wallet.wallet_route;
+        wallet.subaddress_index =
+            fields.subaddress_index ?? wallet.subaddress_index;
+        wallet.halted = fields.halted ?? wallet.halted;
+        if (fields.halted === null)
+            delete wallet.halted;
+        if (fields.subaddress_index === null)
+            delete wallet.subaddress_index;
+        if (fields.wallet_route === null)
+            delete wallet.wallet_route;
+        if (fields.wallet_slot === null)
+            delete wallet.wallet_slot;
+        if (fields.wallet_name === null)
+            delete wallet.wallet_name;
+        await this._persist();
+    }
+    async haltWallet(primary_address) {
+        await this.updateWallet(primary_address, { halted: true });
+    }
+    async unhaltWallet(primary_address) {
+        await this.updateWallet(primary_address, { halted: false });
+    }
+    async setWalletName(primary_address, name) {
+        await this.updateWallet(primary_address, { wallet_name: name ?? null });
+    }
+    async setWalletSlot(primary_address, slot) {
+        await this.updateWallet(primary_address, { wallet_slot: slot ?? null });
+    }
+    async setWalletRoute(primary_address, route) {
+        await this.updateWallet(primary_address, { wallet_route: route ?? null });
+    }
+    async setSubaddressIndex(primary_address, index) {
+        await this.updateWallet(primary_address, {
+            subaddress_index: index ?? null,
+        });
+    }
+    /**
+     * reread the settings file from disk and replace inmemory state.
+     */
+    async reload() {
+        const settings = await openScanSettingsFile(this._scan_settings_path);
+        if (settings) {
+            ScanSettingsOpened._validateLogOptions(settings.logs_include, settings.logs_exclude);
+            this._settings = settings;
+        }
+    }
+    /**
+     * validate that all entries in logs_include and logs_exclude
+     * are valid function names from LOGGING_FUNCTIONS.
+     * throws if any entry is invalid.
+     */
+    static _validateLogOptions(logs_include, logs_exclude) {
+        const valid = new Set(LOGGING_FUNCTIONS);
+        const invalid = [];
+        for (const arr of [logs_include, logs_exclude]) {
+            if (!arr)
+                continue;
+            for (const item of arr) {
+                if (!valid.has(item)) {
+                    invalid.push(item);
+                }
+            }
+        }
+        if (invalid.length > 0) {
+            throw new Error(`invalid log function(s): ${invalid.join(", ")}. ` +
+                `valid options are: ${[...valid].join(", ")}`);
+        }
+    }
+    _settings;
+    constructor(settings, _scan_settings_path, _pathPrefix) {
+        this._scan_settings_path = _scan_settings_path;
+        this._pathPrefix = _pathPrefix;
+        this._settings = settings;
+    }
+    /**
+     * write current in memory state to disk.
+     */
+    async _persist() {
+        await writeScanSettings(this._settings, this._scan_settings_path);
+    }
+}

package/dist/viewpair/ViewPair.js

@@ -8,7 +8,7 @@ import { monero_wallet_api_wasm } from "../wasm-processing/wasmFile";
 import { WasmProcessor } from "../wasm-processing/wasmProcessor";
 import { LOCAL_NODE_DEFAULT_URL, } from "../node-interaction/nodeUrl";
 import { get_block_headers_range, get_info, } from "../api";
-import { readWalletFromScanSettings } from "../scanning-syncing/scanSettings";
+import { readWalletFromScanSettings } from "../api";
 import { sleep } from "../io/sleep";
 /**
  * This class is useful to interact with Moneros DaemonRpc binary requests in a convenient way.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spirobel/monero-wallet-api",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "main": "dist/api.js",
   "module": "dist/api.js",
   "devDependencies": {