Skip to content

Conversation

@tilo-14
Copy link
Collaborator

@tilo-14 tilo-14 commented Jan 16, 2026

Summary

  • Merge create-an-airdrop and create-an-airdrop-with-claim into single airdrop.mdx
  • Add tested localnet examples (mint-spl-tokens.ts, simple-airdrop.ts)
  • Fix broken GitHub links (simple-claim path, distributor branch main→master)
  • Update internal links to new /airdrop path
  • Swap comparison table columns (distributor first)
  • Add Next Steps card linking to Claim Reference Implementations tab

Test plan

  • npx mintlify broken-links passes
  • Localnet code examples tested and working

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Consolidated and restructured airdrop content into a single, tabbed "Airdrop Guide" focused on ZK compression with interactive examples and expanded minting instructions.
    • Added "Merkle Distributor" and "Simple Airdrop with Claim" reference entries and integrated an Airship reference.
    • Updated navigation, overview tables, and home cards to point to the new guide; removed the duplicate airdrop-with-claim page.
  • Chores
    • Updated spelling dictionary with "jito"/"Jito".

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link

coderabbitai bot commented Jan 16, 2026

Walkthrough

This PR consolidates and restructures compressed-tokens airdrop documentation into a single, feature-focused guide at compressed-tokens/advanced-guides/airdrop, and updates navigation links and docs metadata to reference the consolidated guide.

Changes

Cohort / File(s) Summary
Navigation Link Updates
compressed-tokens/advanced-guides/add-wallet-support-for-compressed-tokens.mdx, compressed-tokens/advanced-guides/how-to-combine-operations-in-one-transaction.mdx, compressed-tokens/advanced-guides/use-token-2022-with-compression.mdx, compressed-tokens/overview.mdx
Repointed Next Steps / Card hrefs from /compressed-tokens/advanced-guides/create-an-airdrop to /compressed-tokens/advanced-guides/airdrop.
Airdrop Guide Consolidation & Rewrite
compressed-tokens/advanced-guides/airdrop.mdx
Rewrote guide: new title/metadata, added imports, replaced multi-guide split with tabbed interface (Localnet Guide / Claim Reference Implementations), added code samples for minting, integrated decompression examples, and added CardGroup entries linking external implementations.
Removed Metadata from Legacy Guide
compressed-tokens/advanced-guides/create-an-airdrop-with-claim.mdx
Removed YAML front matter and trailing GitHub link line (metadata cleanup).
Docs Navigation Manifest
docs.json
Added compressed-tokens/advanced-guides/airdrop to navigation; removed create-an-airdrop and create-an-airdrop-with-claim entries.
Home Page Cards
home.mdx
Renamed first Compressed Tokens card to "Airdrop Guide", updated href/description to point to consolidated guide, and removed the separate "Airdrop with Claim" card.
Overview Table Snippet
snippets/overview-tables/compressed-tokens-advanced-guides-table.mdx
Reordered table entries: added new top entries (airdrop guide, wallet support), removed old/duplicate entries and adjusted ordering.
Spellcheck Vocabulary
cspell.json
Added words jito and Jito to the words list.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 I hopped through docs to stitch and play,
One guide now leads the compressed-tokens way,
Tabs and code tucked in a neat little trail,
Seeds of tokens sprout without fail. 🌱

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'chore: refactor airdrop guide' accurately summarizes the main change: consolidating two airdrop guides into a single refactored guide and updating related navigation links.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.



📜 Recent review details

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0ae10d6 and 115c613.

📒 Files selected for processing (10)
  • compressed-tokens/advanced-guides/add-wallet-support-for-compressed-tokens.mdx
  • compressed-tokens/advanced-guides/airdrop.mdx
  • compressed-tokens/advanced-guides/create-an-airdrop-with-claim.mdx
  • compressed-tokens/advanced-guides/how-to-combine-operations-in-one-transaction.mdx
  • compressed-tokens/advanced-guides/use-token-2022-with-compression.mdx
  • compressed-tokens/overview.mdx
  • cspell.json
  • docs.json
  • home.mdx
  • snippets/overview-tables/compressed-tokens-advanced-guides-table.mdx
💤 Files with no reviewable changes (1)
  • compressed-tokens/advanced-guides/create-an-airdrop-with-claim.mdx
🚧 Files skipped from review as they are similar to previous changes (4)
  • compressed-tokens/overview.mdx
  • compressed-tokens/advanced-guides/add-wallet-support-for-compressed-tokens.mdx
  • compressed-tokens/advanced-guides/use-token-2022-with-compression.mdx
  • snippets/overview-tables/compressed-tokens-advanced-guides-table.mdx
🔇 Additional comments (11)
cspell.json (1)

187-189: LGTM!

Adding both "jito" and "Jito" to the spellcheck dictionary correctly resolves the CI spellcheck failure flagged in the past review. Both cases are valid for Jito Labs references in the documentation.

home.mdx (1)

106-115: LGTM!

