chore: light-ctoken-sdk small refactors and inline docs (#2102)

* stash docs

* feat: ctoken-sdk lib.rs docs

* feat: ctoken-sdk ctoken docs

* refactor: rename CloseAccount -> CloseCTokenAccount

* refactor: rename ctoken AccountInfos structs to Cpi suffix

* refactor: light_ctoken_sdk::ctoken docs

* refactor: rename cmint address derivation functions

- derive_compressed_mint_address -> derive_cmint_compressed_address
- find_spl_mint_address -> find_cmint_address
- CreateCMint::mint_signer -> mint_seed_pubkey
- CreateCMintCpi::mint_signer -> mint_seed
- CreateCMintCpi::new_with_address -> new

* docs: add rustdoc examples to ctoken CPI structs

* refactor: clean up ctoken-sdk re-exports and fix import paths

* refactor: rename token_pool_pda to spl_interface_pda, add constants re-exports

* chore: rename TokenSdkError -> CTokenSdkError

* cleanup

* doc: compressible config

* fix: naming inconsistency TransferCtoken -> TransferCToken

* fix: feedback

* refactor: rename CTOKEN_PROGRAM_ID -> COMPRESSED_TOKEN_PROGRAM_ID

* fix: outdated comment

Author: ananas-block

Cargo.lock

@@ -1,4 +1,4 @@
-use light_ctoken_interface::COMPRESSED_TOKEN_PROGRAM_ID;
+use light_ctoken_interface::CTOKEN_PROGRAM_ID;
 use solana_instruction::{AccountMeta, Instruction};
 use solana_pubkey::Pubkey;
 
@@ -13,7 +13,7 @@ use solana_pubkey::Pubkey;
 pub fn derive_pool_pda(compression_authority: &Pubkey) -> (Pubkey, u8) {
     Pubkey::find_program_address(
         &[b"pool", compression_authority.as_ref()],
-        &Pubkey::from(COMPRESSED_TOKEN_PROGRAM_ID),
+        &Pubkey::from(CTOKEN_PROGRAM_ID),
     )
 }
 
@@ -49,7 +49,7 @@ pub fn claim(
     }
 
     Instruction {
-        program_id: Pubkey::from(COMPRESSED_TOKEN_PROGRAM_ID),
+        program_id: Pubkey::from(CTOKEN_PROGRAM_ID),
         accounts,
         data: instruction_data,
     }

forester-utils/src/instructions/claim.rs

@@ -1,4 +1,4 @@
-use light_ctoken_interface::COMPRESSED_TOKEN_PROGRAM_ID;
+use light_ctoken_interface::CTOKEN_PROGRAM_ID;
 use solana_instruction::{AccountMeta, Instruction};
 use solana_pubkey::Pubkey;
 
@@ -37,7 +37,7 @@ pub fn withdraw_funding_pool(
     ];
 
     Instruction {
-        program_id: Pubkey::from(COMPRESSED_TOKEN_PROGRAM_ID),
+        program_id: Pubkey::from(CTOKEN_PROGRAM_ID),
         accounts,
         data: instruction_data,
     }

forester-utils/src/instructions/withdraw_funding_pool.rs

@@ -4,7 +4,7 @@ use base64::{engine::general_purpose, Engine as _};
 use borsh::BorshDeserialize;
 use light_ctoken_interface::{
     state::{extensions::ExtensionStruct, CToken},
-    COMPRESSED_TOKEN_PROGRAM_ID, COMPRESSIBLE_TOKEN_ACCOUNT_SIZE,
+    COMPRESSIBLE_TOKEN_ACCOUNT_SIZE, CTOKEN_PROGRAM_ID,
 };
 use serde_json::json;
 use solana_sdk::pubkey::Pubkey;
@@ -191,7 +191,7 @@ async fn bootstrap_with_v2_api(
     mut shutdown_rx: oneshot::Receiver<()>,
 ) -> Result<()> {
     let client = reqwest::Client::new();
-    let program_id = Pubkey::new_from_array(COMPRESSED_TOKEN_PROGRAM_ID);
+    let program_id = Pubkey::new_from_array(CTOKEN_PROGRAM_ID);
 
     let mut total_fetched = 0;
     let mut total_inserted = 0;
@@ -314,7 +314,7 @@ async fn bootstrap_with_standard_api(
     mut shutdown_rx: oneshot::Receiver<()>,
 ) -> Result<()> {
     let client = reqwest::Client::new();
-    let program_id = Pubkey::new_from_array(COMPRESSED_TOKEN_PROGRAM_ID);
+    let program_id = Pubkey::new_from_array(CTOKEN_PROGRAM_ID);
 
     let payload = json!({
         "jsonrpc": "2.0",

forester/src/compressible/bootstrap.rs

@@ -4,7 +4,7 @@ use anchor_lang::{InstructionData, ToAccountMetas};
 use forester_utils::rpc_pool::SolanaRpcPool;
 use light_client::rpc::Rpc;
 use light_compressible::config::CompressibleConfig;
-use light_ctoken_interface::COMPRESSED_TOKEN_PROGRAM_ID;
+use light_ctoken_interface::CTOKEN_PROGRAM_ID;
 use light_ctoken_sdk::compressed_token::compress_and_close::CompressAndCloseAccounts as CTokenAccounts;
 use light_registry::{
     accounts::CompressAndCloseContext, compressible::compressed_token::CompressAndCloseIndices,
@@ -60,7 +60,7 @@ impl<R: Rpc> Compressor<R> {
         registered_forester_pda: Pubkey,
     ) -> Result<Signature> {
         let registry_program_id = Pubkey::from_str(REGISTRY_PROGRAM_ID_STR)?;
-        let compressed_token_program_id = Pubkey::new_from_array(COMPRESSED_TOKEN_PROGRAM_ID);
+        let compressed_token_program_id = Pubkey::new_from_array(CTOKEN_PROGRAM_ID);
 
         // Derive compression_authority PDA deterministically (version = 1)
         let compression_authority_seeds = CompressibleConfig::get_compression_authority_seeds(1);

forester/src/compressible/compressor.rs

@@ -1,7 +1,7 @@
 use std::{str::FromStr, sync::Arc};
 
 use futures::StreamExt;
-use light_ctoken_interface::{COMPRESSED_TOKEN_PROGRAM_ID, COMPRESSIBLE_TOKEN_ACCOUNT_SIZE};
+use light_ctoken_interface::{COMPRESSIBLE_TOKEN_ACCOUNT_SIZE, CTOKEN_PROGRAM_ID};
 use solana_account_decoder::UiAccountEncoding;
 use solana_client::{
     nonblocking::pubsub_client::PubsubClient,
@@ -44,7 +44,7 @@ impl AccountSubscriber {
             .await
             .map_err(|e| anyhow::anyhow!("Failed to connect to WebSocket: {}", e))?;
 
-        let program_id = Pubkey::new_from_array(COMPRESSED_TOKEN_PROGRAM_ID);
+        let program_id = Pubkey::new_from_array(CTOKEN_PROGRAM_ID);
 
         // Subscribe to compressed token program accounts with filter for compressible account size
         let (mut subscription, unsubscribe) = pubsub_client

forester/src/compressible/subscriber.rs

@@ -218,7 +218,7 @@ async fn test_compressible_ctoken_compression() {
     // Create mint
     let mint_seed = Keypair::new();
     let address_tree = rpc.get_address_tree_v2().tree;
-    let mint = Pubkey::from(create_compressed_mint::derive_compressed_mint_address(
+    let mint = Pubkey::from(create_compressed_mint::derive_cmint_compressed_address(
         &mint_seed.pubkey(),
         &address_tree,
     ));
@@ -369,7 +369,7 @@ async fn test_compressible_ctoken_bootstrap() {
     // Create mint
     let mint_seed = Keypair::new();
     let address_tree = rpc.get_address_tree_v2().tree;
-    let mint = Pubkey::from(create_compressed_mint::derive_compressed_mint_address(
+    let mint = Pubkey::from(create_compressed_mint::derive_cmint_compressed_address(
         &mint_seed.pubkey(),
         &address_tree,
     ));

forester/tests/test_compressible_ctoken.rs

@@ -3,7 +3,7 @@ use light_macros::pubkey_array;
 use crate::state::CompressionInfo;
 
 pub const CPI_AUTHORITY: [u8; 32] = pubkey_array!("GXtd2izAiMJPwMEjfgTRH3d7k9mjn4Jq3JrWFv9gySYy");
-pub const COMPRESSED_TOKEN_PROGRAM_ID: [u8; 32] =
+pub const CTOKEN_PROGRAM_ID: [u8; 32] =
     pubkey_array!("cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m");
 
 /// Account size constants

program-libs/ctoken-interface/src/constants.rs

@@ -50,3 +50,4 @@ light-ctoken-sdk = { workspace = true }
 spl-token-2022 = { workspace = true }
 spl-pod = { workspace = true }
 light-zero-copy = { workspace = true , features = ["std", "derive", "mut"]}
+light-compressed-token-types = { workspace = true }

program-tests/compressed-token-test/Cargo.toml

@@ -65,7 +65,7 @@ async fn test_spl_sdk_compatible_account_lifecycle() -> Result<(), RpcError> {
     let destination_pubkey = destination_keypair.pubkey();
 
     // Close account using SPL SDK compatible instruction
-    let close_account_ix = CloseAccount::new(
+    let close_account_ix = CloseCTokenAccount::new(
         light_compressed_token::ID,
         token_account_pubkey,
         destination_pubkey,
@@ -272,7 +272,7 @@ async fn test_compressible_account_with_compression_authority_lifecycle() {
         .unwrap();
 
     // Close compressible account using owner
-    let close_account_ix = CloseAccount::new(
+    let close_account_ix = CloseCTokenAccount::new(
         light_compressed_token::ID,
         token_account_pubkey,
         destination.pubkey(),           // destination for user funds