Lecture depuis le réseau

Lisez des données du réseau Solana en récupérant différents comptes. Cette section vous aidera à comprendre la structure des comptes Solana. Chaque compte Solana possède une adresse unique qui est utilisée pour localiser ses données correspondantes sur la chaîne. Les comptes contiennent soit des données d'état ou un programme exécutable.

Récupérer un compte de portefeuille

Un portefeuille est un compte détenu par le System Program. Les portefeuilles sont principalement utilisés pour détenir des SOL et signer des transactions. Lorsque des SOL sont envoyés à une nouvelle adresse pour la première fois, un compte système est automatiquement créé.

L'exemple ci-dessous génère une nouvelle keypair, demande des SOL pour financer la nouvelle adresse de clé publique, et récupère les données du compte pour le portefeuille nouvellement financé.

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.

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

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).

Le champ executable indique si le champ data du compte contient du code de programme exécutable. Pour les comptes de portefeuille, ce champ est false.

Le champ lamports contient le solde en SOL du compte, en 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 de rent obsolète. (Ce champ est inclus pour la rétrocompatibilité.)

Le champ space indique le nombre d'octets contenus 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.