Daten vom Netzwerk lesen

Dieser Abschnitt erklärt, wie man Daten aus dem Solana-Netzwerk liest, indem man verschiedene Konten abruft, um die Struktur eines Solana-Kontos zu verstehen.

Auf Solana existieren alle Daten in "Konten". Sie können sich die Daten auf Solana als eine öffentliche Datenbank mit einer einzigen "Konten"-Tabelle vorstellen, wobei jeder Eintrag ein Konto mit dem gleichen Basis- Kontotyp ist.

Base Account Type

#[derive(PartialEq, Eq, Clone, Default)]
pub struct Account {
    /// lamports in the account
    pub lamports: u64,
    /// data held in this account
    #[cfg_attr(feature = "serde", serde(with = "serde_bytes"))]
    pub data: Vec<u8>,
    /// the program that owns this account. If executable, the program that loads this account.
    pub owner: Pubkey,
    /// this account's data contains a loaded program (and is now read-only)
    pub executable: bool,
    /// the epoch at which this account will next owe rent
    pub rent_epoch: Epoch,
}

Konten Konten

Konten auf Solana können "Zustand" oder "ausführbare" Programme speichern. Jedes Konto hat eine "Adresse" (öffentlicher Schlüssel), die als eindeutige ID dient und verwendet wird, um die entsprechenden On-Chain-Daten zu lokalisieren.

Solana-Konten enthalten entweder:

State: Daten, die gelesen und gespeichert werden sollen. Zum Beispiel Informationen über Token, Benutzerdaten oder andere Daten, die innerhalb eines Programms definiert sind.
Ausführbare Programme: Konten, die den tatsächlichen Code von Solana Programmen enthalten. Diese Konten speichern Anweisungen, die Benutzer aufrufen können.

Diese Trennung von Programmcode und Programmzustand ist ein Schlüsselmerkmal von Solanas Kontenmodell. Weitere Details finden Sie auf der Seite Solana-Kontenmodell.

Wallet-Konto abrufen

Dieses Beispiel zeigt, wie man:

Ein neues keypair (öffentliches/privates Schlüsselpaar) generiert.
Einen Airdrop von SOL anfordert, um die neue Adresse zu finanzieren.
Die Kontodaten für die finanzierte Adresse abruft.

Auf Solana erstellt die Finanzierung einer neuen Adresse mit SOL automatisch ein Konto, das dem System Program gehört. Alle "Wallet"-Konten sind einfach System Program-eigene Konten, die SOL halten und Transaktionen signieren können.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

Eine "Wallet" auf Solana ist ein Konto, das dem System Program gehört, einem der integrierten Programme von Solana. Wallet-Konten werden hauptsächlich verwendet, um SOL zu halten (im lamports Feld erfasst) und um Transaktionen zu signieren.

Wenn Sie ein Wallet-Konto abrufen, enthält die Antwort die im Beispiel gezeigten Felder.

Das data Feld enthält die als Bytes gespeicherten Daten des Kontos.

Bei Wallet-Konten ist dieses Feld leer (0 Bytes). Andere Konten verwenden dieses Feld, um entweder Programmzustände oder ausführbaren Programmcode zu speichern.

Das executable Feld gibt an, ob das data Feld des Kontos ausführbaren Programmcode enthält.

Für Wallets und Konten, die Programmzustände speichern, ist dieses Feld false.

Das lamports Feld enthält das SOL-Guthaben des Kontos, angegeben in lamports.

Lamports sind die kleinste Einheit von SOL. 1 SOL = 1.000.000.000 lamports.

Das Feld owner zeigt das Programm an, dem das Konto gehört.

Bei Wallets ist der Eigentümer immer das System Program mit der Adresse 11111111111111111111111111111111.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Das Feld rentEpoch ist ein veraltetes Feld aus einem nicht mehr verwendeten Mechanismus, bei dem Konten "rent" (in lamports) berechnet wurde, um ihre Daten im Netzwerk zu speichern.

Dieses Feld wird derzeit nicht verwendet, ist aber aus Gründen der Abwärtskompatibilität enthalten.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Das Feld space zeigt die Anzahl der Bytes im Feld data an. Dies ist kein Feld im Typ Account selbst, sondern in der Antwort enthalten.

In diesem Beispiel ist das Feld space 0, weil das Feld data 0 Bytes an Daten enthält.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}