@layerzerolabs/oft-core-stellar-contracts 0.2.122

package/Cargo.toml

@@ -0,0 +1,38 @@
+[package]
+name = "oft-core"
+version = "0.0.1"
+edition = "2021"
+publish = false
+
+[lib]
+crate-type = ["rlib"]
+doctest = false
+
+[dependencies]
+soroban-sdk = { version = "25.1.1", features = ["hazmat-address", "hazmat-crypto"] }
+endpoint-v2 = { path = "dependencies/protocol-stellar-v2/endpoint-v2", default-features = false, features = ["library"] }
+utils = { path = "dependencies/common-utils-stellar-contracts" }
+common-macros = { path = "dependencies/common-utils-macros-stellar-contracts" }
+oapp = { path = "dependencies/oapp-stellar-contracts" }
+
+[dev-dependencies]
+soroban-sdk = { version = "25.1.1", features = ["hazmat-address", "hazmat-crypto", "testutils"] }
+simple-message-lib = { path = "dependencies/protocol-stellar-v2/message-libs/simple-message-lib" }
+message-lib-common = { path = "dependencies/protocol-stellar-v2/message-libs/message-lib-common", features = ["testutils"] }
+endpoint-v2 = { path = "dependencies/protocol-stellar-v2/endpoint-v2", features = ["testutils"] }
+utils = { path = "dependencies/common-utils-stellar-contracts", features = ["testutils"] }
+oapp-macros = { path = "dependencies/oapp-macros-stellar-contracts" }
+
+[profile.release]
+opt-level = "z"
+overflow-checks = true
+debug = 0
+strip = "symbols"
+debug-assertions = false
+panic = "abort"
+codegen-units = 1
+lto = true
+
+[profile.release-with-logs]
+inherits = "release"
+debug-assertions = true

package/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026 - LayerZero Labs Ltd.
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/clippy.toml

@@ -0,0 +1,6 @@
+# Clippy configuration for Stellar contracts
+
+# Set the too_many_arguments threshold to 11.
+# This aligns with Stellar: contract functions are limited to 10 parameters, plus 1 for 'env'.
+# (Default is 7; raised here to prevent unnecessary clippy warnings on valid contract interfaces.)
+too-many-arguments-threshold = 11

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@layerzerolabs/oft-core-stellar-contracts",
+  "version": "0.2.122",
+  "private": false,
+  "license": "MIT",
+  "files": [
+    "src",
+    "Cargo.toml",
+    "rust-toolchain.toml",
+    "rustfmt.toml",
+    "clippy.toml"
+  ],
+  "dependencies": {
+    "@layerzerolabs/common-utils-macros-stellar-contracts": "0.2.122",
+    "@layerzerolabs/oapp-stellar-contracts": "0.2.122",
+    "@layerzerolabs/common-utils-stellar-contracts": "0.2.122",
+    "@layerzerolabs/protocol-stellar-v2": "0.2.122",
+    "@layerzerolabs/oapp-macros-stellar-contracts": "0.2.122"
+  },
+  "devDependencies": {
+    "@layerzerolabs/build-utils-rust": "0.2.122",
+    "@layerzerolabs/vm-tooling-stellar": "0.2.122"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "externalRepoConfig": {
+    "targets": [
+      "audit-external",
+      "console-pen-test",
+      "monorepo-external",
+      "onesig-client"
+    ]
+  },
+  "implicitDependencies": {
+    "@layerzerolabs/oapp-stellar-contracts": "workspace:*",
+    "@layerzerolabs/protocol-stellar-v2": "workspace:*",
+    "@layerzerolabs/common-utils-stellar-contracts": "workspace:*",
+    "@layerzerolabs/common-utils-macros-stellar-contracts": "workspace:*",
+    "@layerzerolabs/oapp-macros-stellar-contracts": "workspace:*"
+  },
+  "scripts": {
+    "build": "pnpm resolve-dependencies && pnpm exec lz-tool --script \"cargo build --release\" stellar",
+    "clean": "rm -rf ./dependencies ./target ./node_modules",
+    "format": "pnpm exec lz-tool --script \"cargo fmt\" stellar",
+    "lint": "pnpm resolve-dependencies && pnpm exec lz-tool --script \"cargo clippy -- -D warnings\" stellar",
+    "lint:fix": "pnpm resolve-dependencies && pnpm exec lz-tool --script \"cargo clippy --fix --allow-dirty --allow-staged && cargo fmt\" stellar",
+    "resolve-dependencies": "pnpm exec build-utils-rust resolve",
+    "test": "pnpm resolve-dependencies && pnpm exec lz-tool --script \"cargo nextest run\" stellar",
+    "test:snapshot:check": "pnpm exec turbo-snapshot check",
+    "test:snapshot:update": "pnpm exec turbo-snapshot update"
+  }
+}

