docs: fix bare URL warnings in Rust documentation

Convert all bare URLs to proper hyperlinks by wrapping them with angle
brackets. This resolves the "this URL is not a hyperlink" warnings when
running make docs-rust.

Changes:
- Wrapped all bare URLs in documentation comments with <> brackets
- Fixed URLs in module-level docs (//\!), regular docs (///), and comments (//)
- Processed all .rs files in the workspace excluding build artifacts

All documentation URLs are now properly formatted as clickable hyperlinks
in the generated API documentation.

Author: dannywillems

cli/src/main.rs

@@ -60,7 +60,7 @@ fn setup_var_from_single_and_only_thread() {
 }
 
 /// Mimic default hook:
-/// https://github.com/rust-lang/rust/blob/5986ff05d8480da038dd161b3a6aa79ff364a851/library/std/src/panicking.rs#L246
+/// <https://github.com/rust-lang/rust/blob/5986ff05d8480da038dd161b3a6aa79ff364a851/library/std/src/panicking.rs#L246>
 ///
 /// Unlike the default hook, this one allocates.
 /// We store (+ display) panics in non-main threads, and display them all when the main thread panics.

core/src/block/prevalidate.rs

@@ -113,8 +113,8 @@ pub fn prevalidate_block(
     validate_constants(block, genesis)?;
 
     // TODO(tizoc): check for InvalidDeltaBlockChainProof
-    // https://github.com/MinaProtocol/mina/blob/d800da86a764d8d37ffb8964dd8d54d9f522b358/src/lib/mina_block/validation.ml#L369
-    // https://github.com/MinaProtocol/mina/blob/d800da86a764d8d37ffb8964dd8d54d9f522b358/src/lib/transition_chain_verifier/transition_chain_verifier.ml
+    // <https://github.com/MinaProtocol/mina/blob/d800da86a764d8d37ffb8964dd8d54d9f522b358/src/lib/mina_block/validation.ml#L369>
+    // <https://github.com/MinaProtocol/mina/blob/d800da86a764d8d37ffb8964dd8d54d9f522b358/src/lib/transition_chain_verifier/transition_chain_verifier.ml>
 
     Ok(())
 }

ledger/src/account/account.rs

@@ -76,7 +76,7 @@ impl TokenId {
     }
 }
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/account.ml#L93
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/account.ml#L93>
 #[derive(Clone, PartialEq, Eq, derive_more::From)]
 pub struct TokenSymbol(pub Vec<u8>);
 
