Lezen van het netwerk

Lees gegevens van het Solana-netwerk door verschillende accounts op te halen. Deze handleiding legt de structuur van Solana accounts uit. Elk Solana- account heeft een uniek adres dat wordt gebruikt om de onchain-gegevens van het account te vinden. Solana-accounts bevatten ofwel statusgegevens of een uitvoerbaar programma.

Een wallet-account ophalen

Een wallet-account is een account dat eigendom is van het System Program. Wallet-accounts worden voornamelijk gebruikt om SOL te bewaren en transacties te ondertekenen. Wanneer SOL voor de eerste keer naar een nieuw adres wordt gestuurd, wordt er automatisch een systeemaccount aangemaakt.

Het onderstaande voorbeeld maakt een Kit-client aan, genereert een nieuwe ondertekenaar, vraagt SOL op om het nieuwe adres te financieren, en haalt de accountgegevens op via de RPC- API van de client.

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.

Wanneer je een wallet-account ophaalt met getAccountInfo(), geeft Kit het RPC- antwoord terug zoals weergegeven in de voorbeelduitvoer aan de rechterkant.

Het antwoord heeft twee velden op het hoogste niveau: context beschrijft wanneer het lezen plaatsvond, en value bevat de accountvelden die door de RPC-methode worden geretourneerd.

Het veld context toont de slot die is gebruikt om het account te lezen en de RPC API- versie die het antwoord heeft geleverd. Een latere leesactie kan een andere slot of API-versie retourneren.

Het veld value bevat de accountstatus die door de RPC-methode wordt geretourneerd. De volgende stappen doorlopen de velden binnen value in de volgorde waarin de velden verschijnen.

Example output

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

Het veld lamports bevat het SOL-saldo van het account, gemeten in lamports, de kleinste eenheid van SOL.

Example output

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

Het veld data bevat de gegevens van het account opgeslagen als bytes. De RPC geeftaccountgegevens terug als een tuple: de gecodeerde gegevensstring, gevolgd door de codering. Voor walletaccounts is de gecodeerde gegevensstring leeg, omdat het account 0 bytes aan gegevens opslaat.

Example output

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

Het veld owner toont het programma dat eigenaar is van het account. Voor wallets is de eigenaar altijd het System Program, met het adres 11111111111111111111111111111111.

Example output

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

Het veld executable geeft aan of het adres van het account aanroepbaar is. true betekent dat het adres een programma vertegenwoordigt dat instructies kan verwerken. false betekent dat het account een toestand opslaat, zoals een walletsaldo of accountgegevens, en niet als een programma wordt aangeroepen. Walletaccounts gebruiken false.

Het veld rentEpoch is een verouderd veld afkomstig van een verouderd rent-mechanisme. Het veld wordt nog steeds teruggegeven voor achterwaartse compatibiliteit.

Example output

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

Het veld space toont het aantal bytes in het veld data. Het veld space wordt teruggegeven met de accountopvraagrespons, maar maakt geen deel uit van het gegevenstype van het account.

Voor het walletaccount-voorbeeld is het veld space 0 omdat het veld data 0 bytes aan gegevens bevat.

Example output

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