Konten

Alle Daten im Solana-Netzwerk werden in Konten gespeichert. Sie können sich das Solana-Netzwerk als öffentliche Datenbank mit einer einzigen Konten-Tabelle vorstellen. Die Beziehung zwischen einem Konto und seiner Adresse ähnelt der eines Schlüssel-Wert-Paares, wobei der Schlüssel die Adresse und der Wert das Konto ist.

Jedes Konto hat die gleiche grundlegende Struktur und kann über seine Adresse lokalisiert werden.

Diagramm von 3 Konten und ihren Adressen. Enthält die Definition der Kontostruktur.Diagramm von 3 Konten und ihren Adressen. Enthält die Definition der Kontostruktur.

Kontoadresse

Die Adresse des Kontos ist eine 32-Byte eindeutige ID, die verwendet wird, um das Konto auf der Solana-Blockchain zu lokalisieren. Kontoadressen werden oft als base58-kodierte Zeichenketten angezeigt. Die meisten Konten verwenden einen Ed25519 öffentlichen Schlüssel als ihre Adresse, aber dies ist nicht erforderlich, da Solana auch Program Derived Address unterstützt.

Ein Konto mit seiner base58-kodierten öffentlichen SchlüsseladresseEin Konto mit seiner base58-kodierten öffentlichen Schlüsseladresse

Öffentlicher Schlüssel

Das folgende Beispiel zeigt, wie man das Solana SDK verwendet, um ein keypair zu erstellen.

import { generateKeyPairSigner } from "@solana/kit";
// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);
Console
Click to execute the code.

Program Derived Address

Eine Program Derived Address (PDA) ist eine Adresse, die deterministisch unter Verwendung einer Programm-ID und einer oder mehrerer optionaler Eingaben (Seeds) abgeleitet wird. Das folgende Beispiel zeigt, wie man das Solana SDK verwendet, um eine Program Derived Address zu erstellen.

import { Address, getProgramDerivedAddress } from "@solana/kit";
const programAddress = "11111111111111111111111111111111" as Address;
const seeds = ["helloWorld"];
const [pda, bump] = await getProgramDerivedAddress({
programAddress,
seeds
});
console.log(`PDA: ${pda}`);
console.log(`Bump: ${bump}`);
Console
Click to execute the code.

Kontostruktur

Jedes Account hat eine maximale Größe von 10MiB und enthält folgende Informationen:

  • lamports: Die Anzahl der lamports im Konto
  • data: Die Daten des Kontos
  • owner: Die ID des Programms, das das Konto besitzt
  • executable: Gibt an, ob das Konto ausführbaren Binärcode enthält
  • rent_epoch: Das veraltete rent epoch Feld
Account
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,
}

Lamports

Das Guthaben des Kontos in lamports.

Jedes Konto muss ein Mindestguthaben an Lamports haben, genannt rent, das es ermöglicht, seine Daten on-chain zu speichern. Rent ist proportional zur Größe des Kontos.

Obwohl dieses Guthaben als Rent bezeichnet wird, funktioniert es eher wie eine Kaution, da das gesamte Guthaben zurückerstattet werden kann, wenn das Konto geschlossen wird. (Der Name "rent" stammt aus dem inzwischen veralteten rent epoch Feld.)

(Siehe die Mindestguthaben-Formel und die anwendbaren Konstanten.)

Daten

Dieses Feld wird üblicherweise als "Kontodaten" bezeichnet. Die data in diesem Feld werden als beliebig betrachtet, da sie jede Bytesequenz enthalten können. Jedes Programm definiert die Struktur der in diesem Feld gespeicherten Daten.

  • Program accounts: Dieses Feld enthält entweder ausführbaren Programmcode oder die Adresse eines program data account, das den ausführbaren Programmcode speichert.
  • Data accounts: Dieses Feld speichert in der Regel Zustandsdaten, die gelesen werden sollen.

Das Lesen von Daten aus einem Solana-Konto umfasst zwei Schritte:

  1. Abrufen des Kontos über seine Adresse
  2. Deserialisieren des data-Felds des Kontos von Rohbytes in die entsprechende Datenstruktur, wie vom Programm definiert, das das Konto besitzt.

