Add compressed token program documentation

.github/workflows/sync-handlers.yml

@@ -0,0 +1,33 @@
+name: Sync Handler Code
+
+on:
+  repository_dispatch:
+    types: [sync-handlers]
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout docs repo
+        uses: actions/checkout@v4
+
+      - name: Checkout light-protocol
+        uses: actions/checkout@v4
+        with:
+          repository: Lightprotocol/light-protocol
+          path: light-protocol
+          ref: ${{ github.event.client_payload.commit }}
+
+      - name: Sync handlers to docs
+        run: |
+          chmod +x ./scripts/sync-docs.sh
+          ./scripts/sync-docs.sh
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v5
+        with:
+          branch: sync-handlers-${{ github.event.client_payload.commit }}
+          title: "Sync handler code from light-protocol release"
+          body: |
+            Auto-generated from light-protocol commit: ${{ github.event.client_payload.commit }}
+          commit-message: "sync: update Full Code Examples from light-protocol"

.windsurf/workflows/ask-deepwiki.md

@@ -15,15 +15,15 @@ Query the Light Protocol repository via DeepWiki MCP with precise technical answ
 
 **MANDATORY STEPS BEFORE EXECUTION:**
 1. Read this complete file
-2. Read [Global CLAUDE.md](/home/tilo/.claude/CLAUDE.md)
+2. Read Global CLAUDE.md
 3. Read terminology reference for precision rules
 
 **VERIFICATION CHECKLIST:**
 - [ ] Have you completed all mandatory steps above?
 - [ ] Are you familiar with precision rules (avoid vague verbs)?
 - [ ] Will you provide file:line references?
 
-**Navigation**: [Global README](/home/tilo/.claude/README.md) | [Commands](/home/tilo/.claude/commands/) | [Global CLAUDE.md](/home/tilo/.claude/CLAUDE.md)
+**Navigation**: Global README | Commands | Global CLAUDE.md
 
 ## Command Process
 

blog/README.mdx

@@ -0,0 +1,3 @@
+---
+title: "Blog"
+---

blog/c-token.mdx

