Konta

Wszystkie dane w sieci Solana są przechowywane na kontach. Możesz myśleć o sieci Solana jako o publicznej bazie danych z pojedynczą tabelą Konta. Relacja między kontem a jego adresem jest podobna do pary klucz-wartość, gdzie kluczem jest adres, a wartością konto.

Każde konto ma tę samą podstawową strukturę i można je zlokalizować za pomocą jego adresu.

Diagram przedstawiający 3 konta i ich adresy. Zawiera definicję struktury konta.Diagram przedstawiający 3 konta i ich adresy. Zawiera definicję struktury konta.

Adres konta

Adres konta to unikalny 32-bajtowy identyfikator używany do lokalizowania konta na blockchainie Solana. Adresy kont są często przedstawiane jako ciągi zakodowane w base58. Większość kont używa Ed25519 klucza publicznego jako swojego adresu, ale nie jest to wymagane, ponieważ Solana obsługuje również adresy pochodne programów.

Konto z adresem klucza publicznego zakodowanym w base58Konto z adresem klucza publicznego zakodowanym w base58

Klucz publiczny

Poniższy przykład pokazuje, jak użyć Solana SDK do utworzenia keypair. A Keypair zawiera:

  • Klucz publiczny, który służy jako adres konta
  • Klucz prywatny, który jest używany do podpisywania transakcji
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

Program derived address (PDA) to adres deterministycznie wyprowadzony przy użyciu ID programu i jednego lub więcej opcjonalnych wejść (seeds). Poniższy przykład pokazuje, jak użyć Solana SDK do utworzenia program derived address.

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.

Struktura konta

Każde Account ma maksymalny rozmiar 10MiB i zawiera następujące informacje:

  • lamports: Liczba lamportów na koncie
  • data: Dane konta
  • owner: ID programu, który jest właścicielem konta
  • executable: Wskazuje, czy konto zawiera wykonywalny plik binarny
  • rent_epoch: Przestarzałe pole epoki czynszu
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,
}

Lamporty

Saldo konta w lamportach.

Każde konto musi mieć minimalne saldo lamportów, zwane rent, które pozwala na przechowywanie jego danych w łańcuchu bloków. Czynsz jest proporcjonalny do rozmiaru konta.

Chociaż saldo to nazywane jest rent, działa bardziej jak depozyt, ponieważ pełne saldo można odzyskać po zamknięciu konta. (Nazwa "rent" pochodzi z obecnie przestarzałego pola rent epoch.)

(Zobacz formułę minimalnego salda oraz odpowiednie stałe.)

Dane

To pole jest powszechnie nazywane "danymi konta". data w tym polu jest uznawane za dowolne, ponieważ może zawierać dowolną sekwencję bajtów. Każdy program definiuje strukturę danych przechowywanych w tym polu.

  • Konta programów: To pole zawiera albo wykonywalny kod programu, albo adres konta danych programu, które przechowuje wykonywalny kod programu.
  • Konta danych: To pole zazwyczaj przechowuje dane stanu, przeznaczone do odczytu.

Odczyt danych z konta Solana obejmuje dwa kroki:

  1. Pobranie konta za pomocą jego adresu
  2. Deserializacja pola data konta z surowych bajtów do odpowiedniej struktury danych, zgodnie z definicją programu, który jest właścicielem konta.

Właściciel

To pole zawiera identyfikator programu będącego właścicielem konta.

Każde konto Solana ma program wyznaczony jako jego właściciela. Właściciel konta to jedyny program, który może zmieniać data konta lub odejmować lamporty, zgodnie z instrukcjami programu.

(W przypadku konta programu właścicielem jest jego program ładujący.)

Wykonywalne

To pole wskazuje, czy konto jest kontem programu czy kontem danych

  • Jeśli true: Konto jest kontem programu
  • Jeśli false: Konto jest kontem danych

Epoka czynszu

Pole rent_epoch jest przestarzałe.

W przeszłości to pole śledziło, kiedy konto będzie musiało zapłacić czynsz. Jednak mechanizm pobierania czynszu został od tamtej pory wycofany.

Lamporty

Saldo konta w lamportach.

Każde konto musi mieć minimalne saldo lamportów, zwane rent, które pozwala na przechowywanie jego danych w łańcuchu bloków. Czynsz jest proporcjonalny do rozmiaru konta.

Chociaż saldo to nazywane jest rent, działa bardziej jak depozyt, ponieważ pełne saldo można odzyskać po zamknięciu konta. (Nazwa "rent" pochodzi z obecnie przestarzałego pola rent epoch.)

(Zobacz formułę minimalnego salda oraz odpowiednie stałe.)

Dane

To pole jest powszechnie nazywane "danymi konta". data w tym polu jest uznawane za dowolne, ponieważ może zawierać dowolną sekwencję bajtów. Każdy program definiuje strukturę danych przechowywanych w tym polu.

  • Konta programów: To pole zawiera albo wykonywalny kod programu, albo adres konta danych programu, które przechowuje wykonywalny kod programu.
  • Konta danych: To pole zazwyczaj przechowuje dane stanu, przeznaczone do odczytu.

