Compressed Tokens are supported by leading Solana wallets such as Phantom and Backpack.

Creation	Solana	Compressed
Token Account	~2,000,000 lamports	5,000 lamports

Compressed token accounts store token balance, owner, and other information for SPL and Token 2022 mints.
Compressed token accounts are rent-free.
Any SPL or Token 2022 token can be compressed and decompressed at will.

Recommended Usage of Compressed Tokens

Token Distribution

Distribute tokens without paying upfront rent per recipient.

Create an Airdrop

Store SPL-token accounts rent-free

Compress existing SPL-token accounts to save rent costs for your users.

Compress SPL Token Accounts

Get Started

Installation & Setup

Install dependencies

npm
yarn
pnpm
SDK 2.0 (token-interface)

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

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

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

# npm
npm install @lightprotocol/stateless.js@^0.23.0 \
            @lightprotocol/token-interface@^0.1.2

# yarn
yarn add @lightprotocol/stateless.js@^0.23.0 \
         @lightprotocol/token-interface@^0.1.2

# pnpm
pnpm add @lightprotocol/stateless.js@^0.23.0 \
         @lightprotocol/token-interface@^0.1.2

Set up your developer environment

Localnet
Devnet

By default, all guides use Localnet.

npm
yarn
pnpm

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

yarn global add @lightprotocol/zk-compression-cli

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

# 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();

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";

const RPC_ENDPOINT = "https://devnet.helius-rpc.com?api-key=<your_api_key>";
const connection = createRpc(RPC_ENDPOINT);

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

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

main();

Basic Guides

Guide	Description
Create Compressed Token Accounts	Create compressed and learn difference to regular token accounts
Mint Compressed Tokens	Create new compressed tokens to existing mint
Transfer Compressed Tokens	Move compressed tokens between compressed accounts
Decompress and Compress Tokens	Convert SPL tokens between regular and compressed format
Compress Complete SPL Token Accounts	Compress complete SPL token accounts and reclaim rent afterwards
Create a Mint with Interface PDA	Create new SPL mint with SPL Interface PDA for compression
Create SPL Interface for Existing Mints	Create SPL Interface PDA for existing SPL mints
Merge Compressed Accounts	Consolidate multiple compressed accounts of the same mint into one
Approve and Revoke Delegate Authority	Approve or revoke delegates for compressed token accounts

Advanced Guides

Guide	Description
Create an Airdrop without Claim	ZK Compression is the most efficient way to distribute SPL tokens. Distribute via Webapp or customize with claim.
Privy Guide	Integrate compressed tokens with Privy embedded wallets for rent-free token accounts

Create Compressed Token AccountsShort guide to compressed token account creation with ZK Compression on Solana and difference to regular token accounts.

⌘I

Introduction

Compressed Tokens

Compressed PDA

Custom ZK Applications

Learn

Resources

Overview

Recommended Usage of Compressed Tokens

Token Distribution

Create an Airdrop

Store SPL-token accounts rent-free

Compress SPL Token Accounts

Get Started

Install dependencies

Set up your developer environment

Basic Guides

Advanced Guides

​Recommended Usage of Compressed Tokens

Token Distribution

Create an Airdrop

Store SPL-token accounts rent-free

Compress SPL Token Accounts

​Get Started

​Install dependencies

​Set up your developer environment

​Basic Guides

​Advanced Guides

Recommended Usage of Compressed Tokens

Get Started

Install dependencies

Set up your developer environment

Basic Guides

Advanced Guides