Lectura desde la red

Lee datos de la red Solana obteniendo diferentes cuentas. Esta guía explica la estructura de las cuentas de Solana. Cada cuenta de Solana tiene una dirección única que se utiliza para localizar los datos onchain de la cuenta. Las cuentas de Solana contienen datos de estado o un programa ejecutable.

Obtener una cuenta de billetera

Una cuenta de billetera es una cuenta propiedad del System Program. Las cuentas de billetera se utilizan principalmente para almacenar SOL y firmar transacciones. Cuando se envía SOL a una nueva dirección por primera vez, se crea automáticamente una cuenta del sistema.

El ejemplo a continuación crea un cliente Kit, genera un nuevo firmante, solicita SOL para fondear la nueva dirección y recupera los datos de la cuenta desde la API RPC del cliente.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Cuando obtienes una cuenta de billetera con getAccountInfo(), Kit devuelve la respuesta RPC que se muestra en el ejemplo de salida a la derecha.

La respuesta tiene dos campos de nivel superior: context describe cuándo se realizó la lectura, e value contiene los campos de la cuenta devueltos por el método RPC.

El campo context muestra el slot utilizado para leer la cuenta y la versión de la API RPC que sirvió la respuesta. Una lectura posterior puede devolver un slot o versión de API diferente.

El campo value contiene el estado de la cuenta devuelto por el método RPC. Los siguientes pasos recorren los campos dentro de value en el orden en que aparecen.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo lamports contiene el saldo de SOL de la cuenta, medido en lamports, la unidad más pequeña de SOL.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo data contiene los datos de la cuenta almacenados como bytes. El RPC devuelve los datos de la cuenta como una tupla: la cadena de datos codificada, seguida de la codificación. Para cuentas de billetera, la cadena de datos codificada está vacía porque la cuenta almacena 0 bytes de datos.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo owner muestra el programa que es propietario de la cuenta. Para las billeteras, el propietario siempre es el System Program, con la dirección 11111111111111111111111111111111.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo executable indica si la dirección de la cuenta es invocable. true significa que la dirección representa un programa que puede procesar instrucciones. false significa que la cuenta almacena estado, como el saldo de una billetera o los datos de la cuenta, y no se invoca como un programa. Las cuentas de billetera usan false.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo rentEpoch es un campo heredado de un mecanismo de rent obsoleto. El campo aún se devuelve por compatibilidad con versiones anteriores.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

El campo space muestra el número de bytes contenidos en el campo data. El campo space se devuelve junto con la respuesta de obtención de cuenta, pero no forma parte del tipo de datos de la cuenta.

Para el ejemplo de cuenta de billetera, el campo space es 0 porque el campo data contiene 0 bytes de datos.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}