@@ -135,7 +135,7 @@ impl TokenSymbol {
 impl Default for TokenSymbol {
     fn default() -> Self {
         // empty string
-        // https://github.com/MinaProtocol/mina/blob/3fe924c80a4d01f418b69f27398f5f93eb652514/src/lib/mina_base/account.ml#L133
+        // <https://github.com/MinaProtocol/mina/blob/3fe924c80a4d01f418b69f27398f5f93eb652514/src/lib/mina_base/account.ml#L133>
         Self(Vec::new())
     }
 }
@@ -154,7 +154,7 @@ impl From<&TokenSymbol> for mina_p2p_messages::string::TokenSymbol {
 
 impl ToInputs for TokenSymbol {
     fn to_inputs(&self, inputs: &mut Inputs) {
-        // https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97
+        // <https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97>
         //assert!(self.len() <= 6);
 
         let mut s = <[u8; 6]>::default();
@@ -169,7 +169,7 @@ pub struct SetVerificationKey<Controller> {
     pub txn_version: TxnVersion,
 }
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/permissions.mli#L49
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/permissions.mli#L49>
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Permissions<Controller> {
     pub edit_state: Controller,
@@ -333,7 +333,7 @@ impl Permissions<AuthRequired> {
         }
     }
 
-    /// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L385
+    /// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L385>
     pub fn gen(auth_tag: ControlTag) -> Self {
         let mut rng = rand::thread_rng();
 
@@ -376,7 +376,7 @@ pub enum ProofVerified {
 }
 
 impl ProofVerified {
-    /// https://github.com/MinaProtocol/mina/blob/47a269c2e917775b34a83775b8a55fcc44830831/src/lib/pickles_base/proofs_verified.ml#L17
+    /// <https://github.com/MinaProtocol/mina/blob/47a269c2e917775b34a83775b8a55fcc44830831/src/lib/pickles_base/proofs_verified.ml#L17>
     pub fn to_int(&self) -> usize {
         match self {
             ProofVerified::N0 => 0,
@@ -387,7 +387,7 @@ impl ProofVerified {
 }
 
 impl ToInputs for ProofVerified {
-    /// https://github.com/MinaProtocol/mina/blob/436023ba41c43a50458a551b7ef7a9ae61670b25/src/lib/pickles_base/proofs_verified.ml#L125
+    /// <https://github.com/MinaProtocol/mina/blob/436023ba41c43a50458a551b7ef7a9ae61670b25/src/lib/pickles_base/proofs_verified.ml#L125>
     fn to_inputs(&self, inputs: &mut Inputs) {
         let bits = match self {
             ProofVerified::N0 => [true, false, false],
@@ -517,7 +517,7 @@ impl ToInputs for VerificationKey {
 }
 
 impl VerificationKey {
-    /// https://github.com/MinaProtocol/mina/blob/436023ba41c43a50458a551b7ef7a9ae61670b25/src/lib/pickles/side_loaded_verification_key.ml#L310
+    /// <https://github.com/MinaProtocol/mina/blob/436023ba41c43a50458a551b7ef7a9ae61670b25/src/lib/pickles/side_loaded_verification_key.ml#L310>
     pub fn dummy() -> Arc<Self> {
         static VK: OnceCell<Arc<VerificationKey>> = OnceCell::new();
 
@@ -648,7 +648,7 @@ impl ToFieldElements<Fp> for Option<&ZkAppUri> {
 }
 
 impl ToInputs for Option<&ZkAppUri> {
-    /// https://github.com/MinaProtocol/mina/blob/3fe924c80a4d01f418b69f27398f5f93eb652514/src/lib/mina_base/zkapp_account.ml#L313
+    /// <https://github.com/MinaProtocol/mina/blob/3fe924c80a4d01f418b69f27398f5f93eb652514/src/lib/mina_base/zkapp_account.ml#L313>
     fn to_inputs(&self, inputs: &mut Inputs) {
         let field_zkapp_uri = ZkAppUri::opt_to_field(*self);
         inputs.append(&field_zkapp_uri);
@@ -787,7 +787,7 @@ impl VerificationKeyWire {
     }
 }
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/zkapp_account.ml#L148-L170
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/zkapp_account.ml#L148-L170>
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ZkAppAccount {
     pub app_state: [Fp; 8],
@@ -1265,7 +1265,7 @@ pub struct PermsConst {
     pub or_const: bool,
 }
 
-// https://github.com/MinaProtocol/mina/blob/1765ba6bdfd7c454e5ae836c49979fa076de1bea/src/lib/mina_base/account.ml#L368
+// <https://github.com/MinaProtocol/mina/blob/1765ba6bdfd7c454e5ae836c49979fa076de1bea/src/lib/mina_base/account.ml#L368>
 #[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
 #[serde(into = "v2::MinaBaseAccountBinableArgStableV2")]
 #[serde(try_from = "v2::MinaBaseAccountBinableArgStableV2")]
@@ -1487,7 +1487,7 @@ impl Account {
         }
     }
 
-    /// https://github.com/MinaProtocol/mina/blob/2ff0292b637684ce0372e7b8e23ec85404dc5091/src/lib/mina_base/account.ml#L794
+    /// <https://github.com/MinaProtocol/mina/blob/2ff0292b637684ce0372e7b8e23ec85404dc5091/src/lib/mina_base/account.ml#L794>
     pub fn has_permission_to(&self, control: ControlTag, to: PermissionTo) -> bool {
         match to {
             PermissionTo::Access => check_permission(self.permissions.access, control),
@@ -1741,7 +1741,7 @@ impl ToInputs for Account {
         // Self::balance
         inputs.append_u64(balance.as_u64());
         // Self::token_symbol
-        // https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97
+        // <https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97>
         assert!(token_symbol.len() <= 6);
         inputs.append(token_symbol);
         // Self::token_id

ledger/src/account/common.rs

@@ -140,7 +140,7 @@ impl Default for ReceiptChainHash {
 /// point minimum balance drops to 0, and after that the account behaves
 /// like an untimed one. *)
 ///
-/// https://github.com/MinaProtocol/mina/blob/2ff0292b637684ce0372e7b8e23ec85404dc5091/src/lib/mina_base/account_timing.ml#L22
+/// <https://github.com/MinaProtocol/mina/blob/2ff0292b637684ce0372e7b8e23ec85404dc5091/src/lib/mina_base/account_timing.ml#L22>
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum Timing {
     Untimed,
@@ -227,10 +227,10 @@ pub struct TimingAsRecordChecked<F: FieldWitness> {
     pub vesting_increment: CheckedAmount<F>,
 }
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_numbers/intf.ml#L155
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_numbers/intf.ml#L155>
 // pub type Nonce = u32;
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/token_permissions.ml#L9
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/token_permissions.ml#L9>
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum TokenPermissions {
     TokenOwned { disable_new_accounts: bool },
@@ -245,7 +245,7 @@ impl Default for TokenPermissions {
     }
 }
 
-// https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/permissions.mli#L10
+// <https://github.com/MinaProtocol/mina/blob/develop/src/lib/mina_base/permissions.mli#L10>
 #[derive(Copy, Clone, Debug, PartialEq, Eq, Serialize, Deserialize, strum_macros::Display)]
 #[serde(rename_all = "lowercase")]
 pub enum AuthRequired {
@@ -264,7 +264,7 @@ impl Default for AuthRequired {
 }
 
 impl From<ControlTag> for AuthRequired {
-    /// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L68
+    /// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L68>
     fn from(value: ControlTag) -> Self {
         match value {
             ControlTag::Proof => Self::Proof,
@@ -301,7 +301,7 @@ impl AuthRequired {
 
     /// permissions such that [check permission (Proof _)] is true
     ///
-    /// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L78
+    /// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L78>
     pub fn gen_for_proof_authorization(rng: &mut rand::rngs::ThreadRng) -> Self {
         use rand::seq::SliceRandom;
 
@@ -313,7 +313,7 @@ impl AuthRequired {
 
     /// permissions such that [check permission (Signature _)] is true
     ///
-    /// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L82
+    /// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L82>
     pub fn gen_for_signature_authorization(rng: &mut rand::rngs::ThreadRng) -> Self {
         use rand::seq::SliceRandom;
 
@@ -325,7 +325,7 @@ impl AuthRequired {
 
     /// permissions such that [check permission None_given] is true
     ///
-    /// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L86
+    /// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_base/permissions.ml#L86>
     pub fn gen_for_none_given_authorization(_rng: &mut rand::rngs::ThreadRng) -> Self {
         Self::None
     }

ledger/src/account/conv.rs

@@ -148,7 +148,7 @@ where
 }
 
 /// Note: Refactor when `core::array::try_map` is stable
-/// https://github.com/rust-lang/rust/issues/79711
+/// <https://github.com/rust-lang/rust/issues/79711>
 pub fn try_array_into_with<'a, T, E, U, F, const N: usize>(
     value: &'a [T; N],
     fun: F,

ledger/src/account/legacy.rs

@@ -91,7 +91,7 @@ impl Hashable for SnappAccount {
         } else {
             roi = roi.append_field(
                 // Value of `dummy_vk_hash`:
-                // https://github.com/MinaProtocol/mina/blob/4f765c866b81fa6fed66be52707fd91fd915041d/src/lib/mina_base/snapp_account.ml#L116
+                // <https://github.com/MinaProtocol/mina/blob/4f765c866b81fa6fed66be52707fd91fd915041d/src/lib/mina_base/snapp_account.ml#L116>
                 Fp::from_hex("77a430a03efafd14d72e1a3c45a1fdca8267fcce9a729a1d25128bb5dec69d3f")
                     .unwrap(),
             );
@@ -111,7 +111,7 @@ impl Hashable for SnappAccount {
     }
 }
 
-// https://github.com/MinaProtocol/mina/blob/1765ba6bdfd7c454e5ae836c49979fa076de1bea/src/lib/mina_base/account.ml#L368
+// <https://github.com/MinaProtocol/mina/blob/1765ba6bdfd7c454e5ae836c49979fa076de1bea/src/lib/mina_base/account.ml#L368>
 #[derive(Clone, Debug)]
 pub struct AccountLegacy {
     pub public_key: CompressedPubKey,         // Public_key.Compressed.t
@@ -145,7 +145,7 @@ impl Hashable for AccountLegacy {
 
         // Self::token_symbol
 
-        // https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97
+        // <https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97>
         // assert!(self.token_symbol.len() <= 6);
 
         // if !self.token_symbol.is_empty() {
@@ -286,7 +286,7 @@ impl Hashable for AccountLegacy {
 
     //     // Self::token_symbol
 
-    //     // https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97
+    //     // <https://github.com/MinaProtocol/mina/blob/2fac5d806a06af215dbab02f7b154b4f032538b7/src/lib/mina_base/account.ml#L97>
     //     // assert!(self.token_symbol.len() <= 6);
 
     //     // if !self.token_symbol.is_empty() {

ledger/src/base.rs

@@ -246,7 +246,7 @@ impl LedgerIntf for Mask {
         BaseLedger::set(self, addr.clone(), account)
     }
 
-    /// https://github.com/MinaProtocol/mina/blob/05c2f73d0f6e4f1341286843814ce02dcb3919e0/src/lib/mina_ledger/ledger.ml#L311
+    /// <https://github.com/MinaProtocol/mina/blob/05c2f73d0f6e4f1341286843814ce02dcb3919e0/src/lib/mina_ledger/ledger.ml#L311>
     fn get_or_create(
         &mut self,
         account_id: &AccountId,
@@ -271,7 +271,7 @@ impl LedgerIntf for Mask {
         Ok((action, account, addr))
     }
 
-    /// https://github.com/MinaProtocol/mina/blob/05c2f73d0f6e4f1341286843814ce02dcb3919e0/src/lib/mina_ledger/ledger.ml#L304
+    /// <https://github.com/MinaProtocol/mina/blob/05c2f73d0f6e4f1341286843814ce02dcb3919e0/src/lib/mina_ledger/ledger.ml#L304>
     fn create_new_account(&mut self, account_id: AccountId, account: Account) -> Result<(), ()> {
         match BaseLedger::get_or_create_account(self, account_id, account).unwrap() {
             GetOrCreated::Added(_) => {}
@@ -315,7 +315,7 @@ impl LedgerIntf for Mask {
 
     fn apply_mask(&mut self, mask: Self) {
         // ignore `self` here:
-        // https://github.com/MinaProtocol/mina/blob/f6756507ff7380a691516ce02a3cf7d9d32915ae/src/lib/mina_ledger/ledger.ml#L236-L246
+        // <https://github.com/MinaProtocol/mina/blob/f6756507ff7380a691516ce02a3cf7d9d32915ae/src/lib/mina_ledger/ledger.ml#L236-L246>
         mask.commit()
     }
 

ledger/src/cache.rs

@@ -10,7 +10,7 @@ macro_rules! cache {
         // The destructor won't be run, but we don't care.
         //
         // See
-        // https://github.com/rust-lang/rust/blob/635c4a5e612b0ee8af6615635599702d3dce9906/library/std/src/sys/common/thread_local/fast_local.rs#
+        // <https://github.com/rust-lang/rust/blob/635c4a5e612b0ee8af6615635599702d3dce9906/library/std/src/sys/common/thread_local/fast_local.rs#>
 
         use std::mem::ManuallyDrop;
         use std::cell::RefCell;

ledger/src/dummy/mod.rs

@@ -11,7 +11,7 @@ use crate::VerificationKey;
 pub mod for_tests;
 
 /// Value of `vk` when we run `dune runtest src/lib/staged_ledger -f`
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/staged_ledger/staged_ledger.ml#L2083
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/staged_ledger/staged_ledger.ml#L2083>
 ///
 /// The file was generated this way:
 ///
@@ -35,7 +35,7 @@ pub fn trivial_verification_key() -> VerificationKey {
 }
 
 /// Value of a dummy proof when we run `dune runtest src/lib/staged_ledger -f`
-/// https://github.com/MinaProtocol/mina/blob/d7dad23d8ea2052f515f5d55d187788fe0701c7f/src/lib/mina_base/control.ml#L94
+/// <https://github.com/MinaProtocol/mina/blob/d7dad23d8ea2052f515f5d55d187788fe0701c7f/src/lib/mina_base/control.ml#L94>
 ///
 /// The file was generated this way:
 ///

ledger/src/generators/mod.rs

@@ -4,7 +4,7 @@ pub mod user_command;
 pub mod zkapp_command;
 pub mod zkapp_command_builder;
 
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L20
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L20>
 #[derive(Clone, Debug)]
 pub enum Role {
     FeePayer,
@@ -13,7 +13,7 @@ pub enum Role {
     NewTokenAccount,
 }
 
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L7
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L7>
 #[derive(Clone, Debug)]
 pub enum NotPermitedOf {
     Delegate,
@@ -26,7 +26,7 @@ pub enum NotPermitedOf {
     Receive,
 }
 
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L7
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L7>
 #[derive(Clone, Debug)]
 pub enum Failure {
     InvalidAccountPrecondition,
@@ -42,10 +42,10 @@ pub enum Failure {
 /// when we have separate transaction accounts in integration tests
 /// this number can be increased
 ///
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L1111
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L1111>
 const MAX_ACCOUNT_UPDATES: usize = 2;
 
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L1113
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/zkapp_command_generators.ml#L1113>
 const MAX_TOKEN_UPDATES: usize = 2;
 
 /// Value when we run `dune runtest src/lib/staged_ledger -f`
@@ -55,5 +55,5 @@ const MINIMUM_USER_COMMAND_FEE: Fee = Fee::from_u64(1000000);
 
 /// Value of `ledger_depth` when we run `dune runtest src/lib/staged_ledger -f`
 ///
-/// https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/user_command_generators.ml#L15
+/// <https://github.com/MinaProtocol/mina/blob/3753a8593cc1577bcf4da16620daf9946d88e8e5/src/lib/mina_generators/user_command_generators.ml#L15>
 const LEDGER_DEPTH: usize = 35;