Lendo da rede

Leia dados da rede Solana buscando diferentes contas. Este guia explica a estrutura das contas da Solana. Cada conta da Solana possui um endereço único 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.