Light Token Cookbook

Client and program guides using the light-token-sdk.

Recipes

		TypeScript Client	Rust Client	Program Guide
Create Mint	Create light-mints with token metadata	x	x	x
Create ATA	Create associated light-token accounts	x	x	x
Create Token Account	Create light-token accounts		x	x
Mint To	Mint tokens to light-token accounts	x	x	x
Close Token Account	Close and reclaim rent		x	x
Transfer	Transfer between light-token and SPL accounts	x	x	x
Wrap & Unwrap	Convert between SPL/T22 and light-token	x

Setup

Dependencies

npm

npm install @lightprotocol/stateless.js@alpha \
            @lightprotocol/compressed-token@alpha

yarn

yarn add @lightprotocol/stateless.js@alpha \
         @lightprotocol/compressed-token@alpha

pnpm

pnpm add @lightprotocol/stateless.js@alpha \
         @lightprotocol/compressed-token@alpha

Developer Environment

Localnet

By default, all guides use Localnet.

npm

npm install -g @lightprotocol/zk-compression-cli@alpha

yarn

yarn global add @lightprotocol/zk-compression-cli@alpha

pnpm

pnpm add -g @lightprotocol/zk-compression-cli@alpha

# Start a local test validator
light test-validator

## ensure you have the Solana CLI accessible in your system PATH

// createRpc() defaults to local test validator endpoints
import {
  Rpc,
  createRpc,
} from "@lightprotocol/stateless.js";

const connection: Rpc = createRpc();

async function main() {
  let slot = await connection.getSlot();
  console.log(slot);

  let health = await connection.getIndexerHealth(slot);
  console.log(health);
  // "Ok"
}

main();

Devnet

Replace <your-api-key> with your actual API key. Get your API key here, if you don’t have one yet.

import { createRpc } from "@lightprotocol/stateless.js";

// Helius exposes Solana and Photon RPC endpoints through a single URL
const RPC_ENDPOINT = "https://devnet.helius-rpc.com?api-key=<your_api_key>";
const connection = createRpc(RPC_ENDPOINT, RPC_ENDPOINT, RPC_ENDPOINT);

console.log("Connection created!");
console.log("RPC Endpoint:", RPC_ENDPOINT);