Data Streaming
Stream Light Protocol account state transitions via Laserstream gRPC.
Workflow
- Clarify intent
- Recommend plan mode, if it's not activated
- Use
AskUserQuestion to resolve blind spots
- All questions must be resolved before execution
- Identify references and skills
- 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
- Execute
- Use
Task tool with subagents for parallel research
- Subagents load skills via
Skill tool
- Track progress with
TodoWrite
- When stuck: spawn subagent with
Read, Glob, Grep, DeepWiki MCP access and load skills/ask-mcp
When NOT to use
For simple account lookups, call get_account_interface from light-client. It races hot and cold lookups automatically.
This skill is for continuous data pipelines: aggregators, market makers, and indexers that need real-time state change notifications rather than point queries.
Domain references
| Audience |
Reference |
| All — shared architecture (read first) |
references/shared.md |
| Token accounts (SPL-compatible, 165 bytes) |
references/token-accounts.md |
| Mint accounts (borsh-deserialized, metadata) |
references/mint-accounts.md |
| Compressible PDAs (per-program, discriminator check) |
references/pdas.md |
Account type decision
| Streaming... |
Account type |
Key difference |
| SPL-compatible token balances |
Token accounts |
PodAccount parsing, 165-byte layout |
| Mint supply, metadata, authorities |
Mint accounts |
Mint::deserialize, borsh layout |
| Your program's PDA state |
Compressible PDAs |
8-byte discriminator check, per-program filter |
Program addresses
| Program |
Address |
| Light Token Program |
cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m |
| Light System Program |
SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7 |
External references
SDK references
Security
This skill does not pull, store, or transmit external secrets. It provides code patterns, documentation references, and development guidance only.
- No credentials consumed. The skill requires no API keys, private keys, or signing secrets.
env: [] is declared explicitly.
- User-provided configuration. RPC endpoints, wallet keypairs, and authentication tokens (Privy, wallet adapters) are configured in the user's own application code — the skill only demonstrates how to use them.
- API keys. Reference code uses
HELIUS_API_KEY as a placeholder. For production, set your RPC provider key as an environment variable.
- Subagent scope. This skill may spawn read-only subagents that use
Read, Glob, and Grep to search the local repository. Restrict the working directory to your project.
- Install source.
npx skills add Lightprotocol/skills installs from the public GitHub repository (Lightprotocol/skills). Verify the source before running.
- Audited protocol. Light Protocol smart contracts are independently audited. Reports are published at github.com/Lightprotocol/light-protocol/tree/main/audits.
1---2name: data-streaming3description: For data pipelines, aggregators, or indexers, real-time account state streaming on Solana with light account hot/cold lifecycle tracking. Stream Light token accounts, mint accounts, and PDAs via Laserstream gRPC.4---5
6# Data Streaming
7
8Stream Light Protocol account state transitions via Laserstream gRPC.
9
10## Workflow
11
121. **Clarify intent**
13 - Recommend plan mode, if it's not activated
14 - Use `AskUserQuestion` to resolve blind spots
15 - All questions must be resolved before execution
162. **Identify references and skills**
17 - Match task to [domain references](#domain-references) below
18 - Locate relevant documentation and examples
193. **Write plan file** (YAML task format)
20 - Use `AskUserQuestion` for anything unclear — never guess or assume
21 - Identify blockers: permissions, dependencies, unknowns
22 - Plan must be complete before execution begins
234. **Execute**
24 - Use `Task` tool with subagents for parallel research
25 - Subagents load skills via `Skill` tool
26 - Track progress with `TodoWrite`
275. **When stuck**: spawn subagent with `Read`, `Glob`, `Grep`, DeepWiki MCP access and load `skills/ask-mcp`
28
29## When NOT to use
30
31For simple account lookups, call `get_account_interface` from `light-client`. It races hot and cold lookups automatically.
32
33This skill is for continuous data pipelines: aggregators, market makers, and indexers that need real-time state change notifications rather than point queries.
34
35## Domain references
36
37| Audience | Reference |
38| -------- | --------- |
39| All — shared architecture (read first) | [references/shared.md](references/shared.md) |
40| Token accounts (SPL-compatible, 165 bytes) | [references/token-accounts.md](references/token-accounts.md) |
41| Mint accounts (borsh-deserialized, metadata) | [references/mint-accounts.md](references/mint-accounts.md) |
42| Compressible PDAs (per-program, discriminator check) | [references/pdas.md](references/pdas.md) |
43
44## Account type decision
45
46| Streaming... | Account type | Key difference |
47|---|---|---|
48| SPL-compatible token balances | Token accounts | `PodAccount` parsing, 165-byte layout |
49| Mint supply, metadata, authorities | Mint accounts | `Mint::deserialize`, borsh layout |
50| Your program's PDA state | Compressible PDAs | 8-byte discriminator check, per-program filter |
51
52## Program addresses
53
54| Program | Address |
55|---------|---------|
56| Light Token Program | `cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m` |
57| Light System Program | `SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7` |
58
59## External references
60
61| Resource | Link |
62|----------|------|
63| Photon indexer | [github.com/helius-labs/photon](https://github.com/helius-labs/photon) |
64| Streaming tokens toolkit | [zkcompression.com/light-token/toolkits/for-streaming-tokens](https://www.zkcompression.com/light-token/toolkits/for-streaming-tokens) |
65| Streaming mints toolkit | [zkcompression.com/light-token/toolkits/for-streaming-mints](https://www.zkcompression.com/light-token/toolkits/for-streaming-mints) |
66
67## SDK references
68
69| Package | Link |
70|---------|------|
71| `@lightprotocol/stateless.js` | [API docs](https://lightprotocol.github.io/light-protocol/stateless.js/index.html) |
72| `light-client` | [docs.rs](https://docs.rs/light-client/latest/light_client/) |
73
74
75## Security
76
77This skill does not pull, store, or transmit external secrets. It provides code patterns, documentation references, and development guidance only.
78
79- **No credentials consumed.** The skill requires no API keys, private keys, or signing secrets. `env: []` is declared explicitly.
80- **User-provided configuration.** RPC endpoints, wallet keypairs, and authentication tokens (Privy, wallet adapters) are configured in the user's own application code — the skill only demonstrates how to use them.
81- **API keys.** Reference code uses `HELIUS_API_KEY` as a placeholder. For production, set your RPC provider key as an environment variable.
82- **Subagent scope.** This skill may spawn read-only subagents that use `Read`, `Glob`, and `Grep` to search the local repository. Restrict the working directory to your project.
83- **Install source.** `npx skills add Lightprotocol/skills` installs from the public GitHub repository ([Lightprotocol/skills](https://github.com/Lightprotocol/skills)). Verify the source before running.
84- **Audited protocol.** Light Protocol smart contracts are independently audited. Reports are published at [github.com/Lightprotocol/light-protocol/tree/main/audits](https://github.com/Lightprotocol/light-protocol/tree/main/audits).
modbender