The Card update correctly consolidates the airdrop documentation by:

  • Renaming to "Airdrop Guide" to reflect the merged content
  • Updating the href to the new /compressed-tokens/advanced-guides/airdrop path
  • Providing an accurate description emphasizing ZK Compression efficiency

This aligns well with the PR's objective to merge the separate airdrop guides.

docs.json (1)

130-133: LGTM!

The navigation update correctly:

  • Adds the consolidated airdrop guide at a prominent position directly under "Compressed Tokens"
  • Removes the old separate airdrop pages from the Examples group (per AI summary)

This elevation makes the airdrop functionality more discoverable for users.

compressed-tokens/advanced-guides/how-to-combine-operations-in-one-transaction.mdx (1)

192-198: LGTM!

The Next Steps card href correctly updated to point to the new consolidated airdrop guide path.

compressed-tokens/advanced-guides/airdrop.mdx (7)

1-6: LGTM!

The frontmatter correctly reflects the consolidated guide with appropriate title, sidebar title, description, and relevant keywords for SEO.


71-129: LGTM!

The mint-spl-tokens.ts example correctly demonstrates:

  • Loading a local wallet from the standard Solana CLI path
  • Creating an SPL mint with a token pool for compression
  • Creating an ATA and minting tokens for airdrop preparation
  • Clear step-by-step comments for learning purposes

Good choice for a localnet tutorial.


141-262: LGTM!

The simple-airdrop.ts example is well-structured with:

  • Proper infrastructure selection via getStateTreeInfos() and getTokenPoolInfos()
  • Appropriate compute budget estimation (120k CU per recipient)
  • Multi-recipient compression in a single transaction
  • Verification step to confirm distribution
  • Helpful comments for address lookup table usage in production

The highlighted lines (29-30, 45, 74, 100) effectively draw attention to key concepts.


288-339: LGTM!

The mint example correctly uses createMint from @lightprotocol/compressed-token which handles token pool creation automatically, simplifying the setup for production use.


480-588: LGTM!

The batched instructions implementation correctly:

  • Chunks recipients based on configurable limits
  • Uses selectStateTreeInfo and selectTokenPoolInfo for each batch
  • Applies compute budget limits appropriately
  • Returns well-structured instruction batches for parallel processing

1003-1011: Verify internal anchor link functionality.

The href #claim-reference-implementations links to an anchor within the same page. However, since "Claim Reference Implementations" is a Tab title (not a heading), the anchor may not work as expected in Mintlify's tab component. Tab content might not generate standard heading anchors.

Consider testing this link locally or updating it to switch tabs programmatically if the anchor doesn't work.


1017-1048: LGTM!

The Claim Reference Implementations section provides valuable guidance with:

  • Clear feature comparison table between distributor and simple-claim
  • Appropriate warning about audit status
  • Valid links to reference implementations

The "jito" spelling issue from the past review is now resolved via the cspell.json update.

✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.


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

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

