Membaca dari Jaringan

Bagian ini membahas cara membaca data dari jaringan Solana dengan mengambil berbagai akun untuk memahami struktur akun Solana.

Di Solana, semua data ada dalam "accounts". Anda dapat menganggap data di Solana sebagai database publik dengan satu tabel "Accounts", di mana setiap entri adalah akun dengan dasar yang sama Tipe Akun.

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

Akun Akun

Akun di Solana dapat menyimpan "state" atau program "executable". Setiap akun memiliki "alamat" (kunci publik) yang berfungsi sebagai ID uniknya yang digunakan untuk menemukan data on-chain yang sesuai.

Akun Solana berisi salah satu dari:

State: Data yang dimaksudkan untuk dibaca dan disimpan. Misalnya, informasi tentang token, data pengguna, atau data lain yang didefinisikan dalam program.
Program Executable: Akun yang berisi kode aktual program Solana. Akun ini menyimpan instruksi yang dapat dipanggil oleh pengguna.

Pemisahan antara kode program dan state program adalah fitur utama dari Model Akun Solana. Untuk detail lebih lanjut, lihat halaman Model Akun Solana.

Mengambil Akun Dompet

Contoh ini menunjukkan cara:

Menghasilkan keypair baru (pasangan kunci publik/privat).
Meminta airdrop SOL untuk mendanai alamat baru.
Mengambil data akun untuk alamat yang telah didanai.

Di Solana, mendanai alamat baru dengan SOL secara otomatis membuat akun yang dimiliki oleh System Program. Semua akun "dompet" hanyalah akun yang dimiliki System Program yang menyimpan SOL dan dapat menandatangani transaksi.

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.

"Wallet" di Solana adalah akun yang dimiliki oleh System Program, yang merupakan salah satu program bawaan Solana. Akun wallet terutama digunakan untuk menyimpan SOL (dilacak di bidang lamports) dan untuk menandatangani transaksi.

Ketika Anda mengambil akun wallet, respons tersebut mencakup bidang-bidang yang ditunjukkan dalam contoh output.

Bidang data berisi data akun yang disimpan sebagai byte.

Untuk akun wallet, bidang ini kosong (0 byte). Akun lain menggunakan bidang ini untuk menyimpan status program atau kode program yang dapat dieksekusi.

Bidang executable menunjukkan apakah bidang data akun berisi kode program yang dapat dieksekusi.

Untuk wallet dan akun yang menyimpan status program, bidang ini adalah false.

Bidang lamports berisi saldo SOL akun, yang dinyatakan dalam lamport.

Lamport adalah unit terkecil dari SOL. 1 SOL = 1.000.000.000 lamport.

Kolom owner menunjukkan program yang memiliki akun tersebut.

Untuk dompet, pemiliknya selalu System Program, dengan alamat 11111111111111111111111111111111.

Example Output

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

Kolom rentEpoch adalah kolom lama dari mekanisme yang sudah tidak digunakan di mana akun dikenakan "rent" (dalam lamport) untuk mempertahankan datanya di jaringan.

Kolom ini saat ini tidak digunakan, tetapi disertakan untuk kompatibilitas mundur.

Example Output

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

Kolom space menunjukkan jumlah byte dalam kolom data. Ini bukan kolom dalam tipe Account itu sendiri, tetapi disertakan dalam respons.

Dalam contoh ini, kolom space adalah 0 karena kolom data berisi 0 byte data.

Example Output

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