Lectura desde la red

Obtener una cuenta de billetera

Este ejemplo demuestra cómo:

1. Generar un nuevo keypair (par de claves pública/privada).
2. Solicitar un airdrop de SOL para financiar la nueva dirección.
3. Recuperar los datos de la cuenta para la dirección financiada.

En Solana, financiar una nueva dirección con SOL crea automáticamente una cuenta propiedad del System Program. Todas las cuentas de "billetera" son simplemente cuentas propiedad del System Program que contienen SOL y pueden firmar transacciones.

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

Consultar el Token Program

Este ejemplo consulta el Token Program para demostrar la diferencia entre cuentas de cartera y cuentas de programa.

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);
const address = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
const accountInfo = await connection.getAccountInfo(address);

console.log(

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);
const address = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
const accountInfo = await connection.getAccountInfo(address);

console.log(

Obtener una Mint Account

Este ejemplo obtiene la Mint account de USD Coin (USDC) para mostrar cómo los programas en Solana almacenan el estado en cuentas separadas.

Una cuenta Mint es una cuenta propiedad del Token Program. Almacena metadatos globales para un token específico, incluyendo el suministro total, número de decimales y las cuentas autorizadas para acuñar o congelar tokens. La dirección de la mint account identifica de manera única a un token en la red de Solana.

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);

const address = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const accountInfo = await connection.getAccountInfo(address);

console.log(

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);

const address = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const accountInfo = await connection.getAccountInfo(address);

console.log(

Deserializar una Mint Account

El campo data de una cuenta de Solana contiene bytes en bruto. Para interpretar estos datos de manera significativa, debes deserializarlos al tipo de datos apropiado definido por el programa que posee la cuenta.

La mayoría de los programas de Solana proporcionan bibliotecas cliente con funciones auxiliares que simplifican el proceso de deserialización. Estas funciones convierten los bytes brutos de la cuenta en tipos de datos estructurados, facilitando el trabajo con los datos de la cuenta.

Por ejemplo, @solana/spl-token incluye la función getMint() para ayudar a deserializar el campo data de una cuenta mint en el tipo de datos Mint.

import { PublicKey, Connection } from "@solana/web3.js";
import { getMint } from "@solana/spl-token";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);

const address = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const mintData = await getMint(connection, address, "confirmed");

console.log(

import { PublicKey, Connection } from "@solana/web3.js";
import { getMint } from "@solana/spl-token";

const connection = new Connection(
  "https://api.mainnet-beta.solana.com",
  "confirmed"
);

const address = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
const mintData = await getMint(connection, address, "confirmed");

console.log(