magicblock

用途：面向 MagicBlock 专项开发，处理 ER/PER、委托（delegation）、预言机、Session Keys、cranks、VRF、Magic Actions、eSPL 与隐私支付；通用 Solana/Anchor 工作（脚手架、PDA、账户布局、SPL 代币、客户端、钱包、LiteSVM/Mollusk 测试）需同时加载 solana-dev 技能。核心概念：Ephemeral Rollups 通过在基础层锁定被委托账户、由 ER 克隆在原始程序所有者下继续执行，实现高性能低延迟交易；Ephemeral Accounts 仅在 ER 内创建、使用、关闭，不会提交到 Solana，不能作为持久所有权、余额、奖励或结算结果的唯一副本；委托将被委托账户临时分配给 Delegation Program 并克隆进 ER，正常程序所有权、签名者、权限与账户约束仍适用；提交费用与限额跨越 Delegation Program 与验证者，费用、退款、赞助、成本估算等应先读 fees-and-commit-economics.md。用法：连接分三层——基础层 https://rpc.magicblock.app/devnet 或 https://rpc.magicblock.app/mainnet，路由 https://devnet-router.magicblock.app/ 或 https://router.magicblock.app/，ER 连接使用 router getDelegationStatus 返回的 fqdn；交易路由为委托交易走基础层，被委托账户操作走 ER，取消委托/提交走 ER。默认技术栈：Anchor + ephemeral-rollups-sdk（原生与 Pinocchio 亦支持），需要 #[ephemeral]、#[delegate]、#[commit] 宏，VRF 需 #[vrf]/#[vrf_callback] 并启用 vrf feature；SDK v0.16.2 使用 MagicIntentBundleBuilder，不再用已弃用的 commit_accounts 与 commit_and_undelegate_accounts。操作流程：先做架构规划，再分类操作类型、选连接、实现并记录校验点（router 状态检查、PDA 种子一致、状态传播等待等），随后可调试委托/路由故障、诊断服务端故障（状态源 https://status.magicblock.app/api/services）。限制：Ephemeral Accounts 不保证持久；基础层委托成功不等于 ER 动作执行成功；提交与动作需观察、幂等、重试与对账；资料未提供具体收费金额、安装命令与完整代码示例。