react-native-nitro-ark 0.0.128 → 0.0.130

package/nitrogen/generated/shared/c++/WalletSnapshotInfo.hpp

@@ -0,0 +1,112 @@
+///
+/// WalletSnapshotInfo.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::nitroark {
+
+  /**
+   * A struct which can be represented as a JavaScript object (WalletSnapshotInfo).
+   */
+  struct WalletSnapshotInfo final {
+  public:
+    std::string path     SWIFT_PRIVATE;
+    double sizeBytes     SWIFT_PRIVATE;
+    std::string sha256     SWIFT_PRIVATE;
+    std::string network     SWIFT_PRIVATE;
+    std::string walletFingerprint     SWIFT_PRIVATE;
+    std::optional<std::string> serverPubkey     SWIFT_PRIVATE;
+    std::optional<std::string> mailboxPubkey     SWIFT_PRIVATE;
+    double schemaVersion     SWIFT_PRIVATE;
+
+  public:
+    WalletSnapshotInfo() = default;
+    explicit WalletSnapshotInfo(std::string path, double sizeBytes, std::string sha256, std::string network, std::string walletFingerprint, std::optional<std::string> serverPubkey, std::optional<std::string> mailboxPubkey, double schemaVersion): path(path), sizeBytes(sizeBytes), sha256(sha256), network(network), walletFingerprint(walletFingerprint), serverPubkey(serverPubkey), mailboxPubkey(mailboxPubkey), schemaVersion(schemaVersion) {}
+
+  public:
+    friend bool operator==(const WalletSnapshotInfo& lhs, const WalletSnapshotInfo& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroark
+
+namespace margelo::nitro {
+
+  // C++ WalletSnapshotInfo <> JS WalletSnapshotInfo (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroark::WalletSnapshotInfo> final {
+    static inline margelo::nitro::nitroark::WalletSnapshotInfo fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroark::WalletSnapshotInfo(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "path"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sizeBytes"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sha256"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "network"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "walletFingerprint"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "serverPubkey"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "mailboxPubkey"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "schemaVersion")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroark::WalletSnapshotInfo& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "path"), JSIConverter<std::string>::toJSI(runtime, arg.path));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "sizeBytes"), JSIConverter<double>::toJSI(runtime, arg.sizeBytes));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "sha256"), JSIConverter<std::string>::toJSI(runtime, arg.sha256));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "network"), JSIConverter<std::string>::toJSI(runtime, arg.network));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "walletFingerprint"), JSIConverter<std::string>::toJSI(runtime, arg.walletFingerprint));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "serverPubkey"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.serverPubkey));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "mailboxPubkey"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.mailboxPubkey));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "schemaVersion"), JSIConverter<double>::toJSI(runtime, arg.schemaVersion));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "path")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sizeBytes")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sha256")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "network")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "walletFingerprint")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "serverPubkey")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "mailboxPubkey")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "schemaVersion")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/WalletStateChangeEvent.hpp

