Ανάγνωση από το Δίκτυο

Αυτή η ενότητα εξερευνά πώς να διαβάζετε δεδομένα από το δίκτυο Solana ανακτώντας διαφορετικούς λογαριασμούς για να κατανοήσετε τη δομή ενός λογαριασμού Solana.

Στο Solana, όλα τα δεδομένα υπάρχουν σε "λογαριασμούς". Μπορείτε να σκεφτείτε τα δεδομένα στο Solana ως μια δημόσια βάση δεδομένων με έναν μοναδικό πίνακα "Λογαριασμοί", όπου κάθε καταχώρηση είναι ένας λογαριασμός με τον ίδιο βασικό τύπο Λογαριασμού.

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

Λογαριασμοί

Οι λογαριασμοί στο Solana μπορούν να αποθηκεύσουν "κατάσταση" ή "εκτελέσιμα" προγράμματα. Κάθε λογαριασμός έχει μια "διεύθυνση" (δημόσιο κλειδί) που χρησιμεύει ως το μοναδικό του αναγνωριστικό για τον εντοπισμό των αντίστοιχων δεδομένων του στην αλυσίδα.

Οι λογαριασμοί Solana περιέχουν είτε:

Κατάσταση: Δεδομένα που προορίζονται για ανάγνωση και διατήρηση. Για παράδειγμα, πληροφορίες σχετικά με tokens, δεδομένα χρηστών ή άλλα δεδομένα που ορίζονται μέσα σε ένα πρόγραμμα.
Εκτελέσιμα Προγράμματα: Λογαριασμοί που περιέχουν τον πραγματικό κώδικα των προγραμμάτων Solana. Αυτοί οι λογαριασμοί αποθηκεύουν οδηγίες που μπορούν να επικαλεστούν οι χρήστες.

Αυτός ο διαχωρισμός του κώδικα προγράμματος και της κατάστασης προγράμματος είναι ένα βασικό χαρακτηριστικό του Μοντέλου Λογαριασμών του Solana. Για περισσότερες λεπτομέρειες, ανατρέξτε στη σελίδα Μοντέλο Λογαριασμών Solana.

Ανάκτηση Λογαριασμού Πορτοφολιού

Αυτό το παράδειγμα δείχνει πώς να:

Δημιουργήσετε ένα νέο keypair (ζεύγος δημόσιου/ιδιωτικού κλειδιού).
Ζητήσετε ένα airdrop SOL για να χρηματοδοτήσετε τη νέα διεύθυνση.
Ανακτήσετε τα δεδομένα λογαριασμού για τη χρηματοδοτημένη διεύθυνση.

Στο Solana, η χρηματοδότηση μιας νέας διεύθυνσης με SOL δημιουργεί αυτόματα έναν λογαριασμό που ανήκει στο System Program. Όλοι οι λογαριασμοί "πορτοφολιού" είναι απλώς λογαριασμοί που ανήκουν στο System Program που περιέχουν SOL και μπορούν να υπογράφουν συναλλαγές.

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.

Ένα "πορτοφόλι" στο Solana είναι ένας λογαριασμός που ανήκει στο System Program, που είναι ένα από τα ενσωματωμένα προγράμματα του Solana. Οι λογαριασμοί πορτοφολιού χρησιμοποιούνται κυρίως για να διατηρούν SOL (που παρακολουθείται στο πεδίο lamports) και για να υπογράφουν συναλλαγές.

Όταν ανακτάτε έναν λογαριασμό πορτοφολιού, η απάντηση περιλαμβάνει τα πεδία που φαίνονται στο παράδειγμα εξόδου.

Το πεδίο data περιέχει τα δεδομένα του λογαριασμού αποθηκευμένα ως bytes.

Για λογαριασμούς πορτοφολιού, αυτό το πεδίο είναι κενό (0 bytes). Άλλοι λογαριασμοί χρησιμοποιούν αυτό το πεδίο για να αποθηκεύσουν είτε την κατάσταση του προγράμματος είτε εκτελέσιμο κώδικα προγράμματος.

Το πεδίο executable υποδεικνύει αν το πεδίο data του λογαριασμού περιέχει εκτελέσιμο κώδικα προγράμματος.

Για πορτοφόλια και λογαριασμούς που αποθηκεύουν την κατάσταση του προγράμματος, αυτό το πεδίο είναι false.

Το πεδίο lamports περιέχει το υπόλοιπο SOL του λογαριασμού, εκφρασμένο σε lamport.

Τα lamport είναι η μικρότερη μονάδα του SOL. 1 SOL = 1.000.000.000 lamport.

Το πεδίο owner δείχνει το πρόγραμμα που κατέχει τον λογαριασμό.

Για τα πορτοφόλια, ο ιδιοκτήτης είναι πάντα το System Program, με τη διεύθυνση 11111111111111111111111111111111.

Το πεδίο rentEpoch είναι ένα παλαιό πεδίο από έναν καταργημένο μηχανισμό όπου οι λογαριασμοί χρεώνονταν "rent" (σε lamports) για να διατηρήσουν τα δεδομένα τους στο δίκτυο.

Αυτό το πεδίο δεν χρησιμοποιείται πλέον, αλλά συμπεριλαμβάνεται για λόγους συμβατότητας με προηγούμενες εκδόσεις.

Το πεδίο space δείχνει τον αριθμό των bytes στο πεδίο data. Αυτό δεν είναι ένα πεδίο στον τύπο Account, αλλά συμπεριλαμβάνεται στην απάντηση.

Σε αυτό το παράδειγμα, το πεδίο space είναι 0 επειδή το πεδίο data περιέχει 0 bytes δεδομένων.