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.
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 base58
Klucz publiczny
Poniższy przykład pokazuje, jak użyć Solana SDK do utworzenia pary kluczy.
import { generateKeyPairSigner } from "@solana/kit";// Kit does not enable extractable private keysconst keypairSigner = await generateKeyPairSigner();console.log(keypairSigner);
Adres pochodny programu
Adres pochodny programu (PDA) to adres deterministycznie pochodzący z ID programu i jednego lub więcej opcjonalnych wejść (ziaren). Poniższy przykład pokazuje, jak użyć Solana SDK do utworzenia adresu pochodnego programu.
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}`);
Struktura konta
Każde
Account
ma maksymalny rozmiar
10MiB
i zawiera następujące informacje:
lamports: Liczba lamportów na konciedata: Dane kontaowner: ID programu, który jest właścicielem kontaexecutable: Wskazuje, czy konto zawiera binarne pliki wykonywalnerent_epoch: Przestarzałe pole epoki czynszu
pub struct Account {/// lamports in the accountpub 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 rentpub rent_epoch: Epoch,}
Lamporty
Saldo konta w lamportach.
Każde konto musi mieć minimalne saldo w lamportach, zwane czynszem, które pozwala na przechowywanie danych w łańcuchu bloków. Czynsz jest proporcjonalny do rozmiaru konta.
Chociaż to saldo nazywane jest czynszem, działa bardziej jak depozyt, ponieważ pełne saldo można odzyskać po zamknięciu konta. (Nazwa "czynsz" pochodzi z obecnie przestarzałego pola epoki czynszu.)
(Zobacz wzór na minimalne saldo 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:
- Pobranie konta za pomocą jego adresu
- Deserializacja pola
datakonta 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 jest jedynym programem, który może zmieniać data
konta lub odejmować lamporty, zgodnie z instrukcjami programu.
(W przypadku konta programu właścicielem jest jego loader program.)
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 musiałoby zapłacić czynsz. Jednak mechanizm pobierania czynszu został od tamtej pory wycofany.
Rodzaje kont
Istnieją dwie podstawowe kategorie, do których należą konta:
- Konta programów: Konta zawierające kod wykonywalny
- Konta danych: Konta, które nie zawierają kodu wykonywalnego
To rozdzielenie oznacza, że kod wykonywalny programu i jego stan są przechowywane na oddzielnych kontach. (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ą loadera programu, który jest używany do wdrażania i zarządzania kontem. Gdy nowy program jest wdrażany, tworzone jest konto do przechowywania jego kodu wykonywalnego. To konto nazywa się kontem programu. (Dla uproszczenia możesz traktować konto programu jako sam program.)
Na poniższym diagramie widać, że loader programu jest używany do wdrażania konta
programu. Pole data konta programu zawiera kod wykonywalny programu.
Diagram konta programu, jego 4 komponentów i loadera programu.
Konta danych programów
Programy wdrożone za pomocą loader-v3 nie zawierają kodu programu w swoim polu
data. Zamiast tego ich pole 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 programu
Podczas wdrażania lub aktualizacji programu konta bufora są używane do tymczasowego przechowywania przesyłanych danych.
Poniższy przykład pobiera konto 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);
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:
- Wywołać System Program, aby utworzyć konto. (System Program następnie przekazuje własność nowemu programowi.)
- Zainicjalizować dane konta zgodnie z jego instrukcjami.
Diagram 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 exampleconst rpc = createSolanaRpc("http://localhost:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate keypairs for fee payerconst feePayer = await generateKeyPairSigner();// Fund fee payerawait airdropFactory({ rpc, rpcSubscriptions })({recipientAddress: feePayer.address,lamports: lamports(1_000_000_000n),commitment: "confirmed"});// Generate keypair to use as address of mintconst mint = await generateKeyPairSigner();// Get default mint account size (in bytes), no extensions enabledconst space = BigInt(getMintSize());// Get minimum balance for rent exemptionconst rent = await rpc.getMinimumBalanceForRentExemption(space).send();// Instruction to create new account for mint (token 2022 program)// Invokes the system programconst createAccountInstruction = getCreateAccountInstruction({payer: feePayer,newAccount: mint,lamports: rent,space,programAddress: TOKEN_2022_PROGRAM_ADDRESS});// Instruction to initialize mint account data// Invokes the token 2022 programconst initializeMintInstruction = getInitializeMintInstruction({mint: mint.address,decimals: 9,mintAuthority: feePayer.address});const instructions = [createAccountInstruction, initializeMintInstruction];// Get latest blockhash to include in transactionconst { value: latestBlockhash } = await rpc.getLatestBlockhash().send();// Create transaction messageconst 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 transactionawait sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(signedTransaction,{ commitment: "confirmed" });// Get transaction signatureconst 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);
Konta systemowe
Nie wszystkie konta są przypisywane nowemu właścicielowi 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ów
Kiedy SOL jest wysyłany na nowy adres po raz pierwszy, konto jest tworzone pod tym adresem i należy do System Program.
W poniższym przykładzie generowany jest nowy keypair i zasilany SOL. Po
uruchomieniu kodu możesz zobaczyć adres owner konta, który jest
11111111111111111111111111111111
(System Program).
import {airdropFactory,createSolanaRpc,createSolanaRpcSubscriptions,generateKeyPairSigner,lamports} from "@solana/kit";// Create a connection to Solana clusterconst rpc = createSolanaRpc("http://localhost:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate a new keypairconst keypair = await generateKeyPairSigner();console.log(`Public Key: ${keypair.address}`);// Funding an address with SOL automatically creates an accountconst 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);
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 dataconst clock = await fetchSysvarClock(rpc);console.log(clock);
Is this page helpful?