@@ -0,0 +1,87 @@
+///
+/// WalletStateChangeEvent.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::nitroark {
+
+  /**
+   * A struct which can be represented as a JavaScript object (WalletStateChangeEvent).
+   */
+  struct WalletStateChangeEvent final {
+  public:
+    double sequence     SWIFT_PRIVATE;
+    std::string reason     SWIFT_PRIVATE;
+
+  public:
+    WalletStateChangeEvent() = default;
+    explicit WalletStateChangeEvent(double sequence, std::string reason): sequence(sequence), reason(reason) {}
+
+  public:
+    friend bool operator==(const WalletStateChangeEvent& lhs, const WalletStateChangeEvent& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroark
+
+namespace margelo::nitro {
+
+  // C++ WalletStateChangeEvent <> JS WalletStateChangeEvent (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroark::WalletStateChangeEvent> final {
+    static inline margelo::nitro::nitroark::WalletStateChangeEvent fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroark::WalletStateChangeEvent(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sequence"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "reason")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroark::WalletStateChangeEvent& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "sequence"), JSIConverter<double>::toJSI(runtime, arg.sequence));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "reason"), JSIConverter<std::string>::toJSI(runtime, arg.reason));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "sequence")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "reason")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-ark",
-  "version": "0.0.128",
+  "version": "0.0.130",
   "description": "Pure C++ Nitro Modules for Ark client",
   "source": "./src/index.tsx",
   "main": "./lib/module/index.js",

package/src/NitroArk.nitro.ts

@@ -273,6 +273,10 @@ export interface PendingRoundStatus {
   is_success: boolean;
 }
 
+export interface DelegatedRoundState {
+  round_id: number; // u32
+}
+
 export interface BarkNotificationEvent {
   kind: string; // 'movementCreated' | 'movementUpdated' | 'channelLagging'
   movement?: BarkMovement;
@@ -284,6 +288,34 @@ export interface BarkNotificationSubscription
   isActive(): boolean;
 }
 
+export interface WalletSnapshotInfo {
+  path: string;
+  sizeBytes: number;
+  sha256: string;
+  network: string;
+  walletFingerprint: string;
+  serverPubkey?: string;
+  mailboxPubkey?: string;
+  schemaVersion: number;
+}
+
+export interface WalletSnapshotExpectation {
+  network?: string;
+  walletFingerprint?: string;
+  serverPubkey?: string;
+}
+
+export interface WalletStateChangeEvent {
+  sequence: number;
+  reason: string; // 'initial' | 'databaseChanged' | 'resyncRequired'
+}
+
+export interface WalletStateChangeSubscription
+  extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  stop(): void;
+  isActive(): boolean;
+}
+
 // --- Nitro Module Interface ---
 
 export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
@@ -293,6 +325,14 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   loadWallet(datadir: string, config: BarkCreateOpts): Promise<void>;
   isWalletLoaded(): Promise<boolean>;
   closeWallet(): Promise<void>;
+  createWalletSnapshot(destinationPath: string): Promise<WalletSnapshotInfo>;
+  validateWalletSnapshot(
+    path: string,
+    expected?: WalletSnapshotExpectation
+  ): Promise<WalletSnapshotInfo>;
+  subscribeWalletStateChanges(
+    onEvent: (event: WalletStateChangeEvent) => void
+  ): WalletStateChangeSubscription;
   refreshServer(): Promise<void>;
   syncPendingBoards(): Promise<void>;
   maintenance(): Promise<void>;
@@ -370,6 +410,9 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   decodeVtxoHex(vtxoHex: string): Promise<BarkVtxo>;
   importVtxo(vtxoHex: string): Promise<BarkVtxo>;
   dangerousDropVtxo(vtxoId: string): Promise<void>;
+  refreshVtxosDelegated(
+    vtxoIds: string[]
+  ): Promise<DelegatedRoundState | undefined>;
   getFirstExpiringVtxoBlockheight(): Promise<number | undefined>;
   getNextRequiredRefreshBlockheight(): Promise<number | undefined>;
   getExpiringVtxos(threshold: number): Promise<BarkVtxo[]>;
@@ -409,6 +452,7 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   ): Promise<ArkoorPaymentResult>;
   estimateArkoorPaymentFee(amountSat: number): Promise<BarkFeeEstimate>;
   estimateBoardOffchainFee(amountSat: number): Promise<BarkFeeEstimate>;
+  estimateRefreshFee(vtxoIds: string[]): Promise<BarkFeeEstimate>;
   payLightningInvoice(
     destination: string,
     wait: boolean,

package/src/index.tsx

@@ -32,6 +32,11 @@ import type {
   BarkMovementDestination as NitroBarkMovementDestination,
   BoardResult,
   PendingRoundStatus as NitroPendingRoundStatus,
+  DelegatedRoundState,
+  WalletSnapshotInfo,
+  WalletSnapshotExpectation,
+  WalletStateChangeEvent as NitroWalletStateChangeEvent,
+  WalletStateChangeSubscription,
 } from './NitroArk.nitro';
 
 export type VtxoState = 'Spendable' | 'Spent' | 'Locked' | 'Exited' | 'unknown';
@@ -129,6 +134,24 @@ export type BarkNotificationEvent = Omit<
   movement?: BarkMovement;
 };
 
+export type WalletStateChangeReason =
+  | 'initial'
+  | 'databaseChanged'
+  | 'resyncRequired';
+
+export type WalletStateChangeEvent = Omit<
+  NitroWalletStateChangeEvent,
+  'reason'
+> & {
+  reason: WalletStateChangeReason;
+};
+
+export type {
+  WalletSnapshotInfo,
+  WalletSnapshotExpectation,
+  WalletStateChangeSubscription,
+};
+
 export type LightningPaymentState =
   | 'unknown'
   | 'in_progress'
@@ -215,6 +238,39 @@ export function closeWallet(): Promise<void> {
   return NitroArkHybridObject.closeWallet();
 }
 
+/**
+ * Creates a transactionally consistent SQLite snapshot of the loaded wallet.
+ * The destination must not already exist.
+ */
+export function createWalletSnapshot(
+  destinationPath: string
+): Promise<WalletSnapshotInfo> {
+  return NitroArkHybridObject.createWalletSnapshot(destinationPath);
+}
+
+/**
+ * Validates a wallet snapshot without modifying it. When expected identity
+ * fields are omitted, the loaded wallet identity is used when available.
+ */
+export function validateWalletSnapshot(
+  path: string,
+  expected?: WalletSnapshotExpectation
+): Promise<WalletSnapshotInfo> {
+  return NitroArkHybridObject.validateWalletSnapshot(path, expected);
+}
+
+/**
+ * Observes committed native SQLite changes. Sequence values are local to this
+ * subscription and reset when a new subscription is created.
+ */
+export function subscribeWalletStateChanges(
+  onEvent: (event: WalletStateChangeEvent) => void
+): WalletStateChangeSubscription {
+  return NitroArkHybridObject.subscribeWalletStateChanges(
+    onEvent as (event: NitroWalletStateChangeEvent) => void
+  );
+}
+
 /**
  * Refreshes the server state.
  * @returns A promise that resolves on success or rejects on error.
@@ -283,6 +339,17 @@ export function maintenanceRefresh(): Promise<void> {
   return NitroArkHybridObject.maintenanceRefresh();
 }
 
+/**
+ * Refreshes the provided VTXOs in delegated mode.
+ * @param vtxoIds Array of VTXO ID strings to refresh.
+ * @returns A pending round state reference, or undefined if no VTXOs needed refresh.
+ */
+export function refreshVtxosDelegated(
+  vtxoIds: string[]
+): Promise<DelegatedRoundState | undefined> {
+  return NitroArkHybridObject.refreshVtxosDelegated(vtxoIds);
+}
+
 /**
  * Synchronizes the wallet with the blockchain.
  * @returns A promise that resolves on success.
@@ -1005,6 +1072,17 @@ export function estimateBoardOffchainFee(
   return NitroArkHybridObject.estimateBoardOffchainFee(amountSat);
 }
 
+/**
+ * Estimates the Ark protocol fee for refreshing the provided VTXOs.
+ * @param vtxoIds Array of VTXO ID strings to refresh.
+ * @returns A promise resolving to the fee estimate.
+ */
+export function estimateRefreshFee(
+  vtxoIds: string[]
+): Promise<BarkFeeEstimate> {
+  return NitroArkHybridObject.estimateRefreshFee(vtxoIds);
+}
+
 /**
  * Sends an onchain payment via an Ark round.
  * @param destination The destination Bitcoin address.
@@ -1074,6 +1152,7 @@ export type {
   BarkArkInfo,
   Bolt11Invoice,
   BoardResult,
+  DelegatedRoundState,
   BarkSendManyOutput,
   ArkoorPaymentResult,
   BarkFeeEstimate,