Читання з мережі

Цей розділ розглядає, як читати дані з мережі Solana шляхом отримання різних рахунків для розуміння структури рахунку Solana.

У Solana всі дані існують в "accounts". Можна уявити дані в Solana як публічну базу даних з єдиною таблицею "Accounts", де кожен запис — це рахунок з однаковим базовим типом Account.

Base Account Type

#[derive(PartialEq, Eq, Clone, Default)]
pub struct Account {
    /// lamports in the account
    pub lamports: u64,
    /// data held in this account
    #[cfg_attr(feature = "serde", serde(with = "serde_bytes"))]
    pub data: Vec<u8>,
    /// the program that owns this account. If executable, the program that loads this account.
    pub owner: Pubkey,
    /// this account's data contains a loaded program (and is now read-only)
    pub executable: bool,
    /// the epoch at which this account will next owe rent
    pub rent_epoch: Epoch,
}

Рахунки

Рахунки в Solana можуть зберігати "стан" або "виконувані" програми. Кожен рахунок має "адресу" (публічний ключ), яка служить його унікальним ідентифікатором для пошуку відповідних даних у блокчейні.

Рахунки Solana містять:

Стан: Дані, які призначені для читання та зберігання. Наприклад, інформація про токени, дані користувача або інші дані, визначені в програмі.
Виконувані програми: Рахунки, що містять фактичний код програм Solana. Ці рахунки зберігають інструкції, які користувачі можуть викликати.

Це розділення програмного коду та стану програми є ключовою особливістю моделі рахунків Solana. Для отримання додаткової інформації зверніться до сторінки Модель рахунків Solana.

Отримання рахунку гаманця

Цей приклад демонструє, як:

Згенерувати нову пару ключів (пару публічного/приватного ключа).
Запросити аirdrop SOL для фінансування нової адреси.
Отримати дані рахунку для профінансованої адреси.

У Solana фінансування нової адреси за допомогою SOL автоматично створює рахунок, яким володіє System Program. Усі рахунки "гаманців" — це просто рахунки, якими володіє System Program, що містять SOL і можуть підписувати транзакції.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

"Гаманець" у Solana — це обліковий запис, яким володіє Системна програма, одна з вбудованих програм Solana. Облікові записи гаманців в основному використовуються для зберігання SOL (відстежується в полі lamports) та для підписання транзакцій.

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

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Поле data містить дані облікового запису, збережені у вигляді байтів.

Для облікових записів гаманців це поле порожнє (0 байтів). Інші облікові записи використовують це поле для зберігання або стану програми, або виконуваного програмного коду.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Поле executable вказує, чи містить поле data облікового запису виконуваний програмний код.

Для гаманців та облікових записів, що зберігають стан програми, це поле має значення false.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Поле lamports містить баланс SOL облікового запису, виражений у lamport.

Lamport — це найменша одиниця SOL. 1 SOL = 1 000 000 000 lamport.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Поле owner показує програму, якій належить обліковий запис.

Для гаманців власником завжди є System Program з адресою 11111111111111111111111111111111.

Поле rentEpoch є застарілим полем від неактуального механізму, де облікові записи сплачували "rent" (у lamports) для зберігання своїх даних у мережі.

Це поле наразі не використовується, але включене для зворотної сумісності.

Поле space показує кількість байтів у полі data. Це не є полем у самому типі Account, але включене у відповідь.

У цьому прикладі поле space дорівнює 0, оскільки поле data містить 0 байтів даних.