Odczyt z sieci

Ta sekcja omawia, jak odczytywać dane z sieci Solana, pobierając różne konta, aby zrozumieć strukturę konta Solana.

W Solanie wszystkie dane istnieją w "kontach". Możesz myśleć o danych w Solanie jako o publicznej bazie danych z jedną tabelą "Konta", gdzie każdy wpis to konto z tym samym podstawowym typem konta.

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,
}

Konta Konta

Konta w Solanie mogą przechowywać "stan" lub "wykonywalne" programy. Każde konto ma "adres" (klucz publiczny), który służy jako jego unikalny identyfikator używany do lokalizowania odpowiadających mu danych w łańcuchu bloków.

Konta Solana zawierają albo:

Stan: Dane przeznaczone do odczytu i przechowywania. Na przykład informacje o tokenach, dane użytkownika lub inne dane zdefiniowane w programie.
Wykonywalne programy: Konta zawierające rzeczywisty kod programów Solana. Te konta przechowują instrukcje, które użytkownicy mogą wywoływać.

To rozdzielenie kodu programu i stanu programu jest kluczową cechą modelu kont Solana. Więcej szczegółów znajdziesz na stronie Model kont Solana.

Pobieranie konta portfela

Ten przykład pokazuje, jak:

Wygenerować nowy keypair (parę kluczy publiczny/prywatny).
Poprosić o airdrop SOL, aby zasilić nowy adres.
Pobierać dane konta dla zasilonego adresu.

W Solanie zasilenie nowego adresu SOL automatycznie tworzy konto należące do System Program. Wszystkie konta "portfela" to po prostu konta należące do System Program, które przechowują SOL i mogą podpisywać transakcje.

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.

„Portfel” na Solanie to konto należące do System Program, który jest jednym z wbudowanych programów Solany. Konta portfela są głównie używane do przechowywania SOL (śledzone w polu lamports) i do podpisywania transakcji.

Gdy pobierasz konto portfela, odpowiedź zawiera pola pokazane w przykładowym wyniku.

Pole data zawiera dane konta przechowywane jako bajty.

Dla kont portfela to pole jest puste (0 bajtów). Inne konta używają tego pola do przechowywania stanu programu lub wykonywalnego kodu programu.

Pole executable wskazuje, czy pole data konta zawiera wykonywalny kod programu.

Dla portfeli i kont przechowujących stan programu to pole ma wartość false.

Pole lamports zawiera saldo SOL konta, wyrażone w lamportach.

Lamporty to najmniejsza jednostka SOL. 1 SOL = 1 000 000 000 lamportów.

Pole owner pokazuje program, który jest właścicielem konta.

W przypadku portfeli właścicielem jest zawsze System Program, z adresem 11111111111111111111111111111111.

Pole rentEpoch to pole związane z przestarzałym mechanizmem, w którym kontom naliczano "czynsz" (w lamportach) za przechowywanie danych w sieci.

To pole jest obecnie nieużywane, ale zostało uwzględnione dla zachowania kompatybilności wstecznej.

Pole space pokazuje liczbę bajtów w polu data. Nie jest to pole w typie Account, ale zostało uwzględnione w odpowiedzi.

W tym przykładzie pole space wynosi 0, ponieważ pole data zawiera 0 bajtów danych.