feat: add native program examples for compressed tokens

- Program instructions: mint, transfer, approve, revoke, burn, freeze, thaw, close
- Rust SBF integration tests
- TypeScript tests using light-sdk

Author: tilo-14

program-examples/native/Cargo.lock

@@ -0,0 +1,18 @@
+[workspace]
+members = ["program"]
+resolver = "2"
+
+[workspace.dependencies]
+# Pin to match light-protocol Cargo.lock
+constant_time_eq = "=0.3.1"
+blake3 = "=1.5.5"
+
+[profile.release]
+overflow-checks = true
+lto = "fat"
+codegen-units = 1
+
+[profile.release.build-override]
+opt-level = 3
+incremental = false
+codegen-units = 1

program-examples/native/Cargo.toml

@@ -0,0 +1,23 @@
+{
+  "name": "light-token-examples-native",
+  "version": "1.0.0",
+  "license": "MIT",
+  "scripts": {
+    "test:ts": "ts-mocha -p ./tsconfig.json -t 1000000 ts-tests/*.test.ts"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "0.30.1",
+    "@lightprotocol/stateless.js": "0.22.1-alpha.7",
+    "@lightprotocol/compressed-token": "0.22.1-alpha.8",
+    "dotenv": "^16.5.0"
+  },
+  "devDependencies": {
+    "@types/bn.js": "^5.1.0",
+    "@types/chai": "^4.3.0",
+    "@types/mocha": "^9.0.0",
+    "chai": "^4.3.4",
+    "mocha": "^9.0.3",
+    "ts-mocha": "^10.1.0",
+    "typescript": "^5.0.0"
+  }
+}

program-examples/native/package.json

@@ -0,0 +1,37 @@
+[package]
+name = "light-token-ops"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+
+[features]
+no-entrypoint = []
+test-sbf = []
+default = []
+
+[dependencies]
+light-token-sdk = { git = "https://github.com/Lightprotocol/light-protocol", branch = "jorrit/chore-fix-token-sdk" }
+solana-program = "2.2"
+borsh = "0.10.4"
+
+[dev-dependencies]
+light-program-test = { git = "https://github.com/Lightprotocol/light-protocol", branch = "jorrit/chore-fix-token-sdk", features = ["v2"] }
+light-client = { git = "https://github.com/Lightprotocol/light-protocol", branch = "jorrit/chore-fix-token-sdk", features = ["v2"] }
+light-token-interface = { git = "https://github.com/Lightprotocol/light-protocol", branch = "jorrit/chore-fix-token-sdk" }
+tokio = { version = "1", features = ["full"] }
+solana-sdk = "2"
+anchor-spl = "0.31"
+spl-token = "7"
+spl-token-2022 = "7"
+spl-pod = "0.5"
+blake3 = "=1.5.5"
+
+[lints.rust.unexpected_cfgs]
+level = "allow"
+check-cfg = [
+    'cfg(target_os, values("solana"))',
+    'cfg(feature, values("frozen-abi", "no-entrypoint"))',
+]
+

program-examples/native/program/Cargo.toml

@@ -0,0 +1,48 @@
+use super::authority_seeds;
+use light_token_sdk::token::ApproveCpi;
+use solana_program::{
+    account_info::AccountInfo, entrypoint::ProgramResult, program_error::ProgramError,
+};
+
+pub fn process(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [token_account, delegate, owner, system_program, _token_program] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    let amount = u64::from_le_bytes(
+        data.try_into()
+            .map_err(|_| ProgramError::InvalidInstructionData)?,
+    );
+
+    ApproveCpi {
+        token_account: token_account.clone(),
+        delegate: delegate.clone(),
+        owner: owner.clone(),
+        system_program: system_program.clone(),
+        amount,
+    }
+    .invoke()
+}
+
+pub fn process_signed(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [token_account, delegate, owner, system_program, _token_program] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    if data.len() < 9 {
+        return Err(ProgramError::InvalidInstructionData);
+    }
+
+    let amount = u64::from_le_bytes(data[0..8].try_into().unwrap());
+    let bump = data[8];
+    let signer_seeds = authority_seeds!(bump);
+
+    ApproveCpi {
+        token_account: token_account.clone(),
+        delegate: delegate.clone(),
+        owner: owner.clone(),
+        system_program: system_program.clone(),
+        amount,
+    }
+    .invoke_signed(&[signer_seeds])
+}

program-examples/native/program/src/instructions/approve.rs

