Lettura dalla rete

Leggi i dati dalla rete Solana recuperando diversi account. Questa guida spiega la struttura degli account di Solana. Ogni account Solana ha un indirizzo univoco utilizzato per localizzare i dati onchain dell'account. Gli account Solana contengono dati di stato o un programma eseguibile.

Recuperare un account wallet

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

L'esempio seguente crea un client Kit, genera un nuovo signer, richiede SOL per finanziare il nuovo indirizzo e recupera i dati dell'account dall'API RPC del client.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Quando si recupera un wallet account con getAccountInfo(), Kit restituisce la risposta RPC mostrata nell'output di esempio a destra.

La risposta ha due campi di primo livello: context descrive il momento in cui è avvenuta la lettura, e value contiene i campi dell'account restituiti dal metodo RPC.

Il campo context mostra il slot utilizzato per leggere l'account e la versione dell'API RPC che ha servito la risposta. Una lettura successiva può restituire un slot o una versione API diversi.

Il campo value contiene lo stato dell'account restituito dal metodo RPC. I passaggi seguenti illustrano i campi all'interno di value nell'ordine in cui appaiono.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo lamports contiene il saldo SOL dell'account, misurato in lamports, la più piccola unità di SOL.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo data contiene i dati dell'account memorizzati come byte. L'RPC restituisce i dati dell'account come una tupla: la stringa di dati codificata, seguita dalla codifica. Per gli account wallet, la stringa di dati codificata è vuota perché l'account memorizza 0 byte di dati.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo owner mostra il programma proprietario dell'account. Per i wallet, il proprietario è sempre il System Program, con l'indirizzo 11111111111111111111111111111111.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo executable indica se l'indirizzo dell'account è richiamabile. true significa che l'indirizzo rappresenta un programma in grado di elaborare istruzioni. false significa che l'account memorizza uno stato, come il saldo di un wallet o i dati dell'account, e non viene richiamato come programma. Gli account wallet utilizzano false.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo rentEpoch è un campo legacy proveniente da un meccanismo di rent deprecato. Il campo viene ancora restituito per compatibilità con le versioni precedenti.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

Il campo space mostra il numero di byte contenuti nel campo data. Il campo space viene restituito con la risposta di recupero dell'account, ma non fa parte del tipo di dato dell'account.

Per l'esempio di account wallet, il campo space è 0 perché il campo data contiene 0 byte di dati.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}