smartcontract: add Index PDA derivation to Rust SDK commands

Update Rust SDK multicast group commands to derive and pass Index
PDAs for create, update, get, delete, and deactivate operations.
Add Index command wrappers for standalone create/delete. Update
allowlist commands with Index account support.

Author: martinsander00

smartcontract/sdk/rs/src/commands/index/create.rs

@@ -0,0 +1,44 @@
+use crate::{commands::globalstate::get::GetGlobalStateCommand, DoubleZeroClient};
+use doublezero_program_common::validate_account_code;
+use doublezero_serviceability::{
+    instructions::DoubleZeroInstruction, pda::get_index_pda,
+    processors::index::create::IndexCreateArgs,
+};
+use solana_sdk::{instruction::AccountMeta, pubkey::Pubkey, signature::Signature};
+
+#[derive(Debug, PartialEq, Clone)]
+pub struct CreateIndexCommand {
+    pub entity_seed: String,
+    pub code: String,
+    pub entity_pubkey: Pubkey,
+}
+
+impl CreateIndexCommand {
+    pub fn execute(&self, client: &dyn DoubleZeroClient) -> eyre::Result<(Signature, Pubkey)> {
+        let code =
+            validate_account_code(&self.code).map_err(|err| eyre::eyre!("invalid code: {err}"))?;
+
+        let (globalstate_pubkey, _) = GetGlobalStateCommand
+            .execute(client)
+            .map_err(|_err| eyre::eyre!("Globalstate not initialized"))?;
+
+        let (index_pda, _) =
+            get_index_pda(&client.get_program_id(), self.entity_seed.as_bytes(), &code);
+
+        let accounts = vec![
+            AccountMeta::new(index_pda, false),
+            AccountMeta::new_readonly(self.entity_pubkey, false),
+            AccountMeta::new_readonly(globalstate_pubkey, false),
+        ];
+
+        client
+            .execute_transaction(
+                DoubleZeroInstruction::CreateIndex(IndexCreateArgs {
+                    entity_seed: self.entity_seed.clone(),
+                    code,
+                }),
+                accounts,
+            )
+            .map(|sig| (sig, index_pda))
+    }
+}

smartcontract/sdk/rs/src/commands/index/delete.rs

@@ -0,0 +1,28 @@
+use crate::{commands::globalstate::get::GetGlobalStateCommand, DoubleZeroClient};
+use doublezero_serviceability::{
+    instructions::DoubleZeroInstruction, processors::index::delete::IndexDeleteArgs,
+};
+use solana_sdk::{instruction::AccountMeta, pubkey::Pubkey, signature::Signature};
+
+#[derive(Debug, PartialEq, Clone)]
+pub struct DeleteIndexCommand {
+    pub index_pubkey: Pubkey,
+}
+
+impl DeleteIndexCommand {
+    pub fn execute(&self, client: &dyn DoubleZeroClient) -> eyre::Result<Signature> {
+        let (globalstate_pubkey, _) = GetGlobalStateCommand
+            .execute(client)
+            .map_err(|_err| eyre::eyre!("Globalstate not initialized"))?;
+
+        let accounts = vec![
+            AccountMeta::new(self.index_pubkey, false),
+            AccountMeta::new_readonly(globalstate_pubkey, false),
+        ];
+
+        client.execute_transaction(
+            DoubleZeroInstruction::DeleteIndex(IndexDeleteArgs {}),
+            accounts,
+        )
+    }
+}

smartcontract/sdk/rs/src/commands/index/mod.rs

@@ -0,0 +1,2 @@
+pub mod create;
+pub mod delete;

smartcontract/sdk/rs/src/commands/mod.rs

@@ -5,6 +5,7 @@ pub mod device;
 pub mod exchange;
 pub mod globalconfig;
 pub mod globalstate;
+pub mod index;
 pub mod link;
 pub mod location;
 pub mod migrate;

smartcontract/sdk/rs/src/commands/multicastgroup/allowlist/publisher/add.rs

@@ -93,6 +93,11 @@ mod tests {
                 map.insert(pubkey, AccountData::MulticastGroup(cloned_mgroup.clone()));
                 Ok(map)
             });
+        // Catch-all for Index PDA lookups
+        client
+            .expect_get()
+            .with(predicate::always())
+            .returning(|_| Err(eyre::eyre!("Account not found")));
         client
             .expect_execute_transaction()
             .with(

smartcontract/sdk/rs/src/commands/multicastgroup/allowlist/publisher/remove.rs

@@ -95,6 +95,11 @@ mod tests {
                 map.insert(pubkey, AccountData::MulticastGroup(cloned_mgroup.clone()));
                 Ok(map)
             });
