Lettura dalla rete

Leggi i dati dalla rete Solana recuperando diversi account. Questa sezione ti aiuterà a comprendere la struttura degli account di Solana. Ogni account Solana ha un indirizzo univoco che viene utilizzato per localizzare i suoi dati corrispondenti sulla blockchain. Gli account contengono dati di stato o un programma eseguibile.

Recuperare un account wallet

Un wallet è un account posseduto dal System Program. I wallet sono principalmente utilizzati per conservare SOL e firmare transazioni. Quando SOL viene inviato a un nuovo indirizzo per la prima volta, un account di sistema viene creato automaticamente.

L'esempio seguente genera un nuovo keypair, richiede SOL per finanziare il nuovo indirizzo della chiave pubblica e recupera i dati dell'account per il wallet appena finanziato.

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.

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

Example output

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

Il campo data contiene i dati dell'account memorizzati come byte. Per gli account wallet, questo campo è vuoto (0 byte).

Example output

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

Il campo executable indica se il campo data dell'account contiene codice di programma eseguibile. Per gli account wallet questo campo è false.

Example output

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

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

Example output

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

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 di rent obsoleto. (Questo campo è 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 contenuti 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
}