Odczyt z sieci

Odczytuj dane z sieci Solana, pobierając różne konta. Ten przewodnik wyjaśnia strukturę kont Solana. Każde konto Solana posiada unikalny adres służący do zlokalizowania danych konta w łańcuchu. Konta Solana zawierają albo dane stanu, albo wykonywalny program.

Pobierz konto portfela

Konto portfela to konto należące do System Program. Konta portfela służą przede wszystkim do przechowywania SOL i podpisywania transakcji. Gdy SOL jest wysyłany na nowy adres po raz pierwszy, konto systemowe jest tworzone automatycznie.

Poniższy przykład tworzy klienta Kit, generuje nowy signer, żąda SOL w celu zasilenia nowego adresu oraz pobiera dane konta z API RPC klienta.

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.

Gdy pobierasz konto portfela za pomocą getAccountInfo(), Kit zwraca odpowiedź RPC pokazaną w przykładowych danych wyjściowych po prawej stronie.

Odpowiedź zawiera dwa pola najwyższego poziomu: context opisuje moment odczytu, natomiast value zawiera pola konta zwrócone przez metodę RPC.

Example output

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

Pole context pokazuje slot użyty do odczytu konta oraz wersję API RPC, która obsłużyła odpowiedź. Późniejszy odczyt może zwrócić inny slot lub wersję API.

Example output

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

Pole value zawiera stan konta zwrócony przez metodę RPC. Kolejne kroki omawia pola wewnątrz value w kolejności, w jakiej się pojawiają.

Example output

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

Pole lamports zawiera saldo SOL konta, wyrażone w lamportach — najmniejszej jednostce SOL.

Example output

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

Pole data zawiera dane konta przechowywane jako bajty. RPC zwraca dane konta jako krotkę: zakodowany ciąg danych, a następnie kodowanie. W przypadku kont portfelowych zakodowany ciąg danych jest pusty, ponieważ konto przechowuje 0 bajtów danych.

Example output

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

Pole owner wskazuje program będący właścicielem konta. W przypadku portfeli właścicielem jest zawsze System Program, o adresie 11111111111111111111111111111111.

Example output

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

Pole executable informuje, czy adres konta jest wywoływalny. true oznacza, że adres reprezentuje program mogący przetwarzać instrukcje. false oznacza, że konto przechowuje stan, taki jak saldo portfela lub dane konta, i nie jest wywoływane jako program. Konta portfelowe używają false.

Pole rentEpoch jest polem dziedzicznym z wycofanego mechanizmu rent. Pole jest nadal zwracane w celu zachowania zgodności wstecznej.

Example output

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

Pole space pokazuje liczbę bajtów zawartych w polu data. Pole space jest zwracane wraz z odpowiedzią pobierającą konto, ale nie jest częścią typu danych konta.

Dla przykładowego konta portfelowego pole space wynosi 0, ponieważ pole data zawiera 0 bajtów danych.

Example output

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