@layerzerolabs/protocol-stellar-v2 0.2.21 → 0.2.23

package/contracts/macro-integration-tests/tests/ui/multisig/pass/basic.rs

@@ -0,0 +1,49 @@
+// UI (trybuild) test: minimal multisig usage compiles.
+//
+// Purpose:
+// - Verifies `#[common_macros::multisig]` can be applied on a contract struct.
+// - Verifies the macro-generated trait impls exist and are type-checkable from downstream code:
+//   - `utils::auth::Auth` trait impl for the contract (self-owning authorizer)
+//   - `utils::multisig::MultiSig` trait impl for the contract
+//
+// Note: renamed from `minimal_contract.rs` to `basic.rs` for consistency.
+
+use soroban_sdk::{contract, contractimpl, BytesN, Env, Vec};
+
+#[contract]
+#[common_macros::multisig]
+pub struct MyContract;
+
+#[contractimpl]
+impl MyContract {
+    pub fn smoke(env: Env) {
+        // Auth impl exists.
+        let _authorizer = <Self as utils::auth::Auth>::authorizer(&env);
+
+        // MultiSig APIs exist (view + mutation + verification).
+        let _threshold: u32 = <Self as utils::multisig::MultiSig>::threshold(&env);
+        let signer = BytesN::<20>::from_array(&env, &[1u8; 20]);
+        let _is_signer: bool = <Self as utils::multisig::MultiSig>::is_signer(&env, &signer);
+
+        let _signers: Vec<BytesN<20>> = <Self as utils::multisig::MultiSig>::get_signers(&env);
+        let _total_signers: u32 = <Self as utils::multisig::MultiSig>::total_signers(&env);
+
+        <Self as utils::multisig::MultiSig>::set_signer(&env, &signer, true);
+        <Self as utils::multisig::MultiSig>::set_threshold(&env, 1);
+
+        let digest = BytesN::<32>::from_array(&env, &[0u8; 32]);
+        let sig = BytesN::<65>::from_array(&env, &[0u8; 65]);
+        let mut signatures = Vec::<BytesN<65>>::new(&env);
+        signatures.push_back(sig);
+        <Self as utils::multisig::MultiSig>::verify_signatures(&env, &digest, &signatures);
+        <Self as utils::multisig::MultiSig>::verify_n_signatures(&env, &digest, &signatures, 1);
+    }
+
+    // `only_auth` should be usable with multisig contracts (they implement `Auth`).
+    #[common_macros::only_auth]
+    pub fn protected(env: Env) {
+        let _ = env;
+    }
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ownable/fail/non_struct_input.rs

@@ -0,0 +1,8 @@
+// UI (trybuild) negative test: `#[ownable]` must be applied to a struct.
+
+#[common_macros::ownable]
+pub enum NotAStruct {
+    A,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ownable/fail/non_struct_input.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/ownable/fail/non_struct_input.rs:3:1
+  |
+3 | #[common_macros::ownable]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse struct: expected `struct`

package/contracts/macro-integration-tests/tests/ui/ownable/fail/only_auth_missing_auth.rs

@@ -0,0 +1,19 @@
+// UI (trybuild) negative test: `#[only_auth]` requires `Self: utils::auth::Auth`.
+//
+// Purpose:
+// - Ensures we get a compile-time failure when a contract uses `#[only_auth]`
+//   without implementing the `Auth` trait (e.g. missing `#[ownable]` / `#[multisig]`).
+
+use soroban_sdk::{contract, Env};
+
+#[contract]
+pub struct MyContract;
+
+impl MyContract {
+    #[common_macros::only_auth]
+    pub fn protected(env: &Env) {
+        let _ = env;
+    }
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ownable/fail/only_auth_missing_auth.stderr

@@ -0,0 +1,12 @@
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ownable/fail/only_auth_missing_auth.rs:13:5
+   |
+13 |     #[common_macros::only_auth]
+   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `require_auth`
+  --> $WORKSPACE/contracts/utils/src/auth.rs
+   |
+   | pub fn require_auth<T: Auth>(env: &Env) {
+   |                        ^^^^ required by this bound in `require_auth`
+   = note: this error originates in the attribute macro `common_macros::only_auth` (in Nightly builds, run with -Z macro-backtrace for more info)

package/contracts/macro-integration-tests/tests/ui/ownable/fail/only_auth_missing_env.rs

@@ -4,7 +4,7 @@
 // - Ensures the macro fails compilation when applied to a function that does not accept `Env`.
 // - Validates the downstream UX: macro misuse should surface as a compile-time error.
 
-use soroban_sdk::{contract, contractimpl, Address};
+use soroban_sdk::{contract, contractimpl};
 
 #[contract]
 #[common_macros::ownable]

package/contracts/macro-integration-tests/tests/ui/ownable/fail/only_auth_missing_env.stderr

@@ -6,14 +6,6 @@ error: custom attribute panicked
    |
    = help: message: function must have an Env argument
 
-warning: unused import: `Address`
- --> tests/ui/ownable/fail/only_auth_missing_env.rs:7:43
-  |
-7 | use soroban_sdk::{contract, contractimpl, Address};
-  |                                           ^^^^^^^
-  |
-  = note: `#[warn(unused_imports)]` on by default
-
 error[E0599]: no function or associated item named `bad` found for struct `MyContract` in the current scope
   --> tests/ui/ownable/fail/only_auth_missing_env.rs:17:12
    |

package/contracts/macro-integration-tests/tests/ui/ownable/pass/basic.rs

@@ -0,0 +1,39 @@
+// UI (trybuild) test: consolidated `#[ownable]` pass coverage.
+//
+// This file covers the core `#[ownable]` "pass" surface area:
+// - OwnableInitializer helper (`init_owner`) and UFCS form
+// - Auth impl exists
+// - Ownable trait methods type-check
+// - Macro expansion doesn't rely on downstream trait imports
+
+use soroban_sdk::{contract, contractimpl, Address, Env};
+
+#[contract]
+#[common_macros::ownable]
+pub struct MyContract;
+
+#[contractimpl]
+impl MyContract {
+    pub fn init(env: Env, owner: Address) {
+        // `init_owner` helper exists.
+        Self::init_owner(&env, &owner);
+
+        // Also usable via fully-qualified trait path (doesn't rely on imports).
+        <Self as utils::ownable::OwnableInitializer>::init_owner(&env, &owner);
+
+        // Auth impl exists (type-check only).
+        let _authorizer: Address = <Self as utils::auth::Auth>::authorizer(&env);
+
+        // Ownable trait impl exists (type-check only).
+        let _owner: Option<Address> = <Self as utils::ownable::Ownable>::owner(&env);
+        let _pending_owner: Option<Address> = <Self as utils::ownable::Ownable>::pending_owner(&env);
+
+        // A couple key Ownable APIs type-check.
+        <Self as utils::ownable::Ownable>::transfer_ownership(&env, &owner);
+        <Self as utils::ownable::Ownable>::propose_ownership_transfer(&env, &owner, 1);
+        <Self as utils::ownable::Ownable>::accept_ownership(&env);
+        <Self as utils::ownable::Ownable>::renounce_ownership(&env);
+    }
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ownable/pass/only_auth_env_param_variants.rs

@@ -3,7 +3,7 @@
 // Purpose:
 // - Verifies `#[common_macros::only_auth]` can locate an `Env` argument in the function signature,
 //   even when `Env` is not the first parameter.
-// - Uses `&Env` forms to match the most common `require_auth` signature shape.
+// - Covers borrowed/owned, qualified paths, and `&mut Env`.
 
 use soroban_sdk::{contract, Env};
 
@@ -41,6 +41,12 @@ impl MyContract {
     pub fn f5(x: u32, env: soroban_sdk::Env) {
         let _ = (x, env);
     }
+
+    // Mutable reference Env
+    #[common_macros::only_auth]
+    pub fn f6(env: &mut Env) {
+        let _ = env;
+    }
 }
 
 fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/fail/invalid_storage_type_param.stderr

@@ -4,4 +4,4 @@ error: custom attribute panicked
 7 | #[common_macros::storage]
   | ^^^^^^^^^^^^^^^^^^^^^^^^^
   |
-  = help: message: failed to parse storage variant for Bad: storage type must be specified exactly once as '#[instance(Type)]', '#[persistent(Type)]', or '#[temporary(Type)]': got zero elements when exactly one was expected
+  = help: message: failed to parse storage type for #[persistent(...)] : expected one of: `for`, parentheses, `fn`, `unsafe`, `extern`, identifier, `::`, `<`, `dyn`, square brackets, `*`, `&`, `!`, `impl`, `_`, lifetime

package/contracts/macro-integration-tests/tests/ui/storage/fail/missing_storage_type_param.stderr

@@ -4,4 +4,4 @@ error: custom attribute panicked
 7 | #[common_macros::storage]
   | ^^^^^^^^^^^^^^^^^^^^^^^^^
   |
-  = help: message: failed to parse storage variant for Counter: storage type must be specified exactly once as '#[instance(Type)]', '#[persistent(Type)]', or '#[temporary(Type)]': got zero elements when exactly one was expected
+  = help: message: failed to parse storage type for #[instance(...)] : expected attribute arguments in parentheses: #[instance(...)]

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_default_values.rs

@@ -0,0 +1,11 @@
+// UI (trybuild) negative test: multiple `#[default(...)]` attributes are rejected.
+
+#[common_macros::storage]
+pub enum StorageKey {
+    #[persistent(u32)]
+    #[default(0)]
+    #[default(1)]
+    Counter,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_default_values.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/storage/fail/multiple_default_values.rs:3:1
+  |
+3 | #[common_macros::storage]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse storage variant for Counter: multiple default values specified: got at least 2 elements when exactly one was expected

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_name_attrs.rs

@@ -0,0 +1,11 @@
+// UI (trybuild) negative test: multiple `#[name("...")]` attributes are rejected.
+
+#[common_macros::storage]
+pub enum StorageKey {
+    #[persistent(u32)]
+    #[name("a")]
+    #[name("b")]
+    Counter,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_name_attrs.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/storage/fail/multiple_name_attrs.rs:3:1
+  |
+3 | #[common_macros::storage]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse storage variant for Counter: multiple name attributes specified: got at least 2 elements when exactly one was expected

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_no_ttl_extension.rs

@@ -0,0 +1,11 @@
+// UI (trybuild) negative test: multiple `#[no_ttl_extension]` attributes are rejected.
+
+#[common_macros::storage]
+pub enum StorageKey {
+    #[persistent(u32)]
+    #[no_ttl_extension]
+    #[no_ttl_extension]
+    Counter,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_no_ttl_extension.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/storage/fail/multiple_no_ttl_extension.rs:3:1
+  |
+3 | #[common_macros::storage]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse storage variant for Counter: multiple #[no_ttl_extension] attributes specified: got at least 2 elements when exactly one was expected

package/contracts/macro-integration-tests/tests/ui/storage/fail/multiple_type_params.stderr

@@ -4,4 +4,4 @@ error: custom attribute panicked
 6 | #[common_macros::storage]
   | ^^^^^^^^^^^^^^^^^^^^^^^^^
   |
-  = help: message: failed to parse storage variant for A: storage type must be specified exactly once as '#[instance(Type)]', '#[persistent(Type)]', or '#[temporary(Type)]': got zero elements when exactly one was expected
+  = help: message: failed to parse storage type for #[persistent(...)] : unexpected token

package/contracts/macro-integration-tests/tests/ui/storage/fail/no_ttl_extension_rejects_args.rs

@@ -0,0 +1,13 @@
+// UI (trybuild) negative test: `#[no_ttl_extension]` rejects arguments.
+//
+// Purpose:
+// - Boundary coverage for attribute parsing (Meta::Path only).
+
+#[common_macros::storage]
+pub enum StorageKey {
+    #[persistent(u32)]
+    #[no_ttl_extension(true)]
+    Value,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/fail/no_ttl_extension_rejects_args.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/storage/fail/no_ttl_extension_rejects_args.rs:6:1
+  |
+6 | #[common_macros::storage]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse storage variant for Value: #[no_ttl_extension] does not accept arguments

package/contracts/macro-integration-tests/tests/ui/storage/pass/api_surface.rs

@@ -0,0 +1,102 @@
+// UI (trybuild) test: generated storage API surface type-checks.
+//
+// Purpose:
+// - Ensures the macro-generated methods are callable with the intended signatures:
+//   - unit vs named-fields variants
+//   - primitive keys passed by value, non-primitive by reference
+//   - default getter return type is `T` (not `Option<T>`)
+//   - extend_ttl signatures differ for instance vs persistent/temporary
+
+use soroban_sdk::{Address, BytesN, Env};
+
+#[common_macros::storage]
+pub enum StorageKey {
+    // Unit instance storage.
+    #[instance(u32)]
+    Counter,
+
+    // Unit instance storage with a default value (getter returns u32).
+    #[instance(u32)]
+    #[default(0)]
+    CounterWithDefault,
+
+    // Persistent storage with non-primitive key (key passed by reference).
+    #[persistent(i128)]
+    Balance { key: BytesN<32> },
+
+    // Persistent storage + no_ttl_extension still generates the same API surface.
+    #[persistent(i128)]
+    #[no_ttl_extension]
+    BalanceNoTtl { key: BytesN<32> },
+
+    // Persistent storage with primitive key (key passed by value).
+    #[persistent(u32)]
+    PrimKey { key: u32 },
+
+    // Temporary storage with non-primitive key (key passed by reference).
+    #[temporary(bool)]
+    TempFlag { user: Address },
+
+    // Name override attribute changes generated function names.
+    #[instance(bool)]
+    #[name("custom_flag")]
+    Flag,
+}
+
+#[allow(dead_code)]
+fn typecheck_api(env: &Env, bytes: &BytesN<32>, addr: &Address) {
+    // Unit instance variant API
+    let _: Option<u32> = StorageKey::counter(env);
+    StorageKey::set_counter(env, &1u32);
+    StorageKey::set_or_remove_counter(env, &Some(1u32));
+    StorageKey::remove_counter(env);
+    let _: bool = StorageKey::has_counter(env);
+
+    // Unit instance + default getter return type
+    let _: u32 = StorageKey::counter_with_default(env);
+    StorageKey::set_counter_with_default(env, &2u32);
+    StorageKey::set_or_remove_counter_with_default(env, &Some(2u32));
+    StorageKey::remove_counter_with_default(env);
+    let _: bool = StorageKey::has_counter_with_default(env);
+
+    // Persistent + non-primitive key uses &BytesN<32>
+    let _: Option<i128> = StorageKey::balance(env, bytes);
+    StorageKey::set_balance(env, bytes, &5i128);
+    StorageKey::set_or_remove_balance(env, bytes, &Some(5i128));
+    StorageKey::remove_balance(env, bytes);
+    let _: bool = StorageKey::has_balance(env, bytes);
+    StorageKey::extend_balance_ttl(env, bytes, 1, 2);
+
+    // Persistent + no_ttl_extension (same signatures)
+    let _: Option<i128> = StorageKey::balance_no_ttl(env, bytes);
+    StorageKey::set_balance_no_ttl(env, bytes, &6i128);
+    StorageKey::set_or_remove_balance_no_ttl(env, bytes, &Some(6i128));
+    StorageKey::remove_balance_no_ttl(env, bytes);
+    let _: bool = StorageKey::has_balance_no_ttl(env, bytes);
+    StorageKey::extend_balance_no_ttl_ttl(env, bytes, 1, 2);
+
+    // Persistent + primitive key uses u32 by value
+    let _: Option<u32> = StorageKey::prim_key(env, 7u32);
+    StorageKey::set_prim_key(env, 7u32, &9u32);
+    StorageKey::set_or_remove_prim_key(env, 7u32, &Some(9u32));
+    StorageKey::remove_prim_key(env, 7u32);
+    let _: bool = StorageKey::has_prim_key(env, 7u32);
+    StorageKey::extend_prim_key_ttl(env, 7u32, 1, 2);
+
+    // Temporary + non-primitive key uses &Address
+    let _: Option<bool> = StorageKey::temp_flag(env, addr);
+    StorageKey::set_temp_flag(env, addr, &true);
+    StorageKey::set_or_remove_temp_flag(env, addr, &Some(true));
+    StorageKey::remove_temp_flag(env, addr);
+    let _: bool = StorageKey::has_temp_flag(env, addr);
+    StorageKey::extend_temp_flag_ttl(env, addr, 1, 2);
+
+    // Name override uses the custom name for method generation.
+    let _: Option<bool> = StorageKey::custom_flag(env);
+    StorageKey::set_custom_flag(env, &true);
+    StorageKey::set_or_remove_custom_flag(env, &Some(true));
+    StorageKey::remove_custom_flag(env);
+    let _: bool = StorageKey::has_custom_flag(env);
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/pass/basic.rs

@@ -0,0 +1,43 @@
+// UI (trybuild) test: consolidated storage macro "basic" pass coverage.
+//
+// This replaces several small fixtures by covering them all in one enum:
+// - instance unit variant
+// - default value on variant
+// - persistent named-fields (keyed) variant
+// - temporary unit variant with Option value type
+// - name override attribute
+// - no_ttl_extension (persistent only) + normal persistent variant
+
+use soroban_sdk::{Address, BytesN};
+
+#[common_macros::storage]
+pub enum StorageKey {
+    // Instance unit variant (basic).
+    #[instance(u32)]
+    Counter,
+
+    // Default value on variant (getter return type changes, covered elsewhere too).
+    #[instance(u32)]
+    #[default(0)]
+    CounterWithDefault,
+
+    // Persistent named-fields (keyed) variant (also covers "storage macro compiles" baseline).
+    #[persistent(i128)]
+    Balance { key: BytesN<32> },
+
+    // no_ttl_extension accepted on persistent variants.
+    #[persistent(i128)]
+    #[no_ttl_extension]
+    BalanceNoTtl { key: BytesN<32> },
+
+    // Temporary storage with Option value type.
+    #[temporary(Option<Address>)]
+    MaybeOwner,
+
+    // Name override attribute on a variant.
+    #[instance(bool)]
+    #[name("custom_flag")]
+    Flag,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/storage/pass/multi_key.rs

@@ -0,0 +1,38 @@
+// UI (trybuild) test: storage macro supports multi-field (named) keys.
+//
+// Purpose:
+// - Ensures named-fields variants with multiple fields generate correct signatures:
+//   - primitive key fields are passed by value
+//   - non-primitive key fields are passed by reference (and cloned into the key)
+
+use soroban_sdk::{Address, BytesN, Env};
+
+#[common_macros::storage]
+pub enum StorageKey {
+    // Mixed key fields: &Address (non-primitive) + u32 (primitive)
+    #[persistent(i128)]
+    Nonce { user: Address, nonce: u32 },
+
+    // Two non-primitive key fields: both by reference
+    #[temporary(bool)]
+    TempPair { a: BytesN<32>, b: BytesN<32> },
+}
+
+#[allow(dead_code)]
+fn typecheck_api(env: &Env, user: &Address, a: &BytesN<32>, b: &BytesN<32>) {
+    let _: Option<i128> = StorageKey::nonce(env, user, 1u32);
+    StorageKey::set_nonce(env, user, 1u32, &5i128);
+    StorageKey::set_or_remove_nonce(env, user, 1u32, &Some(5i128));
+    StorageKey::remove_nonce(env, user, 1u32);
+    let _: bool = StorageKey::has_nonce(env, user, 1u32);
+    StorageKey::extend_nonce_ttl(env, user, 1u32, 1, 2);
+
+    let _: Option<bool> = StorageKey::temp_pair(env, a, b);
+    StorageKey::set_temp_pair(env, a, b, &true);
+    StorageKey::set_or_remove_temp_pair(env, a, b, &Some(true));
+    StorageKey::remove_temp_pair(env, a, b);
+    let _: bool = StorageKey::has_temp_pair(env, a, b);
+    StorageKey::extend_temp_pair_ttl(env, a, b, 1, 2);
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/fail/missing_auth_trait.rs

@@ -0,0 +1,14 @@
+// UI (trybuild) negative test: `#[ttl_configurable]` requires `Self: utils::auth::Auth`.
+//
+// Purpose:
+// - Ensures we fail compilation when a contract uses `#[ttl_configurable]` without
+//   also implementing `Auth` (e.g. missing `#[ownable]` / `#[multisig]`).
+
+use common_macros::ttl_configurable;
+use soroban_sdk::contract;
+
+#[contract]
+#[ttl_configurable]
+pub struct MyContract;
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/fail/missing_auth_trait.stderr

@@ -0,0 +1,71 @@
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ttl_configurable/fail/missing_auth_trait.rs:12:12
+   |
+12 | pub struct MyContract;
+   |            ^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `TtlConfigurable`
+  --> $WORKSPACE/contracts/utils/src/ttl_configurable.rs
+   |
+   | pub trait TtlConfigurable: Auth {
+   |                            ^^^^ required by this bound in `TtlConfigurable`
+
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ttl_configurable/fail/missing_auth_trait.rs:12:12
+   |
+12 | pub struct MyContract;
+   |            ^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `set_ttl_configs`
+  --> $WORKSPACE/contracts/utils/src/ttl_configurable.rs
+   |
+   | pub trait TtlConfigurable: Auth {
+   |                            ^^^^ required by this bound in `TtlConfigurable::set_ttl_configs`
+...
+   |     fn set_ttl_configs(
+   |        --------------- required by a bound in this associated function
+
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ttl_configurable/fail/missing_auth_trait.rs:12:12
+   |
+12 | pub struct MyContract;
+   |            ^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `ttl_configs`
+  --> $WORKSPACE/contracts/utils/src/ttl_configurable.rs
+   |
+   | pub trait TtlConfigurable: Auth {
+   |                            ^^^^ required by this bound in `TtlConfigurable::ttl_configs`
+...
+   |     fn ttl_configs(
+   |        ----------- required by a bound in this associated function
+
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ttl_configurable/fail/missing_auth_trait.rs:12:12
+   |
+12 | pub struct MyContract;
+   |            ^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `freeze_ttl_configs`
+  --> $WORKSPACE/contracts/utils/src/ttl_configurable.rs
+   |
+   | pub trait TtlConfigurable: Auth {
+   |                            ^^^^ required by this bound in `TtlConfigurable::freeze_ttl_configs`
+...
+   |     fn freeze_ttl_configs(env: &soroban_sdk::Env) {
+   |        ------------------ required by a bound in this associated function
+
+error[E0277]: the trait bound `MyContract: utils::auth::Auth` is not satisfied
+  --> tests/ui/ttl_configurable/fail/missing_auth_trait.rs:12:12
+   |
+12 | pub struct MyContract;
+   |            ^^^^^^^^^^ the trait `utils::auth::Auth` is not implemented for `MyContract`
+   |
+note: required by a bound in `is_ttl_configs_frozen`
+  --> $WORKSPACE/contracts/utils/src/ttl_configurable.rs
+   |
+   | pub trait TtlConfigurable: Auth {
+   |                            ^^^^ required by this bound in `TtlConfigurable::is_ttl_configs_frozen`
+...
+   |     fn is_ttl_configs_frozen(env: &soroban_sdk::Env) -> bool {
+   |        --------------------- required by a bound in this associated function

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/fail/non_struct_input.rs

@@ -0,0 +1,8 @@
+// UI (trybuild) negative test: `#[ttl_configurable]` must be applied to a struct.
+
+#[common_macros::ttl_configurable]
+pub enum NotAStruct {
+    A,
+}
+
+fn main() {}

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/fail/non_struct_input.stderr

@@ -0,0 +1,7 @@
+error: custom attribute panicked
+ --> tests/ui/ttl_configurable/fail/non_struct_input.rs:3:1
+  |
+3 | #[common_macros::ttl_configurable]
+  | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  |
+  = help: message: failed to parse struct: expected `struct`

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/pass/{minimal_contract.rs → basic.rs}

@@ -5,6 +5,8 @@
 // - Validates the macro-generated `utils::ttl::TtlConfigurable` trait impl exists and is callable.
 // - Validates `#[ttl_extendable]` generates the `extend_instance_ttl` function.
 // - Avoids snapshotting token output; compilation success + type-checking is the integration contract.
+//
+// Note: renamed from `minimal_contract.rs` to `basic.rs` for consistency.
 
 use common_macros::{ownable, ttl_configurable, ttl_extendable};
 use soroban_sdk::{contract, contractimpl, Address, Env};

package/contracts/macro-integration-tests/tests/ui/ttl_configurable/pass/multisig_contract.rs

@@ -0,0 +1,28 @@
+// UI (trybuild) test: `#[ttl_configurable]` compiles with `#[multisig]` auth.
+//
+// Purpose:
+// - Ensures `#[common_macros::ttl_configurable]` works when the contract uses multisig auth.
+// - Type-checks the generated `TtlConfigurable` trait methods are callable.
+
+use common_macros::{multisig, ttl_configurable};
+use soroban_sdk::{contract, contractimpl, Env};
+use utils::ttl_configurable::TtlConfig;
+
+#[contract]
+#[ttl_configurable]
+#[multisig]
+pub struct MyContract;
+
+#[contractimpl]
+impl MyContract {
+    pub fn smoke(env: Env) {
+        let _cfg: (Option<TtlConfig>, Option<TtlConfig>) = Self::ttl_configs(&env);
+        let _frozen: bool = Self::is_ttl_configs_frozen(&env);
+
+        let none: Option<TtlConfig> = None;
+        Self::set_ttl_configs(&env, &none, &none);
+        Self::freeze_ttl_configs(&env);
+    }
+}
+
+fn main() {}