Cara Menggunakan getAccountInfo

​

Kasus Penggunaan Umum

• Memeriksa Saldo SOL: Tentukan saldo SOL native dari akun mana pun.
• Memverifikasi Keberadaan Akun: Periksa apakah akun dengan kunci publik tertentu telah diinisialisasi (yaitu memiliki lamport atau data).
• Memeriksa Akun Program: Ambil data yang disimpan dalam akun milik suatu program. Hal ini penting untuk memahami status program.
• Mengidentifikasi Pemilik Akun: Cari tahu program mana yang memiliki suatu akun. Ini membantu menentukan cara menafsirkan data akun atau mengetahui apakah akun tersebut dimiliki oleh sistem.
• Memeriksa Apakah Akun Dapat Dieksekusi: Identifikasi apakah akun berisi program yang telah di-deploy.

​

Parameter

1. publicKey (string, wajib): Kunci publik akun yang akan dikueri, yang dikodekan dalam base-58.
2. config (objek, opsional): Objek konfigurasi dengan bidang-bidang berikut:
   • commitment (string, opsional): Menentukan tingkat komitmen yang akan digunakan untuk kueri. Nilai default-nya adalah finalized.
     • finalized: Node akan mengkueri blok terbaru yang telah dikomit secara permanen. Utamakan nilai ini untuk kode baru.
     • confirmed: Dalam Alpenglow, setara dengan finalized; dipertahankan untuk kompatibilitas.
     • processed: Node akan mengkueri blok terbarunya. Perhatikan bahwa blok tersebut mungkin belum lengkap.
   • encoding (string, opsional): Enkode untuk data akun. Nilai default-nya adalah base64.
     • base58 (lambat)
     • base64
     • base64+zstd (jika data dikompresi)
     • jsonParsed: Jika data akun merupakan status program yang dikenal (misalnya, akun token atau akun staking), node akan mencoba mengurainya menjadi struktur JSON. Untuk akun program generik, format ini biasanya kembali menggunakan data biner (base64).
   • dataSlice (objek, opsional): Membatasi data akun yang dikembalikan ke potongan tertentu. Hanya tersedia untuk enkode base58, base64, atau base64+zstd.
     • offset (angka): Jumlah byte dari awal data akun untuk memulai potongan.
     • length (angka): Jumlah byte yang akan dikembalikan.
   • minContextSlot (angka, opsional): Slot minimum tempat permintaan dapat dievaluasi.

​

Respons

• context (objek): Berisi metadata tentang permintaan.
  • slot (angka): Slot tempat informasi diambil.
  • apiVersion (string, opsional): Versi API RPC.
• value (objek | null): Jika akun tidak ada, nilainya akan berupa null. Jika tidak, nilainya adalah objek yang berisi:
  • lamports (angka): Jumlah lamport (1 SOL = 1.000.000.000 lamport) yang dimiliki akun.
  • owner (string): Kunci publik program yang memiliki akun ini, yang dikodekan dalam base-58.
  • data (array | objek | string): Data yang disimpan dalam akun. Formatnya bergantung pada parameter encoding yang digunakan dalam permintaan.
    • Untuk base64 (default), base58, base64+zstd: Nilai ini biasanya berupa array [encoded_string, encoding_format], misalnya ["string_data", "base64"].
    • Untuk jsonParsed: Nilai ini dapat berupa objek JSON jika data dapat diurai oleh node RPC (misalnya, untuk akun SPL Token). Jika tidak, nilainya dapat kembali menggunakan ["", "base64"] atau format serupa jika data tidak dikenali sebagai tata letak standar.
  • executable (boolean): true jika akun berisi program, dan false jika tidak.
  • rentEpoch (angka): Epoch berikutnya saat akun ini harus membayar sewa.
  • space (angka, opsional): Panjang data dalam byte. (Catatan: Dokumentasi resmi Solana mencantumkan space, dan beberapa penyedia RPC mungkin menyertakannya. Nilai ini menunjukkan total ruang yang dialokasikan untuk data akun). Untuk detail selengkapnya tentang data akun dan deserialisasi, lihat panduan terperinci kami.

​

Contoh: Mengambil Informasi Akun

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAccountInfo",
  "params": [
    "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
    {
      "encoding": "jsonParsed"
    }
  ]
}'

const { Connection, PublicKey } = require('@solana/web3.js');

async function getAccountDetails() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'finalized');
  const accountPubKey = new PublicKey('9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin');

  try {
    const accountInfo = await connection.getAccountInfo(accountPubKey);

    if (accountInfo === null) {
      console.log('Account not found.');
      return;
    }

    console.log('Account Info:');
    console.log(`   Lamports: ${accountInfo.lamports}`);
    console.log(`   Owner: ${accountInfo.owner.toBase58()}`);
    console.log(`   Executable: ${accountInfo.executable}`);
    console.log(`   Rent Epoch: ${accountInfo.rentEpoch}`);
    // Data is a Buffer, you might need to deserialize it based on the account type
    // console.log(`   Data: ${accountInfo.data.toString()}`); 
  } catch (error) {
    console.error('Error fetching account info:', error);
  }
}

getAccountDetails();

import { address, createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

const publicKey = address("vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg");
const accountInfo = await rpc.getAccountInfo(publicKey).send();

console.log("Account Info:", accountInfo);

use solana_client::nonblocking::rpc_client::RpcClient;
use solana_sdk::{commitment_config::CommitmentConfig, pubkey::Pubkey};
use anyhow::Result;
use std::str::FromStr;

#[tokio::main]
async fn main() -> Result<()> {
    let client = RpcClient::new_with_commitment(
        String::from("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
        CommitmentConfig::finalized()
    );
    let pubkey = Pubkey::from_str("vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg")?;
    let account = client.get_account(&pubkey).await?;

    println!("{:#?}", account);

    Ok(())
}

​

Tips untuk Developer

• Performa: Untuk aplikasi yang memerlukan pemeriksaan beberapa akun secara rutin, pertimbangkan untuk menggunakan getMultipleAccounts guna mengelompokkan permintaan dan mengurangi perjalanan bolak-balik.
• Deserialisasi Data: Bidang data sering kali memerlukan deserialisasi berdasarkan struktur data program pemilik. Alat dan pustaka khusus untuk program tersebut (misalnya, pustaka SPL Token untuk akun token) biasanya diperlukan. Artikel blog kami tentang deserialisasi data akun menyediakan teknik dan contoh yang bermanfaat.
• Batas Laju: Perhatikan batas laju node RPC, terutama saat mengkueri banyak akun atau sering membuat permintaan.
• Pengelolaan Biaya: getAccountInfo umumnya merupakan kueri berbiaya rendah, tetapi polling yang sering dapat meningkatkan biaya. Optimalkan pola kueri Anda.
• Gunakan jsonParsed dengan Bijak: Meskipun jsonParsed praktis digunakan, format ini mungkin tidak mendukung semua jenis akun, dan output-nya dapat berubah jika program memperbarui struktur datanya. Untuk aplikasi penting, penguraian data biner dengan tata letak yang diketahui menawarkan stabilitas lebih baik.
• Pertimbangkan dataSlice: Jika Anda hanya memerlukan sebagian kecil data akun, gunakan dataSlice untuk mengurangi jumlah data yang ditransfer dan berpotensi menurunkan biaya kueri.

​

Metode Terkait