Чтение из сети

В этом разделе рассматривается, как считывать данные из сети Solana, получая различные аккаунты, чтобы понять структуру аккаунта в Solana.

В Solana все данные хранятся в "аккаунтах". Вы можете представить данные в Solana как публичную базу данных с одной таблицей "Аккаунты", где каждая запись — это аккаунт с одинаковым базовым типом аккаунта.

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.

Получение аккаунта кошелька

Этот пример демонстрирует, как:

Сгенерировать новую пару ключей (публичный/приватный ключ).
Запросить airdrop 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) и для подписания транзакций.

Когда вы запрашиваете аккаунт кошелька, ответ включает поля, показанные в примере вывода.

Поле data содержит данные аккаунта, хранящиеся в виде байтов.

Для аккаунтов кошельков это поле пустое (0 байт). Другие аккаунты используют это поле для хранения состояния программы или исполняемого кода программы.

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

Для кошельков и аккаунтов, которые хранят состояние программы, это поле имеет значение false.

Поле lamports содержит баланс SOL аккаунта, выраженный в лампортах.

Лампорты — это наименьшая единица SOL. 1 SOL = 1 000 000 000 лампортов.

Поле owner показывает программу, которой принадлежит аккаунт.

Для кошельков владельцем всегда является Системная программа с адресом 11111111111111111111111111111111.

Поле rentEpoch является устаревшим полем из механизма, где аккаунты оплачивали "ренту" (в лампортах) за хранение данных в сети.

В настоящее время это поле не используется, но включено для обратной совместимости.

Поле space показывает количество байтов в поле data. Это не является полем типа Account, но включено в ответ.

В этом примере поле space равно 0, так как поле data содержит 0 байтов данных.