feat: prefix account components with miden::standards namespace (#2400)

Author: Himess

CHANGELOG.md

@@ -44,6 +44,7 @@ Enable `CodeBuilder` to add advice map entries to compiled scripts ([#2275](http
 - [BREAKING] The native hash function changed from RPO256 to Poseidon2  - see PR description ([#2508](https://github.com/0xMiden/miden-base/pull/2508)).
 - Introduced `StorageMapKey` and `StorageMapKeyHash` Word wrappers for type-safe storage map key handling ([#2431](https://github.com/0xMiden/miden-base/pull/2431)).
 - Restructured `miden-agglayer/asm` directory to separate bridge and faucet into per-component libraries, preventing cross-component procedure exposure ([#2294](https://github.com/0xMiden/miden-base/issues/2294)).
+- Prefixed standard account component names with `miden::standards::components` ([#2400](https://github.com/0xMiden/miden-base/pull/2400)).
 - Made kernel procedure offset constants public and replaced accessor procedures with direct constant usage ([#2375](https://github.com/0xMiden/miden-base/pull/2375)).
 - [BREAKING] Made `AccountComponentMetadata` a required parameter of `AccountComponent::new()`; removed `with_supported_type`, `with_supports_all_types`, and `with_metadata` methods from `AccountComponent`; simplified `AccountComponentMetadata::new()` to take just `name`; renamed `AccountComponentTemplateError` to `ComponentMetadataError` ([#2373](https://github.com/0xMiden/miden-base/pull/2373), [#2395](https://github.com/0xMiden/miden-base/pull/2395)).
 - Fixed MASM inline comment casing to adhere to commenting conventions ([#2398](https://github.com/0xMiden/miden-base/pull/2398)).

crates/miden-standards/build.rs

@@ -15,6 +15,7 @@ const ASM_STANDARDS_DIR: &str = "standards";
 const ASM_ACCOUNT_COMPONENTS_DIR: &str = "account_components";
 
 const STANDARDS_LIB_NAMESPACE: &str = "miden::standards";
+const ACCOUNT_COMPONENTS_LIB_NAMESPACE: &str = "miden::standards::components";
 
 const STANDARDS_ERRORS_RS_FILE: &str = "standards_errors.rs";
 const STANDARDS_ERRORS_ARRAY_NAME: &str = "STANDARDS_ERRORS";
@@ -107,7 +108,19 @@ fn compile_account_components(
         let component_source_code = fs::read_to_string(&masm_file_path)
             .expect("reading the component's MASM source code should succeed");
 
-        let named_source = NamedSource::new(component_name.clone(), component_source_code);
+        // Build full library path from directory structure:
+        // e.g. faucets/basic_fungible_faucet.masm ->
+        // miden::standards::components::faucets::basic_fungible_faucet
+        let relative_path = masm_file_path
+            .strip_prefix(source_dir)
+            .expect("masm file should be inside source dir");
+        let mut library_path = ACCOUNT_COMPONENTS_LIB_NAMESPACE.to_owned();
+        for component in relative_path.with_extension("").components() {
+            let part = component.as_os_str().to_str().expect("valid UTF-8");
+            library_path.push_str("::");
+            library_path.push_str(part);
+        }
+        let named_source = NamedSource::new(library_path, component_source_code);
 
         let component_library = assembler
             .clone()

crates/miden-standards/src/account/auth/multisig.rs

@@ -142,7 +142,7 @@ pub struct AuthMultisig {
 
 impl AuthMultisig {
     /// The name of the component.
-    pub const NAME: &'static str = "miden::auth::multisig";
+    pub const NAME: &'static str = "miden::standards::components::auth::multisig";
 
     /// Creates a new [`AuthMultisig`] component from the provided configuration.
     pub fn new(config: AuthMultisigConfig) -> Result<Self, AccountError> {

crates/miden-standards/src/account/auth/multisig_psm.rs

@@ -194,7 +194,7 @@ pub struct AuthMultisigPsm {
 
 impl AuthMultisigPsm {
     /// The name of the component.
-    pub const NAME: &'static str = "miden::auth::multisig_psm";
+    pub const NAME: &'static str = "miden::standards::components::auth::multisig_psm";
 
     /// Creates a new [`AuthMultisigPsm`] component from the provided configuration.
     pub fn new(config: AuthMultisigPsmConfig) -> Result<Self, AccountError> {

crates/miden-standards/src/account/auth/no_auth.rs

@@ -21,7 +21,7 @@ pub struct NoAuth;
 
 impl NoAuth {
     /// The name of the component.
-    pub const NAME: &'static str = "miden::auth::no_auth";
+    pub const NAME: &'static str = "miden::standards::components::auth::no_auth";
 
     /// Creates a new [`NoAuth`] component.
     pub fn new() -> Self {

crates/miden-standards/src/account/auth/singlesig.rs

@@ -45,7 +45,7 @@ pub struct AuthSingleSig {
 
 impl AuthSingleSig {
     /// The name of the component.
-    pub const NAME: &'static str = "miden::auth::singlesig";
+    pub const NAME: &'static str = "miden::standards::components::auth::singlesig";
 
     /// Creates a new [`AuthSingleSig`] component with the given `public_key`.
     pub fn new(pub_key: PublicKeyCommitment, auth_scheme: AuthScheme) -> Self {

crates/miden-standards/src/account/auth/singlesig_acl.rs

@@ -157,7 +157,7 @@ pub struct AuthSingleSigAcl {
 
 impl AuthSingleSigAcl {
     /// The name of the component.
-    pub const NAME: &'static str = "miden::auth::singlesig_acl";
+    pub const NAME: &'static str = "miden::standards::components::auth::singlesig_acl";
     /// Creates a new [`AuthSingleSigAcl`] component with the given `public_key` and
     /// configuration.
     ///

crates/miden-standards/src/account/faucets/basic_fungible.rs

@@ -33,13 +33,15 @@ use crate::procedure_digest;
 // Initialize the digest of the `distribute` procedure of the Basic Fungible Faucet only once.
 procedure_digest!(
     BASIC_FUNGIBLE_FAUCET_DISTRIBUTE,
+    BasicFungibleFaucet::NAME,
     BasicFungibleFaucet::DISTRIBUTE_PROC_NAME,
     basic_fungible_faucet_library
 );
 
 // Initialize the digest of the `burn` procedure of the Basic Fungible Faucet only once.
 procedure_digest!(
     BASIC_FUNGIBLE_FAUCET_BURN,
+    BasicFungibleFaucet::NAME,
     BasicFungibleFaucet::BURN_PROC_NAME,
     basic_fungible_faucet_library
 );
@@ -74,13 +76,13 @@ impl BasicFungibleFaucet {
     // --------------------------------------------------------------------------------------------
 
     /// The name of the component.
-    pub const NAME: &'static str = "miden::basic_fungible_faucet";
+    pub const NAME: &'static str = "miden::standards::components::faucets::basic_fungible_faucet";
 
     /// The maximum number of decimals supported by the component.
     pub const MAX_DECIMALS: u8 = TokenMetadata::MAX_DECIMALS;
 
-    const DISTRIBUTE_PROC_NAME: &str = "basic_fungible_faucet::distribute";
-    const BURN_PROC_NAME: &str = "basic_fungible_faucet::burn";
+    const DISTRIBUTE_PROC_NAME: &str = "distribute";
+    const BURN_PROC_NAME: &str = "burn";
 
     // CONSTRUCTORS
     // --------------------------------------------------------------------------------------------

crates/miden-standards/src/account/faucets/network_fungible.rs

@@ -34,13 +34,15 @@ const TOKEN_SYMBOL_TYPE: &str = "miden::standards::fungible_faucets::metadata::t
 // Initialize the digest of the `distribute` procedure of the Network Fungible Faucet only once.
 procedure_digest!(
     NETWORK_FUNGIBLE_FAUCET_DISTRIBUTE,
+    NetworkFungibleFaucet::NAME,
     NetworkFungibleFaucet::DISTRIBUTE_PROC_NAME,
     network_fungible_faucet_library
 );
 
 // Initialize the digest of the `burn` procedure of the Network Fungible Faucet only once.
 procedure_digest!(
     NETWORK_FUNGIBLE_FAUCET_BURN,
+    NetworkFungibleFaucet::NAME,
     NetworkFungibleFaucet::BURN_PROC_NAME,
     network_fungible_faucet_library
 );
@@ -77,13 +79,13 @@ impl NetworkFungibleFaucet {
     // --------------------------------------------------------------------------------------------
 
     /// The name of the component.
-    pub const NAME: &'static str = "miden::network_fungible_faucet";
+    pub const NAME: &'static str = "miden::standards::components::faucets::network_fungible_faucet";
 
     /// The maximum number of decimals supported by the component.
     pub const MAX_DECIMALS: u8 = TokenMetadata::MAX_DECIMALS;
 
-    const DISTRIBUTE_PROC_NAME: &str = "network_fungible_faucet::distribute";
-    const BURN_PROC_NAME: &str = "network_fungible_faucet::burn";
+    const DISTRIBUTE_PROC_NAME: &str = "distribute";
+    const BURN_PROC_NAME: &str = "burn";
 
     // CONSTRUCTORS
     // --------------------------------------------------------------------------------------------

crates/miden-standards/src/account/mod.rs

@@ -15,29 +15,35 @@ pub use metadata::AccountBuilderSchemaCommitmentExt;
 /// This macro generates a `LazyLock<Word>` static variable that lazily initializes
 /// the digest of a procedure from a library.
 ///
+/// The full procedure path is constructed by concatenating `$component_name` and `$proc_name`
+/// with `::` as separator (i.e. `"{component_name}::{proc_name}"`).
+///
 /// Note: This macro references exported types from `miden_protocol`, so your crate must
 /// include `miden_protocol` as a dependency.
 ///
 /// # Arguments
 /// * `$name` - The name of the static variable to create
-/// * `$proc_name` - The string name of the procedure
+/// * `$component_name` - The name of the component (e.g. `BasicWallet::NAME`)
+/// * `$proc_name` - The short name of the procedure (e.g. `"receive_asset"`)
 /// * `$library_fn` - The function that returns the library containing the procedure
 ///
 /// # Example
 /// ```ignore
 /// procedure_digest!(
 ///     BASIC_WALLET_RECEIVE_ASSET,
+///     BasicWallet::NAME,
 ///     BasicWallet::RECEIVE_ASSET_PROC_NAME,
 ///     basic_wallet_library
 /// );
 /// ```
 #[macro_export]
 macro_rules! procedure_digest {
-    ($name:ident, $proc_name:expr, $library_fn:expr) => {
+    ($name:ident, $component_name:expr, $proc_name:expr, $library_fn:expr) => {
         static $name: miden_protocol::utils::sync::LazyLock<miden_protocol::Word> =
             miden_protocol::utils::sync::LazyLock::new(|| {
-                $library_fn().get_procedure_root_by_path($proc_name).unwrap_or_else(|| {
-                    panic!("{} should contain '{}' procedure", stringify!($library_fn), $proc_name)
+                let full_path = alloc::format!("{}::{}", $component_name, $proc_name);
+                $library_fn().get_procedure_root_by_path(full_path.as_str()).unwrap_or_else(|| {
+                    panic!("{} should contain '{}' procedure", stringify!($library_fn), full_path)
                 })
             });
     };