Быстрый старт

Узнайте, как запрашивать и использовать проверяемую случайность (verifiable randomness) в сети с помощью MagicBlock VRF SDK на Solana.

---

Быстрый доступ

Ознакомьтесь с базовым примером генерации случайности:

GitHub

Репозиторий с примером броска кубика

VRF dApp

Бросьте кубик на блокчейне

Делегированный СДИ dApp

Бросок кубика на блокчейне за 100 мс

---

Пошаговое руководство

Любая программа на Solana может запрашивать и использовать проверяемую случайность (verifiable randomness) в сети за считанные секунды с помощью MagicBlock VRF SDK. К концу этого руководства у вас будет рабочий пример, который бросает кубик с использованием проверяемой случайности.

1. Пишите вашу программу на Solana как обычно.

2. Добавьте CPI-хуки, которые запрашивают и используют случайность через обратный вызов от проверенного оракула.

3. Разверните вашу программу на Solana с помощью Anchor CLI.

4. Отправляйте транзакции для генерации и использования случайности в сети.

---

Пример «Бросок кубика»

Могут потребоваться следующие пакеты программного обеспечения, другие версии также могут быть совместимы:

Программное обеспечение	Версия	Руководство по установке
Solana	2.3.13	Установите Solana
Rust	1.85.0	Установите Rust
Anchor	0.32.1	Установите Anchor
Node	24.10.0	Установите Node

Фрагменты Кода

1. Напиши программу

Простая программа «Бросок кубика», где игрок инициализирует аккаунт состояния для хранения, запроса и использования случайности:

pub const PLAYER: &[u8] = b"playerd";

#[program]
pub mod random_dice {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        msg!(
            "Initializing player account: {:?}",
            ctx.accounts.player.key()
        );
        Ok(())
    }

    // ... Additional instructions will be added here
}

/// Context for initializing player
#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    #[account(init_if_needed, payer = payer, space = 8 + 1, seeds = [PLAYER, payer.key().to_bytes().as_slice()], bump)]
    pub player: Account<'info, Player>,
    pub system_program: Program<'info, System>,
}

/// Player struct
#[account]
pub struct Player {
    pub last_result: u8,
}

⬆️ Вернуться к началу

2. Запрос и использование случайности

1. Добавь ephemeral_vrf_sdk с использованием возможностей Anchor в вашей программе

cargo add ephemeral_vrf_sdk --features anchor

Импортируйvrf , create_request_randomness_ix, RequestRandomnessParams, иSerializableAccountMeta:

use ephemeral_vrf_sdk::anchor::vrf;
use ephemeral_vrf_sdk::instructions::{create_request_randomness_ix, RequestRandomnessParams};
use ephemeral_vrf_sdk::types::SerializableAccountMeta;

2. **Добавьте инструкции **roll_dice**для запроса случайности и ** callback_roll_diceдля её использования, вместе с соответствующим контекстом:

#[program]
pub mod random_dice {
    use super::*;

    // ... `initialize` instruction

    // Request Randomness
    pub fn roll_dice(ctx: Context<DoRollDiceCtx>, client_seed: u8) -> Result<()> {
        msg!("Requesting randomness...");
        let ix = create_request_randomness_ix(RequestRandomnessParams {
            payer: ctx.accounts.payer.key(),
            oracle_queue: ctx.accounts.oracle_queue.key(),
            callback_program_id: ID,
            callback_discriminator: instruction::CallbackRollDice::DISCRIMINATOR.to_vec(),
            caller_seed: [client_seed; 32],
            // Specify any account that is required by the callback
            accounts_metas: Some(vec![SerializableAccountMeta {
                pubkey: ctx.accounts.player.key(),
                is_signer: false,
                is_writable: true,
            }]),
            ..Default::default()
        });
        ctx.accounts
            .invoke_signed_vrf(&ctx.accounts.payer.to_account_info(), &ix)?;
        Ok(())
    }

    // Consume Randomness
    pub fn callback_roll_dice(
        ctx: Context<CallbackRollDiceCtx>,
        randomness: [u8; 32],
    ) -> Result<()> {
        let rnd_u8 = ephemeral_vrf_sdk::rnd::random_u8_with_range(&randomness, 1, 6);
        msg!("Consuming random number: {:?}", rnd_u8);
        let player = &mut ctx.accounts.player;
        player.last_result = rnd_u8; // Update the player's last result
        Ok(())
    }
}

