From: Leonardo Lima Date: Wed, 4 Dec 2024 18:33:45 +0000 (-0300) Subject: docs(wallet): reword the `next_unused_address` doc X-Git-Tag: core-0.4.1~4^2 X-Git-Url: http://internal-gitweb-vhost/script/%22https:/database/scripts/static/struct.CommandStringError.html?a=commitdiff_plain;h=b39cf08c98d9a5b53bb0eacd53c71c341ba37f76;p=bdk docs(wallet): reword the `next_unused_address` doc docs(wallet): reword the `next_unused_address` doc Adds an example on what `used` stands for, and make it explicit that it has the same behavior as `Wallet::reveal_next_address` in the scenario where all previously revealed addresses have been used. docs(wallet): fix typo in doc comment --- diff --git a/crates/wallet/src/wallet/mod.rs b/crates/wallet/src/wallet/mod.rs index 4adfb633..3af424d3 100644 --- a/crates/wallet/src/wallet/mod.rs +++ b/crates/wallet/src/wallet/mod.rs @@ -732,10 +732,10 @@ impl Wallet { } /// Get the next unused address for the given `keychain`, i.e. the address with the lowest - /// derivation index that hasn't been used. + /// derivation index that hasn't been used in a transaction. /// - /// This will attempt to derive and reveal a new address if no newly revealed addresses - /// are available. See also [`reveal_next_address`](Self::reveal_next_address). + /// This will attempt to reveal a new address if all previously revealed addresses have + /// been used, in which case the returned address will be the same as calling [`Wallet::reveal_next_address`]. /// /// **WARNING**: To avoid address reuse you must persist the changes resulting from one or more /// calls to this method before closing the wallet. See [`Wallet::reveal_next_address`].