react-native-monero 0.2.0 → 0.4.0-beta.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## Unreleased
 
+- added: `getWalletStatus` reports a `refreshed` flag, true once the wallet has completed its first server refresh (and so knows its real balance and spendable outputs). LWS wallets report seed heights that look synced before then, so treat a wallet as synced only when `refreshed` is true.
+- fixed: LWS wallets can spend and receive over the Nym mixnet. The lwsf RPC timeout of 5 seconds was too short for a mixnet round-trip, so single-shot spend and receive calls failed; the Nym path now uses a 120-second budget.
+
+## 0.3.0 (2026-07-03)
+
+- added: `getPendingTransactions`, a paged view of the not-yet-mined transactions. `getAllTransactions` sorts pending entries behind all confirmed ones, so a cursor-based scan of confirmed history never reaches them; this exposes the pending set directly.
+- fixed: LWS wallets sync again. The 0.2.0 https change passed `use_ssl=true` to `wallet->init` for https daemons; wallet2 (monerod) ignores that flag, but lwsf honors it and switches from tolerant `ssl_support_autodetect` to `ssl_support_enabled`, whose certificate verification always fails on iOS/Android (no OpenSSL system CA store in the app sandbox). Every LWS connection was silently dropped at the TLS handshake, so LWS wallets polled forever at height 0 with no transactions or balance. Revert to `use_ssl=false` (TLS still autodetected from the `https://` scheme); the Nym scheme fix is unaffected since it derives https from the port inside NymHttpClient.
+- fixed: Monero Full Node (monerod) sends no longer fail with "Failed to load transaction from file". `createTransaction` now retains the signed transaction natively and `broadcastTransaction` commits it directly, instead of saving it to a file and reloading it: on the full-node (wallet2) backend `save_tx` writes an unsigned tx set while `submitTransaction`'s `load_tx` requires a signed one, so the file round-trip always failed. Retained transactions are capped at 50 per wallet (oldest disposed first) and cleared when the wallet closes. Method signatures are unchanged, but the semantics narrow: `signedTxHex` is now an opaque token (the txid) identifying the retained transaction rather than serialized bytes, a signed transaction can no longer be broadcast after its wallet closes or the app restarts (`broadcastTransaction` reports that it must be recreated), and payments the wallet would split into multiple on-chain transactions are rejected at creation so a broadcast is atomic.
+
 ## 0.2.0 (2026-06-29)
 
 - changed: Switch the package manager from yarn to npm (package-lock.json + `.npmrc` legacy-peer-deps), matching the other Edge currency repos.

package/ios/MoneroModule.xcframework/Info.plist

@@ -8,32 +8,32 @@
 			<key>BinaryPath</key>
 			<string>libmonero-module.a</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>libmonero-module.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>libmonero-module.a</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>libmonero-module.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/lib/src/CppBridge.d.ts

