Ağdan Okuma

Farklı hesapları çekerek Solana ağından veri okuyun. Bu kılavuz, Solana hesaplarının yapısını açıklar. Her Solana hesabının, hesabın zincir üzerindeki verilerini bulmak için kullanılan benzersiz bir adresi vardır. Solana hesapları durum verisi veya çalıştırılabilir bir program içerir.

Bir cüzdan hesabını çekme

Bir cüzdan hesabı, System Program tarafından sahiplenilen bir hesaptır. Cüzdan hesapları öncelikle SOL tutmak ve işlemleri imzalamak için kullanılır. SOL bir adrese ilk kez gönderildiğinde, sistem hesabı otomatik olarak oluşturulur.

Aşağıdaki örnek, bir Kit istemcisi oluşturur, yeni bir imzalayıcı üretir, yeni adresi fonlamak için SOL talep eder ve istemcinin RPC API'sinden hesap verilerini alır.

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.

getAccountInfo() ile bir cüzdan hesabı çektiğinizde, Kit sağ taraftaki örnek çıktıda gösterilen RPC yanıtını döndürür.

Yanıt iki üst düzey alan içerir: context okumanın ne zaman gerçekleştiğini açıklar, value ise RPC yöntemi tarafından döndürülen hesap alanlarını içerir.

context alanı, hesabı okumak için kullanılan slot ile yanıtı sunan RPC API sürümünü gösterir. Sonraki bir okuma farklı bir slot veya API sürümü döndürebilir.

value alanı, RPC yöntemi tarafından döndürülen hesap durumunu içerir. Aşağıdaki adımlar, value içindeki alanları göründükleri sırayla ele almaktadır.

Example output

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

lamports alanı, hesabın SOL bakiyesini, SOL'un en küçük birimi olan lamport cinsinden içerir.

Example output

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

data alanı, hesapta bayt olarak depolanan verileri içerir. RPC, hesap verilerini bir demet olarak döndürür: kodlanmış veri dizisi ve ardından kodlama türü. Cüzdan hesapları için, hesap 0 bayt veri depoladığından kodlanmış veri dizisi boştur.

Example output

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

owner alanı, hesabın sahibi olan programı gösterir. Cüzdanlar için sahip her zaman System Program'dır ve adresi 11111111111111111111111111111111'dir.

Example output

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

executable alanı, hesabın adresinin çağrılabilir olup olmadığını belirtir. true, adresin talimatları işleyebilen bir programı temsil ettiği anlamına gelir. false, hesabın bir cüzdan bakiyesi veya hesap verisi gibi durum depoladığı ve program olarak çağrılmadığı anlamına gelir. Cüzdan hesapları false kullanır.

rentEpoch alanı, kullanımdan kaldırılmış bir rent mekanizmasından kalan eski bir alandır. Alan, geriye dönük uyumluluk için hâlâ döndürülmektedir.

Example output

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

space alanı, data alanında bulunan bayt sayısını gösterir. space alanı, hesap getirme yanıtıyla birlikte döndürülür; ancak hesabın veri türünün bir parçası değildir.

Cüzdan hesabı örneğinde, data alanı 0 bayt veri içerdiğinden space alanı 0'dır.

Example output

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