#[vrf]
#[derive(Accounts)]
pub struct DoRollDiceCtx<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    #[account(seeds = [PLAYER, payer.key().to_bytes().as_slice()], bump)]
    pub player: Account<'info, Player>,
    /// CHECK: The oracle queue
    #[account(mut, address = ephemeral_vrf_sdk::consts::DEFAULT_QUEUE)]
    pub oracle_queue: AccountInfo<'info>,
}

#[derive(Accounts)]
pub struct CallbackRollDiceCtx<'info> {
    /// This check ensure that the vrf_program_identity (which is a PDA) is a singer
    /// enforcing the callback is executed by the VRF program trough CPI
    #[account(address = ephemeral_vrf_sdk::consts::VRF_PROGRAM_IDENTITY)]
    pub vrf_program_identity: Signer<'info>,
    #[account(mut)]
    pub player: Account<'info, Player>,
}

// ... Other context and account struct.

Запрос случайности — это процесс генерации случайного hashId с соответствующей инструкцией обратного вызова, которая активирует проверенные оракулы.

Использование случайности — это процесс применения проверяемой случайности вашей программой, предоставляемой и активируемой через проверенный оракул.

⬆️ Вернуться к началу

3. Развернуть

Теперь ваша программа обновлена и готова! Создавайте и разворачивайте её в нужном кластере:

anchor build && anchor deploy

⬆️ Вернуться к началу

4. Тест

Готово к выполнению транзакций для генерации случайности в сети!

anchor test --skip-build --skip-deploy --skip-local-validator

Запустите следующий тест:

import * as anchor from "@coral-xyz/anchor";
import { Program, web3 } from "@coral-xyz/anchor";
import { RandomDice } from "../target/types/random_dice";

describe("roll-dice", () => {
  // Configure the client to use the local cluster.
  anchor.setProvider(anchor.AnchorProvider.env());

  const program = anchor.workspace.RandomDice as Program<RandomDice>;

  it("Initialized player!", async () => {
    const tx = await program.methods.initialize().rpc();
    console.log("Your transaction signature", tx);
  });

  it("Do Roll Dice!", async () => {
    const tx = await program.methods.rollDice(0).rpc();
    console.log("Your transaction signature", tx);
    const playerPk = web3.PublicKey.findProgramAddressSync(
      [Buffer.from("playerd"), anchor.getProvider().publicKey.toBytes()],
      program.programId
    )[0];
    let player = await program.account.player.fetch(playerPk, "processed");
    await new Promise((resolve) => setTimeout(resolve, 3000));
    console.log("Player PDA: ", playerPk.toBase58());
    console.log("player: ", player);
  });
});

⬆️ Вернуться к начлау

---

Solana Explorer

Получайте информацию о ваших транзакциях и аккаунтах в сети Solana:

Solana Explorer

Официальный обозреватель Solana

Solscan

Обозреватель блокчейна Solana

Провайдеры Solana RPC

Отправляйте транзакции и запросы через существующих RPC-провайдеров:

Solana

Бесплатные публичные ноды

Helius

Бесплатные общие ноды

Triton

Выделенные высокопроизводительные ноды

Панель валидаторов Solana

Следите за обновлениями инфраструктуры валидаторов Solana в реальном времени:

Solana Beach

Аналитика по валидаторам

Validators App

Метрики валидаторов

Статус серверов

Подпишитесь на обновления статуса серверов Solana и MagicBlock:

Solana Status

Подписка на обновления статуса серверов Solana

MagicBlock Status

Подписка на статус серверов MagicBlock

---

Продукты MagicBlock

Эфемерный роллап (ЭР)

Выполнение транзакций в реальном времени без комиссий и с высокой безопасностью в сети Solana.

Приватный эфемерный роллап (ПЭР)

Защита конфиденциальных данных с помощью приватных вычислений.

Проверяемая функция случайности (СДИ)

Генерация доказуемо честной случайности напрямую в блокчейне.