@@ -82,9 +82,27 @@ export declare class CppBridge {
      * @returns Paginated transactions with metadata
      */
     getAllTransactions(walletId: string, page: number, pageSize: number, sort?: 'asc' | 'desc'): Promise<TransactionsPage>;
+    /**
+     * Get not-yet-mined transactions with pagination. Same shape as
+     * getAllTransactions, filtered to pending entries. Pending transactions sort
+     * behind all confirmed ones in getAllTransactions, so a cursor-based scan of
+     * confirmed history never reaches them; use this to read the pending set
+     * directly. The set can include entries the backend reports as permanently
+     * failed (isFailed: true); callers decide how to label those.
+     * @param walletId - Unique identifier for the wallet
+     * @param page - Page number (0-indexed)
+     * @param pageSize - Number of transactions per page
+     * @returns Paginated pending transactions with metadata
+     */
+    getPendingTransactions(walletId: string, page: number, pageSize: number): Promise<TransactionsPage>;
     /**
      * Create a transaction (supports multiple recipients).
-     * The transaction is created and signed but not broadcast yet.
+     * The transaction is created and signed but not broadcast yet: it is retained
+     * natively for a later broadcastTransaction call. At most 50 transactions are
+     * retained per wallet (oldest disposed first; broadcasting an evicted one
+     * reports that it must be recreated), and all are released when the wallet
+     * closes. Payments the wallet would split into multiple on-chain
+     * transactions are rejected, so a later broadcast is atomic.
      * @param walletId - Unique identifier for the wallet
      * @param recipients - Array of recipients with addresses and amounts (atomic units)
      * @param priority - Transaction priority (0=Default, 1=Low, 2=Medium, 3=High)
@@ -92,11 +110,13 @@ export declare class CppBridge {
      */
     createTransaction(walletId: string, recipients: Recipient[], priority: TransactionPriority): Promise<SignedTransaction>;
     /**
-     * Broadcast a previously created transaction.
+     * Broadcast a previously created transaction. `signedTx` identifies the
+     * natively retained transaction to broadcast.
      * @param walletId - Unique identifier for the wallet
-     * @param signedTx - The signed transaction string from createTransaction
-     * @returns The transaction hash
-     * @throws Error if broadcast fails
+     * @param signedTx - The signedTxHex returned by createTransaction
+     * @returns "success"
+     * @throws Error if the transaction is no longer retained (evicted, or the
+     *   wallet was closed since creation) or the broadcast fails
      */
     broadcastTransaction(walletId: string, signedTx: string): Promise<string>;
     /**

package/lib/src/CppBridge.js

@@ -129,9 +129,34 @@ class CppBridge {
         ]);
         return JSON.parse(response);
     }
+    /**
+     * Get not-yet-mined transactions with pagination. Same shape as
+     * getAllTransactions, filtered to pending entries. Pending transactions sort
+     * behind all confirmed ones in getAllTransactions, so a cursor-based scan of
+     * confirmed history never reaches them; use this to read the pending set
+     * directly. The set can include entries the backend reports as permanently
+     * failed (isFailed: true); callers decide how to label those.
+     * @param walletId - Unique identifier for the wallet
+     * @param page - Page number (0-indexed)
+     * @param pageSize - Number of transactions per page
+     * @returns Paginated pending transactions with metadata
+     */
+    async getPendingTransactions(walletId, page, pageSize) {
+        const response = await this.module.callMonero('getPendingTransactions', [
+            walletId,
+            page.toString(),
+            pageSize.toString()
+        ]);
+        return JSON.parse(response);
+    }
     /**
      * Create a transaction (supports multiple recipients).
-     * The transaction is created and signed but not broadcast yet.
+     * The transaction is created and signed but not broadcast yet: it is retained
+     * natively for a later broadcastTransaction call. At most 50 transactions are
+     * retained per wallet (oldest disposed first; broadcasting an evicted one
+     * reports that it must be recreated), and all are released when the wallet
+     * closes. Payments the wallet would split into multiple on-chain
+     * transactions are rejected, so a later broadcast is atomic.
      * @param walletId - Unique identifier for the wallet
      * @param recipients - Array of recipients with addresses and amounts (atomic units)
      * @param priority - Transaction priority (0=Default, 1=Low, 2=Medium, 3=High)
@@ -150,11 +175,13 @@ class CppBridge {
         return JSON.parse(response);
     }
     /**
-     * Broadcast a previously created transaction.
+     * Broadcast a previously created transaction. `signedTx` identifies the
+     * natively retained transaction to broadcast.
      * @param walletId - Unique identifier for the wallet
-     * @param signedTx - The signed transaction string from createTransaction
-     * @returns The transaction hash
-     * @throws Error if broadcast fails
+     * @param signedTx - The signedTxHex returned by createTransaction
+     * @returns "success"
+     * @throws Error if the transaction is no longer retained (evicted, or the
+     *   wallet was closed since creation) or the broadcast fails
      */
     async broadcastTransaction(walletId, signedTx) {
         const response = await this.module.callMonero('broadcastTransaction', [

package/lib/src/types.d.ts

@@ -20,6 +20,14 @@ export interface WalletStatus {
     networkHeight: number;
     balance: string;
     unlockedBalance: string;
+    /**
+     * True once at least one server refresh has completed for this wallet. LWS
+     * wallets seed syncedHeight == networkHeight from the stored scan height
+     * until their first refresh, so heights alone cannot tell "caught up" from
+     * "has not looked yet"; treat the wallet as synced/spendable only when this
+     * is true.
+     */
+    refreshed: boolean;
 }
 /** Transaction direction. */
 export type TransactionDirection = 0 | 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-monero",
-  "version": "0.2.0",
+  "version": "0.4.0-beta.0",
   "description": "React Native bindings for the monero-lwsf library",
   "homepage": "https://github.com/EdgeApp/react-native-monero",
   "repository": {