@@ -0,0 +1,133 @@
+---
+title: "Announcing rent-free Tokens on Solana: the Light-Token Standard"
+description: " Today we bring to you the light-token standard. A token standard with mint and token accounts equivalent to SPL, but without rent-exemption."
+
+---
+import { CodeCompare } from '/snippets/jsx/code-compare.jsx';
+import CompressibleRentExplained from '/snippets/compressible-rent-explained.mdx';
+import { RentLifecycleVisualizer } from '/snippets/jsx/rent-lifecycle-visualizer.jsx';
+
+Today we bring to you the light-token standard. A token standard with mint and token accounts equivalent to SPL, but without rent-exemption.
+Users receive and send the same tokens.
+From now on, you can create mints and tokens 
+1. at a fraction of the cost,
+2. with improved performance, and
+3. with similar developer experience.
+
+
+At the moment around XXX token accounts over 20k mint accounts are created on a daily basis.
+Many are created and rarely accessed.
+Still lock up SOL due to rent-exemption.
+There have been many discussions around how to solve rent on Solana (SIMD references).
+
+To truly scale Solana to 1 billion+ users the cost to store data must be near zero. 
+
+That's why we built light-token, which is like SPL token just stored more efficiently to reduce account creation cost. 
+#### Mints and Tokens without Rent-Exemption
+
+| Creation Cost        | SPL               | Light            |
+|:---------------------|:------------------|:-------------------|
+| **Mint Account**    | ~1,500,000 lamports        | **15,000** lamports     |
+| **Token Account**    | ~2,000,000 lamports | ~**17,000** lamports |
+
+#### Interoperability with Existing SPL Tokens
+
+A key feature to highlight is that light-token accounts can hold tokens from light, SPL, or Token 2022 mints.
+This means you can convert existing SPL tokens to light-tokens and back. 
+Existing SPL tokens can hereby benefit from the rent config light-token introduces, to which we get in a minute.
+
+This is implemented by the `light-token-sdk`.
+It follows similar patterns to SPL to maximize developer experience
+and puts the barrier low to integrate light-token in your protocol, app, or payment flow.
+
+Example to create SPL vs light-token account:
+<CodeCompare
+  firstCode={`// Create SPL token account
+const ix = createAssociatedTokenAccountInstruction(
+  payer,
+  ata,
+  owner,
+  mint
+);`}
+  secondCode={`// Create light-token account
+const ix = CreateAssociatedTokenAccount.new(
+  payer,
+  account,
+  owner,
+  mint
+);`}
+  firstLabel="SPL"
+  secondLabel="Light-Token"
+/>
+
+## Light-Token Program Features
+
+### Mint Accounts with Token Metadata
+
+Mints uniquely represent a token on Solana and store its global metadata, 
+similar to SPL mint accounts with few core differences:
+- Light-token mint accounts are compressed accounts and rent-free.
+- Tokens created from light-token mints are light-tokens.
+
+You can view the source code here.
+
+### Token Accounts with Pay-as-you-go Rent
+
+Light-tokens are like SPL tokens and hold token balances of light, SPL, or Token 2022 mints.
+
+Light-token accounts are Solana accounts, but don't require the creator to pay rent-exemption.
+Instead, rent is paid over time when accounts are accessed:
+
+<CompressibleRentExplained />
+
+<RentLifecycleVisualizer />
+
+The token accounts is initalized and funded with initial rent.
+When rent runs low, transactions top-up the account's rent balance.
+Transactions only top-up the account's rent balance, when it is low. 
+When rent runs out, the account is automatically compressed. 
+Your tokens are preserved as a compressed token account and 
+are automatically decompressed when you interact with it again.
+
+You can view the source code here.
+
+### Extensions
+
+Extensions are under development and are currently implemented. 
+Additional extensions can be requested.
+
+Coming soon:
+- MetadataPointer
+- TokenMetadata
+- InterestBearingConfig
+- GroupPointer
+- GroupMemberPointer
+- TokenGroup
+- TokenGroupMember
+- MintCloseAuthority
+- TransferFeeConfig
+- DefaultAccountState
+- PermanentDelegate
+- TransferHook
+- Pausable
+- ConfidentialTransferMint
+- ConfidentialTransferFeeConfig
+- ConfidentialMintBurn
+
+## Integrate with Your Application
+
+We have dedicated toolkits for specific use cases:
+
+- [Payments](/light-token/toolkits/for-payments)
+- [Wallets](/light-token/toolkits/for-wallets)
+- [DEXs](/light-token/toolkits/for-dexs)
+- [Launchpads](/light-token/toolkits/for-launchpads)
+- [Trading Apps](/light-token/toolkits/for-trading-apps)
+
+Get in touch on telegram for help!
+
+## What's next?
+
+For now, light-token is live on Devnet. Mainnet is anticipated for end of Q1 2026. 
+
+Get started and send us your feedback!

client-library/client-guide.mdx

@@ -5,7 +5,7 @@ description: >-
   code examples.
 ---
 
-import SystemAccountsList from '/snippets/compressed-pdas-system-accounts-list.mdx';
+import SystemAccountsList from '/snippets/accounts-list/compressed-pdas-system-accounts-list.mdx';
 
 ZK Compression provides Rust and Typescript clients to interact with compressed accounts and tokens on Solana.
 

compressed-pdas/create-a-program-with-compressed-pdas.mdx

@@ -1,16 +1,16 @@
 ---
-title: Create a Program with Compressed PDAs
-description: Overview to compressed PDA core features and guide for program development
+title: Overview & Program Template
+description: Compressed PDAs provide full functionality of accounts at PDAs, without rent-exemption per account.
+
 ---
 
-import ProgramExamplesTable from '/snippets/program-examples-table.mdx';
-import DevelopmentEnvironmentSetup from '/snippets/development-environment-setup.mdx';
+import ProgramExamplesTable from '/snippets/overview-tables/program-examples-table.mdx';
+import DevelopmentEnvironmentSetup from '/snippets/setup/development-environment-setup.mdx';
 