@@ -0,0 +1,48 @@
+use super::authority_seeds;
+use light_token_sdk::token::BurnCpi;
+use solana_program::{
+    account_info::AccountInfo, entrypoint::ProgramResult, program_error::ProgramError,
+};
+
+pub fn process(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [source, mint, authority, _token_program] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    let amount = u64::from_le_bytes(
+        data.try_into()
+            .map_err(|_| ProgramError::InvalidInstructionData)?,
+    );
+
+    BurnCpi {
+        source: source.clone(),
+        mint: mint.clone(),
+        amount,
+        authority: authority.clone(),
+        max_top_up: None,
+    }
+    .invoke()
+}
+
+pub fn process_signed(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [source, mint, authority, _token_program] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    if data.len() < 9 {
+        return Err(ProgramError::InvalidInstructionData);
+    }
+
+    let amount = u64::from_le_bytes(data[0..8].try_into().unwrap());
+    let bump = data[8];
+    let signer_seeds = authority_seeds!(bump);
+
+    BurnCpi {
+        source: source.clone(),
+        mint: mint.clone(),
+        amount,
+        authority: authority.clone(),
+        max_top_up: None,
+    }
+    .invoke_signed(&[signer_seeds])
+}

program-examples/native/program/src/instructions/burn.rs

@@ -0,0 +1,42 @@
+use super::authority_seeds;
+use light_token_sdk::token::CloseAccountCpi;
+use solana_program::{
+    account_info::AccountInfo, entrypoint::ProgramResult, program_error::ProgramError,
+};
+
+pub fn process(accounts: &[AccountInfo], _data: &[u8]) -> ProgramResult {
+    let [token_program, account, destination, owner, rent_sponsor] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    CloseAccountCpi {
+        token_program: token_program.clone(),
+        account: account.clone(),
+        destination: destination.clone(),
+        owner: owner.clone(),
+        rent_sponsor: rent_sponsor.clone(),
+    }
+    .invoke()
+}
+
+pub fn process_signed(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [token_program, account, destination, owner, rent_sponsor] = accounts else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    if data.is_empty() {
+        return Err(ProgramError::InvalidInstructionData);
+    }
+
+    let bump = data[0];
+    let signer_seeds = authority_seeds!(bump);
+
+    CloseAccountCpi {
+        token_program: token_program.clone(),
+        account: account.clone(),
+        destination: destination.clone(),
+        owner: owner.clone(),
+        rent_sponsor: rent_sponsor.clone(),
+    }
+    .invoke_signed(&[signer_seeds])
+}

program-examples/native/program/src/instructions/close.rs

@@ -0,0 +1,73 @@
+use super::authority_seeds;
+use light_token_sdk::token::{CompressibleParamsCpi, CreateAssociatedAccountCpi};
+use solana_program::{
+    account_info::AccountInfo, entrypoint::ProgramResult, program_error::ProgramError,
+};
+
+pub fn process(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [owner, mint, payer, associated_token_account, system_program, compressible_config, rent_sponsor, _token_program] =
+        accounts
+    else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    if data.is_empty() {
+        return Err(ProgramError::InvalidInstructionData);
+    }
+
+    let bump = data[0];
+    let idempotent = data.get(1).copied().unwrap_or(0) != 0;
+
+    let compressible = CompressibleParamsCpi::new_ata(
+        compressible_config.clone(),
+        rent_sponsor.clone(),
+        system_program.clone(),
+    );
+
+    CreateAssociatedAccountCpi {
+        owner: owner.clone(),
+        mint: mint.clone(),
+        payer: payer.clone(),
+        associated_token_account: associated_token_account.clone(),
+        system_program: system_program.clone(),
+        bump,
+        compressible,
+        idempotent,
+    }
+    .invoke()
+}
+
+pub fn process_signed(accounts: &[AccountInfo], data: &[u8]) -> ProgramResult {
+    let [owner, mint, payer, associated_token_account, system_program, compressible_config, rent_sponsor, _token_program] =
+        accounts
+    else {
+        return Err(ProgramError::NotEnoughAccountKeys);
+    };
+
+    if data.len() < 3 {
+        return Err(ProgramError::InvalidInstructionData);
+    }
+
+    let bump = data[0];
+    let idempotent = data[1] != 0;
+    let authority_bump = data[2];
+    let signer_seeds = authority_seeds!(authority_bump);
+
+    let compressible = CompressibleParamsCpi::new_ata(
+        compressible_config.clone(),
+        rent_sponsor.clone(),
+        system_program.clone(),
+    );
+
+    CreateAssociatedAccountCpi {
+        owner: owner.clone(),
+        mint: mint.clone(),
+        payer: payer.clone(),
+        associated_token_account: associated_token_account.clone(),
+        system_program: system_program.clone(),
+        bump,
+        compressible,
+        idempotent,
+    }
+    .invoke_signed(&[signer_seeds])
+}