Solana: clarify V2 receive/compose docs (#169)

* update documentation for `LzReceiveTypesV2Accounts`

* Enhance documentation for `LzComposeTypesV2Accounts`

Author: ziming-zung

packages/layerzero-v2/solana/anchor-latest/libs/oapp/src/lz_compose_types_v2.rs

@@ -4,20 +4,31 @@ use endpoint_interface::COMPOSED_MESSAGE_HASH_SEED;
 
 pub const LZ_COMPOSE_TYPES_VERSION: u8 = 2;
 
-/// The payload returned from `lz_compose_types_info` when version == 2.
-/// Provides information needed to construct the call to `lz_compose_types_v2`.
+/// Return payload of `lz_compose_types_info` (version == 2).
+/// Used by the Executor to construct the call to `lz_compose_types_v2`.
 ///
-/// This structure is stored at a deterministic PDA and serves as the bridge between
-/// the version discovery phase and the actual execution planning phase of V2.
+/// `lz_compose_types_info` accounts:
+/// 1. `composer_account`: the Composer identity/account.
+/// 2. `lz_compose_types_accounts`: PDA derived with `seeds = [LZ_COMPOSE_TYPES_SEED,
+///    &composer_account.key().to_bytes()]`.
+/// The program reads this PDA to compute and return `LzComposeTypesV2Accounts`.
 ///
+/// Execution flow:
+/// 1. Version discovery: call `lz_compose_types_info`; when version is 2, decode into
+///    `LzComposeTypesV2Accounts`.
+/// 2. Execution planning: build the account metas for `lz_compose_types_v2` from the decoded value;
+///    calling `lz_compose_types_v2` returns the complete execution plan.
+///
+/// Fields:
+/// - `accounts`: `Pubkey`s returned by `lz_compose_types_info`.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
 pub struct LzComposeTypesV2Accounts {
     pub accounts: Vec<Pubkey>,
 }
 
 /// Output of the lz_compose_types_v2 instruction.
 ///
-/// This structure enables the multi-instruction execution model where OApps can
+/// This structure enables the multi-instruction execution model where Composer can
 /// define multiple instructions to be executed atomically by the Executor.
 /// The Executor constructs a single transaction containing all returned instructions.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
@@ -38,8 +49,8 @@ pub struct LzComposeTypesV2Result {
 /// The list of instructions that can be executed in the LzCompose transaction.
 ///
 /// V2's multi-instruction model enables complex patterns such as:
-/// - Preprocessing steps before lz_receive (e.g., account initialization)
-/// - Postprocessing steps after lz_receive (e.g., verification, cleanup)
+/// - Preprocessing steps before lz_compose (e.g., account initialization)
+/// - Postprocessing steps after lz_compose (e.g., verification, cleanup)
 /// - ABA messaging patterns with additional LayerZero sends
 /// - Conditional execution flows based on message content
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
@@ -52,7 +63,7 @@ pub enum Instruction {
         accounts: Vec<AccountMetaRef>,
     },
     /// Arbitrary custom instruction for preprocessing/postprocessing
-    /// Enables OApps to implement complex execution flows
+    /// Enables Composer to implement complex execution flows
     Standard {
         /// Target program ID for the custom instruction        
         program_id: Pubkey,

packages/layerzero-v2/solana/anchor-latest/libs/oapp/src/lz_receive_types_v2.rs

@@ -10,27 +10,23 @@ use endpoint_interface::{
 
 pub const LZ_RECEIVE_TYPES_VERSION: u8 = 2;
 
-/// The payload returned from `lz_receive_types_info` when version == 2.
-/// Provides information needed to construct the call to `lz_receive_types_v2`.
+/// Return payload of `lz_receive_types_info` (version == 2).
+/// Used by the Executor to construct the call to `lz_receive_types_v2`.
 ///
-/// This structure is stored at a deterministic PDA and serves as the bridge between
-/// the version discovery phase and the actual execution planning phase of V2.
+/// `lz_receive_types_info` accounts:
+/// 1. `oapp_account`: the OApp identity/account.
+/// 2. `lz_receive_types_accounts`: PDA derived with `seeds = [LZ_RECEIVE_TYPES_SEED,
+///    &oapp_account.key().to_bytes()]`.
+/// The program reads this PDA to compute and return `LzReceiveTypesV2Accounts`.
 ///
-/// # Execution Flow
-/// 1. **Version Discovery**: The Executor calls `lz_receive_types_info` using the PDA. If the
-///    version is 2, it decodes the returned payload into LzReceiveTypesV2Accounts.
-/// 2. **Execution Planning**: The Executor constructs the accounts from LzReceiveTypesV2Accounts to
-///    call `lz_receive_types_v2`, which returns the complete execution plan.
+/// Execution flow:
+/// 1. Version discovery: call `lz_receive_types_info`; when version is 2, decode into
+///    `LzReceiveTypesV2Accounts`.
+/// 2. Execution planning: build the account metas for `lz_receive_types_v2` from the decoded value;
+///    calling `lz_receive_types_v2` returns the complete execution plan.
 ///
-/// # Storage Location
-/// This data is stored at a PDA derived using:
-/// ```
-/// seeds = [LZ_RECEIVE_TYPES_SEED, &oapp_address.to_bytes()]
-/// ```
-///
-/// # Fields
-/// - `accounts`: A vector of `Pubkey` containing the static accounts needed to construct the
-///   `lz_receive_types_v2` instruction.
+/// Fields:
+/// - `accounts`: `Pubkey`s returned by `lz_receive_types_info`.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
 pub struct LzReceiveTypesV2Accounts {
     pub accounts: Vec<Pubkey>,

packages/layerzero-v2/solana/programs/libs/oapp/src/lz_compose_types_v2.rs

@@ -4,20 +4,31 @@ use endpoint::COMPOSED_MESSAGE_HASH_SEED;
 
 pub const LZ_COMPOSE_TYPES_VERSION: u8 = 2;
 
-/// The payload returned from `lz_compose_types_info` when version == 2.
-/// Provides information needed to construct the call to `lz_compose_types_v2`.
+/// Return payload of `lz_compose_types_info` (version == 2).
+/// Used by the Executor to construct the call to `lz_compose_types_v2`.
 ///
-/// This structure is stored at a deterministic PDA and serves as the bridge between
-/// the version discovery phase and the actual execution planning phase of V2.
+/// `lz_compose_types_info` accounts:
+/// 1. `composer_account`: the Composer identity/account.
+/// 2. `lz_compose_types_accounts`: PDA derived with `seeds = [LZ_COMPOSE_TYPES_SEED,
+///    &composer_account.key().to_bytes()]`.
+/// The program reads this PDA to compute and return `LzComposeTypesV2Accounts`.
 ///
+/// Execution flow:
+/// 1. Version discovery: call `lz_compose_types_info`; when version is 2, decode into
+///    `LzComposeTypesV2Accounts`.
+/// 2. Execution planning: build the account metas for `lz_compose_types_v2` from the decoded value;
+///    calling `lz_compose_types_v2` returns the complete execution plan.
+///
+/// Fields:
+/// - `accounts`: `Pubkey`s returned by `lz_compose_types_info`.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
 pub struct LzComposeTypesV2Accounts {
     pub accounts: Vec<Pubkey>,
 }
 
 /// Output of the lz_compose_types_v2 instruction.
 ///
-/// This structure enables the multi-instruction execution model where OApps can
+/// This structure enables the multi-instruction execution model where Composer can
 /// define multiple instructions to be executed atomically by the Executor.
 /// The Executor constructs a single transaction containing all returned instructions.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
@@ -38,8 +49,8 @@ pub struct LzComposeTypesV2Result {
 /// The list of instructions that can be executed in the LzCompose transaction.
 ///
 /// V2's multi-instruction model enables complex patterns such as:
-/// - Preprocessing steps before lz_receive (e.g., account initialization)
-/// - Postprocessing steps after lz_receive (e.g., verification, cleanup)
+/// - Preprocessing steps before lz_compose (e.g., account initialization)
+/// - Postprocessing steps after lz_compose (e.g., verification, cleanup)
 /// - ABA messaging patterns with additional LayerZero sends
 /// - Conditional execution flows based on message content
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
@@ -52,7 +63,7 @@ pub enum Instruction {
         accounts: Vec<AccountMetaRef>,
     },
     /// Arbitrary custom instruction for preprocessing/postprocessing
-    /// Enables OApps to implement complex execution flows
+    /// Enables Composer to implement complex execution flows
     Standard {
         /// Target program ID for the custom instruction        
         program_id: Pubkey,

packages/layerzero-v2/solana/programs/libs/oapp/src/lz_receive_types_v2.rs

@@ -10,27 +10,23 @@ use endpoint::{
 
 pub const LZ_RECEIVE_TYPES_VERSION: u8 = 2;
 
-/// The payload returned from `lz_receive_types_info` when version == 2.
-/// Provides information needed to construct the call to `lz_receive_types_v2`.
+/// Return payload of `lz_receive_types_info` (version == 2).
+/// Used by the Executor to construct the call to `lz_receive_types_v2`.
 ///
-/// This structure is stored at a deterministic PDA and serves as the bridge between
-/// the version discovery phase and the actual execution planning phase of V2.
+/// `lz_receive_types_info` accounts:
+/// 1. `oapp_account`: the OApp identity/account.
+/// 2. `lz_receive_types_accounts`: PDA derived with `seeds = [LZ_RECEIVE_TYPES_SEED,
+///    &oapp_account.key().to_bytes()]`.
+/// The program reads this PDA to compute and return `LzReceiveTypesV2Accounts`.
 ///
-/// # Execution Flow
-/// 1. **Version Discovery**: The Executor calls `lz_receive_types_info` using the PDA. If the
-///    version is 2, it decodes the returned payload into LzReceiveTypesV2Accounts.
-/// 2. **Execution Planning**: The Executor constructs the accounts from LzReceiveTypesV2Accounts to
-///    call `lz_receive_types_v2`, which returns the complete execution plan.
+/// Execution flow:
+/// 1. Version discovery: call `lz_receive_types_info`; when version is 2, decode into
+///    `LzReceiveTypesV2Accounts`.
+/// 2. Execution planning: build the account metas for `lz_receive_types_v2` from the decoded value;
+///    calling `lz_receive_types_v2` returns the complete execution plan.
 ///
-/// # Storage Location
-/// This data is stored at a PDA derived using:
-/// ```
-/// seeds = [LZ_RECEIVE_TYPES_SEED, &oapp_address.to_bytes()]
-/// ```
-///
-/// # Fields
-/// - `accounts`: A vector of `Pubkey` containing the static accounts needed to construct the
-///   `lz_receive_types_v2` instruction.
+/// Fields:
+/// - `accounts`: `Pubkey`s returned by `lz_receive_types_info`.
 #[derive(AnchorSerialize, AnchorDeserialize, Clone)]
 pub struct LzReceiveTypesV2Accounts {
     pub accounts: Vec<Pubkey>,