refactor(cli): rename compress/decompress to wrap/unwrap and update commands

[tilo-14]

The rebrand: "ZK Compression" → "Light Token"

The CLI was built around the "ZK Compression" branding — compress SOL, compress SPL, decompress, compressed token balance, etc. The product is being repositioned as Light Token — a token standard on Solana, not a compression utility. The CLI language needs to reflect what users actually do, not the underlying mechanism.

What changed

1. Rename compress/decompress → wrap/unwrap (6e31743)

• compress-spl → wrap-spl (you're wrapping SPL tokens into Light Tokens)
• decompress-spl → unwrap-spl (you're unwrapping Light Tokens back to SPL)
• Commands, tests, file paths all renamed

2. Remove ZK Compression SOL commands (e29b806)

• Deleted compress-sol and decompress-sol entirely
• Deleted balance (compressed SOL balance)
• Deleted merge-token-accounts
• Deleted approve-and-mint-to
• These were compression-layer primitives, not Light Token operations

3. Fix transfer to pass wallet key not ATA (243683c)

• transferInterface expected the wallet pubkey, not the derived ATA address

4. Remove redundant decompressMint (4b73af8)

• Cleaned up a leftover V1 function, updated init command description

5. Replace V1 mintTo in test helpers (5f0ad94)

• Test setup was using V1 mintTo from @lightprotocol/compressed-token to mint compressed tokens directly
• This is the old V1 compress path — it bypasses wrap entirely
• Now: setup mints plain SPL tokens into an ATA, tests call wrap-spl/unwrap-spl
• Tests exercise the actual user flow instead of a V1 backdoor

Net result

The CLI went from ~16 commands exposing compression internals to a focused set of Light Token operations: create-mint, mint-to, transfer, wrap-spl, unwrap-spl, token-balance, create-token-account. The V1 compressed token path is gone from the test helpers. The CI workflow was renamed from cli-tests-v2 to cli-tests.

---

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (35)

• .github/workflows/cli-v1.yml is excluded by none and included by none
• .github/workflows/cli-v2.yml is excluded by none and included by none
• cli/README.md is excluded by none and included by none
• cli/justfile is excluded by none and included by none
• cli/package.json is excluded by none and included by none
• cli/src/commands/approve-and-mint-to/index.ts is excluded by none and included by none
• cli/src/commands/balance/index.ts is excluded by none and included by none
• cli/src/commands/compress-sol/index.ts is excluded by none and included by none
• cli/src/commands/create-interface-pda/index.ts is excluded by none and included by none
• cli/src/commands/create-mint/index.ts is excluded by none and included by none
• cli/src/commands/create-token-account/index.ts is excluded by none and included by none
• cli/src/commands/decompress-sol/index.ts is excluded by none and included by none
• cli/src/commands/init/index.ts is excluded by none and included by none
• cli/src/commands/merge-token-accounts/index.ts is excluded by none and included by none
• cli/src/commands/mint-to/index.ts is excluded by none and included by none
• cli/src/commands/token-balance/index.ts is excluded by none and included by none
• cli/src/commands/transfer/index.ts is excluded by none and included by none
• cli/src/commands/unwrap-spl/index.ts is excluded by none and included by none
• cli/src/commands/wrap-spl/index.ts is excluded by none and included by none
• cli/test/commands/approve-and-mint-to/index.test.ts is excluded by none and included by none
• cli/test/commands/balance/index.test.ts is excluded by none and included by none
• cli/test/commands/compress-sol/index.test.ts is excluded by none and included by none
• cli/test/commands/create-interface-pda/index.test.ts is excluded by none and included by none
• cli/test/commands/create-mint/index.test.ts is excluded by none and included by none
• cli/test/commands/create-token-account/index.test.ts is excluded by none and included by none
• cli/test/commands/decompress-sol/index.test.ts is excluded by none and included by none
• cli/test/commands/merge-token-accounts/index.test.ts is excluded by none and included by none
• cli/test/commands/mint-to/index.test.ts is excluded by none and included by none
• cli/test/commands/token-balance/index.test.ts is excluded by none and included by none
• cli/test/commands/transfer/index.test.ts is excluded by none and included by none
• cli/test/commands/unwrap-spl/index.test.ts is excluded by none and included by none
• cli/test/commands/wrap-spl/index.test.ts is excluded by none and included by none
• cli/test/helpers/helpers.ts is excluded by none and included by none
• external/photon is excluded by none and included by none
• js/compressed-token/src/index.ts is excluded by none and included by none

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch bump-cli-v2

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 5 additional findings.