chore(key-wallet-ffi): regenerate FFI docs + reorder cfg attribute

- Move `#[cfg(feature = "keep-finalized-transactions")]` to before the
  doc comment on the three gated FFI accessors. The
  `contrib/verify_ffi.py` doc-extractor walks back from `#[no_mangle]`
  collecting `///` lines and stops at the first non-doc, non-blank
  line — putting `#[cfg]` between the doc and `#[no_mangle]` made the
  docstrings invisible.
- Regenerate `key-wallet-ffi/FFI_API.md` with the updated descriptions
  for `managed_core_account_get_transaction_count`,
  `managed_core_account_get_transactions`, and
  `managed_core_account_free_transactions`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: QuantumExplorer

key-wallet-ffi/FFI_API.md

@@ -231,7 +231,7 @@ Functions: 109
 | `managed_account_collection_summary_data` | Get structured account collection summary data for managed collection ... | managed_account_collection |
 | `managed_account_collection_summary_free` | Free a managed account collection summary and all its allocated memory  #... | managed_account_collection |
 | `managed_core_account_free` | Free a managed account handle  # Safety  - `account` must be a valid pointer... | managed_account |
-| `managed_core_account_free_transactions` | Free transactions array returned by managed_core_account_get_transactions  #... | managed_account |
+| `managed_core_account_free_transactions` | Free transactions array returned by managed_core_account_get_transactions | managed_account |
 | `managed_core_account_get_account_type` | Get the account type of a managed account  # Safety  - `account` must be a... | managed_account |
 | `managed_core_account_get_address_pool` | Get an address pool from a managed account by type  This function returns... | managed_account |
 | `managed_core_account_get_balance` | Get the balance of a managed account  # Safety  - `account` must be a valid... | managed_account |
@@ -240,8 +240,8 @@ Functions: 109
 | `managed_core_account_get_internal_address_pool` | Get the internal address pool from a managed account  This function returns... | managed_account |
 | `managed_core_account_get_is_watch_only` | Check if a managed account is watch-only  # Safety  - `account` must be a... | managed_account |
 | `managed_core_account_get_network` | Get the network of a managed account  # Safety  - `account` must be a valid... | managed_account |
-| `managed_core_account_get_transaction_count` | Get the number of transactions in a managed account  # Safety  - `account`... | managed_account |
-| `managed_core_account_get_transactions` | Get all transactions from a managed account  Returns an array of... | managed_account |
+| `managed_core_account_get_transaction_count` | Get the number of transactions in a managed account | managed_account |
+| `managed_core_account_get_transactions` | Get all transactions from a managed account | managed_account |
 | `managed_core_account_get_utxo_count` | Get the number of UTXOs in a managed account  # Safety  - `account` must be... | managed_account |
 | `managed_platform_account_free` | Free a managed platform account handle  # Safety  - `account` must be a... | managed_account |
 | `managed_platform_account_get_account_index` | Get the account index of a managed platform account  # Safety  - `account`... | managed_account |
@@ -3065,7 +3065,7 @@ managed_core_account_free_transactions(transactions: *mut FFITransactionRecord,
 ```
 
 **Description:**
-Free transactions array returned by managed_core_account_get_transactions  # Safety  - `transactions` must be a pointer returned by `managed_core_account_get_transactions` - `count` must be the count returned by `managed_core_account_get_transactions` - This function must only be called once per allocation
+Free transactions array returned by managed_core_account_get_transactions.  Only available when the `keep-finalized-transactions` Cargo feature is enabled (matches the visibility of `managed_core_account_get_transactions`).  # Safety  - `transactions` must be a pointer returned by `managed_core_account_get_transactions` - `count` must be the count returned by `managed_core_account_get_transactions` - This function must only be called once per allocation
 
 **Safety:**
 - `transactions` must be a pointer returned by `managed_core_account_get_transactions` - `count` must be the count returned by `managed_core_account_get_transactions` - This function must only be called once per allocation
@@ -3209,7 +3209,7 @@ managed_core_account_get_transaction_count(account: *const FFIManagedCoreAccount
 ```
 
 **Description:**
-Get the number of transactions in a managed account  # Safety  - `account` must be a valid pointer to an FFIManagedCoreAccount instance
+Get the number of transactions in a managed account.  Only available when the `keep-finalized-transactions` Cargo feature is enabled. With the feature on, every processed transaction (including finalized ones) lives in the in-memory map for the wallet's lifetime and this count reflects the full history. With the feature off (the default), records of finalized transactions (IS-locked or chainlocked) are dropped from the map immediately to bound memory growth — exposing the resulting partial count via the FFI would be misleading, so the accessor isn't compiled in.  # Safety  - `account` must be a valid pointer to an FFIManagedCoreAccount instance
 
 **Safety:**
 - `account` must be a valid pointer to an FFIManagedCoreAccount instance
@@ -3225,7 +3225,7 @@ managed_core_account_get_transactions(account: *const FFIManagedCoreAccount, tra
 ```
 
 **Description:**
-Get all transactions from a managed account  Returns an array of FFITransactionRecord structures.  # Safety  - `account` must be a valid pointer to an FFIManagedCoreAccount instance - `transactions_out` must be a valid pointer to receive the transactions array pointer - `count_out` must be a valid pointer to receive the count - The caller must free the returned array using `managed_core_account_free_transactions`
+Get all transactions from a managed account.  Only available when the `keep-finalized-transactions` Cargo feature is enabled. With the feature on, every processed transaction (including finalized ones) lives in the in-memory map and this returns the full history. With the feature off (the default), finalized records (IS-locked or chainlocked txs) are dropped from the map immediately to bound memory growth — exposing the resulting partial array via the FFI would be misleading, so the accessor isn't compiled in.  Returns an array of FFITransactionRecord structures.  # Safety  - `account` must be a valid pointer to an FFIManagedCoreAccount instance - `transactions_out` must be a valid pointer to receive the transactions array pointer - `count_out` must be a valid pointer to receive the count - The caller must free the returned array using `managed_core_account_free_transactions`
 
 **Safety:**
 - `account` must be a valid pointer to an FFIManagedCoreAccount instance - `transactions_out` must be a valid pointer to receive the transactions array pointer - `count_out` must be a valid pointer to receive the count - The caller must free the returned array using `managed_core_account_free_transactions`

key-wallet-ffi/src/managed_account.rs

@@ -645,6 +645,7 @@ pub unsafe extern "C" fn managed_core_account_get_balance(
     true
 }
 
+#[cfg(feature = "keep-finalized-transactions")]
 /// Get the number of transactions in a managed account.
 ///
 /// Only available when the `keep-finalized-transactions` Cargo feature
@@ -659,7 +660,6 @@ pub unsafe extern "C" fn managed_core_account_get_balance(
 /// # Safety
 ///
 /// - `account` must be a valid pointer to an FFIManagedCoreAccount instance
-#[cfg(feature = "keep-finalized-transactions")]
 #[no_mangle]
 pub unsafe extern "C" fn managed_core_account_get_transaction_count(
     account: *const FFIManagedCoreAccount,
@@ -955,6 +955,7 @@ impl Drop for FFITransactionRecord {
     }
 }
 
+#[cfg(feature = "keep-finalized-transactions")]
 /// Get all transactions from a managed account.
 ///
 /// Only available when the `keep-finalized-transactions` Cargo feature
@@ -974,7 +975,6 @@ impl Drop for FFITransactionRecord {
 /// - `transactions_out` must be a valid pointer to receive the transactions array pointer
 /// - `count_out` must be a valid pointer to receive the count
 /// - The caller must free the returned array using `managed_core_account_free_transactions`
-#[cfg(feature = "keep-finalized-transactions")]
 #[no_mangle]
 pub unsafe extern "C" fn managed_core_account_get_transactions(
     account: *const FFIManagedCoreAccount,
@@ -1002,6 +1002,7 @@ pub unsafe extern "C" fn managed_core_account_get_transactions(
     true
 }
 
+#[cfg(feature = "keep-finalized-transactions")]
 /// Free transactions array returned by managed_core_account_get_transactions.
 ///
 /// Only available when the `keep-finalized-transactions` Cargo feature
@@ -1013,7 +1014,6 @@ pub unsafe extern "C" fn managed_core_account_get_transactions(
 /// - `transactions` must be a pointer returned by `managed_core_account_get_transactions`
 /// - `count` must be the count returned by `managed_core_account_get_transactions`
 /// - This function must only be called once per allocation
-#[cfg(feature = "keep-finalized-transactions")]
 #[no_mangle]
 pub unsafe extern "C" fn managed_core_account_free_transactions(
     transactions: *mut FFITransactionRecord,