-Compressed PDAs provide full functionality of accounts at PDAs, without per-account rent cost.
 
-| Creation      | Regular PDA Account    | Compressed PDA         | Cost Reduction     |
-| :------------- | :--------------------- | :---------------------- | :------------------ |
-| 100-byte PDA  | ~ 0.0016 SOL          | **~ 0.00001 SOL**      | ***160x***         |
+| Creation      | Regular PDA Account    | Compressed PDA         |
+| :------------- | :--------------------- | :---------------------- |
+| 100-byte PDA  | 	~1,600,000 lamports          | 15,000 lamports     |
 
 Compressed PDAs are derived using a specific program address and seed, like regular PDAs. Custom programs invoke the <Tooltip tip="The program enforces compressed account layout with ownership and sum checks. It is invoked to create and interact with compressed accounts and tokens.">Light System program</Tooltip> to create and update accounts, instead of the System program.
 

compressed-pdas/guides.mdx

@@ -4,7 +4,7 @@ description: Overview to guides for Solana programs to create, update, close, re
 sidebarTitle: "Overview"
 ---
 
-import GuidesTable from '/snippets/compressed-pdas-guides-table.mdx';
+import GuidesTable from '/snippets/overview-tables/compressed-pdas-guides-table.mdx';
 
 <GuidesTable />
 

compressed-pdas/guides/how-to-burn-compressed-accounts.mdx

@@ -3,9 +3,9 @@ title: Burn Compressed Accounts
 description: Guide to burn compressed accounts in Solana programs with full code examples.
 ---
 
-import CompressedPdasProgramSetup from '/snippets/compressed-pdas-program-setup.mdx';
-import CompressedPdasSystemAccountsList from '/snippets/compressed-pdas-system-accounts-list.mdx';
-import DevelopmentEnvironmentSetup from '/snippets/development-environment-setup.mdx';
+import CompressedPdasProgramSetup from '/snippets/setup/compressed-pdas-program-setup.mdx';
+import CompressedPdasSystemAccountsList from '/snippets/accounts-list/compressed-pdas-system-accounts-list.mdx';
+import DevelopmentEnvironmentSetup from '/snippets/setup/development-environment-setup.mdx';
 
 Compressed accounts are permanently burned via CPI to the Light System Program.
 

compressed-pdas/guides/how-to-close-compressed-accounts.mdx

@@ -3,9 +3,9 @@ title: Close Compressed Accounts
 description: Guide to close compressed accounts in Solana programs with full code examples.
 ---
 
-import CompressedPdasProgramSetup from '/snippets/compressed-pdas-program-setup.mdx';
-import CompressedPdasSystemAccountsList from '/snippets/compressed-pdas-system-accounts-list.mdx';
-import DevelopmentEnvironmentSetup from '/snippets/development-environment-setup.mdx';
+import CompressedPdasProgramSetup from '/snippets/setup/compressed-pdas-program-setup.mdx';
+import CompressedPdasSystemAccountsList from '/snippets/accounts-list/compressed-pdas-system-accounts-list.mdx';
+import DevelopmentEnvironmentSetup from '/snippets/setup/development-environment-setup.mdx';
 
 Compressed accounts are closed via CPI to the Light System Program.
 

compressed-pdas/guides/how-to-create-compressed-accounts.mdx

@@ -3,8 +3,8 @@ title: Create Compressed Accounts
 description: Guide to create compressed accounts in Solana programs with full code examples.
 ---
 
-import CompressedPdasSystemAccountsList from '/snippets/compressed-pdas-system-accounts-list.mdx';
-import DevelopmentEnvironmentSetup from '/snippets/development-environment-setup.mdx';
+import CompressedPdasSystemAccountsList from '/snippets/accounts-list/compressed-pdas-system-accounts-list.mdx';
+import DevelopmentEnvironmentSetup from '/snippets/setup/development-environment-setup.mdx';
 
 Compressed accounts and addresses are created via CPI to the Light System Program.