Membaca dari jaringan

Baca data dari jaringan Solana dengan mengambil berbagai akun. Panduan ini menjelaskan struktur akun Solana. Setiap akun Solana memiliki alamat unik yang digunakan untuk menemukan data onchain akun tersebut. Akun Solana berisi data status atau program yang dapat dieksekusi.

Mengambil akun wallet

Akun dompet adalah akun yang dimiliki oleh System Program. Akun dompet terutama digunakan untuk menyimpan SOL dan menandatangani transaksi. Ketika SOL dikirim ke alamat baru untuk pertama kalinya, akun sistem akan dibuat secara otomatis.

Contoh di bawah ini membuat klien Kit, menghasilkan penanda tangan baru, meminta SOL untuk mendanai alamat baru, dan mengambil data akun dari API RPC klien.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Saat Anda mengambil akun dompet dengan getAccountInfo(), Kit mengembalikan respons RPC seperti yang ditampilkan pada contoh output di sebelah kanan.

Respons memiliki dua field tingkat atas: context mendeskripsikan kapan pembacaan terjadi, dan value berisi field akun yang dikembalikan oleh metode RPC.

Field context menampilkan slot yang digunakan untuk membaca akun dan versi API RPC yang melayani respons tersebut. Pembacaan berikutnya dapat mengembalikan slot atau versi API yang berbeda.

Field value berisi status akun yang dikembalikan oleh metode RPC. Langkah-langkah berikut memandu Anda melalui field di dalam value sesuai urutan field tersebut muncul.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Kolom lamports berisi saldo SOL akun, diukur dalam lamport, satuan terkecil dari SOL.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Kolom data berisi data akun yang disimpan dalam bentuk byte. RPC mengembalikan data akun sebagai tuple: string data yang telah dienkode, diikuti dengan encoding-nya. Untuk akun dompet, string data yang dienkode kosong karena akun menyimpan 0 byte data.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Kolom owner menampilkan program yang memiliki akun tersebut. Untuk dompet, pemiliknya selalu System Program, dengan alamat 11111111111111111111111111111111.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Kolom executable memberi tahu apakah alamat akun dapat dipanggil. true berarti alamat tersebut merepresentasikan program yang dapat memproses instruksi. false berarti akun menyimpan state, seperti saldo dompet atau data akun, dan tidak dipanggil sebagai program. Akun dompet menggunakan false.

Kolom rentEpoch adalah kolom lama dari mekanisme rent yang sudah tidak digunakan. Kolom ini masih dikembalikan untuk kompatibilitas mundur.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Kolom space menampilkan jumlah byte yang terdapat dalam kolom data. Kolom space dikembalikan bersama respons pengambilan akun, tetapi bukan merupakan bagian dari tipe data akun.

Untuk contoh akun dompet, kolom space bernilai 0 karena kolom data berisi 0 byte data.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}