feat: add rust client examples for light-token SDK #7

tilo-14 · 2026-01-15T22:38:10Z

Summary

Adds Rust client examples for light-token SDK
Includes tests for all major operations: create_mint, create_ata, mint_to, transfer_interface, burn, approve, revoke, freeze, thaw, close
Adds scenario test for SPL to light-token flow
Adds GitHub Actions workflow for Rust tests

Test plan

Run cargo test in rust-client directory
Verify all tests pass against localnet

rust-client/example-instructions/create_mint.rs

rust-client/tests/transfer.rs

- Add mint_to_checked, transfer_checked, burn_checked instruction examples - Add action examples: approve, revoke, create_mint, create_ata, mint_to, transfer_checked, transfer_interface, wrap, unwrap - Restructure tests/ to examples-instructions/ and examples-actions/ - Add decimals field to SetupContext - Update README to match TypeScript client style

- Rename examples-actions → example-actions - Rename examples-instructions → example-instructions - Fix setup_for_unwrap to use Wrap action (SPL mints can't mint directly to Light ATAs) - Update Cargo.toml and README.md paths

- Remove verbose "using action API" / "using instruction API" from comments - Simplify setup comments to match instruction style - Rename transfer.rs -> transfer_interface.rs for consistency

- Merge TypeScript and Rust examples into unified list - Add all Rust-only examples (burn, freeze, thaw, close, etc.) - Update create_mint action to show TokenMetadata usage - Fix SDK compatibility: add token_metadata field, remove fee_payer - Fix rust-client README links and description

rust-client/example-actions/transfer_interface.rs

README.md

tilo-14 · 2026-01-23T11:28:28Z

rust-client/example-actions/approve.rs

+        ..
+    } = setup().await;
+
+    let delegate = Pubkey::new_unique();


take keypair

tilo-14 · 2026-01-23T11:29:55Z

rust-client/example-actions/create_ata.rs

+        freeze_authority: None,
+        token_metadata: None,
+    }
+    .execute(&mut rpc, &payer, &payer)


payer rename to mint seed?

tilo-14 · 2026-01-23T11:33:52Z

rust-client/example-actions/transfer_checked.rs

+    }
+    .execute(&mut rpc, &payer)
+    .await
+    .unwrap();


add result and exchange unwrap w/ ?

tilo-14 · 2026-01-23T11:35:32Z

rust-client/example-actions/transfer_interface.rs

+        spl_token_program: None,
+        restricted: false,


should not be exposed.

tilo-14 · 2026-01-23T11:37:15Z

rust-client/example-actions/unwrap.rs

+    // Unwrap tokens from Light Token ATA to SPL ATA
+    Unwrap {
+        source: light_ata,
+        destination_spl_ata: spl_ata,


reame to destination_ata

in line 11

here only destination

rust-client/example-actions/wrap.rs

tilo-14 · 2026-01-23T11:41:34Z

rust-client/example-instructions/transfer_interface.rs

+use solana_sdk::{signature::Keypair, signer::Signer};
+
+#[tokio::main]
+async fn main() {


amend to only 1 transfer

tilo-14 force-pushed the chore/add-rust-client branch from 3202304 to 31c7176 Compare January 15, 2026 22:44

tilo-14 commented Jan 15, 2026

View reviewed changes

rust-client/example-instructions/create_mint.rs Show resolved Hide resolved

tilo-14 force-pushed the chore/add-rust-client branch from 31c7176 to f51fd06 Compare January 15, 2026 22:50

tilo-14 commented Jan 15, 2026

View reviewed changes

rust-client/tests/transfer.rs Outdated Show resolved Hide resolved

tilo-14 force-pushed the chore/add-rust-client branch from d97dcb2 to fa941d2 Compare January 15, 2026 23:36

feat: add rust client examples for light-token SDK

912ae0f

tilo-14 force-pushed the chore/add-rust-client branch from 13fa136 to 912ae0f Compare January 21, 2026 23:14

tilo-14 and others added 5 commits January 22, 2026 02:10

refactor: clean up comments, rename transfer to transfer_interface

7c1755f

- Remove verbose "using action API" / "using instruction API" from comments - Simplify setup comments to match instruction style - Rename transfer.rs -> transfer_interface.rs for consistency

Merge branch 'main' into chore/add-rust-client

9ac6051