Eigentümer

Dieses Feld enthält die Programm-ID des Eigentümers des Kontos.

Jedes Solana-Konto hat ein Programm, das als sein Eigentümer festgelegt ist. Der Eigentümer des Kontos ist das einzige Programm, das die data des Kontos ändern oder Lamports abziehen kann, wie in den Anweisungen des Programms angegeben.

(Im Fall eines program account ist der Eigentümer sein Loader-Programm.)

Ausführbar

Dieses Feld gibt an, ob ein Konto ein program account oder ein data account ist

  • Wenn true: Das Konto ist ein program account
  • Wenn false: Das Konto ist ein data account

Rent-Epoche

Das Feld rent_epoch ist veraltet.

In der Vergangenheit verfolgte dieses Feld, wann ein Konto rent zahlen musste. Dieser rent-Erfassungsmechanismus wurde jedoch inzwischen eingestellt.

Lamports

Das Guthaben des Kontos in lamports.

Jedes Konto muss ein Mindestguthaben an Lamports haben, genannt rent, das es ermöglicht, seine Daten on-chain zu speichern. Rent ist proportional zur Größe des Kontos.

Obwohl dieses Guthaben als Rent bezeichnet wird, funktioniert es eher wie eine Kaution, da das gesamte Guthaben zurückerstattet werden kann, wenn das Konto geschlossen wird. (Der Name "rent" stammt aus dem inzwischen veralteten rent epoch Feld.)

(Siehe die Mindestguthaben-Formel und die anwendbaren Konstanten.)

Daten

Dieses Feld wird üblicherweise als "Kontodaten" bezeichnet. Die data in diesem Feld werden als beliebig betrachtet, da sie jede Bytesequenz enthalten können. Jedes Programm definiert die Struktur der in diesem Feld gespeicherten Daten.

  • Program accounts: Dieses Feld enthält entweder ausführbaren Programmcode oder die Adresse eines program data account, das den ausführbaren Programmcode speichert.
  • Data accounts: Dieses Feld speichert in der Regel Zustandsdaten, die gelesen werden sollen.

Das Lesen von Daten aus einem Solana-Konto umfasst zwei Schritte:

  1. Abrufen des Kontos über seine Adresse
  2. Deserialisieren des data-Felds des Kontos von Rohbytes in die entsprechende Datenstruktur, wie vom Programm definiert, das das Konto besitzt.

Eigentümer

Dieses Feld enthält die Programm-ID des Eigentümers des Kontos.

Jedes Solana-Konto hat ein Programm, das als sein Eigentümer festgelegt ist. Der Eigentümer des Kontos ist das einzige Programm, das die data des Kontos ändern oder Lamports abziehen kann, wie in den Anweisungen des Programms angegeben.

(Im Fall eines program account ist der Eigentümer sein Loader-Programm.)

Ausführbar

Dieses Feld gibt an, ob ein Konto ein program account oder ein data account ist

  • Wenn true: Das Konto ist ein program account
  • Wenn false: Das Konto ist ein data account

Rent-Epoche

Das Feld rent_epoch ist veraltet.

In der Vergangenheit verfolgte dieses Feld, wann ein Konto rent zahlen musste. Dieser rent-Erfassungsmechanismus wurde jedoch inzwischen eingestellt.

Account Examples
// Example Token Mint Account
Account {
lamports: 1461600,
data.len: 82,
owner: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb,
executable: false,
rent_epoch: 0,
data: 010000001e213c90625a7e643d9555bb01b6c3fe6416d7afd523ce8c7ddd9b923ceafb9d00000000000000000901010000001e213c90625a7e643d9555bb01b6,
}
// Example Token Program Account
Account {
lamports: 4513200894,
data.len: 134080,
owner: BPFLoader2111111111111111111111111111111111,
executable: true,
rent_epoch: 18446744073709551615,
data: 7f454c460201010000000000000000000300f70001000000d8f90000000000004000000000000000800902000000000000000000400038000400400009000800,
}

Arten von Konten

Es gibt zwei grundlegende Kategorien, in die Konten fallen:

