Add TypeScript tests for native and anchor programs

.github/actions/setup/action.yml

@@ -5,11 +5,11 @@ inputs:
   solana-cli-version:
     description: "Solana CLI version"
     required: false
-    default: "2.1.21"
+    default: "2.3.11"
   rust-toolchain:
     description: "Rust toolchain version"
     required: false
-    default: "1.85.0"
+    default: "1.90.0"
   light-cli-version:
     description: "Light CLI version"
     required: false

.github/workflows/rust-tests.yml

@@ -0,0 +1,36 @@
+name: Rust
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  SOLANA_CLI_VERSION: "2.3.11"
+  RUST_TOOLCHAIN: "1.90.0"
+
+jobs:
+  rust-client:
+    name: rust-client
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup environment
+        uses: ./.github/actions/setup
+        with:
+          solana-cli-version: ${{ env.SOLANA_CLI_VERSION }}
+          rust-toolchain: ${{ env.RUST_TOOLCHAIN }}
+
+      - name: Run tests
+        working-directory: rust-client
+        run: cargo test
+

.github/workflows/typescript-tests.yml

@@ -14,8 +14,10 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  SOLANA_CLI_VERSION: "2.1.21"
+  SOLANA_CLI_VERSION: "2.3.11"
+  RUST_TOOLCHAIN: "1.90.0"
   NODE_VERSION: "22"
+  PHOTON_REV: "1a785036de52896b68d06413e3b0231122d6aa4a"
 
 jobs:
   typescript-tests:
@@ -30,6 +32,7 @@ jobs:
           node-version: ${{ env.NODE_VERSION }}
 
       - name: Cache Solana CLI tools
+        id: cache-solana
         uses: actions/cache@v4
         with:
           path: |
@@ -38,32 +41,38 @@ jobs:
           key: solana-cli-${{ runner.os }}-${{ env.SOLANA_CLI_VERSION }}
 
       - name: Install Solana CLI tools
+        if: steps.cache-solana.outputs.cache-hit != 'true'
         run: |
           sh -c "$(curl -sSfL https://release.anza.xyz/v${{ env.SOLANA_CLI_VERSION }}/install)"
-          echo "/home/runner/.local/share/solana/install/active_release/bin" >> $GITHUB_PATH
+
+      - name: Add Solana to PATH
+        run: echo "/home/runner/.local/share/solana/install/active_release/bin" >> $GITHUB_PATH
 
       - name: Install Light CLI
         run: npm install -g @lightprotocol/zk-compression-cli@alpha
 
       - name: Install Rust (for Photon)
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
-          toolchain: stable
+          toolchain: ${{ env.RUST_TOOLCHAIN }}
           cache: false
 
       - name: Cache Photon indexer
         id: cache-photon
         uses: actions/cache@v4
         with:
           path: ~/.cargo/bin/photon
-          key: photon-${{ runner.os }}-1a785036de52896b68d06413e3b0231122d6aa4a
+          key: photon-${{ runner.os }}-${{ env.PHOTON_REV }}
 
       - name: Install Photon indexer
         if: steps.cache-photon.outputs.cache-hit != 'true'
-        run: cargo install --git https://github.com/lightprotocol/photon.git --rev 1a785036de52896b68d06413e3b0231122d6aa4a --locked
+        run: cargo install --git https://github.com/lightprotocol/photon.git --rev ${{ env.PHOTON_REV }} --locked
         env:
           RUSTFLAGS: "-A dead-code"
 
+      - name: Add cargo bin to PATH
+        run: echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+
       - name: Generate keypair
         run: solana-keygen new --no-bip39-passphrase
 
@@ -74,7 +83,16 @@ jobs:
       - name: Start test validator
         run: |
           light test-validator &
-          sleep 15
+          sleep 30
+          # Wait for Photon indexer to be ready
+          for i in {1..30}; do
+            if curl -s http://127.0.0.1:8784/health > /dev/null 2>&1; then
+              echo "Photon indexer is ready"
+              break
+            fi
+            echo "Waiting for Photon... ($i/30)"
+            sleep 2
+          done
 
       - name: Run actions
         working-directory: typescript-client

.gitignore

@@ -7,3 +7,4 @@
 **/test-ledger
 **/target
 cli/accounts/
+**/.cursor/

README.md

