Account
Tutti i dati sulla rete Solana sono memorizzati negli account. Puoi pensare alla rete Solana come a un database pubblico con un'unica tabella Account. La relazione tra un account e il suo indirizzo è simile a quella di una coppia chiave-valore, dove la chiave è l'indirizzo e il valore è l'account.
Ogni account ha la stessa struttura di base e può essere localizzato utilizzando il suo indirizzo.
Diagramma di 3 account e i loro indirizzi. Include la definizione della struttura dell'account.
Indirizzo dell'account
L'indirizzo dell'account è un ID univoco di 32 byte utilizzato per localizzare l'account sulla blockchain Solana. Gli indirizzi degli account sono spesso mostrati come stringhe codificate in base58. La maggior parte degli account utilizza una chiave pubblica Ed25519 come indirizzo, ma questo non è obbligatorio, poiché Solana supporta anche indirizzi derivati da programmi.
Un account con il suo indirizzo di chiave pubblica codificato in base58
Chiave pubblica
L'esempio seguente mostra come utilizzare l'SDK di Solana per creare un keypair.
import { generateKeyPairSigner } from "@solana/kit";// Kit does not enable extractable private keysconst keypairSigner = await generateKeyPairSigner();console.log(keypairSigner);
Program derived address
Un program derived address (PDA) è un indirizzo che viene deterministicamente derivato utilizzando un ID di programma e uno o più input opzionali (semi). L'esempio seguente mostra come utilizzare l'SDK di Solana per creare un 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}`);
Struttura dell'account
Ogni
Account
ha una dimensione massima di
10MiB
e contiene le seguenti informazioni:
lamports: Il numero di lamport nell'accountdata: I dati dell'accountowner: L'ID del programma che possiede l'accountexecutable: Indica se l'account contiene un binario eseguibilerent_epoch: Il campo rent epoch deprecato
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,}
Lamports
Il saldo dell'account in lamport.
Ogni account deve avere un saldo minimo in lamport, chiamato rent, che permette ai suoi dati di essere memorizzati sulla blockchain. Il rent è proporzionale alla dimensione dell'account.
Sebbene questo saldo sia chiamato rent, funziona più come un deposito, poiché il saldo completo può essere recuperato quando l'account viene chiuso. (Il nome "rent" deriva dal campo rent epoch ora deprecato.)
(Vedi la formula del saldo minimo e le costanti applicabili.)
Data
Questo campo è comunemente chiamato "dati dell'account". I data in questo
campo sono considerati arbitrari poiché possono contenere qualsiasi sequenza di
byte. Ogni programma definisce la struttura dei dati memorizzati in questo
campo.
- Account di programma: questo campo contiene il codice del programma eseguibile o l'indirizzo di un account dati del programma che memorizza il codice del programma eseguibile.
- Account di dati: questo campo generalmente memorizza dati di stato, destinati alla lettura.
La lettura dei dati da un account Solana coinvolge due passaggi:
- Recuperare l'account utilizzando il suo indirizzo
- Deserializzare il campo
datadell'account da byte grezzi nella struttura dati appropriata, come definito dal programma che possiede l'account.
Proprietario
Questo campo contiene l'ID del programma proprietario dell'account.
Ogni account Solana ha un programma designato come suo
proprietario. Il proprietario dell'account è l'unico programma che può
modificare i dati (data) dell'account o detrarre lamports, come indicato dalle
istruzioni del programma.
(Nel caso di un program account, il proprietario è il suo loader program.)
Eseguibile
Questo campo indica se un account è un program account o un data account
- Se
true: L'account è un program account - Se
false: L'account è un data account
Epoch di rent
Il campo rent_epoch è deprecato.
In passato, questo campo teneva traccia di quando un account avrebbe dovuto pagare il rent. Tuttavia, questo meccanismo di riscossione del rent è stato deprecato.
Tipi di account
Gli account si suddividono in due categorie principali:
- Program account: Account che contengono codice eseguibile
- Data account: Account che non contengono codice eseguibile
Questa separazione significa che il codice eseguibile di un programma e il suo stato sono memorizzati in account separati. (Simile ai sistemi operativi, che tipicamente hanno file separati per i programmi e i loro dati.)
Program account
Ogni programma è di proprietà di un loader program, che viene utilizzato per fare il deployment e gestire l'account. Quando viene fatto il deployment di un nuovo programma, viene creato un account per memorizzare il suo codice eseguibile. Questo è chiamato program account. (Per semplicità, puoi considerare il program account come il programma stesso.)
Nel diagramma seguente, puoi vedere come un loader program viene utilizzato per
fare il deployment di un program account. Il campo data del program account
contiene il codice eseguibile del programma.
Diagramma di un program account, i suoi 4 componenti e il suo loader program.
Program data accounts
I programmi distribuiti utilizzando loader-v3 non contengono codice di programma
nel loro campo data. Invece, il loro data punta a un program data
account separato, che contiene il codice del programma. (Vedi il diagramma
sotto.)
Un program account con dati. I dati puntano a un program data account separato
Durante il deployment o gli aggiornamenti del programma, gli account buffer vengono utilizzati per preparare temporaneamente il caricamento.
L'esempio seguente recupera l'account del Token Program. Nota che il campo
executable è impostato su true, indicando che l'account è un programma.
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);
Data accounts
I data account non contengono codice eseguibile. Invece, memorizzano informazioni.
Program state account
I programmi utilizzano i data account per mantenere il loro stato. Per farlo, devono prima creare un nuovo data account. Il processo di creazione di un program state account è spesso astratto, ma è utile comprendere il processo sottostante.
Per gestire il suo stato, un nuovo programma deve:
- Invocare il System Program per creare un account. (Il System Program poi trasferisce la proprietà al nuovo programma.)
- Inizializzare i dati dell'account, come definito dalle sue istruzioni.
Diagramma di un data account posseduto da un program account
L'esempio seguente crea e recupera un account Token Mint posseduto dal programma 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);
System accounts
Non tutti gli account vengono assegnati a un nuovo proprietario dopo essere stati creati dal System Program. Gli account di proprietà del System Program sono chiamati account di sistema. Tutti gli account di portafoglio sono account di sistema, il che consente loro di pagare le commissioni di transazione.
Un portafoglio di proprietà del System Program contenente 1.000.000 lamports
Quando SOL viene inviato a un nuovo indirizzo per la prima volta, viene creato un account a quell'indirizzo di proprietà del System Program.
Nell'esempio seguente, viene generata una nuova keypair e finanziata con SOL.
Dopo l'esecuzione del codice, puoi vedere che l'indirizzo del owner
dell'account è 11111111111111111111111111111111 (il
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);
Account Sysvar
Gli account Sysvar esistono a indirizzi predefiniti e forniscono accesso ai dati sullo stato del cluster. Si aggiornano dinamicamente con dati sul cluster di rete. Vedi l'elenco completo degli Account Sysvar.
L'esempio seguente recupera e deserializza i dati dall'account 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?