- Merge create-an-airdrop and create-an-airdrop-with-claim into single airdrop.mdx
- Add tested localnet examples (mint-spl-tokens.ts, simple-airdrop.ts)
- Fix broken GitHub links (simple-claim path, distributor branch)
- Update internal links to new /airdrop path
- Swap comparison table columns (distributor first)
- Add Next Steps card linking to Claim Reference Implementations tab

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@tilo-14 tilo-14 force-pushed the chore/refactor-airdrop branch from 0ae10d6 to 115c613 Compare January 16, 2026 01:28
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@compressed-tokens/advanced-guides/airdrop.mdx`:
- Line 1036: The phrase "Merkle distributor based on jito airdrop and optimized
with rent-free PDAs." triggers a spellcheck failure for "jito"; update the
wording to use the proper noun by capitalizing it (e.g., change "jito airdrop"
to "Jito airdrop" or "Jito Labs airdrop") in the sentence containing "Merkle
distributor based on jito airdrop and optimized with rent-free PDAs." to resolve
the pipeline error (alternatively add "jito" to the project's spellcheck
dictionary if preferred).
📜 Review details

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 324d547 and 0ae10d6.

📒 Files selected for processing (9)
  • compressed-tokens/advanced-guides/add-wallet-support-for-compressed-tokens.mdx
  • compressed-tokens/advanced-guides/airdrop.mdx
  • compressed-tokens/advanced-guides/create-an-airdrop-with-claim.mdx
  • compressed-tokens/advanced-guides/how-to-combine-operations-in-one-transaction.mdx
  • compressed-tokens/advanced-guides/use-token-2022-with-compression.mdx
  • compressed-tokens/overview.mdx
  • docs.json
  • home.mdx
  • snippets/overview-tables/compressed-tokens-advanced-guides-table.mdx
💤 Files with no reviewable changes (1)
  • compressed-tokens/advanced-guides/create-an-airdrop-with-claim.mdx
🧰 Additional context used
🪛 GitHub Actions: CI
compressed-tokens/advanced-guides/airdrop.mdx

[error] 1036-1036: Spellcheck failed: Unknown word 'jito'. CSpell: Files checked: 201, Issues found: 1 in 1 file. Command 'npm run spellcheck' exited with code 1.

🔇 Additional comments (15)
compressed-tokens/overview.mdx (1)

30-36: LGTM!

The navigation link update to the consolidated airdrop guide is correct and consistent with the PR's refactoring objective.

compressed-tokens/advanced-guides/how-to-combine-operations-in-one-transaction.mdx (1)

192-198: LGTM!

The Next Steps card link correctly points to the new consolidated airdrop guide path.

compressed-tokens/advanced-guides/use-token-2022-with-compression.mdx (1)

270-276: LGTM!

The Next Steps card link correctly points to the new consolidated airdrop guide path.

compressed-tokens/advanced-guides/add-wallet-support-for-compressed-tokens.mdx (1)

634-639: LGTM!

The Next Steps card link correctly points to the new consolidated airdrop guide path.

home.mdx (1)

107-115: LGTM!

The card updates appropriately reflect the consolidation of airdrop guides:

  • Title renamed to the more general "Airdrop Guide"
  • Updated description accurately describes the consolidated guide's purpose
  • Link correctly points to the new airdrop path
docs.json (1)

133-133: LGTM!

The navigation update correctly consolidates the two previous airdrop entries (create-an-airdrop and create-an-airdrop-with-claim) into a single airdrop entry, aligning with the PR objective.

compressed-tokens/advanced-guides/airdrop.mdx (8)

1-14: LGTM!

Metadata and imports are well-structured with relevant SEO keywords for discoverability.


18-32: LGTM!

The tabbed structure with the comparison table provides clear guidance for users to choose the appropriate implementation based on their needs.


71-129: LGTM!

The mint-spl-tokens.ts example is well-documented with clear step-by-step comments and follows the standard pattern for creating an SPL mint with compression support on localnet.


141-262: LGTM!

The simple-airdrop.ts example demonstrates the complete airdrop workflow with proper state tree/token pool selection, compute budget optimization, and verification. The code is well-documented with clear steps.

Note: Line 251 contains &#x3C; which is the HTML entity for < — this will render correctly in the documentation.


267-461: LGTM!

The Simple Airdrop tab provides production-ready code with proper environment configuration, lookup table usage for reduced transaction size, and dynamic priority fee calculation.


463-893: LGTM!

The batched instructions implementation is well-designed for large-scale airdrops with proper chunking, background blockhash refresh, and retry logic. The modular structure with separate files for concerns (instructions, blockhash, signing) follows good practices.


896-1001: LGTM!

The Advanced Features section provides a complete decompression script and references to Jupiter swap integration, giving users flexibility in how they handle distributed tokens.


1013-1051: LGTM!

The Claim Reference Implementations tab provides clear comparison between distributor options with appropriate warnings about audit status. The CardGroup links to external repositories are well-structured.

snippets/overview-tables/compressed-tokens-advanced-guides-table.mdx (1)

3-5: LGTM!

Table entries correctly updated to reference the new consolidated airdrop guide path and provide clearer descriptions. The link paths align with the navigation changes in docs.json.

✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.

href="https://github.com/Lightprotocol/distributor"
horizontal
>
Merkle distributor based on jito airdrop and optimized with rent-free PDAs.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix spellcheck failure for "jito".

The pipeline is failing because "jito" is flagged as an unknown word by the spellchecker. Since "Jito" refers to Jito Labs (a known Solana ecosystem company), consider one of these fixes:

  1. Capitalize it as "Jito" (proper noun)
  2. Add "jito" to the project's spellcheck dictionary/word list
  3. Rephrase to "Jito Labs airdrop"
Suggested fix (option 1 - capitalize)
-    Merkle distributor based on jito airdrop and optimized with rent-free PDAs.
+    Merkle distributor based on Jito airdrop and optimized with rent-free PDAs.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Merkle distributor based on jito airdrop and optimized with rent-free PDAs.
Merkle distributor based on Jito airdrop and optimized with rent-free PDAs.
🧰 Tools
🪛 GitHub Actions: CI

[error] 1036-1036: Spellcheck failed: Unknown word 'jito'. CSpell: Files checked: 201, Issues found: 1 in 1 file. Command 'npm run spellcheck' exited with code 1.

🤖 Prompt for AI Agents
In `@compressed-tokens/advanced-guides/airdrop.mdx` at line 1036, The phrase
"Merkle distributor based on jito airdrop and optimized with rent-free PDAs."
triggers a spellcheck failure for "jito"; update the wording to use the proper
noun by capitalizing it (e.g., change "jito airdrop" to "Jito airdrop" or "Jito
Labs airdrop") in the sentence containing "Merkle distributor based on jito
airdrop and optimized with rent-free PDAs." to resolve the pipeline error
(alternatively add "jito" to the project's spellcheck dictionary if preferred).

@tilo-14 tilo-14 merged commit 694e0c3 into main Jan 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants