Document script_pubkey-only matching in into_unique_contributions

The function compares outputs by script_pubkey alone, not full TxOut,
so any contribution output sharing a script with an existing output is
filtered regardless of value. This is intentional — a change output's
value may shift between rounds (e.g., for a new feerate) and should
still match. But the consequence isn't obvious: multiple contribution
outputs sharing a script are all filtered together when any existing
output uses that script. Document it.

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

Author: jkczyz

lightning/src/ln/funding.rs

@@ -757,6 +757,15 @@ impl FundingContribution {
 		(inputs.into_iter().map(|input| input.utxo.outpoint).collect(), outputs)
 	}
 
+	/// Returns this contribution's inputs and outputs after removing any that overlap with
+	/// the provided `existing_inputs`/`existing_outputs`.
+	///
+	/// Outputs are compared by `script_pubkey` alone (not full `TxOut`), since values may
+	/// differ between rounds (e.g., a change output adjusted for a new feerate). As a
+	/// consequence, multiple contribution outputs sharing a `script_pubkey` are all
+	/// dropped together when any existing output uses the same script.
+	///
+	/// Returns `None` if every input and output was filtered as overlapping.
 	pub(super) fn into_unique_contributions<'a>(
 		self, existing_inputs: impl Iterator<Item = OutPoint>,
 		existing_outputs: impl Iterator<Item = &'a TxOut>,