react-native-nitro-ark 0.0.58 → 0.0.60

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

@@ -23,6 +23,8 @@ namespace margelo::nitro::nitroark { struct OffchainBalanceResult; }
 namespace margelo::nitro::nitroark { struct KeyPairResult; }
 // Forward declaration of `NewAddressResult` to properly resolve imports.
 namespace margelo::nitro::nitroark { struct NewAddressResult; }
+// Forward declaration of `BarkMovement` to properly resolve imports.
+namespace margelo::nitro::nitroark { struct BarkMovement; }
 // Forward declaration of `BarkVtxo` to properly resolve imports.
 namespace margelo::nitro::nitroark { struct BarkVtxo; }
 // Forward declaration of `OnchainBalanceResult` to properly resolve imports.
@@ -33,8 +35,10 @@ namespace margelo::nitro::nitroark { struct OnchainPaymentResult; }
 namespace margelo::nitro::nitroark { struct BarkSendManyOutput; }
 // Forward declaration of `ArkoorPaymentResult` to properly resolve imports.
 namespace margelo::nitro::nitroark { struct ArkoorPaymentResult; }
-// Forward declaration of `LightningPaymentResult` to properly resolve imports.
-namespace margelo::nitro::nitroark { struct LightningPaymentResult; }
+// Forward declaration of `Bolt11PaymentResult` to properly resolve imports.
+namespace margelo::nitro::nitroark { struct Bolt11PaymentResult; }
+// Forward declaration of `Bolt12PaymentResult` to properly resolve imports.
+namespace margelo::nitro::nitroark { struct Bolt12PaymentResult; }
 // Forward declaration of `LnurlPaymentResult` to properly resolve imports.
 namespace margelo::nitro::nitroark { struct LnurlPaymentResult; }
 // Forward declaration of `LightningReceive` to properly resolve imports.
@@ -47,14 +51,16 @@ namespace margelo::nitro::nitroark { struct LightningReceive; }
 #include "OffchainBalanceResult.hpp"
 #include "KeyPairResult.hpp"
 #include "NewAddressResult.hpp"
-#include "BarkVtxo.hpp"
+#include "BarkMovement.hpp"
 #include <vector>
+#include "BarkVtxo.hpp"
+#include <optional>
 #include "OnchainBalanceResult.hpp"
 #include "OnchainPaymentResult.hpp"
-#include <optional>
 #include "BarkSendManyOutput.hpp"
 #include "ArkoorPaymentResult.hpp"
-#include "LightningPaymentResult.hpp"
+#include "Bolt11PaymentResult.hpp"
+#include "Bolt12PaymentResult.hpp"
 #include "LnurlPaymentResult.hpp"
 #include "LightningReceive.hpp"
 
