Розгортання вашої першої програми Solana

Створення проєкту Anchor

Спочатку відкрийте https://beta.solpg.io в новій вкладці браузера.

• Натисніть кнопку "Create a new project" на лівій панелі.

• Введіть назву проєкту, виберіть Anchor як фреймворк, а потім натисніть кнопку "Create".

Новий проєкт

Ви побачите новий створений проєкт з кодом програми у файлі lib.rs.

Ця базова програма Solana створює новий обліковий запис і зберігає в ньому число. Програма містить одну інструкцію (initialize), яка:

• Вимагає параметр data як вхідні дані
• Створює новий обліковий запис
• Зберігає значення параметра data у даних облікового запису
• Записує повідомлення в програмні логи транзакції

use anchor_lang::prelude::*;

declare_id!("11111111111111111111111111111111");

#[program]
mod hello_anchor {
    use super::*;
    pub fn initialize(ctx: Context<Initialize>, data: u64) -> Result<()> {
        let my_account = &mut ctx.accounts.my_account;
        my_account.data = data;
        msg!("Data initialized: {}", data);
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(init, payer = user, space = 8 + 8)]
    pub my_account: Account<'info, MyAccount>,
    #[account(mut)]
    pub user: Signer<'info>,
    pub system_program: Program<'info, System>,
}

#[account]
pub struct MyAccount {
    pub data: u64,
}

Побудова та розгортання програми

Щоб побудувати програму, просто запустіть build в терміналі. Команда build компілює програму. Байт-код програми потім зберігається у виконуваному обліковому записі програми при розгортанні.

$ 
build
Copy
[show output]

Solana Playground оновлює адресу в declare_id!(). Ця адреса представляє адресу вашої програми в мережі (ідентифікатор програми).

Після збірки програми, виконайте deploy у терміналі, щоб розгорнути програму в мережі (devnet за замовчуванням). Розгортання програми вимагає виділення SOL для облікового запису в мережі, який зберігає програму.

Перед розгортанням переконайтеся, що у вас достатньо SOL. Ви можете отримати SOL для devnet, виконавши solana airdrop 5 у терміналі Playground або використовуючи Веб-кран.

$ 
deploy
Copy
[show output]

Ви також можете використовувати кнопки Build та Deploy на лівій панелі.

Збірка та розгортання

Після розгортання програми ви можете викликати її інструкції.

Тестування програми

// No imports needed: web3, anchor, pg and more are globally available

describe("Test", () => {
  it("initialize", async () => {
    // Generate keypair for the new account
    const newAccountKp = new web3.Keypair();

    // Send transaction
    const data = new BN(42);
    const txHash = await pg.program.methods
      .initialize(data)
      .accounts({
        newAccount: newAccountKp.publicKey,
        signer: pg.wallet.publicKey,
        systemProgram: web3.SystemProgram.programId
      })
      .signers([newAccountKp])
      .rpc();
    console.log(`Use 'solana confirm -v ${txHash}' to see the logs`);

    // Confirm transaction
    await pg.connection.confirmTransaction(txHash);

    // Fetch the created account
    const newAccount = await pg.program.account.newAccount.fetch(
      newAccountKp.publicKey
    );

    console.log("On-chain data is:", newAccount.data.toString());

    // Check whether the data on-chain is equal to local 'data'
    assert(data.eq(newAccount.data));
  });
});

Щоб запустити тестовий файл після розгортання програми, виконайте test у терміналі.

$ 
test
Copy
[show output]

Шукайте вивід, який підтверджує успішне проходження тесту.

Ви також можете використовувати кнопку Test на лівій панелі.

Запуск тесту

Потім ви можете переглянути журнали транзакцій, виконавши команду solana confirm -v і вказавши хеш транзакції (підпис) з виводу тесту:

$ 
solana confirm -v [TxHash]Copy

Наприклад:

$ 
solana confirm -v 3TewJtiUz1EgtT88pLJHvKFzqrzDNuHVi8CfD2mWmHEBAaMfC5NAaHdmr19qQYfTiBace6XUmADvR4Qrhe8gH5uc
Copy
[show output]

Ви також можете переглянути деталі транзакції на SolanaFM або Solana Explorer, шукаючи за підписом транзакції (хешем).

Закриття програми

Нарешті, закриття програми дозволяє повністю відновити SOL, виділений для програми в мережі.

Ви можете закрити програму, виконавши наступну команду та вказавши адресу програми, яку можна знайти в declare_id!():

$ 
solana program close [ProgramID]Copy

Наприклад:

$ 
solana program close 2VvQ11q8xrn5tkPNyeraRsPaATdiPx8weLAD8aD4dn2r
Copy
[show output]

Вітаємо. Ви щойно створили та розгорнули свою першу програму Solana, використовуючи фреймворк Anchor.