Diese Trennung bedeutet, dass der ausführbare Code eines Programms und sein Zustand in separaten Konten gespeichert werden. (Ähnlich wie bei Betriebssystemen, die typischerweise separate Dateien für Programme und ihre Daten haben.)

Program accounts

Jedes Programm wird von einem Loader-Programm verwaltet, das zum Bereitstellen und Verwalten des Kontos verwendet wird. Wenn ein neues Programm bereitgestellt wird, wird ein Konto erstellt, um seinen ausführbaren Code zu speichern. Dies wird als program account bezeichnet. (Der Einfachheit halber können Sie das program account als das Programm selbst betrachten.)

In der Abbildung unten sehen Sie, dass ein Loader-Programm verwendet wird, um ein program account bereitzustellen. Das data des program account enthält den ausführbaren Programmcode.

Diagramm eines program account, seiner 4 Komponenten und seines Loader-Programms.Diagramm eines program account, seiner 4 Komponenten und seines Loader-Programms.

Program data accounts

Programme, die mit loader-v3 bereitgestellt werden, enthalten keinen Programmcode in ihrem Feld data. Stattdessen verweist ihr data auf ein separates program data account, das den Programmcode enthält. (Siehe Abbildung unten.)

Ein program account mit Daten. Die Daten verweisen auf ein separates program data accountEin program account mit Daten. Die Daten verweisen auf ein separates program data account

Während des Programm-Deployments oder Upgrades werden Buffer-Accounts verwendet, um den Upload temporär zu speichern.

Das folgende Beispiel ruft das Token Program-Konto ab. Beachten Sie, dass das Feld executable auf true gesetzt ist, was darauf hinweist, dass das Konto ein Programm ist.

