Lezen van het netwerk

Dit gedeelte verkent hoe je gegevens kunt lezen van het Solana-netwerk door verschillende accounts op te halen om de structuur van een Solana-account te begrijpen.

Op Solana bestaan alle gegevens in "accounts". Je kunt gegevens op Solana zien als een openbare database met een enkele "Accounts"-tabel, waarbij elke invoer een account is met hetzelfde basis Account-type.

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

Accounts

Accounts op Solana kunnen "state" of "uitvoerbare" programma's opslaan. Elk account heeft een "adres" (publieke sleutel) dat dient als unieke ID om de bijbehorende on-chain gegevens te lokaliseren.

Solana-accounts bevatten ofwel:

State: Gegevens die bedoeld zijn om uit te lezen en te bewaren. Bijvoorbeeld, informatie over tokens, gebruikersgegevens of andere gegevens die binnen een programma zijn gedefinieerd.
Uitvoerbare programma's: Accounts die de daadwerkelijke code van Solana- programma's bevatten. Deze accounts slaan instructies op die gebruikers kunnen aanroepen.

Deze scheiding tussen programmacode en programmastatus is een belangrijk kenmerk van Solana's Account Model. Voor meer details, raadpleeg de Solana Account Model pagina.

Wallet-account ophalen

Dit voorbeeld laat zien hoe je:

Een nieuw keypair (publieke/private sleutelpaar) genereert.
Een airdrop van SOL aanvraagt om het nieuwe adres te financieren.
De accountgegevens voor het gefinancierde adres ophaalt.

Op Solana wordt bij het financieren van een nieuw adres met SOL automatisch een account aangemaakt dat eigendom is van het System Program. Alle "wallet"-accounts zijn simpelweg accounts in eigendom van het System Program die SOL bevatten en transacties kunnen ondertekenen.

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.

Een "wallet" op Solana is een account dat eigendom is van het System Program, een van Solana's ingebouwde programma's. Wallet accounts worden voornamelijk gebruikt om SOL te bewaren (bijgehouden in het lamports veld) en om transacties te ondertekenen.

Wanneer je een wallet account opvraagt, bevat het antwoord de velden die in het voorbeeldresultaat worden getoond.

Example Output

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

Het data veld bevat de gegevens van het account opgeslagen als bytes.

Voor wallet accounts is dit veld leeg (0 bytes). Andere accounts gebruiken dit veld om programma-status of uitvoerbare programmacode op te slaan.

Example Output

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

Het executable veld geeft aan of het data veld van het account uitvoerbare programmacode bevat.

Voor wallets en accounts die programma-status opslaan, is dit veld false.

Example Output

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

Het lamports veld bevat het SOL-saldo van het account, uitgedrukt in lamports.

Lamports zijn de kleinste eenheid van SOL. 1 SOL = 1.000.000.000 lamports.

Example Output

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

Het owner veld toont het programma dat eigenaar is van het account.

Voor wallets is de eigenaar altijd het System Program, met het adres 11111111111111111111111111111111.

Example Output

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

Het rentEpoch veld is een verouderd veld van een afgeschaft mechanisme waarbij accounts "rent" (in lamports) moesten betalen om hun gegevens op het netwerk te behouden.

Dit veld wordt momenteel niet gebruikt, maar is opgenomen voor achterwaartse compatibiliteit.

Example Output

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

Het space veld toont het aantal bytes in het data veld. Dit is geen veld in het Account type zelf, maar is opgenomen in de respons.

In dit voorbeeld is het space veld 0 omdat het data veld 0 bytes aan gegevens bevat.

Example Output

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