Skip to content

Commit 663d520

Browse files
author
tilo-14
committed
split AI tools into four pages, add sponsor top-ups prompt, support footers
- Split ai-tools/guide into overview, agent-skills, mcp, prompts - Add sponsor rent top-ups AI prompt and FAQ entry - Add support footer to all toolkit pages - Promote payments guide headings to h2 - Update docs.json navigation and redirects
1 parent f7d3e55 commit 663d520

35 files changed

Lines changed: 1707 additions & 136 deletions

‎ai-tools/agent-skills.mdx‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: "Agent skills"
3+
description: "Install structured agent skill files for Token API's and PDA accounts. Skills tell AI coding agents what they can do with ZK Compression."
4+
---
5+
6+
## Agent Skill for Orchestration
7+
View or install [`/skill.md`](https://zkcompression.com/skill.md). If you're building with agents, start here.
8+
9+
```bash
10+
npx skills add https://zkcompression.com
11+
```
12+
13+
## Dedicated Agent Skills
14+
15+
<Tabs>
16+
<Tab title="Claude Code">
17+
Add the marketplace and install:
18+
19+
```
20+
/plugin marketplace add Lightprotocol/skills
21+
/plugin install solana-rent-free-dev
22+
```
23+
</Tab>
24+
<Tab title="Cursor">
25+
1. Open Settings (**Cmd+Shift+J** / **Ctrl+Shift+J**)
26+
2. Navigate to **Rules & Commands** → **Project Rules** → **Add Rule** → **Remote Rule (GitHub)**
27+
3. Enter: `https://github.com/Lightprotocol/skills.git`
28+
</Tab>
29+
<Tab title="Any Agent">
30+
```
31+
npx skills add Lightprotocol/skills
32+
```
33+
</Tab>
34+
</Tabs>
35+
36+
| Use case | Skill |
37+
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
38+
| Build rent-free Solana programs with Light SDK (Anchor or Pinocchio). Includes router integration. | [light-sdk](https://github.com/Lightprotocol/skills/tree/main/skills/light-sdk) |
39+
| Use Light Token client SDKs (TypeScript and Rust) for mints, ATAs, transfers | [light-token-client](https://github.com/Lightprotocol/skills/tree/main/skills/light-token-client) |
40+
| Stream account state via Laserstream gRPC | [data-streaming](https://github.com/Lightprotocol/skills/tree/main/skills/data-streaming) |
41+
| Wallets and payment flows with light-token. Includes privy, wallet adapter, mobile wallet adapter signing. Optional nullifier to prevent your onchain instruction from being executed more than once. | [payments-and-wallets](https://github.com/Lightprotocol/skills/tree/main/skills/payments-and-wallets) |
42+
| Airdrops, DePIN, token distribution | [token-distribution](https://github.com/Lightprotocol/skills/tree/main/skills/token-distribution) |
43+
| Anti-double-spend nullifiers for Privacy-preserving ZK programs | [zk-nullifier](https://github.com/Lightprotocol/skills/tree/main/skills/zk-nullifier) |
44+
| Testing programs and clients on localnet, devnet, mainnet | [testing](https://github.com/Lightprotocol/skills/tree/main/skills/testing) |
45+
| For per-user state, DePIN nodes, and infrequently accessed app state with compressed PDAs | [solana-compression](https://github.com/Lightprotocol/skills/tree/main/skills/solana-compression) |
46+
| Help with Debugging and Questions via DeepWiki MCP | [ask-mcp](https://github.com/Lightprotocol/skills/tree/main/skills/ask-mcp) |
47+
48+
> View all skills here: https://github.com/Lightprotocol/skills.
49+
50+
All skills are included and are auto-discovered based on context. Ask about light-token, defi, payments, or program migration and the agent uses the relevant skill automatically.

ai-tools/guide.mdx renamed to ai-tools/mcp.mdx

Lines changed: 4 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,11 @@
11
---
2-
title: "AI Tools Guide"
3-
description: "Guidance to AI tools when working with ZK Compression. Includes Agent Skill, MCP server, DeepWiki, and AI Search guides."
2+
title: "MCP"
3+
description: "Connect AI apps to Light Protocol data sources and tools via the Model Context Protocol (MCP). Includes installation for Claude Code, Codex, Cursor, and more."
44
---
5-
import InstallAgentSkills from "/snippets/setup/install-agent-skills.mdx";
6-
7-
# For Docs
8-
9-
- **Docs AI Search** - Search documentation with AI in the search bar.
10-
- **Markdown Export** - Append `.md` to any page URL for raw markdown.
11-
* **View [`/llms.txt`](https://zkcompression.com/llms.txt)** for an index of the docs - It lists key pages with descriptions
12-
so agents can navigate to answers quickly.
13-
14-
# For Development
15-
16-
## Agent Skills
17-
18-
View or install [`/skill.md`](https://zkcompression.com/skill.md), a structured capability file that tells agents what they can do
19-
with Light Protocol and ZK Compression. If you're building with agents, start here.
20-
21-
Install or view dedicated agent skills:
22-
23-
| Use case | Skill |
24-
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
25-
| Build rent-free Solana programs with Light SDK (Anchor or Pinocchio). Includes router integration. | [light-sdk](https://github.com/Lightprotocol/skills/tree/main/skills/light-sdk) |
26-
| Use Light Token client SDKs (TypeScript and Rust) for mints, ATAs, transfers | [light-token-client](https://github.com/Lightprotocol/skills/tree/main/skills/light-token-client) |
27-
| Stream account state via Laserstream gRPC | [data-streaming](https://github.com/Lightprotocol/skills/tree/main/skills/data-streaming) |
28-
| Wallets and payment flows with light-token. Includes privy, wallet adapter, mobile wallet adapter signing. Optional nullifier to prevent your onchain instruction from being executed more than once. | [payments-and-wallets](https://github.com/Lightprotocol/skills/tree/main/skills/payments-and-wallets) |
29-
| Airdrops, DePIN, token distribution | [token-distribution](https://github.com/Lightprotocol/skills/tree/main/skills/token-distribution) |
30-
| Anti-double-spend nullifiers for Privacy-preserving ZK programs | [zk-nullifier](https://github.com/Lightprotocol/skills/tree/main/skills/zk-nullifier) |
31-
| Testing programs and clients on localnet, devnet, mainnet | [testing](https://github.com/Lightprotocol/skills/tree/main/skills/testing) |
32-
| For per-user state, DePIN nodes, and infrequently accessed app state with compressed PDAs | [solana-compression](https://github.com/Lightprotocol/skills/tree/main/skills/solana-compression) |
33-
| Help with Debugging and Questions via DeepWiki MCP | [ask-mcp](https://github.com/Lightprotocol/skills/tree/main/skills/ask-mcp) |
34-
35-
> View all skills here: https://github.com/Lightprotocol/skills.
36-
37-
All skills are included and are auto-discovered based on context. Ask about light-token, defi, payments, or program migration and the agent uses the relevant skill automatically.
38-
39-
<InstallAgentSkills />
40-
41-
## AI Prompts
42-
43-
<Card
44-
title="Find ready-to-use AI prompts for your agent here and all guides. "
45-
icon="chevron-right"
46-
color="#0066ff"
47-
href="/ai-tools/prompts"
48-
horizontal
49-
/>
50-
51-
## MCP
525

536
The Model Context Protocol (MCP) is an open standard to connect AI apps to data sources and tools. The DeepWiki MCP server provides access to the Light Protocol repository with its search capabilities (AskDevin).
547

55-
### Installation
8+
## Installation
569

5710
<Tabs>
5811
<Tab title="Claude Code">
@@ -166,7 +119,7 @@ codex mcp add deepwiki -- npx -y mcp-remote@latest https://mcp.deepwiki.com/mcp
166119
</Tab>
167120
</Tabs>
168121

169-
### DeepWiki MCP-Tools
122+
## DeepWiki MCP-Tools
170123

171124
- **read\_wiki\_structure** - Get a list of documentation topics for a GitHub repository
172125

@@ -208,4 +161,3 @@ If you don't have the MCP installed we recommend to use [AskDevin](https://deepw
208161
</Frame>
209162

210163
</Accordion>
211-

‎ai-tools/overview.mdx‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: "AI tools"
3+
sidebarTitle: "Overview"
4+
description: "AI tools for working with Light Protocol and ZK Compression. Includes docs search, agent skills, MCP server, and ready-to-use prompts."
5+
---
6+
7+
## For docs
8+
9+
- **Docs AI Search** - Search documentation with AI in the search bar.
10+
- **Markdown Export** - Append `.md` to any page URL for raw markdown.
11+
* **View [`/llms.txt`](https://zkcompression.com/llms.txt)** for an index of the docs - It lists key pages with descriptions
12+
so agents can navigate to answers quickly.
13+
14+
## For development
15+
16+
<CardGroup cols={3}>
17+
<Card title="Agent Skills" icon="wand-magic-sparkles" href="/ai-tools/agent-skills">
18+
Install structured skill files that tell agents what they can do with Light Protocol.
19+
</Card>
20+
<Card title="MCP" icon="plug" href="/ai-tools/mcp">
21+
Connect AI apps to Light Protocol data sources via the Model Context Protocol.
22+
</Card>
23+
<Card title="AI Prompts" icon="message-bot" href="/ai-tools/prompts">
24+
Ready-to-use prompts for your AI coding agent.
25+
</Card>
26+
</CardGroup>

‎api-reference/sdk.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: SDK Reference
3+
sidebarTitle: Reference
34
description: Client and program SDKs for Light Token and ZK Compression.
45
---
56

‎docs.json‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,7 @@
6464
"pages": [
6565
"light-token/toolkits/for-wallets",
6666
"light-token/toolkits/for-privy",
67+
"light-token/toolkits/for-wallet-adapter",
6768
"light-token/toolkits/sponsor-top-ups"
6869
]
6970
},
@@ -227,7 +228,9 @@
227228
{
228229
"group": "AI Tools",
229230
"pages": [
230-
"ai-tools/guide",
231+
"ai-tools/overview",
232+
"ai-tools/agent-skills",
233+
"ai-tools/mcp",
231234
"ai-tools/prompts"
232235
]
233236
}
@@ -323,7 +326,7 @@
323326
},
324327
{
325328
"source": "/learn/ai-tools-guide",
326-
"destination": "https://zkcompression.com/ai-tools/guide"
329+
"destination": "https://zkcompression.com/ai-tools/overview"
327330
},
328331
{
329332
"source": "/resources/sdks/client-development",
@@ -887,7 +890,11 @@
887890
},
888891
{
889892
"source": "/learn/ask-deepwiki-public",
890-
"destination": "https://zkcompression.com/ai-tools/guide"
893+
"destination": "https://zkcompression.com/ai-tools/mcp"
894+
},
895+
{
896+
"source": "/ai-tools/guide",
897+
"destination": "https://zkcompression.com/ai-tools/overview"
891898
},
892899
{
893900
"source": "/light-token/cookbook/overview",

‎faq.mdx‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,26 @@ This is dealt with under the hood in a way that doesn’t disrupt the UX of what
3030

3131
</Accordion>
3232

33+
<Accordion title="How can I sponsor rent top-ups for my users?">
34+
35+
Set the `payer` parameter to the sponsor's public key on any Light Token instruction. The sponsor pays SOL for rent top-ups while the user only signs to authorize the transfer.
36+
37+
```typescript
38+
const ix = createLightTokenTransferInstruction(
39+
senderAta,
40+
recipientAta,
41+
sender.publicKey,
42+
amount,
43+
sponsor.publicKey, // sponsor pays rent top-ups
44+
);
45+
46+
await sendAndConfirmTransaction(rpc, tx, [sponsor, sender]);
47+
```
48+
49+
<Card title="Sponsor rent top-ups guide" icon="chevron-right" color="#0066ff" href="/light-token/toolkits/sponsor-top-ups" horizontal />
50+
51+
</Accordion>
52+
3353
## Light Token Program
3454

3555
<Accordion title="What is light-token?">

‎light-token/toolkits/for-payments.mdx‎

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ import ToolkitsSetup from "/snippets/setup/toolkits-setup.mdx";
1010
import RegisterSplMint from "/snippets/setup/register-spl-mint.mdx";
1111
import AgentSkillPayments from "/snippets/setup/agent-skill-payments.mdx";
1212
import PaymentsAiPrompt from "/snippets/ai-prompts/toolkits/payments.mdx";
13+
import SupportFooter from "/snippets/support-footer.mdx";
1314

1415
1. The light-token API matches the SPL-token API almost entirely, and extends their functionality to include the light token program in addition to the SPL-token and Token-2022 programs.
1516
2. Your users use the same stablecoins, just stored more efficiently.
@@ -97,9 +98,7 @@ import {
9798
const rpc = createRpc(RPC_ENDPOINT);
9899
```
99100

100-
<RegisterSplMint />
101-
102-
### Receive Payments
101+
## Receive Payments
103102

104103
<Note>
105104
Find a full code example [here](https://github.com/Lightprotocol/examples-light-token/blob/main/toolkits/payments-and-wallets/receive.ts).
@@ -119,16 +118,16 @@ loop handles the rare multi-transaction case automatically.
119118
<Tab title="Instruction">
120119

121120
```typescript
122-
import { Transaction } from "@solana/web3.js";
121+
import { Transaction, sendAndConfirmTransaction } from "@solana/web3.js";
123122
import {
124123
createLoadAtaInstructions,
125124
getAssociatedTokenAddressInterface,
126125
} from "@lightprotocol/compressed-token/unified";
127126

128127
const ata = getAssociatedTokenAddressInterface(mint, recipient);
129128

130-
// Returns TransactionInstruction[][].
131-
// Each inner array is one transaction.
129+
// Returns TransactionInstruction[][].
130+
// Each inner array is one transaction.
132131
// Almost always returns just one.
133132
const instructions = await createLoadAtaInstructions(
134133
rpc,
@@ -140,8 +139,7 @@ const instructions = await createLoadAtaInstructions(
140139

141140
for (const ixs of instructions) {
142141
const tx = new Transaction().add(...ixs);
143-
144-
// sign and send ...
142+
await sendAndConfirmTransaction(rpc, tx, [payer, owner]);
145143
}
146144
```
147145

@@ -187,7 +185,7 @@ const ata = await getOrCreateAssociatedTokenAccount(
187185

188186
</Accordion>
189187

190-
### Send Payments
188+
## Send Payments
191189

192190
<Note>
193191
Find a full code example: [instruction](https://github.com/Lightprotocol/examples-light-token/blob/main/toolkits/payments-and-wallets/send-instruction.ts) | [action](https://github.com/Lightprotocol/examples-light-token/blob/main/toolkits/payments-and-wallets/send-action.ts).
@@ -197,11 +195,11 @@ Find a full code example: [instruction](https://github.com/Lightprotocol/example
197195
<Tab title="Instruction">
198196

199197
```typescript
200-
import { Transaction } from "@solana/web3.js";
198+
import { Transaction, sendAndConfirmTransaction } from "@solana/web3.js";
201199
import { createTransferInterfaceInstructions } from "@lightprotocol/compressed-token/unified";
202200

203-
// Returns TransactionInstruction[][].
204-
// Each inner array is one transaction.
201+
// Returns TransactionInstruction[][].
202+
// Each inner array is one transaction.
205203
// Almost always returns just one.
206204
const instructions = await createTransferInterfaceInstructions(
207205
rpc,
@@ -214,8 +212,7 @@ const instructions = await createTransferInterfaceInstructions(
214212

215213
for (const ixs of instructions) {
216214
const tx = new Transaction().add(...ixs);
217-
218-
// sign and send ...
215+
await sendAndConfirmTransaction(rpc, tx, [payer, owner]);
219216
}
220217
```
221218

@@ -332,7 +329,7 @@ await transfer(connection, payer, sourceAta, destinationAta, owner, amount);
332329
</Tab>
333330
</Tabs>
334331

335-
### Show Balance
332+
## Show Balance
336333

337334
<Note>
338335
Find a full code example [here](https://github.com/Lightprotocol/examples-light-token/blob/main/toolkits/payments-and-wallets/get-balance.ts).
@@ -362,7 +359,7 @@ console.log(account.amount);
362359

363360
</Accordion>
364361

365-
### Transaction History
362+
## Transaction History
366363

367364
<Note>
368365
Find a full code example [here](https://github.com/Lightprotocol/examples-light-token/blob/main/toolkits/payments-and-wallets/get-history.ts).
@@ -386,7 +383,7 @@ const signatures = await connection.getSignaturesForAddress(ata);
386383

387384
</Accordion>
388385

389-
### Wrap from SPL
386+
## Wrap from SPL
390387

391388
Wrap tokens from SPL/Token-2022 accounts to light-token ATA.
392389

@@ -445,7 +442,7 @@ await wrap(rpc, payer, splAta, tokenAta, owner, mint, amount);
445442
</Tab>
446443
</Tabs>
447444

448-
### Unwrap to SPL
445+
## Unwrap to SPL
449446

450447
Unwrap moves the token balance from a light-token account to a SPL-token account.
451448
Use this to compose with applications that do not yet support light-token.
@@ -495,8 +492,12 @@ await unwrap(rpc, payer, splAta, owner, mint, amount);
495492
</Tab>
496493
</Tabs>
497494

495+
<RegisterSplMint />
496+
498497
</Tab>
499498
<Tab title="AI Prompt">
500499
<PaymentsAiPrompt />
501500
</Tab>
502501
</Tabs>
502+
503+
<SupportFooter />

0 commit comments

Comments
 (0)