Lettura dalla rete

Questa sezione esplora come leggere i dati dalla rete Solana recuperando diversi account per comprendere la struttura di un account Solana.

Su Solana, tutti i dati esistono negli "account". Puoi pensare ai dati su Solana come a un database pubblico con una singola tabella "Account", dove ogni voce è un account con lo stesso tipo base di Account.

Base Account Type

#[derive(PartialEq, Eq, Clone, Default)]
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,
}

Account Account

Gli account su Solana possono memorizzare "stato" o programmi "eseguibili". Ogni account ha un "indirizzo" (chiave pubblica) che funge da ID univoco utilizzato per localizzare i dati corrispondenti sulla blockchain.

Gli account Solana contengono:

Stato: dati che devono essere letti e persistenti. Ad esempio, informazioni sui token, dati utente o altri dati definiti all'interno di un programma.
Programmi eseguibili: account contenenti il codice effettivo dei programmi Solana. Questi account memorizzano istruzioni che gli utenti possono invocare.

Questa separazione tra codice del programma e stato del programma è una caratteristica chiave del Modello di Account di Solana. Per maggiori dettagli, consulta la pagina Modello di Account Solana.

Recuperare un account wallet

Questo esempio dimostra come:

Generare un nuovo keypair (coppia di chiavi pubblica/privata).
Richiedere un airdrop di SOL per finanziare il nuovo indirizzo.
Recuperare i dati dell'account per l'indirizzo finanziato.

Su Solana, finanziare un nuovo indirizzo con SOL crea automaticamente un account posseduto dal System Program. Tutti gli account "wallet" sono semplicemente account posseduti dal System Program che contengono SOL e possono firmare transazioni.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

Fetch Account

import { Keypair, Connection, LAMPORTS_PER_SOL } from "@solana/web3.js";

const keypair = Keypair.generate();
console.log(`Public Key: ${keypair.publicKey}`);

const connection = new Connection("http://localhost:8899", "confirmed");

// Funding an address with SOL automatically creates an account
const signature = await connection.requestAirdrop(
  keypair.publicKey,
  LAMPORTS_PER_SOL
);
await connection.confirmTransaction(signature, "confirmed");

const accountInfo = await connection.getAccountInfo(keypair.publicKey);
console.log(JSON.stringify(accountInfo, null, 2));

Console

Click to execute the code.

Un "wallet" su Solana è un account posseduto dal System Program, che è uno dei programmi integrati di Solana. Gli account wallet sono utilizzati principalmente per conservare SOL (tracciati nel campo lamports) e per firmare transazioni.

Quando recuperi un account wallet, la risposta include i campi mostrati nell' esempio di output.

Il campo data contiene i dati dell'account memorizzati come byte.

Per gli account wallet, questo campo è vuoto (0 byte). Altri account utilizzano questo campo per memorizzare lo stato del programma o il codice eseguibile del programma.

Il campo executable indica se il campo data dell'account contiene codice di programma eseguibile.

Per i wallet e gli account che memorizzano lo stato del programma, questo campo è false.

Il campo lamports contiene il saldo SOL dell'account, denominato in lamport.

I lamport sono l'unità più piccola di SOL. 1 SOL = 1.000.000.000 lamport.

Il campo owner mostra il programma che possiede l'account.

Per i wallet, il proprietario è sempre il System Program, con l'indirizzo 11111111111111111111111111111111.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Il campo rentEpoch è un campo legacy di un meccanismo deprecato in cui agli account veniva addebitato il "rent" (in lamport) per mantenere i propri dati sulla rete.

Questo campo attualmente non è utilizzato, ma è incluso per retrocompatibilità.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

Il campo space mostra il numero di byte nel campo data. Questo non è un campo nel tipo Account stesso, ma è incluso nella risposta.

In questo esempio, il campo space è 0 perché il campo data contiene 0 byte di dati.

Example Output

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}