import { Address, createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;
const accountInfo = await rpc
.getAccountInfo(programId, { encoding: "base64" })
.send();
console.log(accountInfo);
Console
Click to execute the code.

Datenkonten

Datenkonten enthalten keinen ausführbaren Code. Stattdessen speichern sie Informationen.

Programmzustandskonto

Programme verwenden Datenkonten, um ihren Zustand zu verwalten. Dazu müssen sie zunächst ein neues Datenkonto erstellen. Der Prozess der Erstellung eines Programmzustandskontos wird oft abstrahiert, aber es ist hilfreich, den zugrundeliegenden Prozess zu verstehen.

Um seinen Zustand zu verwalten, muss ein neues Programm:

  1. Das System Program aufrufen, um ein Konto zu erstellen. (Das System Program überträgt dann den Besitz an das neue Programm.)
  2. Die Kontodaten initialisieren, wie in seinen Anweisungen definiert.

Diagramm eines Datenkontos, das einem program account gehörtDiagramm eines Datenkontos, das einem program account gehört

Das folgende Beispiel erstellt und ruft ein Token Mint-Konto ab, das dem Token 2022-Programm gehört.

import {
airdropFactory,
appendTransactionMessageInstructions,
createSolanaRpc,
createSolanaRpcSubscriptions,
createTransactionMessage,
generateKeyPairSigner,
getSignatureFromTransaction,
lamports,
pipe,
sendAndConfirmTransactionFactory,
setTransactionMessageFeePayerSigner,
setTransactionMessageLifetimeUsingBlockhash,
signTransactionMessageWithSigners
} from "@solana/kit";
import { getCreateAccountInstruction } from "@solana-program/system";
import {
getInitializeMintInstruction,
getMintSize,
TOKEN_2022_PROGRAM_ADDRESS,
fetchMint
} from "@solana-program/token-2022";
// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");
// Generate keypairs for fee payer
const feePayer = await generateKeyPairSigner();
// Fund fee payer
await airdropFactory({ rpc, rpcSubscriptions })({
recipientAddress: feePayer.address,
lamports: lamports(1_000_000_000n),
commitment: "confirmed"
});
// Generate keypair to use as address of mint
const mint = await generateKeyPairSigner();
// Get default mint account size (in bytes), no extensions enabled
const space = BigInt(getMintSize());
// Get minimum balance for rent exemption
const rent = await rpc.getMinimumBalanceForRentExemption(space).send();
// Instruction to create new account for mint (token 2022 program)
// Invokes the system program
const createAccountInstruction = getCreateAccountInstruction({
payer: feePayer,
newAccount: mint,
lamports: rent,
space,
programAddress: TOKEN_2022_PROGRAM_ADDRESS
});
// Instruction to initialize mint account data
// Invokes the token 2022 program
const initializeMintInstruction = getInitializeMintInstruction({
mint: mint.address,
decimals: 9,
mintAuthority: feePayer.address
});
const instructions = [createAccountInstruction, initializeMintInstruction];
// Get latest blockhash to include in transaction
const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
// Create transaction message
const transactionMessage = pipe(
createTransactionMessage({ version: 0 }), // Create transaction message
(tx) => setTransactionMessageFeePayerSigner(feePayer, tx), // Set fee payer
(tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), // Set transaction blockhash
(tx) => appendTransactionMessageInstructions(instructions, tx) // Append instructions
);
// Sign transaction message with required signers (fee payer and mint keypair)
const signedTransaction =
await signTransactionMessageWithSigners(transactionMessage);
// Send and confirm transaction
await sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(
signedTransaction,
{ commitment: "confirmed" }
);
// Get transaction signature
const transactionSignature = getSignatureFromTransaction(signedTransaction);
console.log("Mint Address:", mint.address);
console.log("Transaction Signature:", transactionSignature);
const accountInfo = await rpc.getAccountInfo(mint.address).send();
console.log(accountInfo);
const mintAccount = await fetchMint(rpc, mint.address);
console.log(mintAccount);
Console
Click to execute the code.

Systemkonten

Nicht alle Konten erhalten nach der Erstellung durch das System Program einen neuen Besitzer. Konten, die dem System Program gehören, werden als Systemkonten bezeichnet. Alle Wallet-Konten sind Systemkonten, was ihnen ermöglicht, Transaktionsgebühren zu bezahlen.

Eine Wallet im Besitz des System Programs mit 1.000.000 LamportsEine Wallet im Besitz des System Programs mit 1.000.000 Lamports

Wenn SOL zum ersten Mal an eine neue Adresse gesendet wird, wird an dieser Adresse ein Konto erstellt, das dem System Program gehört.

Im folgenden Beispiel wird ein neues keypair generiert und mit SOL finanziert. Nach der Ausführung des Codes können Sie sehen, dass die Adresse des owner des Kontos 11111111111111111111111111111111 ist (das System Program).

import {
airdropFactory,
createSolanaRpc,
createSolanaRpcSubscriptions,
generateKeyPairSigner,
lamports
} from "@solana/kit";
// Create a connection to Solana cluster
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");
// Generate a new keypair
const keypair = await generateKeyPairSigner();
console.log(`Public Key: ${keypair.address}`);
// Funding an address with SOL automatically creates an account
const signature = await airdropFactory({ rpc, rpcSubscriptions })({
recipientAddress: keypair.address,
lamports: lamports(1_000_000_000n),
commitment: "confirmed"
});
const accountInfo = await rpc.getAccountInfo(keypair.address).send();
console.log(accountInfo);
Console
Click to execute the code.

Sysvar-Konten

Sysvar-Konten existieren an vordefinierten Adressen und bieten Zugriff auf Cluster-Zustandsdaten. Sie werden dynamisch mit Daten über den Netzwerk-Cluster aktualisiert. Siehe die vollständige Liste der Sysvar-Konten.

Das folgende Beispiel ruft Daten aus dem Sysvar-Clock-Konto ab und deserialisiert sie.

import { createSolanaRpc } from "@solana/kit";
import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";
const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
const accountInfo = await rpc
.getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
.send();
console.log(accountInfo);
// Automatically fetch and deserialize the account data
const clock = await fetchSysvarClock(rpc);
console.log(clock);
Console
Click to execute the code.

Is this page helpful?

Inhaltsverzeichnis

Seite bearbeiten

Verwaltet von

© 2025 Solana Foundation.
Alle Rechte vorbehalten.
Verbinden Sie sich
Konten | Solana