@spirobel/monero-wallet-api 0.3.15 → 0.3.18

package/dist/io/atomicWrite.js

@@ -5,6 +5,11 @@ export async function atomicWrite(targetPath, data) {
     const { rename } = await import("node:fs/promises");
     const tempPath = targetPath + ".tmp";
     const bytesWritten = await Bun.write(tempPath, data);
-    await rename(tempPath, targetPath);
+    try {
+        await rename(tempPath, targetPath);
+    }
+    catch (e) {
+        //eat rename failed
+    }
     return bytesWritten;
 }

package/dist/scanning-syncing/scanSettings.d.ts

@@ -34,11 +34,13 @@ export type ScanSettings = {
     wallets: ScanSetting[];
     node_url: string;
     start_height: number | null;
+    merchant_confirmations?: number | null;
 };
 export type ScanSettingsOpened = {
     wallets: (ScanSettingOpened | undefined)[];
     node_url: string;
     start_height: number | null;
+    merchant_confirmations?: number | null;
 };
 /**
  * Writes scan settings to the default or specified storage file in json.
@@ -71,6 +73,38 @@ export declare function writeDaemonHeightAsStartHeightToScanSettings(node_url: s
 export declare function cullTooLargeScanHeight(node_url: string, settingsStorePath?: string): Promise<number>;
 export declare function writeNodeUrlToScanSettings(node_url: string, settingsStorePath?: string): Promise<number>;
 export declare function readNodeUrlFromScanSettings(settingsStorePath?: string): Promise<string | undefined>;
+/**
+ * Writes the merchant confirmation threshold to scan settings.
+ *
+ * This setting only has effect when the wallet is run as part of a checkout system,
+ * that accepts payments.
+ * It determines after how many confirmations a transaction is accepted
+ * for a payment. The actual enforcement of this policy is left to the
+ * custom payment-system code that consumes this library.
+ *
+ * @param merchant_confirmations - Number of confirmations required before
+ *   accepting a payment, or `null` to leave it unset.
+ * @param settingsStorePath - Optional path for the settings file.
+ *   Defaults to `SCAN_SETTINGS_STORE_NAME_DEFAULT`.
+ * @returns A promise that resolves when the file is successfully written.
+ */
+export declare function writeMerchantConfirmationsToScanSettings(merchant_confirmations: number | null, settingsStorePath?: string): Promise<number>;
+/**
+ * Reads the merchant confirmation threshold from scan settings.
+ *
+ * This setting only has effect when the wallet is run as part of a checkout system,
+ * that accepts payments.
+ *
+ * It determines after how many confirmations a transaction is accepted
+ * for a payment. The actual enforcement of this policy is left to the
+ * custom payment-system code that consumes this library.
+ *
+ * @param settingsStorePath - Optional path for the settings file.
+ *   Defaults to `SCAN_SETTINGS_STORE_NAME_DEFAULT`.
+ * @returns The configured number of confirmations, null, or `undefined`
+ *   if the setting has not been persisted yet.
+ */
+export declare function readMerchantConfirmationsFromScanSettings(settingsStorePath?: string): Promise<number | null | undefined>;
 /**
  * Reads scan settings from the default or specified storage file.
  * secret_view_key and spend_private_key are read from environment variables

package/dist/scanning-syncing/scanSettings.js

@@ -87,6 +87,49 @@ export async function readNodeUrlFromScanSettings(settingsStorePath = SCAN_SETTI
     const scanSettings = await openScanSettingsFile(settingsStorePath);
     return scanSettings?.node_url;
 }
+/**
+ * Writes the merchant confirmation threshold to scan settings.
+ *
+ * This setting only has effect when the wallet is run as part of a checkout system,
+ * that accepts payments.
+ * It determines after how many confirmations a transaction is accepted
+ * for a payment. The actual enforcement of this policy is left to the
+ * custom payment-system code that consumes this library.
+ *
+ * @param merchant_confirmations - Number of confirmations required before
+ *   accepting a payment, or `null` to leave it unset.
+ * @param settingsStorePath - Optional path for the settings file.
+ *   Defaults to `SCAN_SETTINGS_STORE_NAME_DEFAULT`.
+ * @returns A promise that resolves when the file is successfully written.
+ */
+export async function writeMerchantConfirmationsToScanSettings(merchant_confirmations, settingsStorePath = SCAN_SETTINGS_STORE_NAME_DEFAULT) {
+    const scanSettings = (await openScanSettingsFile(settingsStorePath)) || {
+        node_url: LOCAL_NODE_DEFAULT_URL,
+        wallets: [],
+        start_height: null,
+    };
+    scanSettings.merchant_confirmations = merchant_confirmations;
+    return await atomicWrite(settingsStorePath, JSON.stringify(scanSettings, null, 2));
+}
+/**
+ * Reads the merchant confirmation threshold from scan settings.
+ *
+ * This setting only has effect when the wallet is run as part of a checkout system,
+ * that accepts payments.
+ *
+ * It determines after how many confirmations a transaction is accepted
+ * for a payment. The actual enforcement of this policy is left to the
+ * custom payment-system code that consumes this library.
+ *
+ * @param settingsStorePath - Optional path for the settings file.
+ *   Defaults to `SCAN_SETTINGS_STORE_NAME_DEFAULT`.
+ * @returns The configured number of confirmations, null, or `undefined`
+ *   if the setting has not been persisted yet.
+ */
+export async function readMerchantConfirmationsFromScanSettings(settingsStorePath = SCAN_SETTINGS_STORE_NAME_DEFAULT) {
+    const scanSettings = await openScanSettingsFile(settingsStorePath);
+    return scanSettings?.merchant_confirmations;
+}
 /**
  * Reads scan settings from the default or specified storage file.
  * secret_view_key and spend_private_key are read from environment variables