Anatomía de una cuenta

Cada cuenta de Solana comparte los mismos campos estructurales. Comprender cada campo te dice quién puede escribir, si el código o los datos viven allí y cuántos SOL se bloquean para el alquiler.

Receta

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const { value: acct } = await rpc
  .getAccountInfo(address("PUBKEY"), { encoding: "base64" })
  .send();

Cuándo recurrir a esto:

• Depuración de errores de permisos (propietario incorrecto o firmante faltante)
• Determinar si una dirección es un programa o una cuenta de datos
• Cálculo del alquiler a partir de data.length
• Verificación de la existencia de la cuenta antes de construir transacciones

Ejemplo de trabajo

solana account 11111111111111111111111111111111

use anchor_lang::prelude::*;
 
pub fn inspect(ctx: Context<Inspect>) -> Result<()> {
    let acct = &ctx.accounts.target;
    msg!("lamports: {}", acct.lamports());
    msg!("owner: {}", acct.owner);
    msg!("data len: {}", acct.data_len());
    msg!("executable: {}", acct.executable);
    Ok(())
}
 
#[derive(Accounts)]
pub struct Inspect<'info> {
    /// CHECK: raw inspection
    pub target: UncheckedAccount<'info>,
}

Lo que esto demuestra:

• Todos los cinco campos son legibles por cualquier programa que reciba la cuenta
• executable distingue las cuentas de programa de las cuentas de datos
• data_len() devuelve el tamaño del búfer de bytes excluyendo los campos de metadatos

Profundización

Referencia de campos

Cómo funciona

• Los campos de metadatos (lamports, owner, executable, rent_epoch) son administrados por el tiempo de ejecución
• Solo el owner puede cambiar el tamaño o escribir data (además del Programa del Sistema para la asignación)
• Las cuentas de programa tienen owner = BPF Loader y executable = true

Trampas

• Confundir lamports con saldo de tokens - Los saldos de SPL viven en los datos de la cuenta de tokens (data), no en lamports. Solución: leer el diseño de la cuenta de tokens para obtener los saldos.
• Asumir que data es texto UTF-8 - son bytes sin procesar (Borsh, bincode o personalizado). Solución: deserializar con el esquema correcto.
• Ignorar el indicador executable - pasar una cuenta de programa donde se esperan datos falla. Solución: verificar el indicador antes de la deserialización.
• Semántica de rent_epoch cambiada - las cuentas modernas están exentas de alquiler; el campo de época es heredado. Solución: usar getMinimumBalanceForRentExemption para la financiación.
• Propietario vs. autoridad - el propietario es el programa; la autoridad es a menudo una pubkey dentro de data. Solución: validar ambos en tus restricciones.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos del modelo de cuenta - ejemplos generales
• Alquiler y exención de alquiler - requisitos de lamports
• Cuentas de datos y diseño - diseño de búfer de bytes

Versiones de Stack: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.