package/rust-toolchain.toml

@@ -0,0 +1,4 @@
+[toolchain]
+channel = "1.90.0"
+targets = ["wasm32v1-none"]
+components = ["rustfmt", "clippy"]

package/rustfmt.toml

@@ -0,0 +1,15 @@
+format_macro_bodies = true
+max_width = 120
+format_macro_matchers = true
+format_strings = true
+imports_granularity = "Crate"
+match_arm_blocks = false
+reorder_impl_items = true
+group_imports = "StdExternalCrate"
+use_field_init_shorthand = true
+use_small_heuristics = "Max"
+wrap_comments = true
+format_code_in_doc_comments = true
+
+# most of these are unstable, so we enable them
+unstable_features = true

package/src/codec/mod.rs

@@ -0,0 +1,2 @@
+pub mod oft_compose_msg_codec;
+pub mod oft_msg_codec;

package/src/codec/oft_compose_msg_codec.rs

@@ -0,0 +1,55 @@
+use soroban_sdk::{Bytes, BytesN, Env};
+use utils::{buffer_reader::BufferReader, buffer_writer::BufferWriter};
+
+/// Decoded compose message containing transfer context and payload execution
+#[derive(Clone, Debug)]
+pub struct OFTComposeMsg {
+    /// Unique sequence number for the cross-chain message packet
+    pub nonce: u64,
+    /// Source endpoint ID where the transfer originated
+    pub src_eid: u32,
+    /// Amount received in local decimals
+    pub amount_ld: i128,
+    /// Address that initiated the compose call on the source chain
+    pub compose_from: BytesN<32>,
+    /// Custom payload for compose logic execution
+    pub compose_msg: Bytes,
+}
+
+impl OFTComposeMsg {
+    /// Encodes the OFTComposeMsg struct into Bytes.
+    ///
+    /// # Arguments
+    /// * `env` - The Soroban environment
+    ///
+    /// # Returns
+    /// Encoded bytes representation of the compose message
+    pub fn encode(&self, env: &Env) -> Bytes {
+        let mut writer = BufferWriter::new(env);
+        writer
+            .write_u64(self.nonce)
+            .write_u32(self.src_eid)
+            .write_i128(self.amount_ld)
+            .write_bytes_n(&self.compose_from)
+            .write_bytes(&self.compose_msg)
+            .to_bytes()
+    }
+
+    /// Decodes Bytes into an OFTComposeMsg struct.
+    ///
+    /// # Arguments
+    /// * `bytes` - The encoded bytes to decode
+    ///
+    /// # Returns
+    /// Decoded OFTComposeMsg struct
+    pub fn decode(bytes: &Bytes) -> Self {
+        let mut reader = BufferReader::new(bytes);
+        let nonce = reader.read_u64();
+        let src_eid = reader.read_u32();
+        let amount_ld = reader.read_i128();
+        let compose_from = reader.read_bytes_n::<32>();
+        let compose_msg = reader.read_bytes_until_end();
+
+        OFTComposeMsg { nonce, src_eid, amount_ld, compose_from, compose_msg }
+    }
+}

package/src/codec/oft_msg_codec.rs

