fix(consensus): mark tx_mut as hidden with invalidation warning (#3608)

mattsse · ampcode-com · web-flow · commit ed80471b62dd · 2026-01-27T22:32:27.000+01:00
Amp-Thread-ID: https://ampcode.com/threads/T-019c0135-70cf-710a-8324-f38bb9eeb676 Co-authored-by: Amp <amp@ampcode.com>
diff --git a/crates/consensus/src/signed.rs b/crates/consensus/src/signed.rs
@@ -52,6 +52,11 @@ impl<T, Sig> Signed<T, Sig> {
     }
 
     /// Returns a mutable reference to the transaction.
+    ///
+    /// # Warning
+    ///
+    /// Modifying the transaction structurally invalidates the signature and hash.
+    #[doc(hidden)]
     pub const fn tx_mut(&mut self) -> &mut T {
         &mut self.tx
     }

Original file line number	Diff line number	Diff line change
`@@ -52,6 +52,11 @@ impl<T, Sig> Signed<T, Sig> {`
`52`	`52`	`}`
`53`	`53`
`54`	`54`	`/// Returns a mutable reference to the transaction.`
	`55`	`+ ///`
	`56`	`+ /// # Warning`
	`57`	`+ ///`
	`58`	`+ /// Modifying the transaction structurally invalidates the signature and hash.`
	`59`	`+ #[doc(hidden)]`
`55`	`60`	`pub const fn tx_mut(&mut self) -> &mut T {`
`56`	`61`	`&mut self.tx`
`57`	`62`	`}`