Daten vom Netzwerk lesen

Lesen Sie Daten aus dem Solana-Netzwerk, indem Sie verschiedene Konten abrufen. Dieser Leitfaden erläutert die Struktur von Solana-Konten. Jedes Solana- Konten hat eine eindeutige Adresse, die verwendet wird, um die Onchain-Daten des Kontos zu lokalisieren. Solana-Konten enthalten entweder Zustandsdaten oder ein ausführbares Programm.

Ein Wallet-Konto abrufen

Ein Wallet-Konten ist ein Konten, das dem System Program gehört. Wallet-Konten werden hauptsächlich verwendet, um SOL zu halten und Transaktionen zu signieren. Wenn SOL zum ersten Mal an eine neue Adresse gesendet wird, wird automatisch ein System-Konten erstellt.

Das folgende Beispiel erstellt einen Kit-Client, generiert einen neuen Signer, fordert SOL an, um die neue Adresse zu finanzieren, und ruft die Kontendaten ab über die RPC-API des Clients.

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.

Wenn Sie ein Wallet-Konten mit getAccountInfo() abrufen, gibt Kit die RPC- Antwort zurück, die im Beispiel-Output auf der rechten Seite gezeigt wird.

Die Antwort hat zwei Felder auf oberster Ebene: context beschreibt, wann der Lesevorgang stattgefunden hat, und value enthält die Kontenfelder, die von der RPC-Methode zurückgegeben werden.

Das Feld context zeigt den slot, der zum Lesen des Kontos verwendet wurde, sowie die RPC-API- Version, die die Antwort bereitgestellt hat. Ein späterer Lesevorgang kann einen anderen slot oder eine andere API-Version zurückgeben.

Das Feld value enthält den Kontenstatus, der von der RPC-Methode zurückgegeben wird. Die folgenden Schritte erläutern die Felder innerhalb von value in der Reihenfolge, in der die Felder erscheinen.

Example output

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

Das Feld lamports enthält das SOL-Guthaben des Konten, gemessen in lamports, der kleinsten Einheit von SOL.

Example output

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

Das Feld data enthält die im Konten gespeicherten Daten in Form von Bytes. RPC gibt Kontendaten als Tupel zurück: den codierten Datenstring, gefolgt von der Kodierung. Bei Wallet-Konten ist der codierte Datenstring leer, da das Konten 0 Bytes an Daten speichert.

Example output

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

Das Feld owner zeigt das Programm, dem das Konten gehört. Bei Wallets ist der Eigentümer immer das System Program, mit der Adresse 11111111111111111111111111111111.

Example output

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

Das Feld executable gibt an, ob die Adresse des Konten aufrufbar ist. true bedeutet, dass die Adresse ein Programm repräsentiert, das Anweisungen verarbeiten kann. false bedeutet, dass das Konten einen Zustand speichert, wie z. B. ein Wallet-Guthaben oder Kontendaten, und nicht als Programm aufgerufen wird. Wallet-Konten verwenden false.

Das Feld rentEpoch ist ein Legacy-Feld aus einem veralteten rent-Mechanismus. Das Feld wird aus Gründen der Abwärtskompatibilität weiterhin zurückgegeben.

Example output

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

Das Feld space zeigt die Anzahl der Bytes im Feld data. Das Feld space wird mit der Antwort beim Abrufen des Konten zurückgegeben, ist jedoch nicht Teil des Datentyps des Konten.

Für das Wallet-Konten-Beispiel ist das Feld space 0, da das Feld data 0 Bytes an Daten enthält.

Example output

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

Wenn Sie ein Wallet-Konten mit getAccountInfo() abrufen, gibt Kit die RPC- Antwort zurück, die im Beispiel-Output auf der rechten Seite gezeigt wird.

Die Antwort hat zwei Felder auf oberster Ebene: context beschreibt, wann der Lesevorgang stattgefunden hat, und value enthält die Kontenfelder, die von der RPC-Methode zurückgegeben werden.

Das Feld lamports enthält das SOL-Guthaben des Konten, gemessen in lamports, der kleinsten Einheit von SOL.

Das Feld owner zeigt das Programm, dem das Konten gehört. Bei Wallets ist der Eigentümer immer das System Program, mit der Adresse 11111111111111111111111111111111.

Das Feld rentEpoch ist ein Legacy-Feld aus einem veralteten rent-Mechanismus. Das Feld wird aus Gründen der Abwärtskompatibilität weiterhin zurückgegeben.

Das Feld space zeigt die Anzahl der Bytes im Feld data. Das Feld space wird mit der Antwort beim Abrufen des Konten zurückgegeben, ist jedoch nicht Teil des Datentyps des Konten.

Für das Wallet-Konten-Beispiel ist das Feld space 0, da das Feld data 0 Bytes an Daten enthält.

Example output

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

Token Program abrufen

