# MagicBlock 临时汇总指南使用 MagicBlock Ephemeral Rollups 构建高性能 Solana 应用程序的综合指南 - 实现低于 10 毫秒的延迟和无 Gas 交易。 ## 概述 MagicBlock 临时汇总 (ER) 是专门的 SVM 运行时，可通过以下方式增强 Solana： * **低于 10 毫秒的延迟**（基础 Solana 上的延迟约为 400 毫秒） * **无 Gas 交易** 实现无缝用户体验 * **与现有 Solana 程序的完全可组合性** * **通过按需汇总进行水平扩展** ## 架构 ┌──────────────────────────────────────────────────────────────┐ │ 您的申请 │ ├──────────────────────────────────────────────────────────────┤ │ 基础层 (Solana) │ 临时汇总 (ER) │ │ - 初始化账户 │ - 执行操作 │ │ - 代理帐户 │ - 处理时间约为 10-50 毫秒 │ │ - 最终状态承诺 │ - 零汽油费 │ │ - ~400ms 最终确定 │ - 将状态提交给 Solana │ └──────────────────────────────────────────────────────────────┘ ### 核心流程 1. **初始化** \- 在 Solana 基础层上创建帐户 2. **委托** \- 将账户所有权转移给委托程序 3. **执行** \- 在 Ephemeral Rollup 上运行快速操作 4. **提交** \- 将状态同步回基础层 5. **取消委托** \- 将所有权归还给您的程序 ## 先决条件 # 所需版本索拉纳：2.3.13 铁锈：1.85.0 锚：0.32.1 节点：24.10.0 # 安装锚点（如果需要）货物安装--git https://github.com/coral-xyz/anchoranchor-cli ## 快速入门 ### 1\.添加依赖项 (Cargo.toml) [依赖项] 锚-lang =“0.32.1” ephemeral-rollups-sdk = { version = "0.6.5", features = ["anchor", "disable-realloc"] } ### 2\.程序设置 (lib.rs) 使用anchor_lang::prelude::*；使用 ephemeral_rollups_sdk::anchor::{delegate_account, commit_accounts, ephemeral}；使用 ephemeral_rollups_sdk::cpi::DelegationProgram； declare_id!("你的程序Id111111111111111111111111111111"); #[ephemeral] // 必需：启用 ER 支持 #[节目] 酒吧模组我的程序{ 使用超级::*; pub fn 初始化(ctx: Context<初始化>) -> 结果<()> { ctx.accounts.state.value = 0; 好的(()) } #[delegate] // 自动注入委托账户 pub fn delegate(ctx: Context) -> Result<()> { 好的(()) } pub fn 增量(ctx: Context<更新>) -> 结果<()> { ctx.accounts.state.value += 1; 好的(()) } #[commit] // 自动注入提交帐户 pub fn undelegate(ctx: Context) -> Result<()> { 好的(()) } } ### 3\. TypeScript 客户端设置从“@solana/web3.js”导入{Connection, PublicKey}；从“@coral-xyz/anchor”导入{AnchorProvider，程序}；从“@magicblock-labs/ephemeral-rollups-sdk”导入{ DELEGATION_PROGRAM_ID }； // 关键：每一层都有单独的连接 const baseConnection = new Connection("https://api.devnet.solana.com"); const erConnection = new Connection("https://devnet.magicblock.app"); // 创建提供者 const baseProvider = new AnchorProvider(baseConnection, wallet, { 承诺: "已确认" }); const erProvider = new AnchorProvider(erConnection, 钱包, { 承诺：“已确认”， skipPreflight: true, // ER 必需 }); // 检查委托状态异步函数 isDelegate(pubkey: PublicKey): Promise { const info =等待baseConnection.getAccountInfo(pubkey); 返回信息？.owner.equals(DELEGATION_PROGRAM_ID) ??错误的; } ## 关键概念 ### 代表团委托将 PDA 所有权转移给委托程序，允许临时验证器处理交易。 #[导出（帐户）] pub struct Delegate <'信息> { #[账户(mut)] 酒吧付款人：Signer<'info>, /// CHECK：将被委托 #[account(mut, del)] // 'del' 代表委托标记酒吧状态：AccountInfo <'信息>， pub delegate_program：程序<'info，DelegationProgram>， } ### 提交提交将 PDA 状态从 ER 更新到基础层，而无需取消委派。使用 ephemeral_rollups_sdk::anchor::commit_accounts； pub fn commit(ctx: Context) -> 结果<()> { 提交帐户（ &ctx.accounts.payer, vec![&ctx.accounts.state.to_account_info()], &ctx.accounts.magic_context, &ctx.accounts.magic_program, ）？；好的(()) } ### 取消授权将 PDA 所有权归还给您的程序，同时提交最终状态。 #[commit] // 处理提交+取消委托 pub fn undelegate(ctx: Context) -> Result<()> { 好的(()) } ## ER 验证器（Devnet）地区 |验证者身份 ---|--- 亚洲 | `MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57` 欧盟| `MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e` 美国 | `MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd` 三通 | `FnE6VJT5QNZdedZPnCoLsARgBwoE6DeJNjBs2H1gySXA` **Magic Router**（自动选择最佳）：`https://devnet-router.magicblock.app` ## 关键规则 ### 要做： * 维护基础层和 ER 的独立连接 * 对所有 ER 事务使用 `skipPreflight: true` * 在发送到 ER 之前验证委托状态 * 在 Rust 中使用 `AccountInfo` 作为委托帐户 * 在 Rust 和 TypeScript 之间精确匹配 PDA 种子 ### 不要： * 将委托账户操作发送到基础层 * 在单个事务中混合基础层和 ER 操作 * 无需检查即可取得账户所有权 * 在基础层读取之前跳过承诺验证 ## 产品产品 |描述 ---|--- **临时汇总 (ER)** |高性能、无gas交易 **私人急诊室 (PER)** |使用英特尔 TDX 进行隐私保护计算 **VRF** |用于链上随机性的可验证随机函数 **BOLT 框架** |全链上游戏的ECS架构 **Solana 插件** |用于增强功能的特定于应用程序的扩展 ## Solana 插件（新） Solana 插件是模块化功能，可以添加到您的 dApp 中以扩展 Solana 的功能。将它们视为您的自定义工具包：在需要时插入您需要的内容。 ### 可用插件插件 |描述 |使用案例 ---|---|--- **可验证随机性 (VRF)** |可证明公平的链上随机性 |游戏、彩票、NFT 掉落 **实时价格反馈** |精确到毫秒的市场数据 | DEX、交易机器人、DeFi **人工智能预言机** |直接从智能合约调用人工智能模型 |动态 NFT、AI 代理 ### 使用 VRF 插件从“@magicblock-labs/vrf-sdk”导入{requestRandomness，getRandomnessResult}； // 请求随机性 const requestTx = 等待 requestRandomness({ 付款人：wallet.publicKey，种子： Buffer.from("my_game_seed"), }); // 确认后获取结果 const 结果 = 等待 getRandomnessResult(requestId); console.log("随机值：", result.randomness); ### 英特尔 TDX 的隐私 MagicBlock 通过在 Intel TDX 上的可信执行环境 (TEE) 中运行的临时汇总，在任何 Solana 程序状态帐户中实现隐私。这允许： * 不公开状态的私有计算 * 可验证的执行保证 * 选择性披露结果 ## 资源 * **文档**： * **GitHub**： * **示例** : * **入门套件**： * **BOLT 书**： * **Discord** ：加入测试网访问 ## 技能结构魔法块/ ├── SKILL.md # 这个文件 ├── 资源/ │ ├── api-reference.md # 完整API参考 │ └── program-ids.md # 所有程序ID和常量 ├── 例子/ │ ├──anchor-counter/README.md # 带委托的基本计数器 │ ├── delegate-flow/README.md # 完整的委托生命周期 │ ├── vrf-randomness/README.md # VRF 集成 │ └── Crane-automation/README.md # 计划任务 ├── 模板/ │ ├── program-template.rs # Rust 程序启动器 │ └── client-template.ts # TypeScript 客户端启动器 └── 文档/ ├── Advanced-patterns.md # 复杂模式 └── Troubleshooting.md # 常见问题

魔法块

包含技能