Merge pull request #23 from synonymdev/feat/include-untrusted-pending-in-spendable

feat: allow including received unconfirmed balance in spendable balance

Author: ovitrif

CHANGELOG.md

@@ -45,6 +45,12 @@
   - `Bolt11Payment::estimate_routing_fees_using_amount()`: Estimates fees for amount-less invoices.
 - Enhanced `OnchainPayment::send_to_address()` to accept optional `utxos_to_spend` parameter
   for manual UTXO selection.
+- Added `Config::include_untrusted_pending_in_spendable` option to control whether unconfirmed
+  funds from external sources are included in `spendable_onchain_balance_sats`. When set to `true`,
+  the spendable balance will include `untrusted_pending` UTXOs (unconfirmed transactions received
+  from external wallets). Default is `false` for safety, as spending unconfirmed external funds
+  carries risk of double-spending. This affects all balance reporting including `list_balances()`
+  and `BalanceChanged` events.
 
 # 0.7.0 - Dec. 3, 2025
 This seventh minor release introduces numerous new features, bug fixes, and API improvements. In particular, it adds support for channel Splicing, Async Payments, as well as sourcing chain data from a Bitcoin Core REST backend.

Package.swift

@@ -4,7 +4,7 @@
 import PackageDescription
 
 let tag = "v0.7.0"
-let checksum = "688ba4f800921fe64f12b1c457c1765c0868cbb906583918d5933e4f01ba983c"
+let checksum = "26c09b6902c07dc1b725871fafb94ab8cf5c31bf08b88322b818a192b0d3cd07"
 let url = "https://github.com/synonymdev/ldk-node/releases/download/\(tag)/LDKNodeFFI.xcframework.zip"
 
 let package = Package(

bindings/kotlin/ldk-node-android/lib/src/main/jniLibs/arm64-v8a/libldk_node.so

@@ -9112,6 +9112,7 @@ object FfiConverterTypeConfig: FfiConverterRustBuffer<Config> {
             FfiConverterULong.read(buf),
             FfiConverterOptionalTypeAnchorChannelsConfig.read(buf),
             FfiConverterOptionalTypeRouteParametersConfig.read(buf),
+            FfiConverterBoolean.read(buf),
         )
     }
 
@@ -9124,7 +9125,8 @@ object FfiConverterTypeConfig: FfiConverterRustBuffer<Config> {
             FfiConverterSequenceTypePublicKey.allocationSize(value.`trustedPeers0conf`) +
             FfiConverterULong.allocationSize(value.`probingLiquidityLimitMultiplier`) +
             FfiConverterOptionalTypeAnchorChannelsConfig.allocationSize(value.`anchorChannelsConfig`) +
-            FfiConverterOptionalTypeRouteParametersConfig.allocationSize(value.`routeParameters`)
+            FfiConverterOptionalTypeRouteParametersConfig.allocationSize(value.`routeParameters`) +
+            FfiConverterBoolean.allocationSize(value.`includeUntrustedPendingInSpendable`)
     )
 
     override fun write(value: Config, buf: ByteBuffer) {
@@ -9137,6 +9139,7 @@ object FfiConverterTypeConfig: FfiConverterRustBuffer<Config> {
         FfiConverterULong.write(value.`probingLiquidityLimitMultiplier`, buf)
         FfiConverterOptionalTypeAnchorChannelsConfig.write(value.`anchorChannelsConfig`, buf)
         FfiConverterOptionalTypeRouteParametersConfig.write(value.`routeParameters`, buf)
+        FfiConverterBoolean.write(value.`includeUntrustedPendingInSpendable`, buf)
     }
 }
 

bindings/kotlin/ldk-node-android/lib/src/main/jniLibs/armeabi-v7a/libldk_node.so

@@ -789,7 +789,8 @@ data class Config (
     val `trustedPeers0conf`: List<PublicKey>, 
     val `probingLiquidityLimitMultiplier`: kotlin.ULong, 
     val `anchorChannelsConfig`: AnchorChannelsConfig?, 
-    val `routeParameters`: RouteParametersConfig?
+    val `routeParameters`: RouteParametersConfig?, 
+    val `includeUntrustedPendingInSpendable`: kotlin.Boolean
 ) {
     companion object
 }

bindings/kotlin/ldk-node-android/lib/src/main/jniLibs/x86_64/libldk_node.so

