@layerzerolabs/protocol-stellar-v2 0.2.121 → 0.2.122

package/contracts/oapps/oapp/src/tests/test_macros.rs

@@ -1,434 +0,0 @@
-// ============================================================================
-// Test 1: Full OApp with all defaults
-// ============================================================================
-mod test_full_default {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::oapp_receiver::LzReceiveInternal;
-    use oapp_macros::oapp;
-    use soroban_sdk::{Address, Bytes, BytesN, Env};
-
-    #[oapp]
-    #[common_macros::lz_contract]
-    struct TestFullDefault;
-
-    impl LzReceiveInternal for TestFullDefault {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Default behavior
-        }
-    }
-}
-
-// ============================================================================
-// Test 2: Full OApp with manual core implementation
-// ============================================================================
-mod test_full_manual_core {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::oapp_core::OAppCore;
-    use oapp::oapp_receiver::LzReceiveInternal;
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [core])]
-    #[common_macros::lz_contract]
-    struct TestFullManualCore;
-
-    #[soroban_sdk::contractimpl(contracttrait)]
-    impl utils::rbac::RoleBasedAccessControl for TestFullManualCore {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppCore for TestFullManualCore {
-        fn oapp_version(_env: &Env) -> (u64, u64) {
-            (2, 0)
-        }
-    }
-
-    impl LzReceiveInternal for TestFullManualCore {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom logic
-        }
-    }
-}
-
-// ============================================================================
-// Test 3: Full OApp with manual sender implementation
-// ============================================================================
-mod test_full_manual_sender {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::oapp_receiver::LzReceiveInternal;
-    use oapp::oapp_sender::OAppSenderInternal;
-    use oapp_macros::oapp;
-    use soroban_sdk::{Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [sender])]
-    #[common_macros::lz_contract]
-    struct TestFullManualSender;
-
-    impl OAppSenderInternal for TestFullManualSender {
-        // Custom sender implementation
-    }
-
-    impl LzReceiveInternal for TestFullManualSender {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Implementation
-        }
-    }
-}
-
-// ============================================================================
-// Test 4: Full OApp with manual receiver implementation
-// ============================================================================
-mod test_full_manual_receiver {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::oapp_receiver::{LzReceiveInternal, OAppReceiver};
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [receiver])]
-    #[common_macros::lz_contract]
-    struct TestFullManualReceiver;
-
-    impl LzReceiveInternal for TestFullManualReceiver {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppReceiver for TestFullManualReceiver {
-        fn is_compose_msg_sender(_env: &Env, _origin: &Origin, _message: &Bytes, _sender: &Address) -> bool {
-            true
-        }
-
-        fn allow_initialize_path(_env: &Env, _origin: &Origin) -> bool {
-            true
-        }
-
-        fn next_nonce(_env: &Env, _src_eid: u32, _sender: &BytesN<32>) -> u64 {
-            1 // Ordered delivery
-        }
-    }
-}
-
-// ============================================================================
-// Test 5: Full OApp with manual options_type3 implementation
-// ============================================================================
-mod test_full_manual_options {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::oapp_options_type3::OAppOptionsType3;
-    use oapp::oapp_receiver::LzReceiveInternal;
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [options_type3])]
-    #[common_macros::lz_contract]
-    struct TestFullManualOptions;
-
-    impl LzReceiveInternal for TestFullManualOptions {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppOptionsType3 for TestFullManualOptions {
-        // Custom options implementation
-    }
-}
-
-// ============================================================================
-// Test 6: Full OApp with manual core + sender
-// ============================================================================
-mod test_full_manual_core_sender {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::{oapp_core::OAppCore, oapp_receiver::LzReceiveInternal, oapp_sender::OAppSenderInternal};
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [core, sender])]
-    #[common_macros::lz_contract]
-    struct TestFullManualCoreSender;
-
-    #[soroban_sdk::contractimpl(contracttrait)]
-    impl utils::rbac::RoleBasedAccessControl for TestFullManualCoreSender {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppCore for TestFullManualCoreSender {
-        fn oapp_version(_env: &Env) -> (u64, u64) {
-            (3, 0)
-        }
-    }
-
-    impl OAppSenderInternal for TestFullManualCoreSender {
-        // Custom sender implementation
-    }
-
-    impl LzReceiveInternal for TestFullManualCoreSender {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Implementation
-        }
-    }
-}
-
-// ============================================================================
-// Test 7: Full OApp with manual core + receiver
-// ============================================================================
-mod test_full_manual_core_receiver {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::{
-        oapp_core::OAppCore,
-        oapp_receiver::{LzReceiveInternal, OAppReceiver},
-    };
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [core, receiver])]
-    #[common_macros::lz_contract]
-    struct TestFullManualCoreReceiver;
-
-    #[soroban_sdk::contractimpl(contracttrait)]
-    impl utils::rbac::RoleBasedAccessControl for TestFullManualCoreReceiver {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppCore for TestFullManualCoreReceiver {
-        fn oapp_version(_env: &Env) -> (u64, u64) {
-            (4, 0)
-        }
-    }
-
-    impl LzReceiveInternal for TestFullManualCoreReceiver {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom receiver implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppReceiver for TestFullManualCoreReceiver {}
-}
-
-// ============================================================================
-// Test 8: Full OApp with manual sender + receiver
-// ============================================================================
-mod test_full_manual_sender_receiver {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::{
-        oapp_receiver::{LzReceiveInternal, OAppReceiver},
-        oapp_sender::OAppSenderInternal,
-    };
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [sender, receiver])]
-    #[common_macros::lz_contract]
-    struct TestFullManualSenderReceiver;
-
-    impl OAppSenderInternal for TestFullManualSenderReceiver {
-        // Custom sender implementation
-    }
-
-    impl LzReceiveInternal for TestFullManualSenderReceiver {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom receiver implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppReceiver for TestFullManualSenderReceiver {}
-}
-
-// ============================================================================
-// Test 9: Full OApp with manual core + sender + receiver (all except options)
-// ============================================================================
-mod test_full_manual_all_except_options {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::{
-        oapp_core::OAppCore,
-        oapp_receiver::{LzReceiveInternal, OAppReceiver},
-        oapp_sender::OAppSenderInternal,
-    };
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [core, sender, receiver])]
-    #[common_macros::lz_contract]
-    struct TestFullManualAllExceptOptions;
-
-    #[soroban_sdk::contractimpl(contracttrait)]
-    impl utils::rbac::RoleBasedAccessControl for TestFullManualAllExceptOptions {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppCore for TestFullManualAllExceptOptions {
-        fn oapp_version(_env: &Env) -> (u64, u64) {
-            (5, 0)
-        }
-    }
-
-    impl OAppSenderInternal for TestFullManualAllExceptOptions {
-        // Custom sender implementation
-    }
-
-    impl LzReceiveInternal for TestFullManualAllExceptOptions {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom receiver implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppReceiver for TestFullManualAllExceptOptions {}
-}
-
-// ============================================================================
-// Test 10: Full OApp with all manual implementations
-// ============================================================================
-mod test_full_manual_all {
-    extern crate self as oapp;
-
-    use endpoint_v2::Origin;
-    use oapp::{
-        oapp_core::OAppCore,
-        oapp_options_type3::OAppOptionsType3,
-        oapp_receiver::{LzReceiveInternal, OAppReceiver},
-        oapp_sender::OAppSenderInternal,
-    };
-    use oapp_macros::oapp;
-    use soroban_sdk::{contractimpl, Address, Bytes, BytesN, Env};
-
-    #[oapp(custom = [core, sender, receiver, options_type3])]
-    #[common_macros::lz_contract]
-    struct TestFullManualAll;
-
-    #[soroban_sdk::contractimpl(contracttrait)]
-    impl utils::rbac::RoleBasedAccessControl for TestFullManualAll {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppCore for TestFullManualAll {
-        fn oapp_version(_env: &Env) -> (u64, u64) {
-            (6, 0)
-        }
-    }
-
-    impl OAppSenderInternal for TestFullManualAll {
-        // Custom sender implementation
-    }
-
-    impl LzReceiveInternal for TestFullManualAll {
-        fn __lz_receive(
-            _env: &Env,
-            _origin: &Origin,
-            _guid: &BytesN<32>,
-            _message: &Bytes,
-            _extra_data: &Bytes,
-            _executor: &Address,
-            _value: i128,
-        ) {
-            // Custom receiver implementation
-        }
-    }
-
-    #[contractimpl(contracttrait)]
-    impl OAppReceiver for TestFullManualAll {}
-
-    #[contractimpl(contracttrait)]
-    impl OAppOptionsType3 for TestFullManualAll {
-        // Custom options implementation
-    }
-}
-
-// ============================================================================
-// Tests
-// ============================================================================
-
-#[test]
-fn test_macros_compile() {
-    // This test verifies that all macro combinations compile successfully
-    assert!(true);
-}

package/contracts/oapps/oapp-macros/Cargo.toml

@@ -1,18 +0,0 @@
-[package]
-name = "oapp-macros"
-version.workspace = true
-edition.workspace = true
-license.workspace = true
-publish = false
-
-[lib]
-proc-macro = true
-
-[dependencies]
-proc-macro2 = { workspace = true }
-quote = { workspace = true }
-syn = { workspace = true }
-
-[dev-dependencies]
-insta = { workspace = true }
-prettyplease = { workspace = true }

package/contracts/oapps/oapp-macros/src/generators.rs

@@ -1,147 +0,0 @@
-//! Code generators for OApp trait implementations.
-
-use proc_macro2::TokenStream;
-use quote::quote;
-use syn::{
-    bracketed,
-    parse::{Parse, ParseStream},
-    punctuated::Punctuated,
-    Error, Ident, ItemStruct, Token,
-};
-
-/// Specifies which OApp trait implementations the user will provide themselves.
-///
-/// Parsed from `#[oapp(custom = [...])]`. When a field is `true`, the macro skips
-/// generating that trait implementation, allowing the user to provide their own.
-#[derive(Debug, Clone, Copy, Default)]
-pub(crate) struct CustomImpls {
-    pub core: bool,
-    pub sender: bool,
-    pub receiver: bool,
-    pub options_type3: bool,
-}
-
-impl Parse for CustomImpls {
-    fn parse(input: ParseStream) -> syn::Result<Self> {
-        if input.is_empty() {
-            return Ok(Self::default());
-        }
-
-        // Consume the `custom` keyword
-        let key: Ident = input.parse()?;
-        if key != "custom" {
-            return Err(Error::new(key.span(), "expected `custom`"));
-        }
-
-        // Consume the `=` in `custom = [...]`
-        input.parse::<Token![=]>()?;
-
-        // Parse the `[...]` brackets and capture the inner tokens into `content`
-        let content;
-        bracketed!(content in input);
-
-        // Parse the comma-separated list of identifiers into `idents`
-        let idents = Punctuated::<Ident, Token![,]>::parse_terminated(&content)?;
-
-        // Initialize the custom implementations struct
-        let mut custom_impls = Self::default();
-
-        for ident in idents {
-            match ident.to_string().as_str() {
-                "core" => custom_impls.core = true,
-                "sender" => custom_impls.sender = true,
-                "receiver" => custom_impls.receiver = true,
-                "options_type3" => custom_impls.options_type3 = true,
-                _ => {
-                    return Err(Error::new(
-                        ident.span(),
-                        "expected one of `core`, `sender`, `receiver`, `options_type3`",
-                    ));
-                }
-            }
-        }
-
-        Ok(custom_impls)
-    }
-}
-
-/// Generates OApp trait implementations only. No contract-level attributes are applied.
-///
-/// This function creates OAppCore, OAppSenderInternal, OAppReceiver, and OAppOptionsType3 trait implementations.
-///
-/// **The user must apply a contract macro** such as `#[common_macros::lz_contract]` or
-/// `#[soroban_sdk::contract]` to the struct. `#[lz_contract]` provides contract, TTL, and Auth
-/// (via `#[ownable]` or `#[multisig]`) in one place.
-///
-/// The `custom` parameter controls which trait implementations are generated vs.
-/// expected to be provided by the user.
-pub fn generate_oapp(attr: TokenStream, input: TokenStream) -> TokenStream {
-    let custom: CustomImpls = syn::parse2(attr).unwrap_or_else(|e| panic!("failed to parse oapp attributes: {}", e));
-    let item_struct: ItemStruct = syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse struct: {}", e));
-
-    let core_impl = (!custom.core).then(|| generate_oapp_core(&item_struct.ident));
-    let sender_impl = (!custom.sender).then(|| generate_oapp_sender(&item_struct.ident));
-    let receiver_impl = (!custom.receiver).then(|| generate_oapp_receiver(&item_struct.ident));
-    let options_type3_impl = (!custom.options_type3).then(|| generate_oapp_options_type3(&item_struct.ident));
-    quote! {
-        #item_struct
-
-        #core_impl
-        #sender_impl
-        #receiver_impl
-        #options_type3_impl
-    }
-}
-
-/// Generates an empty `impl OAppCore` that uses the trait's default implementations
-/// for peer management and endpoint access.
-///
-/// Also generates `impl RoleBasedAccessControl` because OAppCore extends it.
-fn generate_oapp_core(name: &Ident) -> TokenStream {
-    quote! {
-        use oapp::oapp_core::OAppCore as _;
-        use utils::rbac::RoleBasedAccessControl as _;
-
-        #[soroban_sdk::contractimpl(contracttrait)]
-        impl oapp::oapp_core::OAppCore for #name {}
-
-        #[soroban_sdk::contractimpl(contracttrait)]
-        impl utils::rbac::RoleBasedAccessControl for #name {}
-    }
-}
-
-/// Generates the `OAppSenderInternal` trait implementation.
-///
-/// Generates an empty `impl OAppSenderInternal` that uses the trait's default
-/// implementations for `__lz_quote` and `__lz_send`.
-fn generate_oapp_sender(name: &Ident) -> TokenStream {
-    quote! {
-        use oapp::oapp_sender::OAppSenderInternal as _;
-
-        impl oapp::oapp_sender::OAppSenderInternal for #name {}
-    }
-}
-
-/// Generates an empty `impl OAppReceiver` that uses the trait's default `lz_receive`
-/// implementation (which calls `clear_payload_and_transfer` then `__lz_receive`).
-///
-/// Users must implement `LzReceiveInternal` themselves to provide the `__lz_receive` method.
-fn generate_oapp_receiver(name: &Ident) -> TokenStream {
-    quote! {
-        use oapp::oapp_receiver::OAppReceiver as _;
-
-        #[soroban_sdk::contractimpl(contracttrait)]
-        impl oapp::oapp_receiver::OAppReceiver for #name {}
-    }
-}
-
-/// Generates an empty `impl OAppOptionsType3` that uses the trait's default
-/// implementations for enforced options management.
-fn generate_oapp_options_type3(name: &Ident) -> TokenStream {
-    quote! {
-        use oapp::oapp_options_type3::OAppOptionsType3 as _;
-
-        #[soroban_sdk::contractimpl(contracttrait)]
-        impl oapp::oapp_options_type3::OAppOptionsType3 for #name {}
-    }
-}