@layerzerolabs/protocol-stellar-v2 0.2.53 → 0.2.55

package/contracts/workers/executor-helper/src/executor_helper.rs

@@ -45,8 +45,16 @@ impl ExecutorHelper {
         executor.require_auth();
         if params.value != 0 {
             value_payer.require_auth();
+            transfer_value(env, value_payer, executor, params.value);
         }
-        Self::execute_internal(env, executor, params, value_payer);
+        LayerZeroReceiverClient::new(env, &params.receiver).lz_receive(
+            executor,
+            &params.origin,
+            &params.guid,
+            &params.message,
+            &params.extra_data,
+            &params.value,
+        );
     }
 
     /// Records a failed `lz_receive` execution for off-chain processing.
@@ -113,38 +121,6 @@ impl ExecutorHelper {
         ExecutorClient::new(env, executor).native_drop(admin, origin, &dst_eid, oapp, params);
     }
 
-    /// Executes `native_drop` followed by `lz_receive`.
-    pub fn native_drop_and_execute(
-        env: &Env,
-        executor: &Address,
-        admin: &Address,
-        origin: &Origin,
-        dst_eid: u32,
-        oapp: &Address,
-        native_drop_params: &Vec<NativeDropParams>,
-        execute_params: &ExecutionParams,
-    ) {
-        executor.require_auth();
-        admin.require_auth();
-        Self::native_drop(env, executor, admin, origin, dst_eid, oapp, native_drop_params);
-        Self::execute_internal(env, executor, execute_params, admin);
-    }
-
-    /// Internal execute logic without auth checks.
-    /// Callers (`execute` / `native_drop_and_execute`) are responsible for authorization.
-    fn execute_internal(env: &Env, executor: &Address, params: &ExecutionParams, value_payer: &Address) {
-        if params.value != 0 {
-            transfer_value(env, value_payer, executor, params.value);
-        }
-        LayerZeroReceiverClient::new(env, &params.receiver).lz_receive(
-            executor,
-            &params.origin,
-            &params.guid,
-            &params.message,
-            &params.extra_data,
-            &params.value,
-        );
-    }
 }
 
 #[inline]

package/contracts/workers/executor-helper/src/tests/executor_helper.rs

@@ -339,125 +339,3 @@ fn test_lz_compose_alert_with_empty_reason() {
     assert_eq!(record.unwrap().reason.len(), 0);
 }
 
