技术细节

随机数通过构建在 Curve25519 的 Ristretto group 之上的 VRF 生成，并使用 RFC 9381 所描述的类 Schnorr 签名进行证明。proof 和输出会通过来自 MagicBlock VRF signer PDA 的已签名 callback 返回给 rollup。你的程序会先验证 caller，然后在游戏逻辑中使用该随机数。 像 random_u32、random_u8_with_range 和 random_bool 这样的辅助工具，可以轻松将 [u8; 32] 输出转换为可用值。由于请求和消费步骤都发生在 ephemeral execution window 内，用户能够获得具备可验证公平性的实时结果，而无需依赖外部服务器。

​

流程

流程从“请求随机数”开始。

1. 你的程序会通过 CPI 调用 MagicBlock VRF program，并将一个请求追加到队列中。
2. 一旦你的随机数请求进入队列，某个预言机就会提取该请求并执行随机数计算。
3. 完成后，它会将结果和 proof 返回给 MagicBlock VRF program。VRF program 验证 proof 后，会通过预定义函数回调你的程序，从而“消费”该随机数。

​

预言机队列

每个随机数请求都会指定一个预言机队列（oracle queue）账户（即 RequestRandomnessParams 的 oracle_queue 字段）。与所有 Solana 账户一样，该队列同样存放在 Solana 上；但已委托（delegated）的队列只能在 ephemeral rollup 内部直接写入，而未委托的队列则可在基础层直接写入。请使用与交易运行位置相匹配的队列来发起随机数请求——在 Solana 上使用基础层队列，在 ephemeral rollup 内部则使用已委托的队列。请尽可能引用 ephemeral_vrf_sdk::consts 中的常量，而不要硬编码地址。