Odczyt danych z konta Solana obejmuje dwa kroki:

  1. Pobranie konta za pomocą jego adresu
  2. Deserializacja pola data konta z surowych bajtów do odpowiedniej struktury danych, zgodnie z definicją programu, który jest właścicielem konta.

Właściciel

To pole zawiera identyfikator programu będącego właścicielem konta.

Każde konto Solana ma program wyznaczony jako jego właściciela. Właściciel konta to jedyny program, który może zmieniać data konta lub odejmować lamporty, zgodnie z instrukcjami programu.

(W przypadku konta programu właścicielem jest jego program ładujący.)

Wykonywalne

To pole wskazuje, czy konto jest kontem programu czy kontem danych

  • Jeśli true: Konto jest kontem programu
  • Jeśli false: Konto jest kontem danych

Epoka czynszu

Pole rent_epoch jest przestarzałe.

W przeszłości to pole śledziło, kiedy konto będzie musiało zapłacić czynsz. Jednak mechanizm pobierania czynszu został od tamtej pory wycofany.

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,
}

Rodzaje kont

Istnieją dwie podstawowe kategorie kont:

Oddzielenie kodu programu od jego stanu jest kluczową cechą modelu kont Solana. (Podobnie jak w systemach operacyjnych, które zazwyczaj mają oddzielne pliki dla programów i ich danych.)

Konta programów

Każdy program jest własnością programu ładującego, który służy do wdrażania i zarządzania kontem. Gdy nowy program jest wdrażany, tworzone jest konto do przechowywania jego kodu wykonywalnego. To konto nazywane jest kontem programu. (Dla uproszczenia można uznać konto programu za sam program.)

Na poniższym diagramie widać, że program ładujący jest używany do wdrażania konta programu. data konta programu zawiera wykonywalny kod programu.

Diagram konta programu, jego 4 komponentów i programu ładującego.Diagram konta programu, jego 4 komponentów i programu ładującego.

Konta danych programów

Programy wdrażane za pomocą loader-v3 nie zawierają kodu programu w polu data. Zamiast tego ich data wskazuje na oddzielne konto danych programu, które zawiera kod programu. (Zobacz diagram poniżej.)

Konto programu z danymi. Dane wskazują na oddzielne konto danych programuKonto programu z danymi. Dane wskazują na oddzielne konto danych programu

Podczas wdrażania lub aktualizacji programu używane są konta buforowe do tymczasowego przechowywania przesyłanych danych.

Poniższy przykład pobiera konto programu Token Program. Zauważ, że pole executable jest ustawione na true, co wskazuje, że konto jest programem.

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.

Konta danych

Konta danych nie zawierają kodu wykonywalnego. Zamiast tego przechowują informacje.

Konto stanu programu

Programy używają kont danych do utrzymania swojego stanu. Aby to zrobić, muszą najpierw utworzyć nowe konto danych. Proces tworzenia konta stanu programu jest często abstrakcyjny, ale warto zrozumieć jego podstawy.

Aby zarządzać swoim stanem, nowy program musi:

  1. Wywołać System Program, aby utworzyć konto. (System Program następnie przenosi własność na nowy program.)
  2. Zainicjalizować dane konta, zgodnie z jego instrukcjami.

Schemat konta danych należącego do konta programuSchemat konta danych należącego do konta programu

Poniższy przykład tworzy i pobiera konto Token Mint należące do programu Token 2022.

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.

Konta systemowe

Nie wszystkie konta są przypisane do nowego właściciela po ich utworzeniu przez System Program. Konta należące do System Program nazywane są kontami systemowymi. Wszystkie konta portfela są kontami systemowymi, co pozwala im płacić opłaty transakcyjne.

Portfel należący do System Program zawierający 1 000 000 lamportówPortfel należący do System Program zawierający 1 000 000 lamportów

Kiedy SOL jest wysyłany na nowy adres po raz pierwszy, konto jest tworzone na tym adresie i należy do System Program.

W poniższym przykładzie generowany jest nowy keypair i zasilany SOL. Po uruchomieniu kodu można zobaczyć adres konta owner jest 11111111111111111111111111111111 (czyli 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.

Konta Sysvar

Konta Sysvar istnieją pod z góry określonymi adresami i zapewniają dostęp do danych stanu klastra. Aktualizują się dynamicznie, dostarczając dane o klastrze sieciowym. Zobacz pełną listę kont Sysvar.

Poniższy przykład pobiera i deserializuje dane z konta Sysvar Clock.

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?

Spis treści

Edytuj stronę

Zarządzane przez

© 2025 Solana Foundation.
Wszelkie prawa zastrzeżone.
Bądź na bieżąco