feat: light client get cached merkle tree (#1775)

* feat: add Merkle tree getters

refactor: rename RpcConnection -> Rpc

refactor: rename SolanaRpcConnection -> LightClient, rename RpcConnection -> Rpc

rename: SolanaRpcUrl -> RpcUrl

fix: make PhotonIndexer flexible for non local host

feat: add ValidityProofWithContext::pack_merkle_tree_accounts

refactor: pack_merkle_tree_accounts add pack output indices

fix: use TreeType in test-utils

fix: lint

fix: counter example assert

chore: set LightProgramTest address Merkle tree to amt1Ayt45jfbdw5YSo7iz6WZxUmnZsQTYXy82hVwyC2

* refactor: set_account inputs without references

* fix: account compression tests!

* fix: counter example

* rename: indexer::types::Account -> CompressedAccount

* refactor: rename CompressedAccount::merkle_context -> tree_info

* refactor: light-sdk rename merkle_context -> tree_info, use PackedTreeInfo which contains root_index instead of PackedMerkleContext, rename PackedMerkleTreeAccounts -> PackedTreeAccounts and return one output_tree_index

* refactor: split get_compressed_account into two add get_compressed_account_by_hash

* chore: remove duplicate TreeMeta type

* refactor: pack_tree_accounts output

* chore: add log_failed_tx option, log all tx with debug asserts

* refactor: light-sdk rename merkle_context -> tree_info

* fix: light-program-test

* chore: deprecate PackMerkleContext functions

* fix: registry test

* add light-client tests

* test: add program-test indexer trait test

* chore: move light-client test to program-tests

* refactor: rename account_trees -> state_trees, get_output_tree_index -> pack_output_tree_index

* refactor: rename field output_tree_index -> output_state_tree_index

Author: ananas-block

.github/workflows/rust.yml

@@ -62,6 +62,7 @@ jobs:
               cargo test -p light-sdk
               cargo test -p light-program-test
               cargo test -p light-client
+              cargo test-sbf -p client-test
               cargo test -p light-sparse-merkle-tree
               cargo test -p light-batched-merkle-tree --features test-only -- --skip test_simulate_transactions --skip test_e2e
 

Cargo.lock

@@ -41,6 +41,7 @@ members = [
     "program-tests/create-address-test-program",
     "program-tests/utils",
     "program-tests/merkle-tree",
+    "program-tests/client-test",
     "forester-utils",
     "forester",
     "sparse-merkle-tree",

Cargo.toml

@@ -29,3 +29,4 @@ light-compressed-account = { workspace = true }
 light-program-test = { workspace = true, features = ["devenv"] }
 tokio = "1.43.0"
 solana-sdk = { workspace = true }
+light-client = { workspace = true }

examples/anchor/counter/Cargo.toml

@@ -6,9 +6,10 @@ use light_sdk::{
     address::v1::derive_address,
     cpi::{CpiAccounts, CpiInputs},
     instruction::{
-        account_meta::CompressedAccountMeta, merkle_context::PackedAddressMerkleContext,
+        account_meta::{CompressedAccountMeta, CompressedAccountMetaClose},
+        tree_info::PackedAddressTreeInfo,
     },
-    LightDiscriminator, LightHasher, NewAddressParamsPacked, ValidityProof,
+    LightDiscriminator, LightHasher, ValidityProof,
 };
 
 declare_id!("GRLu2hKaAiMbxpkAM1HeXzks9YeGuz18SEgXEizVvPqX");
@@ -21,8 +22,8 @@ pub mod counter {
     pub fn create_counter<'info>(
         ctx: Context<'_, '_, '_, 'info, GenericAnchorAccounts<'info>>,
         proof: ValidityProof,
-        address_merkle_context: PackedAddressMerkleContext,
-        output_merkle_tree_index: u8,
+        address_tree_info: PackedAddressTreeInfo,
+        output_state_tree_index: u8,
     ) -> Result<()> {
         let program_id = crate::ID.into();
         // LightAccount::new_init will create an account with empty output state (no input state).
@@ -40,23 +41,17 @@ pub mod counter {
         let (address, address_seed) = derive_address(
             &[b"counter", ctx.accounts.signer.key().as_ref()],
             &light_cpi_accounts.tree_accounts()
-                [address_merkle_context.address_merkle_tree_pubkey_index as usize]
+                [address_tree_info.address_merkle_tree_pubkey_index as usize]
                 .key(),
             &crate::ID,
         );
 
-        let new_address_params = NewAddressParamsPacked {
-            seed: address_seed,
-            address_queue_account_index: address_merkle_context.address_queue_pubkey_index,
-            address_merkle_tree_root_index: address_merkle_context.root_index,
-            address_merkle_tree_account_index: address_merkle_context
-                .address_merkle_tree_pubkey_index,
-        };
+        let new_address_params = address_tree_info.into_new_address_params_packed(address_seed);
 
         let mut counter = LightAccount::<'_, CounterAccount>::new_init(
             &program_id,
             Some(address),
-            output_merkle_tree_index,
+            output_state_tree_index,
         );
 
         counter.owner = ctx.accounts.signer.key();
@@ -198,7 +193,7 @@ pub mod counter {
         ctx: Context<'_, '_, '_, 'info, GenericAnchorAccounts<'info>>,
         proof: ValidityProof,
         counter_value: u64,
-        account_meta: CompressedAccountMeta,
+        account_meta: CompressedAccountMetaClose,
     ) -> Result<()> {
         let program_id = crate::ID.into();
         // LightAccount::new_close() will create an account with only input state and no output state.