Lecture depuis le réseau

Cette section explore comment lire des données du réseau Solana en récupérant différents comptes pour comprendre la structure d'un compte Solana.

Sur Solana, toutes les données existent dans des "accounts" (comptes). Vous pouvez considérer les données sur Solana comme une base de données publique avec une seule table "Accounts", où chaque entrée est un compte avec le même type de base 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,
}

Comptes Comptes

Les comptes sur Solana peuvent stocker des "états" ou des programmes "exécutables". Chaque compte possède une "adresse" (clé publique) qui sert d'identifiant unique utilisé pour localiser ses données correspondantes sur la chaîne.

Les comptes Solana contiennent soit :

État : Données destinées à être lues et persistantes. Par exemple, des informations sur les jetons, les données utilisateur, ou d'autres données définies dans un programme.
Programmes exécutables : Comptes contenant le code réel des programmes Solana. Ces comptes stockent des instructions que les utilisateurs peuvent invoquer.

Cette séparation entre le code du programme et l'état du programme est une caractéristique clé du modèle de compte de Solana. Pour plus de détails, consultez la page Modèle de compte Solana.

Récupérer un compte de portefeuille

Cet exemple démontre comment :

Générer une nouvelle keypair (paire de clés publique/privée).
Demander un airdrop de SOL pour financer la nouvelle adresse.
Récupérer les données du compte pour l'adresse financée.

Sur Solana, financer une nouvelle adresse avec du SOL crée automatiquement un compte détenu par le System Program. Tous les comptes de "portefeuille" sont simplement des comptes détenus par le System Program qui contiennent du SOL et peuvent signer des transactions.

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 "portefeuille" sur Solana est un compte détenu par le Programme Système, qui est l'un des programmes intégrés de Solana. Les comptes de portefeuille sont principalement utilisés pour détenir des SOL (suivis dans le champ lamports) et pour signer des transactions.

Lorsque vous récupérez un compte de portefeuille, la réponse inclut les champs présentés dans l'exemple de sortie.

Le champ data contient les données du compte stockées sous forme d'octets.

Pour les comptes de portefeuille, ce champ est vide (0 octet). D'autres comptes utilisent ce champ pour stocker soit l'état du programme, soit du code de programme exécutable.

Le champ executable indique si le champ data du compte contient du code de programme exécutable.

Pour les portefeuilles et les comptes qui stockent l'état du programme, ce champ est false.

Le champ lamports contient le solde en SOL du compte, exprimé en lamports.

Les lamports sont la plus petite unité de SOL. 1 SOL = 1 000 000 000 lamports.

Le champ owner indique le programme qui possède le compte.

Pour les portefeuilles, le propriétaire est toujours le System Program, avec l'adresse 11111111111111111111111111111111.

Le champ rentEpoch est un champ hérité d'un mécanisme obsolète où les comptes étaient facturés du "rent" (en lamports) pour maintenir leurs données sur le réseau.

Ce champ n'est actuellement pas utilisé, mais est inclus pour la rétrocompatibilité.

Le champ space indique le nombre d'octets dans le champ data. Ce n'est pas un champ dans le type Account lui-même, mais il est inclus dans la réponse.

Dans cet exemple, le champ space est à 0 car le champ data contient 0 octets de données.