docs: add program examples README

Author: tilo-14

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).