@@ -94,7 +100,9 @@ namespace margelo::nitro::nitroark {
       virtual std::shared_ptr<Promise<void>> loadWallet(const std::string& datadir, const BarkCreateOpts& config) = 0;
       virtual std::shared_ptr<Promise<bool>> isWalletLoaded() = 0;
       virtual std::shared_ptr<Promise<void>> closeWallet() = 0;
+      virtual std::shared_ptr<Promise<void>> registerAllConfirmedBoards() = 0;
       virtual std::shared_ptr<Promise<void>> maintenance() = 0;
+      virtual std::shared_ptr<Promise<void>> maintenanceWithOnchain() = 0;
       virtual std::shared_ptr<Promise<void>> maintenanceRefresh() = 0;
       virtual std::shared_ptr<Promise<void>> sync() = 0;
       virtual std::shared_ptr<Promise<void>> syncExits() = 0;
@@ -108,7 +116,10 @@ namespace margelo::nitro::nitroark {
       virtual std::shared_ptr<Promise<std::string>> signMesssageWithMnemonic(const std::string& message, const std::string& mnemonic, const std::string& network, double index) = 0;
       virtual std::shared_ptr<Promise<KeyPairResult>> deriveKeypairFromMnemonic(const std::string& mnemonic, const std::string& network, double index) = 0;
       virtual std::shared_ptr<Promise<bool>> verifyMessage(const std::string& message, const std::string& signature, const std::string& publicKey) = 0;
-      virtual std::shared_ptr<Promise<std::vector<BarkVtxo>>> getVtxos() = 0;
+      virtual std::shared_ptr<Promise<std::vector<BarkMovement>>> movements(double pageIndex, double pageSize) = 0;
+      virtual std::shared_ptr<Promise<std::vector<BarkVtxo>>> vtxos() = 0;
+      virtual std::shared_ptr<Promise<std::optional<double>>> getFirstExpiringVtxoBlockheight() = 0;
+      virtual std::shared_ptr<Promise<std::optional<double>>> getNextRequiredRefreshBlockheight() = 0;
       virtual std::shared_ptr<Promise<std::vector<BarkVtxo>>> getExpiringVtxos(double threshold) = 0;
       virtual std::shared_ptr<Promise<OnchainBalanceResult>> onchainBalance() = 0;
       virtual std::shared_ptr<Promise<void>> onchainSync() = 0;
@@ -122,11 +133,13 @@ namespace margelo::nitro::nitroark {
       virtual std::shared_ptr<Promise<std::string>> boardAll() = 0;
       virtual std::shared_ptr<Promise<void>> validateArkoorAddress(const std::string& address) = 0;
       virtual std::shared_ptr<Promise<ArkoorPaymentResult>> sendArkoorPayment(const std::string& destination, double amountSat) = 0;
-      virtual std::shared_ptr<Promise<LightningPaymentResult>> sendLightningPayment(const std::string& destination, std::optional<double> amountSat) = 0;
+      virtual std::shared_ptr<Promise<Bolt11PaymentResult>> sendLightningPayment(const std::string& destination, std::optional<double> amountSat) = 0;
+      virtual std::shared_ptr<Promise<Bolt12PaymentResult>> payOffer(const std::string& offer, std::optional<double> amountSat) = 0;
       virtual std::shared_ptr<Promise<LnurlPaymentResult>> sendLnaddr(const std::string& addr, double amountSat, const std::string& comment) = 0;
       virtual std::shared_ptr<Promise<std::string>> sendRoundOnchainPayment(const std::string& destination, double amountSat) = 0;
       virtual std::shared_ptr<Promise<std::string>> bolt11Invoice(double amountMsat) = 0;
-      virtual std::shared_ptr<Promise<std::optional<LightningReceive>>> lightningReceiveStatus(const std::string& payment) = 0;
+      virtual std::shared_ptr<Promise<std::optional<LightningReceive>>> lightningReceiveStatus(const std::string& paymentHash) = 0;
+      virtual std::shared_ptr<Promise<std::vector<LightningReceive>>> lightningReceives(double pageSize, double pageIndex) = 0;
       virtual std::shared_ptr<Promise<void>> finishLightningReceive(const std::string& bolt11) = 0;
       virtual std::shared_ptr<Promise<std::string>> offboardSpecific(const std::vector<std::string>& vtxoIds, const std::string& destinationAddress) = 0;
       virtual std::shared_ptr<Promise<std::string>> offboardAll(const std::string& destinationAddress) = 0;

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

@@ -30,9 +30,10 @@ namespace margelo::nitro::nitroark {
    */
   enum class PaymentTypes {
     BOLT11      SWIFT_NAME(bolt11) = 0,
-    LNURL      SWIFT_NAME(lnurl) = 1,
-    ARKOOR      SWIFT_NAME(arkoor) = 2,
-    ONCHAIN      SWIFT_NAME(onchain) = 3,
+    BOLT12      SWIFT_NAME(bolt12) = 1,
+    LNURL      SWIFT_NAME(lnurl) = 2,
+    ARKOOR      SWIFT_NAME(arkoor) = 3,
+    ONCHAIN      SWIFT_NAME(onchain) = 4,
   } CLOSED_ENUM;
 
 } // namespace margelo::nitro::nitroark
@@ -46,6 +47,7 @@ namespace margelo::nitro {
       std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
       switch (hashString(unionValue.c_str(), unionValue.size())) {
         case hashString("Bolt11"): return margelo::nitro::nitroark::PaymentTypes::BOLT11;
+        case hashString("Bolt12"): return margelo::nitro::nitroark::PaymentTypes::BOLT12;
         case hashString("Lnurl"): return margelo::nitro::nitroark::PaymentTypes::LNURL;
         case hashString("Arkoor"): return margelo::nitro::nitroark::PaymentTypes::ARKOOR;
         case hashString("Onchain"): return margelo::nitro::nitroark::PaymentTypes::ONCHAIN;
@@ -56,6 +58,7 @@ namespace margelo::nitro {
     static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitroark::PaymentTypes arg) {
       switch (arg) {
         case margelo::nitro::nitroark::PaymentTypes::BOLT11: return JSIConverter<std::string>::toJSI(runtime, "Bolt11");
+        case margelo::nitro::nitroark::PaymentTypes::BOLT12: return JSIConverter<std::string>::toJSI(runtime, "Bolt12");
         case margelo::nitro::nitroark::PaymentTypes::LNURL: return JSIConverter<std::string>::toJSI(runtime, "Lnurl");
         case margelo::nitro::nitroark::PaymentTypes::ARKOOR: return JSIConverter<std::string>::toJSI(runtime, "Arkoor");
         case margelo::nitro::nitroark::PaymentTypes::ONCHAIN: return JSIConverter<std::string>::toJSI(runtime, "Onchain");
@@ -71,6 +74,7 @@ namespace margelo::nitro {
       std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
       switch (hashString(unionValue.c_str(), unionValue.size())) {
         case hashString("Bolt11"):
+        case hashString("Bolt12"):
         case hashString("Lnurl"):
         case hashString("Arkoor"):
         case hashString("Onchain"):

package/package.json

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

package/src/NitroArk.nitro.ts

@@ -40,16 +40,17 @@ export interface BarkSendManyOutput {
   amountSat: number; // uint64_t -> number
 }
 
-export interface BarkVtxo {
+interface BarkVtxo {
   amount: number; // u64
   expiry_height: number; // u32
   server_pubkey: string;
   exit_delta: number; // u16
   anchor_point: string;
   point: string;
+  state: string;
 }
 
-export type PaymentTypes = 'Bolt11' | 'Lnurl' | 'Arkoor' | 'Onchain';
+export type PaymentTypes = 'Bolt11' | 'Bolt12' | 'Lnurl' | 'Arkoor' | 'Onchain';
 
 export interface ArkoorPaymentResult {
   amount_sat: number; // u64
@@ -58,12 +59,18 @@ export interface ArkoorPaymentResult {
   payment_type: PaymentTypes; // 'Arkoor'
 }
 
-export interface LightningPaymentResult {
+export interface Bolt11PaymentResult {
   bolt11_invoice: string;
   preimage: string;
   payment_type: PaymentTypes; // 'Lightning'
 }
 
+export interface Bolt12PaymentResult {
+  bolt12_offer: string;
+  preimage: string;
+  payment_type: PaymentTypes; // 'Bolt12'
+}
+
 export interface LnurlPaymentResult {
   lnurl: string;
   bolt11_invoice: string;
@@ -114,6 +121,21 @@ export interface LightningReceive {
   preimage_revealed_at?: number;
 }
 
+export interface BarkMovementRecipient {
+  recipient: string;
+  amount_sat: number;
+}
+
+export interface BarkMovement {
+  id: number;
+  kind: string;
+  fees: number;
+  spends: BarkVtxo[];
+  receives: BarkVtxo[];
+  recipients: BarkMovementRecipient[];
+  created_at: string;
+}
+
 // --- Nitro Module Interface ---
 
 export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
@@ -123,7 +145,9 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   loadWallet(datadir: string, config: BarkCreateOpts): Promise<void>;
   isWalletLoaded(): Promise<boolean>;
   closeWallet(): Promise<void>;
+  registerAllConfirmedBoards(): Promise<void>;
   maintenance(): Promise<void>;
+  maintenanceWithOnchain(): Promise<void>;
   maintenanceRefresh(): Promise<void>;
   sync(): Promise<void>;
   syncExits(): Promise<void>;
@@ -152,7 +176,10 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
     signature: string,
     publicKey: string
   ): Promise<boolean>;
-  getVtxos(): Promise<BarkVtxo[]>;
+  movements(pageIndex: number, pageSize: number): Promise<BarkMovement[]>;
+  vtxos(): Promise<BarkVtxo[]>;
+  getFirstExpiringVtxoBlockheight(): Promise<number | undefined>;
+  getNextRequiredRefreshBlockheight(): Promise<number | undefined>;
   getExpiringVtxos(threshold: number): Promise<BarkVtxo[]>;
 
   // --- Onchain Operations ---
@@ -189,7 +216,8 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   sendLightningPayment(
     destination: string,
     amountSat?: number
-  ): Promise<LightningPaymentResult>;
+  ): Promise<Bolt11PaymentResult>;
+  payOffer(offer: string, amountSat?: number): Promise<Bolt12PaymentResult>;
   sendLnaddr(
     addr: string,
     amountSat: number,
@@ -203,8 +231,12 @@ export interface NitroArk extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   // --- Lightning Invoicing ---
   bolt11Invoice(amountMsat: number): Promise<string>; // Returns invoice string
   lightningReceiveStatus(
-    payment: string
+    paymentHash: string
   ): Promise<LightningReceive | undefined>;
+  lightningReceives(
+    pageSize: number,
+    pageIndex: number
+  ): Promise<LightningReceive[]>;
   finishLightningReceive(bolt11: string): Promise<void>; // Throws on error
 
   // --- Offboarding / Exiting ---

package/src/index.tsx

@@ -5,17 +5,34 @@ import type {
   BarkArkInfo,
   BarkSendManyOutput,
   ArkoorPaymentResult,
-  LightningPaymentResult,
+  Bolt11PaymentResult,
+  Bolt12PaymentResult,
   LnurlPaymentResult,
   OnchainPaymentResult,
-  BarkVtxo,
   OffchainBalanceResult,
   OnchainBalanceResult,
   NewAddressResult,
   KeyPairResult,
   LightningReceive,
+  BarkMovement,
 } from './NitroArk.nitro';
 
+export type BarkVtxo = {
+  amount: number; // u64
+  expiry_height: number; // u32
+  server_pubkey: string;
+  exit_delta: number; // u16
+  anchor_point: string;
+  point: string;
+  state:
+    | 'Spendable'
+    | 'Spent'
+    | 'UnregisteredBoard'
+    | 'PendingLightningSend'
+    | 'PendingLightningRecv'
+    | 'Unknown';
+};
+
 // Create the hybrid object instance
 export const NitroArkHybridObject =
   NitroModules.createHybridObject<NitroArk>('NitroArk');
@@ -74,13 +91,31 @@ export function isWalletLoaded(): Promise<boolean> {
 }
 
 /**
- * Runs wallet maintenance tasks.
+ * Registers all confirmed boards.
+ * @returns A promise that resolves on success.
+ */
+export function registerAllConfirmedBoards(): Promise<void> {
+  return NitroArkHybridObject.registerAllConfirmedBoards();
+}
+
+/**
+ * Runs wallet maintenance tasks for offchain.
+ * This includes refreshing vtxos that need to be refreshed.
  * @returns A promise that resolves on success.
  */
 export function maintenance(): Promise<void> {
   return NitroArkHybridObject.maintenance();
 }
 
+/**
+ * Runs wallet maintenance tasks for both offchain and onchain.
+ * This includes refreshing vtxos that need to be refreshed.
+ * @returns A promise that resolves on success.
+ */
+export function maintenanceWithOnchain(): Promise<void> {
+  return NitroArkHybridObject.maintenanceWithOnchain();
+}
+
 /**
  * Refreshes vtxos that need to be refreshed.
  * @returns A promise that resolves on success.
@@ -223,13 +258,44 @@ export function verifyMessage(
   return NitroArkHybridObject.verifyMessage(message, signature, publicKey);
 }
 
+/**
+ * Gets a paginated list of wallet movements (balance changes).
+ * @param pageIndex The index of the page to retrieve (0-based).
+ * @param pageSize The number of movements per page.
+ * @returns A promise resolving to an array of BarkMovement objects.
+ */
+export function movements(
+  pageIndex: number,
+  pageSize: number
+): Promise<BarkMovement[]> {
+  return NitroArkHybridObject.movements(pageIndex, pageSize);
+}
+
 /**
  * Gets the list of VTXOs as a JSON string for the loaded wallet.
  * @param no_sync If true, skips synchronization with the blockchain. Defaults to false.
  * @returns A promise resolving BarkVtxo[] array.
  */
-export function getVtxos(): Promise<BarkVtxo[]> {
-  return NitroArkHybridObject.getVtxos();
+export function vtxos(): Promise<BarkVtxo[]> {
+  return NitroArkHybridObject.vtxos() as Promise<BarkVtxo[]>;
+}
+
+/**
+ * Gets the first expiring VTXO blockheight for the loaded wallet.
+ * @returns A promise resolving to the first expiring VTXO blockheight.
+ */
+export function getFirstExpiringVtxoBlockheight(): Promise<number | undefined> {
+  return NitroArkHybridObject.getFirstExpiringVtxoBlockheight();
+}
+
+/**
+ * Gets the next required refresh blockheight for the loaded wallet for the first expiring VTXO.
+ * @returns A promise resolving to the next required refresh blockheight.
+ */
+export function getNextRequiredRefreshBlockheight(): Promise<
+  number | undefined
+> {
+  return NitroArkHybridObject.getNextRequiredRefreshBlockheight();
 }
 
 /**
@@ -239,7 +305,9 @@ export function getVtxos(): Promise<BarkVtxo[]> {
  */
 
 export function getExpiringVtxos(threshold: number): Promise<BarkVtxo[]> {
-  return NitroArkHybridObject.getExpiringVtxos(threshold);
+  return NitroArkHybridObject.getExpiringVtxos(threshold) as Promise<
+    BarkVtxo[]
+  >;
 }
 
 // --- Onchain Operations ---
@@ -330,14 +398,26 @@ export function bolt11Invoice(amountMsat: number): Promise<string> {
 
 /**
  * Gets the status of a Lightning receive.
- * @param payment The payment hash of the Lightning receive.
+ * @param paymentHash The payment hash of the Lightning receive.
  * @returns A promise resolving to the Lightning receive status.
  */
-
 export function lightningReceiveStatus(
-  payment: string
+  paymentHash: string
 ): Promise<LightningReceive | undefined> {
-  return NitroArkHybridObject.lightningReceiveStatus(payment);
+  return NitroArkHybridObject.lightningReceiveStatus(paymentHash);
+}
+
+/**
+ * Gets a page of Lightning receives.
+ * @param pageSize The number of items to retrieve.
+ * @param pageIndex The index of the page to retrieve.
+ * @returns A promise resolving to an array of Lightning receives.
+ */
+export function lightningReceives(
+  pageSize: number,
+  pageIndex: number
+): Promise<LightningReceive[]> {
+  return NitroArkHybridObject.lightningReceives(pageSize, pageIndex);
 }
 
 /**
@@ -353,15 +433,28 @@ export function finishLightningReceive(bolt11: string): Promise<void> {
  * Sends a Lightning payment.
  * @param destination The Lightning invoice.
  * @param amountSat The amount in satoshis to send. Use 0 for invoice amount.
- * @returns A promise resolving to a LightningPaymentResult object
+ * @returns A promise resolving to a Bolt11PaymentResult object
  */
 export function sendLightningPayment(
   destination: string,
   amountSat?: number
-): Promise<LightningPaymentResult> {
+): Promise<Bolt11PaymentResult> {
   return NitroArkHybridObject.sendLightningPayment(destination, amountSat);
 }
 
+/**
+ * Sends a payment to a Bolt12 offer.
+ * @param offer The Bolt12 offer.
+ * @param amountSat The amount in satoshis to send. Use 0 for invoice amount.
+ * @returns A promise resolving to a Bolt12PaymentResult object
+ */
+export function payOffer(
+  offer: string,
+  amountSat?: number
+): Promise<Bolt12PaymentResult> {
+  return NitroArkHybridObject.payOffer(offer, amountSat);
+}
+
 /**
  * Sends a payment to a Lightning Address.
  * @param addr The Lightning Address.
@@ -465,7 +558,7 @@ export type {
   BarkArkInfo,
   BarkSendManyOutput,
   ArkoorPaymentResult,
-  LightningPaymentResult,
+  Bolt11PaymentResult,
   LnurlPaymentResult,
   OnchainPaymentResult,
   PaymentTypes,
@@ -474,4 +567,6 @@ export type {
   NewAddressResult,
   KeyPairResult,
   LightningReceive,
+  BarkMovement,
+  BarkMovementRecipient,
 } from './NitroArk.nitro';