light-sdk

免租金 Solana 程序

Light SDK 为 PDA、代币账户和铸币账户支付租金豁免费用。程序逻辑基本无需改动。

租金成本（每个账户）	Solana / SPL	Light SDK
代币账户	~2,000,000 lamports	~11,000 lamports
DeFi 池平均值	~$2	~$0.02

工作流

1. 明确意图
   • 如果尚未启用计划模式，建议启用
   • 使用 AskUserQuestion 解决盲点
   • 执行前必须解决所有问题
2. 确定参考资料和技能
   • 将任务与下方的领域参考资料匹配
   • 查找相关文档和示例
3. 编写计划文件（YAML 任务格式）
   • 对任何不明确的事项使用 AskUserQuestion——绝不猜测或假设
   • 确定阻碍因素：权限、依赖项、未知事项
   • 执行开始前必须完成计划
4. 执行
   • 使用 Task 工具和子 Agent 并行调研
   • 子 Agent 通过 Skill 工具加载技能
   • 使用 TodoWrite 跟踪进度
5. 遇到阻碍时：启动子 Agent，使用 Read、Glob、Grep、DeepWiki MCP 访问权限，并加载 skills/ask-mcp

领域参考资料

受众	参考资料
Anchor 模式	references/anchor.md
Pinocchio 模式	references/pinocchio.md
客户端 SDK（LightProgramInterface）	references/client-sdk.md
测试	references/testing.md
CPI 指令	references/instructions.md
SPL 与 Light 对比	references/spl-to-light.md
常见问题	references/faq.md
Router 集成	references/router.md

如何选择

标准	Anchor	Pinocchio
框架	anchor-lang 0.31、#[light_program] 宏	pinocchio 0.9、LightProgramPinocchio 派生宏
状态结构体	Option<CompressionInfo> + LightAccount 派生宏	CompressionInfo（非可选）+ bytemuck::Pod + Zeroable + #[repr(C)]
账户创建	#[light_account(init, ...)] 属性或 CreateTokenAccountCpi	CreateTokenAccountCpi、CreateMints 批处理模式
压缩/解压处理程序	由 #[light_program] 宏自动生成	在入口点中路由 ProgramAccounts::COMPRESS_ACCOUNTS_IDEMPOTENT 等
程序 ID 常量	无需（由宏派生）	需要 pub const ID: Pubkey = pubkey_array!(...) + LIGHT_CPI_SIGNER
依赖项	light-sdk、light-sdk-macros、light-token、light-anchor-spl	light-account-pinocchio、light-token-pinocchio、bytemuck

DeFi 集成

对于 DeFi 程序（AMM、借贷、金库）：上述 Anchor 和 Pinocchio 模式可直接适用。DeFi 专用参考资料：

任务	参考资料
Router/聚合器集成（冷账户加载）	references/router.md
LightProgramInterface trait（Router 的客户端 SDK）	references/client-sdk.md

热与冷模型

长时间不活跃后（多个 epoch 未写入），账户会自动压缩为冷状态。程序只与热账户交互。客户端通过 create_load_instructions 将冷账户加载回链上。

	热（活跃）	冷（非活跃）
存储	链上	已压缩
延迟	正常	+0-200ms
Tx 大小	正常	+100-2400 bytes
CU	正常	+15k-400k CU
程序代码	不变	不变

热路径没有任何开销。

外部参考

资源	链接
Anchor AMM 参考	cp-swap-reference
Pinocchio 交换参考	pinocchio-swap
Anchor 计数器（免租金 PDA）	basic-macros/counter
Pinocchio 计数器（零拷贝 PDA）	pinocchio/counter

SDK 参考

包	链接
light-sdk	docs.rs
light-sdk-macros	docs.rs
light-sdk-pinocchio	docs.rs
light-token	docs.rs
light-token-pinocchio	docs.rs
light-account-pinocchio	docs.rs
light-token-client	docs.rs
light-client	docs.rs
light-program-test	docs.rs

安全

此技能不会获取、存储或传输外部机密。它仅提供代码模式、文档参考和开发指导。

• 不使用凭据。 此技能无需 API 密钥、私钥或签名机密。已明确声明 env: []。
• 用户提供配置。 RPC 端点、钱包密钥对和身份验证令牌（Privy、钱包适配器）均在用户自己的应用代码中配置；此技能仅演示如何使用它们。
• 安装来源。 npx skills add Lightprotocol/skills 会从公开的 GitHub 仓库 (Lightprotocol/skills) 安装。运行前请验证来源。
• 子 Agent 范围。 此技能可能会启动只读子 Agent，使用 Read、Glob 和 Grep 搜索本地仓库。请将工作目录限制为你的项目。
• 经过审计的协议。 Light Protocol 智能合约已由独立机构审计。审计报告发布于 github.com/Lightprotocol/light-protocol/tree/main/audits。