> ## Documentation Index
> Fetch the complete documentation index at: https://mgb-ru.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

***

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

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

> [card] [GitHub](https://github.com/magicblock-labs/magicblock-engine-examples/tree/main/roll-dice)
>
> Репозиторий с примером броска кубика

> [card] [VRF dApp](https://roll-dice.magicblock.app/)
>
> Бросьте кубик на блокчейне

> [card] [Делегированный СДИ dApp](https://er-roll-dice.magicblock.app/delegated)
>
> Бросок кубика на блокчейне за 100 мс

***

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

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

**1. [Напишите вашу программу](#1-write-program)**

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

**2. [Добавьте запрос и используйте инструкции по случайному использованию.](#2-request-%26-consume-randomnness)**

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

**3. [Разверни свою программу на Solana](#3-deploy)**

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

**4. [Выполняйте транзакции для обеспечения случайности в цепочке.](#4-test)**

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

***

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

![Roll Dice GIF](https://mintcdn.com/mgb-ru/gqgLMTUzbC5HYCB0/images/gifs/vrf-roll-dice-420w.gif?s=a3867a520894a12ae2e440be62098aa3)

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

| **Программное обеспечение** | **Версия** | **Руководство по установке** |
| :- | :- | :- |
| **Solana** | 2.3.13 | [Установите Solana](https://docs.anza.xyz/cli/install) |
| **Rust** | 1.85.0 | [Установите Rust](https://rust-lang.org/tools/install/) |
| **Anchor** | 0.32.1 | [Установите Anchor](https://www.anchor-lang.com/docs/installation) |
| **Node** | 24.10.0 | [**Установите Node**](https://nodejs.org/en/download/current) |

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

> [tab] 1. Напиши программу
>
> Простая программа «Бросок кубика», где игрок инициализирует аккаунт состояния для хранения, запроса и использования случайности:
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> 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,
> }
> ```
>
> [⬆️ Вернуться к началу](#code-snippets)

> [tab] 2. Запрос и использование случайности
>
> 1. Добавь `ephemeral_vrf_sdk` с использованием возможностей Anchor в вашей программе
>
> ```bash theme={null}
> cargo add ephemeral_vrf_sdk --features anchor
> ```
>
> Импортируй`vrf` , `create_request_randomness_ix`, `RequestRandomnessParams`, и`SerializableAccountMeta`:
>
> ```rust theme={null}
> 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`**для её использования, вместе с соответствующим контекстом:**
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> #[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 с соответствующей инструкцией обратного вызова, которая активирует проверенные оракулы.**
>
> > Использование случайности — это процесс применения проверяемой случайности вашей программой, предоставляемой и активируемой через проверенный оракул.
>
> [⬆️ Вернуться к началу](#code-snippets)

> [tab] 3. Развернуть
>
> **Теперь ваша программа обновлена и готова! Создавайте и разворачивайте её в нужном кластере:**
>
> ```bash theme={null}
> anchor build && anchor deploy
> ```
>
> [⬆️ Вернуться к началу](#code-snippets)

> [tab] 4. Тест
>
> Готово к выполнению транзакций для генерации случайности в сети!
>
> ```bash theme={null}
> anchor test --skip-build --skip-deploy --skip-local-validator
> ```
>
> Запустите следующий тест:
>
> ```typescript theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> 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);
>   });
> });
> ```
>
> [⬆️ Вернуться к начлау](#code-snippets)

***

### **Solana Explorer**

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

> [card] [Solana Explorer](https://explorer.solana.com/)
>
> Официальный обозреватель Solana

> [card] [Solscan](https://solscan.io/)
>
> Обозреватель блокчейна Solana

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

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

> [card] [Solana](https://solana.com/docs/references/clusters#on-a-high-level)
>
> Бесплатные публичные ноды

> [card] [Helius](https://www.helius.dev/solana-rpc-nodes)
>
> Бесплатные общие ноды

> [card] [Triton](https://triton.one/solana)
>
> Выделенные высокопроизводительные ноды

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

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

> [card] [Solana Beach](https://solanabeach.io/)
>
> Аналитика по валидаторам

> [card] [Validators App](https://www.validators.app/)
>
> Метрики валидаторов

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

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

> [card] [Solana Status](https://status.solana.com/)
>
> Подписка на обновления статуса серверов Solana

> [card] [MagicBlock Status](https://mgb-ru.mintlify.site/pages/overview/additional-information/server-status)
>
> Подписка на статус серверов MagicBlock

***

### **Продукты MagicBlock**

> [card] [Эфемерный роллап (ЭР)](https://mgb-ru.mintlify.site/pages/ephemeral-rollups-ers/how-to-guide/quickstart.md)
>
> Выполнение транзакций в реальном времени без комиссий и с высокой безопасностью в сети Solana.

> [card] [Приватный эфемерный роллап (ПЭР)](https://mgb-ru.mintlify.site/pages/private-ephemeral-rollups-pers/how-to-guide/quickstart.md)
>
> Защита конфиденциальных данных с помощью приватных вычислений.

> [card] [Проверяемая функция случайности (СДИ)](https://mgb-ru.mintlify.site/pages/verifiable-randomness-functions-vrfs/how-to-guide/quickstart.md)
>
> Генерация доказуемо честной случайности напрямую в блокчейне.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.