@@ -23,7 +23,7 @@ TypeScript examples for light-token-sdk.
   - [Action](typescript-client/actions/load-ata.ts) | [Instruction](typescript-client/instructions/load-ata.ts)
 - **mint-to** - Mint tokens to a light-account
   - [Action](typescript-client/actions/mint-to.ts) | [Instruction](typescript-client/instructions/mint-to.ts)
-- **transfer-interface** - Transfer between light-token, T22, and SPL accounts
+- **transfer-interface** - Unified Transfer Interface between light-token, T22, and SPL accounts. The interface detects account types and invokes the right programs.
   - [Action](typescript-client/actions/transfer-interface.ts) | [Instruction](typescript-client/instructions/transfer-interface.ts)
 - **wrap** - Wrap SPL/T22 to light-token
   - [Action](typescript-client/actions/wrap.ts)
@@ -34,6 +34,21 @@ TypeScript examples for light-token-sdk.
 - **delegate-revoke** - Revoke delegate
   - [Action](typescript-client/actions/delegate-revoke.ts)
 
+### Rust Client
+
+- **[scenario_spl_to_light](rust-client/tests/scenario_spl_to_light.rs)** - SPL to light-token flow
+- **[create_mint](rust-client/tests/create_mint.rs)** - Create a light-mint
+- **[create_ata](rust-client/tests/create_ata.rs)** - Create an associated light-token account
+- **[create_token_account](rust-client/tests/create_token_account.rs)** - Create a light-token account
+- **[mint_to](rust-client/tests/mint_to.rs)** - Mint tokens to a light-token account
+- **[transfer](rust-client/tests/transfer.rs)** - Transfer between SPL and light-token accounts
+- **[burn](rust-client/tests/burn.rs)** - Burn light-tokens
+- **[approve](rust-client/tests/approve.rs)** - Approve delegate
+- **[revoke](rust-client/tests/revoke.rs)** - Revoke delegate
+- **[freeze](rust-client/tests/freeze.rs)** - Freeze light-token account
+- **[thaw](rust-client/tests/thaw.rs)** - Thaw frozen light-token account
+- **[close](rust-client/tests/close.rs)** - Close light-token account
+
 ## Documentation
 
 Learn more [about to Light-Token here](https://www.zkcompression.com/light-token/welcome).

program-examples/README.md

@@ -0,0 +1,80 @@
+# Light Token Program Examples
+
+Native Solana program examples that CPI the Light Token Program.
+
+### Native
+
+- **create-mint** - Create a light-token mint via CPI
+  - [Instruction](native/program/src/instructions/create_mint.rs) | [Test](native/program/tests/create_mint.rs)
+- **create-ata** - Create an associated light-token account via CPI
+  - [Instruction](native/program/src/instructions/create_ata.rs) | [Test](native/program/tests/create_ata.rs)
+- **mint-to** - Mint tokens via CPI
+  - [Instruction](native/program/src/instructions/mint_to.rs) | [Test](native/program/tests/mint_to.rs)
+- **transfer-interface** - Transfer between light-token, T22, and SPL accounts via CPI
+  - [Instruction](native/program/src/instructions/transfer_interface.rs) | [Test](native/program/tests/transfer.rs)
+- **approve** - Approve delegate via CPI
+  - [Instruction](native/program/src/instructions/approve.rs) | [Test](native/program/tests/approve.rs)
+- **revoke** - Revoke delegate via CPI
+  - [Instruction](native/program/src/instructions/revoke.rs) | [Test](native/program/tests/revoke.rs)
+- **burn** - Burn tokens via CPI
+  - [Instruction](native/program/src/instructions/burn.rs) | [Test](native/program/tests/burn.rs)
+- **freeze** - Freeze token account via CPI
+  - [Instruction](native/program/src/instructions/freeze.rs) | [Test](native/program/tests/freeze.rs)
+- **thaw** - Thaw token account via CPI
+  - [Instruction](native/program/src/instructions/thaw.rs) | [Test](native/program/tests/thaw.rs)
+- **close** - Close token account via CPI
+  - [Instruction](native/program/src/instructions/close.rs) | [Test](native/program/tests/close.rs)
+
+## Build
+
+```bash
+cargo build-sbf
+```
+
+## Test
+
+### Requirements
+
+- light cli version 0.24.0+ (install via `npm i -g @lightprotocol/zk-compression-cli`)
+- solana cli version 2.1.16+
+- Node.js and npm
+
+### Rust Tests
+
+```bash
+cargo test-sbf
+```
+
+### TypeScript Tests
+
+1. Build the program:
+
+   ```bash
+   cargo build-sbf
+   ```
+
+2. Start the test validator:
+
+   ```bash
+   light test-validator --sbf-program "TokenCpi11111111111111111111111111111111111" ./native/target/deploy/light_token_ops.so
+   ```
+
+3. Install dependencies and run tests:
+
+   ```bash
+   cd native
+   npm install
+   npm test
+   ```
+
+`light test-validator` spawns the following background processes:
+
+1. solana test validator `http://127.0.0.1:8899`
+2. prover server `http://127.0.0.1:3001`
+3. photon indexer `http://127.0.0.1:8784`
+
+You can kill these background processes with `lsof -i:<port>` and `kill <pid>`.
+
+## Documentation
+
+Learn more [about Light-Token here](https://www.zkcompression.com/light-token/welcome).

program-examples/anchor/Anchor.toml

@@ -0,0 +1,36 @@
+[features]
+seeds = false
+skip-lint = false
+
+[programs.localnet]
+light_token_anchor_create_ata = "77bt3j6A3g9s1WtwYnRFTGP9y8H1nigW7mLtywGKPmMi"
+light_token_anchor_create_mint = "Ev7tKaozVxbZLVGcKcVcz8A9yKZjUf5ATqoNSe5BDkjj"
+light_token_anchor_create_token_account = "CTAiNDz2wJrB67HuJYYfooHG1gN3nXnZVfm3QhPgi2Vi"
+light_token_anchor_mint_to = "7SUgjNZYC1h89MuPVYkgEP5A4uYx5GFSjC7mzqMbN8U2"
+light_token_anchor_transfer_interface = "ChkDqFsvNNT5CGrV2YCkmK4DiVSATnXc98mNozPbhC6u"
+light_token_anchor_close = "4fi27siKEvKXJYN5WCzWuHdAw1rLed6Tprv9ZARv3Gxu"
+light_token_anchor_approve = "A9b9t3qNQmYTpbui7TXLQbTJPXbNaV5dW11vxn2M7eC5"
+light_token_anchor_revoke = "Dvq3UxQUDEF3B6khoJTdcbm3UutDsvxkdkTvxoJvegfg"
+light_token_anchor_burn = "BHTGZDjDw9Gpz8oYm7CRMg2WtKwW65YAYHXXMKv4dpr6"
+light_token_anchor_freeze = "7ovuM3dD2MZtcWQesVMiSYJef3oh1XH3e8nUk1ArpWX6"
+light_token_anchor_thaw = "FL4MY6v5mTqncytUeuPoGroo6DHSsmBCPirckygGbcip"
+
+[programs.devnet]
+light_token_anchor_create_ata = "77bt3j6A3g9s1WtwYnRFTGP9y8H1nigW7mLtywGKPmMi"
+light_token_anchor_create_mint = "Ev7tKaozVxbZLVGcKcVcz8A9yKZjUf5ATqoNSe5BDkjj"
+light_token_anchor_create_token_account = "CTAiNDz2wJrB67HuJYYfooHG1gN3nXnZVfm3QhPgi2Vi"
+light_token_anchor_mint_to = "7SUgjNZYC1h89MuPVYkgEP5A4uYx5GFSjC7mzqMbN8U2"
+light_token_anchor_transfer_interface = "ChkDqFsvNNT5CGrV2YCkmK4DiVSATnXc98mNozPbhC6u"
+light_token_anchor_close = "4fi27siKEvKXJYN5WCzWuHdAw1rLed6Tprv9ZARv3Gxu"
+light_token_anchor_approve = "A9b9t3qNQmYTpbui7TXLQbTJPXbNaV5dW11vxn2M7eC5"
+light_token_anchor_revoke = "Dvq3UxQUDEF3B6khoJTdcbm3UutDsvxkdkTvxoJvegfg"
+light_token_anchor_burn = "BHTGZDjDw9Gpz8oYm7CRMg2WtKwW65YAYHXXMKv4dpr6"
+light_token_anchor_freeze = "7ovuM3dD2MZtcWQesVMiSYJef3oh1XH3e8nUk1ArpWX6"
+light_token_anchor_thaw = "FL4MY6v5mTqncytUeuPoGroo6DHSsmBCPirckygGbcip"
+
+[provider]
+cluster = "Localnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "ts-mocha -p ./tsconfig.json -t 1000000 ts-tests/**/*.ts"