> ## 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.

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

> Любая программа Solana может быть обновлена с помощью Эфемерных Роллапов путём добавления возможностей делегирования.

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

Ознакомьтесь с основным примером счетчика:

> [card] [GitHub](https://github.com/magicblock-labs/magicblock-engine-examples/tree/main/anchor-counter)
>
> Реализация Anchor

> [card] [GitHub](https://github.com/magicblock-labs/ephemeral-counter-ui)
>
> Реализация React

***

[Build a real-time Anchor Counter on Solana with MagicBlock's Ephemeral Rollup | Tutorial](https://www.youtube.com/embed/qwu2RBKyFiw?si=PMg-3UbRfvvbrs7C\&list=PLWR_ZQiGMS8mIe1kPZe8OfHIbhvZqaM8V)

***

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

Создайте вашу программу и обновите её, добавив хуки делегирования с помощью Программы Делегирования MagicBlock. `DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh`:

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

Напишите вашу программу для Solana так, как вы обычно это делаете.

**2. [Добавьте перехватчики делегирования и отмены делегирования в вашу программу](#2-delegate)**

Добавьте CPI-хуки для делегирования, фиксации и анделегирования аккаунтов состояния через сессии Эфемерного Роллапа.

> [!NOTE]
>
> Эти общедоступные средства проверки поддерживаются для разработки. Не забудьте добавить конкретный ER валидатор в свою инструкцию при делегировании:
>
> * Азия ([devnet-as.magicblock.app](http://devnet-as.magicblock.app)): `MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57`
> * Европа ([devnet-eu.magicblock.app](http://devnet-eu.magicblock.app)): `MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e`
> * США ([devnet-us.magicblock.app](http://devnet-us.magicblock.app)): `MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd`
> * TEE ([tee.magicblock.app](http://tee.magicblock.app)): `FnE6VJT5QNZdedZPnCoLsARgBwoE6DeJNjBs2H1gySXA`
> * Локальная служба поддержки ([localhost](http://localhost)): `mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev`

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

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

**4. [Готовность к выполнению транзакций с делегированием полномочий и скоростью в режиме реального времени](#4-test)**

Отправляйте транзакции как в блокчейн, так и вне его без изменений, при этом соблюдая спецификацию SVM RPC..

***

## Пример счетчика

![Counter GIF](https://mintcdn.com/mgb-ru/gqgLMTUzbC5HYCB0/images/gifs/counter-420w.gif?s=d05527abd8f881d7f54b504aefc70540)

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

| **Программное обеспечение** | **Версия** | **Руководство по установке** |
| - | - | - |
| **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. Напиши программу
>
> Программа реализует две основные инструкции:
>
> 1. `initialize`: Устоновите счетчик на 0
> 2. `increment`: Увеличивает счётчик на 1
>
> Программа реализует специальные инструкции для делегирования и отмены делегирования счётчика:
>
> 1. `Delegate`: Делегирует счётчик с базового слоя (Base Layer) в ЭР (вызывается на базовом слое)
> 2. `CommitAndUndelegate`: Планирует синхронизацию счётчика из ЭР в базовый слой (Base Layer) и отменяет делегирование счётчика в ЭР (вызывается в ЭР)
> 3. `Commit`: Планирует синхронизацию счётчика из ER в базовый слой (Base Layer) (вызывается в ЭР)
> 4. `Undelegate`:
>    * Планирует синхронизацию и отмену делегирования счётчика (вызывается в ER)
>    * Отмена делегирования, инициируемая через callback-инструкцию, внедрённую с помощью `#[ephemeral]` (вызывается на базовом слое (Base Layer) через CPI валидатора)
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> #[ephemeral]
> #[program]
> pub mod anchor_counter {
>     use super::*;
>
>     /// Initialize the counter.
>     pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
>         let counter = &mut ctx.accounts.counter;
>         counter.count = 0;
>         Ok(())
>     }
>
>     /// Increment the counter.
>     pub fn increment(ctx: Context<Increment>) -> Result<()> {
>         let counter = &mut ctx.accounts.counter;
>         counter.count += 1;
>         Ok(())
>     }
>
>     /// Delegate the account to the delegation program
>     /// Set specific validator based on ER, see https://docs.magicblock.gg/pages/get-started/how-integrate-your-program/local-setup
>     pub fn delegate(ctx: Context<DelegateInput>) -> Result<()> {
>     // ...
>     }
>
>     /// Increment the counter and manually commit the account in the Ephemeral Rollup session.
>     pub fn increment_and_commit(ctx: Context<IncrementAndCommit>) -> Result<()> {
>     // ...
>     }
>
>     /// Undelegate the account from the delegation program
>     pub fn undelegate(ctx: Context<IncrementAndCommit>) -> Result<()> {
>     // ...
>     }
> }
>
> /// Context for initializing counter
> #[derive(Accounts)]
> pub struct Initialize<'info> {
>     #[account(init_if_needed, payer = user, space = 8 + 8, seeds = [TEST_PDA_SEED], bump)]
>     pub counter: Account<'info, Counter>,
>     #[account(mut)]
>     pub user: Signer<'info>,
>     pub system_program: Program<'info, System>,
> }
>
>
> /// Context for incrementing counter
> #[derive(Accounts)]
> pub struct Increment<'info> {
>     #[account(mut, seeds = [TEST_PDA_SEED], bump)]
>     pub counter: Account<'info, Counter>,
> }
>
> /// Counter struct
> #[account]
> pub struct Counter {
>     pub count: u64,
> }
>
> /// Other context for delegation
>
>
> ```
>
> Ничего особенного — это просто простой Anchor-программный контракт, который увеличивает счётчик. Единственное отличие в том, что мы добавляем макрос `ephemeral` для отмены делегирования и макрос `delegate`, чтобы внедрить полезную логику для взаимодействия с программой делегирования.
>
> [⬆️ Вернуться к началу](#code-snippets)

> [tab] 2. Делегировать
>
> > [!NOTE]
> >
> > These public validators are supported for development. Make sure to add the
> > specific ER validator in your instruction when delegating:
> >
> > <ul>
> >   <li>
> >     Asia (devnet-as.magicblock.app):&#x20;
> >     `MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57`
> >   </li>
> >
> >   <li>
> >     EU (devnet-eu.magicblock.app):&#x20;
> >     `MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e`
> >   </li>
> >
> >   <li>
> >     US (devnet-us.magicblock.app):&#x20;
> >     `MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd`
> >   </li>
> >
> >   <li>
> >     TEE (tee.magicblock.app):&#x20;
> >     `FnE6VJT5QNZdedZPnCoLsARgBwoE6DeJNjBs2H1gySXA`
> >   </li>
> >
> >   <li>
> >     Local ER (localhost):&#x20;
> >     `mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev`
> >   </li>
> > </ul>
>
> 1. Добавьте `ephemeral-rollups-sdk` с возможностями Anchor в вашу программу
>
> ```bash theme={null}
> cargo add ephemeral-rollups-sdk --features anchor
> ```
>
> Ипортировать `delegate`, `commit`, `ephemeral`, `DelegateConfig`, `commit_accounts` аа так же`commit_and_undelegate_accounts`:
>
> ```rust theme={null}
> use ephemeral_rollups_sdk::anchor::{
>   commit,
>   delegate,
>   ephemeral
> };
> use ephemeral_rollups_sdk::cpi::DelegateConfig;
> use ephemeral_rollups_sdk::ephem::{
>   commit_accounts,
>   commit_and_undelegate_accounts
>   };
> ```
>
> 2. Добавьте в вашу программу макрос `delegate` и инструкцию, макрос `ephemeral` и инструкцию `undelegate`. Укажите предпочитаемую конфигурацию делегирования, например, автоматические коммиты и конкретного валидатора ЭР
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> /// Add delegate function to the context
> #[delegate]
> #[derive(Accounts)]
> pub struct DelegateInput<'info> {
>     pub payer: Signer<'info>,
>     /// CHECK: Checked by the delegate program
>     pub validator: Option<AccountInfo<'info>>,
>     /// CHECK The pda to delegate
>     #[account(mut, del)]
>     pub pda: AccountInfo<'info>,
> }
> ```
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> /// Delegate the account to the delegation program
> /// Set specific validator based on ER, see https://docs.magicblock.gg/pages/get-started/how-integrate-your-program/local-setup
> pub fn delegate(ctx: Context<DelegateInput>) -> Result<()> {
>     ctx.accounts.delegate_pda(
>         &ctx.accounts.payer,
>         &[TEST_PDA_SEED],
>         DelegateConfig {
>             // Optionally set a specific validator from the first remaining account
>             validator: ctx.remaining_accounts.first().map(|acc| acc.key()),
>             ..Default::default()
>         },
>     )?;
>     Ok(())
> }
> ```
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> /// Increment the counter and manually commit the account in the Ephemeral Rollup session.
> pub fn increment_and_commit(ctx: Context<IncrementAndCommit>) -> Result<()> {
>     let counter = &mut ctx.accounts.counter;
>     counter.count += 1;
>     commit_accounts(
>         &ctx.accounts.payer,
>         vec![&ctx.accounts.counter.to_account_info()],
>         &ctx.accounts.magic_context,
>         &ctx.accounts.magic_program,
>     )?;
>     Ok(())
> }
> ```
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> /// Undelegate the account from the delegation program
> pub fn undelegate(ctx: Context<IncrementAndCommit>) -> Result<()> {
>     commit_and_undelegate_accounts(
>         &ctx.accounts.payer,
>         vec![&ctx.accounts.counter.to_account_info()],
>         &ctx.accounts.magic_context,
>         &ctx.accounts.magic_program,
>     )?;
>     Ok(())
> }
> ```
>
> > `Delegation` is the process of transferring ownership of one or more of your program's `PDAs` to the delegation program. Ephemeral Validators will then be able to use the `PDAs` to perform transactions in the SVM runtime.
>
> > `Commit` is the process of updating the state of the `PDAs` from ER to the base layer. After the finalization process, the `PDAs` remain locked on base layer.
>
> > `Undelegation` is the process of transferring ownership of the `PDAs` back to your program. On undelegation, the state is committed and it trigger the finalization process. Once state it validated, the `PDAs` are unlocked and can be used as normal on base layer.
>
> [⬆️ Вернуться к началу](#code-snippets)

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

> [tab] 4. Протестировать
>
> Готово к выполнению транзакций для делегирования с поддержкой обработки в реальном времени
>
> > [!NOTE]
> >
> > These public validators are supported for development. Make sure to add the
> > specific ER validator in your instruction when delegating:
> >
> > <ul>
> >   <li>
> >     Asia (devnet-as.magicblock.app):&#x20;
> >     `MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57`
> >   </li>
> >
> >   <li>
> >     EU (devnet-eu.magicblock.app):&#x20;
> >     `MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e`
> >   </li>
> >
> >   <li>
> >     US (devnet-us.magicblock.app):&#x20;
> >     `MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd`
> >   </li>
> >
> >   <li>
> >     TEE (tee.magicblock.app):&#x20;
> >     `FnE6VJT5QNZdedZPnCoLsARgBwoE6DeJNjBs2H1gySXA`
> >   </li>
> >
> >   <li>
> >     Local ER (localhost):&#x20;
> >     `mAGicPQYBMvcYveUZA5F5UNNwyHvfYh5xkLS2Fr1mev`
> >   </li>
> > </ul>
>
> ```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}
> // Set ER Validator
> const ER_VALIDATOR = new web3.PublicKey(
>   "MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57"
> ); // Asia ER Validator
>
> // Set Anchor providers
> const provider = anchor.AnchorProvider.env();
> anchor.setProvider(provider);
> const providerEphemeralRollup = new anchor.AnchorProvider(
>   new anchor.web3.Connection("https://devnet-as.magicblock.app/", {
>     wsEndpoint: "wss://devnet.magicblock.app/",
>   }),
>   anchor.Wallet.local()
> );
>
> // Set program and pda
> const program = anchor.workspace.AnchorCounter as Program<AnchorCounter>;
> const [pda] = anchor.web3.PublicKey.findProgramAddressSync(
>   [Buffer.from(SEED_TEST_PDA)],
>   program.programId
> );
>
> // Initialize Counter on Base Layer
> let initTx = await program.methods
>   .increment()
>   .accounts({
>     counter: pda,
>   })
>   .transaction();
> initTx.feePayer = provider.wallet.publicKey;
> initTx.recentBlockhash = (
>   await provider.connection.getLatestBlockhash()
> ).blockhash;
> initTx = await provider.connection.signTransaction(initTx);
> const dinitTxHash = await provider.sendAndConfirm(initTx);
>
> // Delegate Counter on Base Layer to ER
> let delTx = await program.methods
>   .increment()
>   .accounts({
>     payer: provider.wallet.publicKey,
>     validator: ER_VALIDATOR,
>     pda: pda,
>   })
>   .transaction();
> delTx.feePayer = provider.connection.wallet.publicKey;
> delTx.recentBlockhash = (
>   await provider.connection.getLatestBlockhash()
> ).blockhash;
> delTx = await provider.wallet.signTransaction(delTx);
> const delTxHash = await provider.sendAndConfirm(delTx);
>
> // Increment Counter in real-time on ER
> let incTx = await program.methods
>   .increment()
>   .accounts({
>     counter: pda,
>   })
>   .transaction();
> incTx.feePayer = providerEphemeralRollup.wallet.publicKey;
> incTx.recentBlockhash = (
>   await providerEphemeralRollup.connection.getLatestBlockhash()
> ).blockhash;
> incTx = await providerEphemeralRollup.wallet.signTransaction(incTx);
> const incTxHash = await providerEphemeralRollup.sendAndConfirm(incTx);
> ```
>
> Чтобы упростить интеграцию через фронтенд, мы создали Magic Router. Вы отправляете транзакции напрямую в Magic Router, а мы определяем за вас, следует ли направлять их в Ephemeral Rollup или на базовый слой.
>
> > [!NOTE]
> >
> > These public RPC endpoints are currently free and supported for development:
> > \
> > &#x20;Magic Router Devnet: [https://devnet-router.magicblock.app](https://devnet-router.magicblock.app) \\
> >
> > Solana Devnet: [https://api.devnet.solana.com](https://api.devnet.solana.com) \\
> >
> > ER Devnet: [https://devnet.magicblock.app](https://devnet.magicblock.app) \\
> >
> > TEE Devnet: [https://tee.magicblock.app/](https://tee.magicblock.app/) \\
> >
> > Find out more details [
> > here
> > ](https://mgb-ru.mintlify.site/pages/ephemeral-rollups-ers/how-to-guide/local-development.md).
>
> [⬆️ Вернуться к началу ](#code-snippets)

***

### Расширенные Фрагменты Кода

> [tab] Изменить размер PDA
>
> При изменении размера делегированного PDA:
>
> * У PDA должно быть достаточно лампортов, чтобы оставаться освобождённым от аренды для нового размера аккаунта.
> * Если требуется добавить дополнительные лампорты, счётчик-плательщик должен быть делегирован для предоставления недостающей суммы.
> * PDA должен принадлежать программе, а транзакция должна включать всех необходимых подписантов для перевода лампортов.
> * Используй `system_instruction::allocate`
>
> ```rust theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
> #[account]
> pub struct Counter {
>     pub count: u64,
>     pub extra_data: Vec<u8>,
> }
>
> #[derive(Accounts)]
> pub struct ResizeCounter<'info> {
>     #[account(mut)]
>     pub counter: Account<'info, Counter>,
>     #[account(mut)]
>     pub payer: Signer<'info>,
>     pub system_program: Program<'info, System>,
> }
>
>     // Resize the counter (e.g., to store more extra_data)
>     pub fn resize_counter(ctx: Context<ResizeCounter>, new_size: usize) -> Result<()> {
>         let account_to_resize = &mut ctx.accounts.counter.to_account_info();
>         let payer = &mut ctx.accounts.payer.to_account_info();
>
>         // Calculate rent-exemption for the new size
>         let rent = Rent::get()?;
>         let min_balance = rent.minimum_balance(new_size);
>
>         // Top up lamports if needed
>         let current_lamports = **account_to_resize.lamports.borrow();
>         if current_lamports < min_balance {
>             let to_transfer = min_balance - current_lamports;
>             **payer.try_borrow_mut_lamports()? -= to_transfer;
>             **account_to_resize.try_borrow_mut_lamports()? += to_transfer;
>         }
>
>         // Resize account
>         account_to_resize.resize(new_size)?;
>
>         Ok(())
>     }
> ```
>
> [⬆️ Вернутся к началу ](#advanced-code-snippets)
>
> ### Быстрый доступ
>
> Узнайте больше о приватных ER, нативной реализации на Rust и локальной разработке:

> [card] [Приватные эфемерные роллапы (PER)](https://mgb-ru.mintlify.site/pages/private-ephemeral-rollups-pers/how-to-guide/quickstart.md)
>
> Быстрый старт

> [card] [Нативная версия на Rust](https://mgb-ru.mintlify.site/pages/ephemeral-rollups-ers/how-to-guide/rust-program.md)
>
> Быстрый старт

> [card] [Руководство](https://mgb-ru.mintlify.site/pages/ephemeral-rollups-ers/how-to-guide/local-development.md)
>
> Локальная разработка

***

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

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

> [card] [Проверяемая функция случайности (VRF)](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.