+        // Catch-all for Index PDA lookups
+        client
+            .expect_get()
+            .with(predicate::always())
+            .returning(|_| Err(eyre::eyre!("Account not found")));
         client
             .expect_execute_transaction()
             .with(

smartcontract/sdk/rs/src/commands/multicastgroup/allowlist/subscriber/add.rs

@@ -95,6 +95,11 @@ mod tests {
                 map.insert(pubkey, AccountData::MulticastGroup(cloned_mgroup.clone()));
                 Ok(map)
             });
+        // Catch-all for Index PDA lookups
+        client
+            .expect_get()
+            .with(predicate::always())
+            .returning(|_| Err(eyre::eyre!("Account not found")));
         client
             .expect_execute_transaction()
             .with(

smartcontract/sdk/rs/src/commands/multicastgroup/allowlist/subscriber/remove.rs

@@ -95,6 +95,11 @@ mod tests {
                 map.insert(pubkey, AccountData::MulticastGroup(cloned_mgroup.clone()));
                 Ok(map)
             });
+        // Catch-all for Index PDA lookups
+        client
+            .expect_get()
+            .with(predicate::always())
+            .returning(|_| Err(eyre::eyre!("Account not found")));
         client
             .expect_execute_transaction()
             .with(

smartcontract/sdk/rs/src/commands/multicastgroup/create.rs

@@ -1,9 +1,10 @@
 use doublezero_program_common::validate_account_code;
 use doublezero_serviceability::{
     instructions::DoubleZeroInstruction,
-    pda::{get_multicastgroup_pda, get_resource_extension_pda},
+    pda::{get_index_pda, get_multicastgroup_pda, get_resource_extension_pda},
     processors::multicastgroup::create::MulticastGroupCreateArgs,
     resource::ResourceType,
+    seeds::SEED_MULTICAST_GROUP,
     state::feature_flags::{is_feature_enabled, FeatureFlag},
 };
 use solana_sdk::{instruction::AccountMeta, pubkey::Pubkey, signature::Signature};
@@ -45,6 +46,10 @@ impl CreateMulticastGroupCommand {
             accounts.push(AccountMeta::new(multicast_group_block_ext, false));
         }
 
+        // Index account (payer and system_program are appended by the framework)
+        let (index_pda, _) = get_index_pda(&client.get_program_id(), SEED_MULTICAST_GROUP, &code);
+        accounts.push(AccountMeta::new(index_pda, false));
+
         client
             .execute_transaction(
                 DoubleZeroInstruction::CreateMulticastGroup(MulticastGroupCreateArgs {
@@ -67,9 +72,12 @@ mod tests {
     };
     use doublezero_serviceability::{
         instructions::DoubleZeroInstruction,
-        pda::{get_globalstate_pda, get_multicastgroup_pda, get_resource_extension_pda},
+        pda::{
+            get_globalstate_pda, get_index_pda, get_multicastgroup_pda, get_resource_extension_pda,
+        },
         processors::multicastgroup::create::MulticastGroupCreateArgs,
         resource::ResourceType,
+        seeds::SEED_MULTICAST_GROUP,
         state::{
             accountdata::AccountData, accounttype::AccountType, feature_flags::FeatureFlag,
             globalstate::GlobalState,
@@ -84,6 +92,8 @@ mod tests {
 
         let (globalstate_pubkey, _globalstate) = get_globalstate_pda(&client.get_program_id());
         let (pda_pubkey, _) = get_multicastgroup_pda(&client.get_program_id(), 1);
+        let (index_pda, _) =
+            get_index_pda(&client.get_program_id(), SEED_MULTICAST_GROUP, "test_group");
 
         client
             .expect_execute_transaction()
@@ -99,6 +109,7 @@ mod tests {
                 predicate::eq(vec![
                     AccountMeta::new(pda_pubkey, false),
                     AccountMeta::new(globalstate_pubkey, false),
+                    AccountMeta::new(index_pda, false),
                 ]),
             )
             .returning(|_, _| Ok(Signature::new_unique()));
@@ -155,6 +166,7 @@ mod tests {
         let (pda_pubkey, _) = get_multicastgroup_pda(&program_id, 1);
         let (multicast_group_block_ext, _, _) =
             get_resource_extension_pda(&program_id, ResourceType::MulticastGroupBlock);
+        let (index_pda, _) = get_index_pda(&program_id, SEED_MULTICAST_GROUP, "test_group");
 
         let owner = Pubkey::new_unique();
         client
@@ -172,6 +184,7 @@ mod tests {
                     AccountMeta::new(pda_pubkey, false),
                     AccountMeta::new(globalstate_pubkey, false),
                     AccountMeta::new(multicast_group_block_ext, false),
+                    AccountMeta::new(index_pda, false),
                 ]),
             )
             .returning(|_, _| Ok(Signature::new_unique()));