@layerzerolabs/protocol-stellar-v2 0.2.13 → 0.2.18

package/Cargo.lock

@@ -332,14 +332,26 @@ version = "0.0.1"
 dependencies = [
  "assert_unordered",
  "common-macros",
+ "dvn",
+ "dvn-fee-lib",
+ "ed25519-dalek",
  "endpoint-v2",
  "executor",
+ "executor-fee-lib",
+ "executor-helper",
+ "k256",
  "message-lib-common",
  "oapp",
  "oapp-macros",
+ "price-feed",
+ "rand",
+ "sha3",
  "simple-message-lib",
  "soroban-sdk",
+ "treasury",
+ "uln302",
  "utils",
+ "worker",
 ]
 
 [[package]]
@@ -609,7 +621,6 @@ dependencies = [
 name = "dvn-fee-lib"
 version = "0.0.1"
 dependencies = [
- "cfg-if",
  "common-macros",
  "message-lib-common",
  "soroban-sdk",
@@ -750,7 +761,6 @@ dependencies = [
 name = "executor-helper"
 version = "0.0.1"
 dependencies = [
- "cfg-if",
  "common-macros",
  "endpoint-v2",
  "executor",
@@ -1038,6 +1048,19 @@ dependencies = [
  "cpufeatures",
 ]
 
+[[package]]
+name = "layerzero-views"
+version = "0.0.1"
+dependencies = [
+ "cfg-if",
+ "common-macros",
+ "endpoint-v2",
+ "message-lib-common",
+ "soroban-sdk",
+ "uln302",
+ "utils",
+]
+
 [[package]]
 name = "libc"
 version = "0.2.177"
@@ -1056,6 +1079,19 @@ version = "0.4.28"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "34080505efa8e45a4b816c349525ebe327ceaa8559756f0356cba97ef3bf7432"
 
+[[package]]
+name = "macro-integration-tests"
+version = "0.0.1"
+dependencies = [
+ "common-macros",
+ "endpoint-v2",
+ "oapp",
+ "oapp-macros",
+ "soroban-sdk",
+ "trybuild",
+ "utils",
+]
+
 [[package]]
 name = "macro-string"
 version = "0.1.4"
@@ -1182,9 +1218,11 @@ version = "0.0.1"
 dependencies = [
  "common-macros",
  "endpoint-v2",
+ "message-lib-common",
  "oapp",
  "oapp-macros",
  "oft",
+ "simple-message-lib",
  "soroban-sdk",
  "utils",
 ]
@@ -1259,7 +1297,6 @@ name = "price-feed"
 version = "0.0.1"
 dependencies = [
  "common-macros",
- "endpoint-v2",
  "soroban-sdk",
  "utils",
  "worker",
@@ -1471,6 +1508,15 @@ dependencies = [
  "serde_core",
 ]
 
+[[package]]
+name = "serde_spanned"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8bbf91e5a4d6315eee45e704372590b30e260ee83af6639d64557f51b067776"
+dependencies = [
+ "serde_core",
+]
+
 [[package]]
 name = "serde_with"
 version = "3.15.1"
@@ -1910,6 +1956,21 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "target-triple"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "591ef38edfb78ca4771ee32cf494cb8771944bee237a9b91fc9c1424ac4b777b"
+
+[[package]]
+name = "termcolor"
+version = "1.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
+dependencies = [
+ "winapi-util",
+]
+
 [[package]]
 name = "thiserror"
 version = "1.0.69"
@@ -1961,6 +2022,45 @@ dependencies = [
  "time-core",
 ]
 
+[[package]]
+name = "toml"
+version = "0.9.10+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0825052159284a1a8b4d6c0c86cbc801f2da5afd2b225fa548c72f2e74002f48"
+dependencies = [
+ "indexmap 2.12.0",
+ "serde_core",
+ "serde_spanned",
+ "toml_datetime",
+ "toml_parser",
+ "toml_writer",
+ "winnow",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "0.7.5+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92e1cfed4a3038bc5a127e35a2d360f145e1f4b971b551a2ba5fd7aedf7e1347"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "toml_parser"
+version = "1.0.6+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a3198b4b0a8e11f09dd03e133c0280504d0801269e9afa46362ffde1cbeebf44"
+dependencies = [
+ "winnow",
+]
+
+[[package]]
+name = "toml_writer"
+version = "1.0.6+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab16f14aed21ee8bfd8ec22513f7287cd4a91aa92e44edfe2c17ddd004e92607"
+
 [[package]]
 name = "treasury"
 version = "0.0.1"
@@ -1974,6 +2074,21 @@ dependencies = [
  "utils",
 ]
 
+[[package]]
+name = "trybuild"
+version = "1.0.114"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3e17e807bff86d2a06b52bca4276746584a78375055b6e45843925ce2802b335"
+dependencies = [
+ "glob",
+ "serde",
+ "serde_derive",
+ "serde_json",
+ "target-triple",
+ "termcolor",
+ "toml",
+]
+
 [[package]]
 name = "ts-bindings-gen"
 version = "0.0.1"
@@ -2006,6 +2121,15 @@ version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
 
+[[package]]
+name = "upgrader"
+version = "0.0.1"
+dependencies = [
+ "common-macros",
+ "soroban-sdk",
+ "utils",
+]
+
 [[package]]
 name = "utils"
 version = "0.0.1"
@@ -2136,6 +2260,15 @@ version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
 
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys",
+]
+
 [[package]]
 name = "winapi-x86_64-pc-windows-gnu"
 version = "0.4.0"
@@ -2274,6 +2407,12 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
 
+[[package]]
+name = "winnow"
+version = "0.7.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a5364e9d77fcdeeaa6062ced926ee3381faa2ee02d3eb83a5c27a8825540829"
+
 [[package]]
 name = "worker"
 version = "0.0.1"

package/Cargo.toml

@@ -20,8 +20,9 @@ hex-literal = "1.0.0"
 endpoint-v2 = { path = "contracts/endpoint-v2", default-features = false }
 utils = { path = "contracts/utils" }
 common-macros = { path = "contracts/common-macros" }
-oapp-macros = { path = "contracts/oapp-macros" }
+oapp-macros = { path = "contracts/oapps/oapp-macros" }
 message-lib-common = { path = "contracts/message-libs/message-lib-common" }
+uln302 = { path = "contracts/message-libs/uln-302", default-features = false }
 oapp = { path = "contracts/oapps/oapp" }
 simple-message-lib = { path = "contracts/message-libs/simple-message-lib" }
 treasury = { path = "contracts/message-libs/treasury" }
@@ -29,6 +30,9 @@ worker = { path = "contracts/workers/worker" }
 executor = { path = "contracts/workers/executor" }
 executor-helper = { path = "contracts/workers/executor-helper" }
 executor-fee-lib = { path = "contracts/workers/executor-fee-lib" }
+dvn = { path = "contracts/workers/dvn" }
+dvn-fee-lib = { path = "contracts/workers/dvn-fee-lib" }
+price-feed = { path = "contracts/workers/price-feed" }
 oft = { path = "contracts/oapps/oft" }
 stellar-macros = { git = "https://github.com/OpenZeppelin/stellar-contracts.git", tag = "v0.5.1" }
 stellar-tokens = { git = "https://github.com/OpenZeppelin/stellar-contracts.git", tag = "v0.5.1" }

package/contracts/ERROR_SPEC.md

@@ -0,0 +1,44 @@
+# Stellar LayerZero Protocol - Error Code Specification
+
+This document defines the error code allocation strategy for the Stellar LayerZero contracts.
+
+## Purpose
+
+Each library has a unique error code range to:
+
+- **Prevent collisions**: Avoid error code conflicts between different libraries
+- **Enable traceability**: Quickly identify which library an error originated from based on its code
+- **Simplify debugging**: Error codes are globally unique, making it easier to track and diagnose issues
+
+## Allocation Rules
+
+- **Library allocation**: Each library is allocated a 100-unit block (e.g., 1000-1099, 1100-1199). Total errors in one library should not exceed 100.
+- **Sub-range allocation**: Each error type within a library is allocated a 10-unit block. Example from `utils` (1000-1099):
+
+    - BufferReaderError: 1000-1009
+    - BufferWriterError: 1010-1019
+    - TtlConfigurableError: 1020-1029
+    - OwnableError: 1030-1039
+    - BytesExtError: 1040-1049
+    - UpgradeableError: 1050-1059
+    - MultisigError: 1060-1069
+
+    If an error type exceeds 10 errors (e.g., 12 errors), it extends into the next block but the following error type should start at the next 10-unit boundary (e.g., if errors are 1000-1011, next sub-range starts at 1020).
+
+- **Auto-increment**: Within each error enum, values auto-increment from the starting value.
+
+## Error Code Ranges
+
+| Range       | Category        | Library            | Description                                                  |
+| ----------- | --------------- | ------------------ | ------------------------------------------------------------ |
+| 1 - 999     | Contract Errors | -                  | Application-specific contract errors (auto-increment from 1) |
+| 1000 - 1099 | Protocol Lib    | utils              | `utils/src/errors.rs`                                        |
+| 1100 - 1199 | Protocol Lib    | message-lib-common | `message-libs/message-lib-common/src/errors.rs`              |
+| 1200 - 1299 | Protocol Lib    | worker             | `workers/worker/src/errors.rs`                               |
+| 1300 - 1999 | Protocol Lib    | (reserved)         | Future protocol libs                                         |
+| 2000 - 2099 | OApp Lib        | oapp               | `oapps/oapp/src/errors.rs`                                   |
+| 2100 - 2999 | OApp Lib        | (reserved)         | Future OApp libs                                             |
+| 3000 - 3099 | OFT Lib         | oft                | `oapps/oft/src/errors.rs`                                    |
+| 3100 - 3999 | OFT Lib         | (reserved)         | Future OFT libs                                              |
+
+---

package/contracts/common-macros/src/auth.rs

@@ -0,0 +1,113 @@
+//! Authorization macros for Stellar contracts.
+//!
+//! This module provides macros for implementing authorization patterns:
+//! - `#[ownable]` - Owner-based access control (external owner address)
+//! - `#[multisig]` - Multisig-based access control (self-owning pattern)
+//! - `#[only_auth]` - Authorization check attribute for functions
+
+use crate::utils;
+use proc_macro2::TokenStream;
+use quote::{quote, ToTokens};
+use syn::{parse_quote, ItemFn, ItemStruct};
+
+// ============================================================================
+// Ownable Macro Implementation
+// ============================================================================
+
+/// Generates the ownable implementation from the `#[ownable]` attribute macro.
+///
+/// This macro implements both `Auth` and `Ownable` traits for the contract:
+/// - `Auth::authorizer()` returns the stored owner address
+/// - `Ownable` provides ownership management (transfer, renounce)
+pub fn generate_ownable_impl(input: TokenStream) -> TokenStream {
+    let item_struct: ItemStruct = syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse struct: {}", e));
+    let name = &item_struct.ident;
+    let impl_mod = utils::impl_mod_ident(name, "ownable");
+
+    quote! {
+        #item_struct
+
+        use utils::{auth::Auth as _, ownable::{Ownable as _, OwnableInitializer as _}};
+
+        #[doc(hidden)]
+        mod #impl_mod {
+            use super::*;
+            use utils::{
+                auth::Auth,
+                errors::OwnableError,
+                option_ext::OptionExt as _,
+                ownable::{Ownable, OwnableInitializer},
+            };
+
+            impl OwnableInitializer for #name {}
+
+            #[common_macros::contract_impl]
+            impl Auth for #name {
+                fn authorizer(env: &soroban_sdk::Env) -> soroban_sdk::Address {
+                    <Self as Ownable>::owner(env).unwrap_or_panic(env, OwnableError::OwnerNotSet)
+                }
+            }
+
+            #[common_macros::contract_impl(contracttrait)]
+            impl Ownable for #name {}
+        }
+    }
+}
+
+// ============================================================================
+// Multisig Macro Implementation
+// ============================================================================
+
+/// Generates the multisig implementation from the `#[multisig]` attribute macro.
+///
+/// This macro implements both `Auth` and `Multisig` traits for the contract:
+/// - `Auth::authorizer()` returns the contract's own address (self-owning pattern)
+/// - `Multisig` provides signature verification and signer management
+pub fn generate_multisig_impl(input: TokenStream) -> TokenStream {
+    let item_struct: ItemStruct = syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse struct: {}", e));
+    let name = &item_struct.ident;
+    let impl_mod = utils::impl_mod_ident(name, "multisig");
+
+    quote! {
+        #item_struct
+
+        use utils::{auth::Auth as _, multisig::Multisig as _};
+
+        #[doc(hidden)]
+        mod #impl_mod {
+            use super::*;
+            use utils::{auth::Auth, multisig::Multisig};
+
+            #[common_macros::contract_impl]
+            impl Auth for #name {
+                fn authorizer(env: &soroban_sdk::Env) -> soroban_sdk::Address {
+                    env.current_contract_address()
+                }
+            }
+
+            #[common_macros::contract_impl(contracttrait)]
+            impl Multisig for #name {}
+        }
+    }
+}
+
+// ============================================================================
+// Only Auth Macro Implementation
+// ============================================================================
+
+/// Prepends an auth check to a method using the `Auth` trait.
+///
+/// Works with any contract that implements the `Auth` trait, including both
+/// `Ownable` and `Multisig` contracts.
+pub fn prepend_only_auth_check(input: TokenStream) -> TokenStream {
+    let mut input_fn: ItemFn = syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse function: {}", e));
+
+    let env_param = utils::expect_env_param(&input_fn.sig.inputs);
+
+    // Get a reference to env (handles both `Env` and `&Env` parameter types)
+    let env_ref = env_param.as_ref_tokens();
+
+    // Insert the auth check at the beginning of the function body
+    input_fn.block.stmts.insert(0, parse_quote!(utils::auth::require_auth::<Self>(#env_ref);));
+    input_fn.into_token_stream()
+}

package/contracts/common-macros/src/contract_ttl.rs

@@ -0,0 +1,84 @@
+use crate::utils;
+use proc_macro2::TokenStream;
+use quote::quote;
+use syn::{ImplItem, ItemImpl, ItemTrait, TraitItem, Visibility};
+
+/// Generates a `#[soroban_sdk::contractimpl]` with automatic instance TTL extension.
+pub fn contractimpl_with_ttl(attr: TokenStream, input: TokenStream) -> TokenStream {
+    let mut impl_block: ItemImpl = syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse impl block: {}", e));
+
+    let is_trait_impl = impl_block.trait_.is_some();
+
+    for item in &mut impl_block.items {
+        let ImplItem::Fn(method) = item else { continue };
+
+        // For trait impls, process all methods; for inherent impls, only public methods
+        if !is_trait_impl && !matches!(method.vis, Visibility::Public(_)) {
+            continue;
+        }
+
+        // Skip the constructor as TTL config is typically not set during initialization
+        if method.sig.ident == "__constructor" {
+            continue;
+        }
+
+        // Skip methods without Env parameter
+        let Some(env_param) = utils::find_env_param(&method.sig.inputs) else { continue };
+
+        // Inject TTL extension at the start of the method body
+        method.block.stmts.insert(0, extend_instance_ttl_stmt(&env_param));
+    }
+
+    let contract_attr = if attr.is_empty() {
+        quote! { #[soroban_sdk::contractimpl]}
+    } else {
+        quote! { #[soroban_sdk::contractimpl(#attr)] }
+    };
+    quote! {
+        #contract_attr
+        #impl_block
+    }
+}
+
+/// Generates a `#[soroban_sdk::contracttrait]` with automatic instance TTL extension.
+///
+/// This macro processes trait definitions and injects TTL extension logic into
+/// default method implementations that have an `Env` parameter.
+pub fn contracttrait_with_ttl(attr: TokenStream, input: TokenStream) -> TokenStream {
+    let mut trait_def: ItemTrait =
+        syn::parse2(input).unwrap_or_else(|e| panic!("failed to parse trait definition: {}", e));
+
+    for item in &mut trait_def.items {
+        let TraitItem::Fn(method) = item else { continue };
+
+        // Only process methods with default implementations (have a body)
+        let Some(ref mut block) = method.default else { continue };
+
+        // Skip methods without Env parameter
+        let Some(env_param) = utils::find_env_param(&method.sig.inputs) else { continue };
+
+        // Inject TTL extension at the start of the method body
+        block.stmts.insert(0, extend_instance_ttl_stmt(&env_param));
+    }
+
+    let trait_attr = if attr.is_empty() {
+        quote! { #[soroban_sdk::contracttrait]}
+    } else {
+        quote! { #[soroban_sdk::contracttrait(#attr)] }
+    };
+    quote! {
+        #trait_attr
+        #trait_def
+    }
+}
+
+/// Generates a statement that extends instance TTL if configured.
+fn extend_instance_ttl_stmt(env_param: &utils::EnvParam<'_>) -> syn::Stmt {
+    let env_ref = env_param.as_ref_tokens();
+    let env_ident = env_param.ident;
+    syn::parse_quote! {
+        if let Some(instance_ttl) = utils::ttl_configurable::TtlConfigStorage::instance(#env_ref) {
+            #env_ident.storage().instance().extend_ttl(instance_ttl.threshold, instance_ttl.extend_to);
+        }
+    }
+}