Das folgende Beispiel ruft das Token Program ab, um den Unterschied zwischen Wallet- und Programm-Konten zu veranschaulichen. Das Token Program definiert Anweisungen für die Arbeit mit Token, wie das Erstellen und Übertragen von Token. Programme werden aufgerufen, um Anweisungen zu verarbeiten. Der Programmzustand, wie Token-Daten und Guthaben, wird in separaten Konten gespeichert, die dem Programm gehören.

Die Adresse des Token Programs ist das onchain program account. Der Einfachheit halber kann man die Programmadresse als das Programm selbst betrachten, da dies die Adresse ist, die zum Aufrufen verwendet wird. Bei upgradefähigen Programmen speichert das program account Metadaten und verweist auf ein separates programdata account, das den bereitgestellten ausführbaren Code enthält. Sie können den Token Program Quellcode und das program account im Solana Explorer einsehen.

Fetch program account

import { address, createClient, fetchJsonParsedAccount } from "@solana/kit";
import { solanaRpc } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "https://api.mainnet.solana.com"
    })
  );

const tokenProgramAddress = address(
  "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
);

const accountInfo = await client.rpc
  .getAccountInfo(tokenProgramAddress, {
    encoding: "base64"
  })
  .send();

console.log(accountInfo);

const parsedAccount = await fetchJsonParsedAccount(
  client.rpc,
  tokenProgramAddress
);

console.log(parsedAccount);

Console

Click to execute the code.

Fetch program account

import { address, createClient, fetchJsonParsedAccount } from "@solana/kit";
import { solanaRpc } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "https://api.mainnet.solana.com"
    })
  );

const tokenProgramAddress = address(
  "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
);

const accountInfo = await client.rpc
  .getAccountInfo(tokenProgramAddress, {
    encoding: "base64"
  })
  .send();

console.log(accountInfo);

const parsedAccount = await fetchJsonParsedAccount(
  client.rpc,
  tokenProgramAddress
);

console.log(parsedAccount);

Console

Click to execute the code.

Das Token Program ist ein ausführbares program account. Programme besitzen dieselben grundlegenden Felder wie alle Konten, weisen jedoch wesentliche Unterschiede auf.

Das Token Program-Beispiel verwendet die base64-Kodierung, um die Rohdaten des program accounts zurückzugeben.

Die folgenden Schritte führen durch die Felder in value in der Reihenfolge, in der die Felder erscheinen.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Das Feld data speichert den Zustand des program accounts des BPF Upgradeable Loaders. Das erste Tupel-Element enthält die vollständigen Kontodaten, kodiert als Base64. Das zweite Tupel-Element gibt die Kodierung an. Hier umfassen die 36 Bytes Metadaten und die Adresse des programdata accounts.

Bei upgradefähigen Programmen verweist der Zustand des program accounts auf das separate programdata account, das den ausführbaren Code des Programms enthält.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Das Feld executable ist auf true gesetzt, was bedeutet, dass die Adresse des Konten als Programm aufgerufen werden kann.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Das Feld lamports enthält den SOL-Guthaben des program account. Program accounts benötigen ausreichend lamports, um rent-exempt zu bleiben.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Jedes program account gehört einem Loader-Programm. Für das Token Program account ist der owner der BPF Upgradeable Loader.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Das Feld rentEpoch ist ein veraltetes Feld aus einem abgeschafften rent-Mechanismus. Das Feld wird aus Gründen der Abwärtskompatibilität weiterhin zurückgegeben.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Das Feld space zeigt die Gesamtgröße der Daten des program account in Bytes. Der Wert space beträgt nur 36 Bytes, da das program account Loader-Metadaten und die Adresse des ProgramData-Konten speichert, nicht den vollständig kompilierten Programmcode.

Token program account

{
  context: {
    apiVersion: "3.1.14",
    slot: 420601581n
  },
  value: {
    data: ["AgAAACfxkLHTr5i4znFMROjK3/n4/EXLjl+sQgLv+BENl903", "base64"],
    executable: true,
    lamports: 2191440n,
    owner: "BPFLoaderUpgradeab1e11111111111111111111111",
    rentEpoch: 18446744073709551615n,
    space: 36n
  }
}

Die vorherige Antwort hat das Feld data des program account als Base64- Tupel zurückgegeben. Die geparste Antwort deserialisiert diese Bytes in benannte Felder des data-Objekts. Das Feld programData enthält die Adresse des ProgramData- Konten, das den ausführbaren Programmcode speichert.

Parsed Token program account

{
  executable: true,
  lamports: 43712780n,
  programAddress: "BPFLoaderUpgradeab1e11111111111111111111111",
  space: 36n,
  address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  data: {
    programData: "3gvYRKWyXRR9xKWe1ZjPhLY5ZJRN7KDB4rFZFGoJfFk2",
    parsedAccountMeta: { program: "bpf-upgradeable-loader", type: "program" }
  },
  exists: true
}