-// =============================================================================
-// native_drop_and_execute() tests
-// =============================================================================
-
-#[test]
-fn test_native_drop_and_execute_calls_both() {
-    let setup = TestSetup::new();
-    let origin = setup.default_origin();
-    let dst_eid = 2u32;
-    let oapp = Address::generate(&setup.env);
-
-    let receiver1 = Address::generate(&setup.env);
-    let native_drop_params: Vec<NativeDropParams> =
-        vec![&setup.env, NativeDropParams { receiver: receiver1.clone(), amount: 10 }];
-
-    let execute_params = setup.default_execution_params();
-
-    setup.mock_all_auths();
-    setup.executor_helper_client.native_drop_and_execute(
-        &setup.executor,
-        &setup.admin,
-        &origin,
-        &dst_eid,
-        &oapp,
-        &native_drop_params,
-        &execute_params,
-    );
-
-    // Verify native_drop was called
-    let drop_record = setup.executor_client().get_native_drop();
-    assert!(drop_record.is_some());
-    let drop_record = drop_record.unwrap();
-    assert_eq!(drop_record.admin, setup.admin);
-    assert_eq!(drop_record.origin, origin);
-    assert_eq!(drop_record.dst_eid, dst_eid);
-    assert_eq!(drop_record.oapp, oapp);
-    assert_eq!(drop_record.params.len(), 1);
-    assert_eq!(drop_record.params.get(0).unwrap().receiver, receiver1);
-    assert_eq!(drop_record.params.get(0).unwrap().amount, 10);
-
-    // Verify lz_receive was also called
-    let receive_record = setup.receiver_client().get_lz_receive();
-    assert!(receive_record.is_some());
-    let receive_record = receive_record.unwrap();
-    assert_eq!(receive_record.executor, setup.executor);
-    assert_eq!(receive_record.origin, execute_params.origin);
-    assert_eq!(receive_record.guid, execute_params.guid);
-}
-
-#[test]
-fn test_native_drop_and_execute_with_empty_drop_params() {
-    let setup = TestSetup::new();
-    let origin = setup.default_origin();
-    let dst_eid = 1u32;
-    let oapp = Address::generate(&setup.env);
-    let native_drop_params: Vec<NativeDropParams> = vec![&setup.env];
-    let execute_params = setup.default_execution_params();
-
-    setup.mock_all_auths();
-    setup.executor_helper_client.native_drop_and_execute(
-        &setup.executor,
-        &setup.admin,
-        &origin,
-        &dst_eid,
-        &oapp,
-        &native_drop_params,
-        &execute_params,
-    );
-
-    // Verify native_drop was called with empty params
-    let drop_record = setup.executor_client().get_native_drop();
-    assert!(drop_record.is_some());
-    assert_eq!(drop_record.unwrap().params.len(), 0);
-
-    // Verify lz_receive was still called
-    let receive_record = setup.receiver_client().get_lz_receive();
-    assert!(receive_record.is_some());
-}
-
-#[test]
-fn test_native_drop_and_execute_with_value_transfer() {
-    let setup = TestSetup::new();
-    let origin = setup.default_origin();
-    let dst_eid = 2u32;
-    let oapp = Address::generate(&setup.env);
-
-    let receiver1 = Address::generate(&setup.env);
-    let native_drop_params: Vec<NativeDropParams> =
-        vec![&setup.env, NativeDropParams { receiver: receiver1.clone(), amount: 10 }];
-
-    let mut execute_params = setup.default_execution_params();
-    execute_params.value = 25; // Add value to trigger token transfer
-
-    // Mint tokens to admin (value payer)
-    setup.mint_native(&setup.admin, 100);
-    let admin_before = setup.balance_native(&setup.admin);
-    let executor_before = setup.balance_native(&setup.executor);
-
-    setup.mock_all_auths();
-    setup.executor_helper_client.native_drop_and_execute(
-        &setup.executor,
-        &setup.admin,
-        &origin,
-        &dst_eid,
-        &oapp,
-        &native_drop_params,
-        &execute_params,
-    );
-
-    // Verify token transfer occurred
-    assert_eq!(setup.balance_native(&setup.admin), admin_before - 25);
-    assert_eq!(setup.balance_native(&setup.executor), executor_before + 25);
-
-    // Verify both operations occurred
-    let drop_record = setup.executor_client().get_native_drop();
-    assert!(drop_record.is_some());
-    assert_eq!(drop_record.unwrap().params.len(), 1);
-
-    let receive_record = setup.receiver_client().get_lz_receive();
-    assert!(receive_record.is_some());
-    assert_eq!(receive_record.unwrap().value, 25);
-}

package/docs/oft-guide.md

@@ -11,6 +11,21 @@ An OFT enables cross-chain token transfers through LayerZero. The framework prov
 - **Token types**: MintBurn and LockUnlock strategies
 - **Extensions**: Pausable, fee collection, rate limiting
 
+### Classic Assets Receiving Requirements
+
+#### G-Address (EOA)
+
+G-address recipients must meet two prerequisites before they can receive classic assets:
+
+1. **Account activation**: The account must hold a minimum of 1 XLM to exist on the Stellar network.
+2. **Trustline**: The account must have an explicit trustline for the classic asset being received.
+
+If `lz_receive` fails due to unmet prerequisites, delivery can be retried once the recipient account is activated and the trustline is established.
+
+#### C-Address (Smart Contract)
+
+C-address recipients are not subject to these restrictions. As long as the contract address exists on-chain, it can receive assets directly.
+
 ## Architecture
 
 ```

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@layerzerolabs/protocol-stellar-v2",
-  "version": "0.2.53",
+  "version": "0.2.55",
   "private": false,
   "license": "LZBL-1.2",
   "devDependencies": {
     "@types/node": "^22.18.6",
     "tsx": "^4.19.3",
     "typescript": "^5.8.2",
-    "@layerzerolabs/common-node-utils": "0.2.53",
-    "@layerzerolabs/stellar-ts-bindings-gen": "0.2.53",
-    "@layerzerolabs/vm-tooling-stellar": "0.2.53"
+    "@layerzerolabs/common-node-utils": "0.2.55",
+    "@layerzerolabs/vm-tooling-stellar": "0.2.55",
+    "@layerzerolabs/stellar-ts-bindings-gen": "0.2.55"
   },
   "publishConfig": {
     "access": "restricted",