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.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 base58Un 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. Un Keypair include:

  • Una chiave pubblica che funge da indirizzo dell'account
  • Una chiave privata che viene utilizzata per firmare le transazioni
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

Un program derived address (PDA) è un indirizzo che viene deterministicamente derivato utilizzando un ID di programma e uno o più input opzionali (seed). 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}`);
Console
Click to execute the code.

Struttura dell'account

Ogni Account ha una dimensione massima di 10MiB e contiene le seguenti informazioni:

  • lamports: Il numero di lamport nell'account
  • data: I dati dell'account
  • owner: L'ID del programma che possiede l'account
  • executable: Indica se l'account contiene un binario eseguibile
  • rent_epoch: Il campo epoch di rent deprecato
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

Il saldo dell'account in lamport.

Ogni account deve avere un saldo minimo di lamport, chiamato rent, che consente di memorizzare i suoi dati sulla blockchain. Il rent è proporzionale alla dimensione dell'account.

Sebbene questo saldo sia chiamato rent, funziona più come un deposito, poiché l'intero saldo 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 relative costanti.)

Dati

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.

  • Program account: Questo campo contiene il codice del programma eseguibile o l'indirizzo di un program data account che memorizza il codice del programma eseguibile.
  • Data account: Questo campo generalmente memorizza dati di stato, destinati alla lettura.

La lettura dei dati da un account Solana coinvolge due passaggi:

  1. Recuperare l'account utilizzando il suo indirizzo
  2. Deserializzare il campo data dell'account dai byte grezzi nella struttura dati appropriata, come definito dal programma proprietario dell'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 data dell'account o detrarre lamport, 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.

Lamports

Il saldo dell'account in lamport.

Ogni account deve avere un saldo minimo di lamport, chiamato rent, che consente di memorizzare i suoi dati sulla blockchain. Il rent è proporzionale alla dimensione dell'account.

Sebbene questo saldo sia chiamato rent, funziona più come un deposito, poiché l'intero saldo 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 relative costanti.)

Dati

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.

  • Program account: Questo campo contiene il codice del programma eseguibile o l'indirizzo di un program data account che memorizza il codice del programma eseguibile.
  • Data account: Questo campo generalmente memorizza dati di stato, destinati alla lettura.

La lettura dei dati da un account Solana coinvolge due passaggi:

  1. Recuperare l'account utilizzando il suo indirizzo
  2. Deserializzare il campo data dell'account dai byte grezzi nella struttura dati appropriata, come definito dal programma proprietario dell'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 data dell'account o detrarre lamport, 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.

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

Tipi di account

Gli account si suddividono in due categorie principali:

Questa separazione tra il codice di un programma e il suo stato è una caratteristica fondamentale del modello di account di Solana. (Simile ai sistemi operativi, che tipicamente hanno file separati per i programmi e i loro dati.)

Account di programma

Ogni programma è posseduto da un programma loader, che viene utilizzato per distribuire e gestire l'account. Quando un nuovo programma viene distribuito, viene creato un account per memorizzare il suo codice eseguibile. Questo è chiamato account di programma. (Per semplicità, puoi considerare l'account di programma come il programma stesso.)

Nel diagramma seguente, puoi vedere come un programma loader viene utilizzato per distribuire un account di programma. Il campo data dell'account di programma contiene il codice eseguibile del programma.

Diagramma di un account di programma, i suoi 4 componenti e il suo programma loader.Diagramma di un account di programma, i suoi 4 componenti e il suo programma loader.

Account di dati del programma

I programmi distribuiti utilizzando loader-v3 non contengono codice di programma nel loro campo data. Invece, il loro data punta a un account di dati del programma separato, che contiene il codice del programma. (Vedi il diagramma seguente.)

Un account di programma con dati. I dati puntano a un account di dati del programma separatoUn account di programma con dati. I dati puntano a un account di dati del programma separato

Durante la distribuzione 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);
Console
Click to execute the code.

Account di dati

Gli account di dati non contengono codice eseguibile. Invece, memorizzano informazioni.

Account di stato del programma

I programmi utilizzano gli account di dati per mantenere il loro stato. Per farlo, devono prima creare un nuovo account di dati. Il processo di creazione di un account di stato del programma è spesso astratto, ma è utile comprendere il processo sottostante.

Per gestire il proprio stato, un nuovo programma deve:

  1. Invocare il System Program per creare un account. (Il System Program trasferisce poi la proprietà al nuovo programma.)
  2. Inizializzare i dati dell'account, come definito dalle sue istruzioni.

Diagramma di un account di dati posseduto da un account di programmaDiagramma di un account di dati posseduto da un account di programma

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 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.

Account di sistema

Non tutti gli account vengono assegnati a un nuovo proprietario dopo essere stati creati dal System Program. Gli account posseduti dal System Program sono chiamati account di sistema. Tutti gli account wallet sono account di sistema, il che consente loro di pagare le commissioni di transazione.

Un wallet posseduto dal System Program contenente 1.000.000 di lamportUn wallet posseduto dal System Program contenente 1.000.000 di lamport

Quando SOL viene inviato a un nuovo indirizzo per la prima volta, viene creato un account a quell'indirizzo posseduto dal System Program.

Nell'esempio seguente, viene generato un nuovo keypair e finanziato 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 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.

Account Sysvar

Gli account Sysvar esistono a indirizzi predefiniti e forniscono accesso ai dati sullo stato del cluster. Si aggiornano dinamicamente con i dati relativi al 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 data
const clock = await fetchSysvarClock(rpc);
console.log(clock);
Console
Click to execute the code.

Is this page helpful?

Indice

Modifica Pagina

Gestito da

© 2025 Solana Foundation.
Tutti i diritti riservati.
Rimani Connesso