@@ -13,6 +13,7 @@ dictionary Config {
 	u64 probing_liquidity_limit_multiplier;
 	AnchorChannelsConfig? anchor_channels_config;
 	RouteParametersConfig? route_parameters;
+	boolean include_untrusted_pending_in_spendable;
 };
 
 dictionary AnchorChannelsConfig {

bindings/kotlin/ldk-node-android/lib/src/main/kotlin/org/lightningdevkit/ldknode/ldk_node.android.kt

@@ -7683,7 +7683,8 @@ class Config:
     probing_liquidity_limit_multiplier: "int"
     anchor_channels_config: "typing.Optional[AnchorChannelsConfig]"
     route_parameters: "typing.Optional[RouteParametersConfig]"
-    def __init__(self, *, storage_dir_path: "str", network: "Network", listening_addresses: "typing.Optional[typing.List[SocketAddress]]", announcement_addresses: "typing.Optional[typing.List[SocketAddress]]", node_alias: "typing.Optional[NodeAlias]", trusted_peers_0conf: "typing.List[PublicKey]", probing_liquidity_limit_multiplier: "int", anchor_channels_config: "typing.Optional[AnchorChannelsConfig]", route_parameters: "typing.Optional[RouteParametersConfig]"):
+    include_untrusted_pending_in_spendable: "bool"
+    def __init__(self, *, storage_dir_path: "str", network: "Network", listening_addresses: "typing.Optional[typing.List[SocketAddress]]", announcement_addresses: "typing.Optional[typing.List[SocketAddress]]", node_alias: "typing.Optional[NodeAlias]", trusted_peers_0conf: "typing.List[PublicKey]", probing_liquidity_limit_multiplier: "int", anchor_channels_config: "typing.Optional[AnchorChannelsConfig]", route_parameters: "typing.Optional[RouteParametersConfig]", include_untrusted_pending_in_spendable: "bool"):
         self.storage_dir_path = storage_dir_path
         self.network = network
         self.listening_addresses = listening_addresses
@@ -7693,9 +7694,10 @@ def __init__(self, *, storage_dir_path: "str", network: "Network", listening_add
         self.probing_liquidity_limit_multiplier = probing_liquidity_limit_multiplier
         self.anchor_channels_config = anchor_channels_config
         self.route_parameters = route_parameters
+        self.include_untrusted_pending_in_spendable = include_untrusted_pending_in_spendable
 
     def __str__(self):
-        return "Config(storage_dir_path={}, network={}, listening_addresses={}, announcement_addresses={}, node_alias={}, trusted_peers_0conf={}, probing_liquidity_limit_multiplier={}, anchor_channels_config={}, route_parameters={})".format(self.storage_dir_path, self.network, self.listening_addresses, self.announcement_addresses, self.node_alias, self.trusted_peers_0conf, self.probing_liquidity_limit_multiplier, self.anchor_channels_config, self.route_parameters)
+        return "Config(storage_dir_path={}, network={}, listening_addresses={}, announcement_addresses={}, node_alias={}, trusted_peers_0conf={}, probing_liquidity_limit_multiplier={}, anchor_channels_config={}, route_parameters={}, include_untrusted_pending_in_spendable={})".format(self.storage_dir_path, self.network, self.listening_addresses, self.announcement_addresses, self.node_alias, self.trusted_peers_0conf, self.probing_liquidity_limit_multiplier, self.anchor_channels_config, self.route_parameters, self.include_untrusted_pending_in_spendable)
 
     def __eq__(self, other):
         if self.storage_dir_path != other.storage_dir_path:
@@ -7716,6 +7718,8 @@ def __eq__(self, other):
             return False
         if self.route_parameters != other.route_parameters:
             return False
+        if self.include_untrusted_pending_in_spendable != other.include_untrusted_pending_in_spendable:
+            return False
         return True
 
 class _UniffiConverterTypeConfig(_UniffiConverterRustBuffer):
@@ -7731,6 +7735,7 @@ def read(buf):
             probing_liquidity_limit_multiplier=_UniffiConverterUInt64.read(buf),
             anchor_channels_config=_UniffiConverterOptionalTypeAnchorChannelsConfig.read(buf),
             route_parameters=_UniffiConverterOptionalTypeRouteParametersConfig.read(buf),
+            include_untrusted_pending_in_spendable=_UniffiConverterBool.read(buf),
         )
 
     @staticmethod
@@ -7744,6 +7749,7 @@ def check_lower(value):
         _UniffiConverterUInt64.check_lower(value.probing_liquidity_limit_multiplier)
         _UniffiConverterOptionalTypeAnchorChannelsConfig.check_lower(value.anchor_channels_config)
         _UniffiConverterOptionalTypeRouteParametersConfig.check_lower(value.route_parameters)
+        _UniffiConverterBool.check_lower(value.include_untrusted_pending_in_spendable)
 
     @staticmethod
     def write(value, buf):
@@ -7756,6 +7762,7 @@ def write(value, buf):
         _UniffiConverterUInt64.write(value.probing_liquidity_limit_multiplier, buf)
         _UniffiConverterOptionalTypeAnchorChannelsConfig.write(value.anchor_channels_config, buf)
         _UniffiConverterOptionalTypeRouteParametersConfig.write(value.route_parameters, buf)
+        _UniffiConverterBool.write(value.include_untrusted_pending_in_spendable, buf)
 
 
 class CustomTlvRecord:

bindings/kotlin/ldk-node-android/lib/src/main/kotlin/org/lightningdevkit/ldknode/ldk_node.common.kt

@@ -4901,10 +4901,11 @@ public struct Config {
     public var probingLiquidityLimitMultiplier: UInt64
     public var anchorChannelsConfig: AnchorChannelsConfig?
     public var routeParameters: RouteParametersConfig?
+    public var includeUntrustedPendingInSpendable: Bool
 
     // Default memberwise initializers are never public by default, so we
     // declare one manually.
-    public init(storageDirPath: String, network: Network, listeningAddresses: [SocketAddress]?, announcementAddresses: [SocketAddress]?, nodeAlias: NodeAlias?, trustedPeers0conf: [PublicKey], probingLiquidityLimitMultiplier: UInt64, anchorChannelsConfig: AnchorChannelsConfig?, routeParameters: RouteParametersConfig?) {
+    public init(storageDirPath: String, network: Network, listeningAddresses: [SocketAddress]?, announcementAddresses: [SocketAddress]?, nodeAlias: NodeAlias?, trustedPeers0conf: [PublicKey], probingLiquidityLimitMultiplier: UInt64, anchorChannelsConfig: AnchorChannelsConfig?, routeParameters: RouteParametersConfig?, includeUntrustedPendingInSpendable: Bool) {
         self.storageDirPath = storageDirPath
         self.network = network
         self.listeningAddresses = listeningAddresses
@@ -4914,6 +4915,7 @@ public struct Config {
         self.probingLiquidityLimitMultiplier = probingLiquidityLimitMultiplier
         self.anchorChannelsConfig = anchorChannelsConfig
         self.routeParameters = routeParameters
+        self.includeUntrustedPendingInSpendable = includeUntrustedPendingInSpendable
     }
 }
 
@@ -4946,6 +4948,9 @@ extension Config: Equatable, Hashable {
         if lhs.routeParameters != rhs.routeParameters {
             return false
         }
+        if lhs.includeUntrustedPendingInSpendable != rhs.includeUntrustedPendingInSpendable {
+            return false
+        }
         return true
     }
 
@@ -4959,6 +4964,7 @@ extension Config: Equatable, Hashable {
         hasher.combine(probingLiquidityLimitMultiplier)
         hasher.combine(anchorChannelsConfig)
         hasher.combine(routeParameters)
+        hasher.combine(includeUntrustedPendingInSpendable)
     }
 }
 
@@ -4977,7 +4983,8 @@ public struct FfiConverterTypeConfig: FfiConverterRustBuffer {
                 trustedPeers0conf: FfiConverterSequenceTypePublicKey.read(from: &buf),
                 probingLiquidityLimitMultiplier: FfiConverterUInt64.read(from: &buf),
                 anchorChannelsConfig: FfiConverterOptionTypeAnchorChannelsConfig.read(from: &buf),
-                routeParameters: FfiConverterOptionTypeRouteParametersConfig.read(from: &buf)
+                routeParameters: FfiConverterOptionTypeRouteParametersConfig.read(from: &buf),
+                includeUntrustedPendingInSpendable: FfiConverterBool.read(from: &buf)
             )
     }
 
@@ -4991,6 +4998,7 @@ public struct FfiConverterTypeConfig: FfiConverterRustBuffer {
         FfiConverterUInt64.write(value.probingLiquidityLimitMultiplier, into: &buf)
         FfiConverterOptionTypeAnchorChannelsConfig.write(value.anchorChannelsConfig, into: &buf)
         FfiConverterOptionTypeRouteParametersConfig.write(value.routeParameters, into: &buf)
+        FfiConverterBool.write(value.includeUntrustedPendingInSpendable, into: &buf)
     }
 }