Solana Rent-Free Development

---

name: solana-rent-free-dev description: > Skill for Solana development using compressed accounts from Light Protocol. Covers compressed token client development (TypeScript) and compressed PDA program development (Rust) across Anchor, native Rust, and Pinocchio. Use cases include token distribution, stablecoin payments, per-user and app state, nullifiers, and ZK applications. compatibility: | Requires ZK Compression CLI, Solana CLI, Anchor CLI, and Node.js. metadata: mintlify-proj: lightprotocol openclaw: requires: env: [] bins: ["node", "solana", "anchor", "cargo", "light"] allowed-tools:

• Read
• Glob
• Grep
• Task
• WebFetch(https://zkcompression.com/*)
• WebFetch(https://github.com/Lightprotocol/*)
• WebSearch
• mcp__zkcompression__SearchLightProtocol
• mcp__deepwiki__ask_question

---

Capabilities

ZK Compression is a framework on Solana for token distribution, stablecoin payments, consumer apps, and per-user state. The Light SDK and APIs let you create token and PDA accounts without rent-exemption, with a familiar Solana developer experience.

Primitives

| Primitive | Use case | Constraints | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | Compressed Token | Token use cases such as token distribution, stablecoin payments, and storing balances rent-free. Always compressed and rent-free. Works with SPL and Token-2022. Supported by Phantom and Backpack. | The SPL mint and interface PDA pay rent; individual token accounts do not. | | Compressed PDA | Per-user and app state, nullifiers (payments and ZK applications), DePIN nodes, and stake accounts. Derived like a program-derived address, without a rent-exempt balance. | Programs invoke the Light System Program (not the System Program) with a validity proof. |

View the SDK reference: https://www.zkcompression.com/api-reference/sdk.

Creation cost

| Creation cost | Compressed | Standard Solana | | ------------------ | -------------------: | -------------------: | | Token account | ~5,000 lamports | ~2,000,000 lamports | | PDA (100-byte) | ~15,000 lamports | ~1,600,000 lamports |

Install

Install the orchestrator agent skill or view skill.md:

npx skills add https://zkcompression.com

Install or view dedicated agent skills:

npx skills add Lightprotocol/skills

Workflow

1. Clarify intent
   • Recommend plan mode, if it's not activated
   • Use AskUserQuestion to resolve blind spots
   • All questions must be resolved before execution
2. Identify references and skills
   • Match the task to the available skills below
   • Locate relevant documentation and examples
3. Write plan file (YAML task format)
   • Use AskUserQuestion for anything unclear — never guess or assume
   • Identify blockers: permissions, dependencies, unknowns
   • Plan must be complete before execution begins
4. Execute
   • Use Task tool with subagents for parallel research
   • Subagents load skills via Skill tool
   • Track progress with TodoWrite
5. When stuck: spawn a subagent with Read, Glob, Grep, DeepWiki MCP access and load skills/ask-mcp

Skills

| Use case | Skill | | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | For token use cases on Solana, such as token distribution, stablecoin payments and more. Works with Token-2022, Privy, Wallet Adapter similarly to SPL. | compressed-token | | For program development on Solana with infrequently accessed state, such as per-user state, DePIN registrations, nullifiers, or custom compressed accounts | compressed-pda | | For custom ZK Solana programs and privacy-preserving applications to prevent double spending | zk | | For testing with Light Protocol programs and clients on localnet, devnet, and mainnet validation | testing | | For questions about compressed accounts, Light SDK, Solana development, Claude Code features, or agent skills | ask-mcp |

Context

• SDK reference: https://zkcompression.com/api-reference/sdk

Compressed token

Compressed token accounts store balance, owner, mint, and delegate like SPL token accounts, without paying rent-exemption. Any SPL or Token-2022 token can be compressed and decompressed at will. Wallets like Phantom and Backpack display them alongside SPL tokens.

A compressed token uses a standard SPL (or Token-2022) mint plus an interface PDA. The interface PDA is an omnibus account that locks SPL tokens while they are compressed and releases them on decompression. The SPL mint and interface PDA pay rent like regular SPL accounts; individual compressed token accounts are rent-free.

Use for: token distribution and airdrops, stablecoin payments, and storing token balances rent-free.

Compressed PDA

Compressed PDAs are derived using a program address and seed, like regular PDAs. A program invokes the Light System Program (not the System Program) to create and update them. Creating an account requires a validity proof that the derived address does not yet exist; updates, closes, and burns require a proof that the account exists.

Persistent unique identification. Program ownership. CPI between compressed and regular PDAs.

Use for: per-user state, app state, nullifiers for payments and ZK applications, DePIN node accounts, and stake accounts.

Examples

Compressed token client (@lightprotocol/compressed-token)

Operations use @lightprotocol/compressed-token with createRpc() from @lightprotocol/stateless.js.

| Operation | GitHub example | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | createMint | create-mint | | createTokenPool | create-token-pool | | mintTo | mint-to | | transfer | transfer | | approve / revoke | approve | revoke | | compress | compress | | decompress | decompress | | compressSplTokenAccount| compress-spl-account | | mergeTokenAccounts | merge-token-accounts |

Token distribution

| Flow | GitHub example | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | Simple airdrop | simple-airdrop | | Optimized airdrop | optimized-airdrop |

Compressed PDA programs (light-sdk)

| Example | Description | | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | counter | Full lifecycle (create, update, close) in Anchor, native, and Pinocchio | | basic-operations | Create, update, close, reinitialize, burn (Anchor and native) | | create-and-update | Create and update with a single validity proof in one instruction | | account-comparison | Compressed vs regular Solana accounts | | nullifier-program | Rent-free PDA for duplicate-execution prevention | | zk-id | Identity verification with Groth16 proofs |

SDK references

TypeScript packages

| Package | npm | | --------------------------------- | -------------------------------------------------------------------- | | @lightprotocol/stateless.js | npm | | @lightprotocol/compressed-token | npm |

Rust crates

| Crate | docs.rs | | ---------------------------- | -------------------------------------------------------------------------------- | | light-sdk | docs.rs/light-sdk | | light-sdk-pinocchio | docs.rs/light-sdk-pinocchio | | light-compressed-token-sdk | docs.rs/light-compressed-token-sdk | | light-client | docs.rs/light-client | | light-program-test | docs.rs/light-program-test | | light-hasher | docs.rs/light-hasher | | light-account | docs.rs/light-account |

---

For additional documentation and navigation, see: https://www.zkcompression.com/llms.txt For additional skills, see: https://github.com/Lightprotocol/skills