@@ -0,0 +1,58 @@
+use soroban_sdk::{Bytes, BytesN, Env};
+use utils::{buffer_reader::BufferReader, buffer_writer::BufferWriter};
+
+/// Decoded OFT message containing transfer details and optional compose data.
+///
+/// Wire format:
+/// ```text
+/// [send_to: 32 bytes][amount_sd: 8 bytes][compose_from: 32 bytes (optional)][compose_msg: variable (optional)]
+/// ```
+#[derive(Clone, Debug)]
+pub struct OFTMessage {
+    /// Recipient address on the destination chain
+    pub send_to: BytesN<32>,
+    /// Amount to transfer in shared decimals
+    pub amount_sd: u64,
+    /// Optional compose data for cross-chain composed calls
+    pub compose: Option<ComposeData>,
+}
+
+/// Initiator address and payload for a cross-chain composed call.
+#[derive(Clone, Debug)]
+pub struct ComposeData {
+    /// Address that initiated the compose call
+    pub from: BytesN<32>,
+    /// Compose message payload
+    pub msg: Bytes,
+}
+
+impl OFTMessage {
+    /// Encodes the OFTMessage into Bytes.
+    pub fn encode(&self, env: &Env) -> Bytes {
+        let mut writer = BufferWriter::new(env);
+        writer.write_bytes_n(&self.send_to).write_u64(self.amount_sd);
+
+        if let Some(ref compose_data) = self.compose {
+            writer.write_bytes_n(&compose_data.from).write_bytes(&compose_data.msg);
+        }
+
+        writer.to_bytes()
+    }
+
+    /// Decodes Bytes into an OFTMessage.
+    pub fn decode(message: &Bytes) -> Self {
+        let mut reader = BufferReader::new(message);
+        let send_to = reader.read_bytes_n::<32>();
+        let amount_sd = reader.read_u64();
+
+        let compose = if reader.remaining_len() > 0 {
+            let from = reader.read_bytes_n::<32>();
+            let msg = reader.read_bytes_until_end();
+            Some(ComposeData { from, msg })
+        } else {
+            None
+        };
+
+        OFTMessage { send_to, amount_sd, compose }
+    }
+}

package/src/errors.rs

@@ -0,0 +1,15 @@
+use common_macros::contract_error;
+
+// OFT library error codes: 3000-3099
+// See docs/error-spec.md for allocation rules
+
+/// OFTError: 3000-3099
+#[contract_error]
+pub enum OFTError {
+    InvalidAddress = 3000,
+    InvalidAmount,
+    InvalidLocalDecimals,
+    NotInitialized,
+    Overflow,
+    SlippageExceeded,
+}

package/src/events.rs

@@ -0,0 +1,32 @@
+use soroban_sdk::{contractevent, Address, BytesN};
+
+#[contractevent]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub struct OFTSent {
+    #[topic]
+    pub guid: BytesN<32>,
+    #[topic]
+    pub dst_eid: u32,
+    #[topic]
+    pub from: Address,
+    pub amount_sent_ld: i128,
+    pub amount_received_ld: i128,
+}
+
+#[contractevent]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub struct OFTReceived {
+    #[topic]
+    pub guid: BytesN<32>,
+    #[topic]
+    pub src_eid: u32,
+    #[topic]
+    pub to: Address,
+    pub amount_received_ld: i128,
+}
+
+#[contractevent]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub struct MsgInspectorSet {
+    pub inspector: Option<Address>,
+}

package/src/lib.rs

@@ -0,0 +1,22 @@
+#![no_std]
+
+pub mod events;
+pub mod storage;
+pub mod utils;
+
+mod codec;
+mod errors;
+mod oft_core;
+mod types;
+
+pub use codec::*;
+pub use errors::*;
+pub use oft_core::*;
+pub use types::*;
+
+#[cfg(test)]
+#[path = "../integration-tests/mod.rs"]
+mod integration_tests;
+
+#[cfg(test)]
+mod tests;