Lendo da rede

Leia dados da rede Solana buscando diferentes contas. Este guia explica a estrutura das contas da Solana. Cada conta da Solana tem um endereço único que é usado para localizar os dados onchain da conta. As contas da Solana contêm dados de estado ou um programa executável.

Buscar uma conta de carteira

Uma conta de carteira é uma conta pertencente ao System Program. As contas de carteira são usadas principalmente para armazenar SOL e assinar transações. Quando SOL é enviado para um novo endereço pela primeira vez, uma conta do sistema é criada automaticamente.

O exemplo abaixo cria um cliente Kit, gera um novo assinante, solicita SOL para financiar o novo endereço e recupera os dados da conta da API RPC do 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.

Ao buscar uma conta de carteira com getAccountInfo(), o Kit retorna a resposta RPC exibida no exemplo de saída à direita.

A resposta possui dois campos de nível superior: context descreve quando a leitura ocorreu, e value contém os campos da conta retornados pelo método RPC.

O campo context mostra o slot usado para ler a conta e a versão da API RPC que forneceu a resposta. Uma leitura posterior pode retornar um slot ou versão de API diferente.

O campo value contém o estado da conta retornado pelo método RPC. Os seguintes passos percorrem os campos dentro de value na ordem em que os campos aparecem.

O campo lamports contém o saldo SOL da conta, medido em lamports, a menor unidade de SOL.

O campo data contém os dados da conta armazenados em bytes. O RPC retorna os dados da conta como uma tupla: a string de dados codificada, seguida da codificação. Para contas de carteira, a string de dados codificada está vazia porque a conta armazena 0 bytes de dados.

O campo owner mostra o programa que é proprietário da conta. Para carteiras, o proprietário é sempre o System Program, com o endereço 11111111111111111111111111111111.

O campo executable indica se o endereço da conta é chamável. true significa que o endereço representa um programa que pode processar instruções. false significa que a conta armazena estado, como o saldo de uma carteira ou dados da conta, e não é chamada como um programa. Contas de carteira utilizam false.

O campo rentEpoch é um campo legado de um mecanismo de rent descontinuado. O campo ainda é retornado para compatibilidade retroativa.

O campo space mostra o número de bytes contidos no campo data. O campo space é retornado junto com a resposta de busca da conta, mas não faz parte do tipo de dados da conta.

Para o exemplo de conta de carteira, o campo space é 0 porque o campo data contém 0 bytes de dados.