Inspeccionar Cuentas y Programas

Utiliza solana account y solana program para leer el estado en la cadena, los propietarios y los metadatos del bytecode ejecutable sin escribir un cliente.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

solana account <CLAVE_PÚBLICA_CUENTA>
solana account <CLAVE_PÚBLICA> --output json
solana program show <ID_PROGRAMA>
solana program dump <ID_PROGRAMA> program.so

Cuándo usar esto:

• Depurar errores de "cuenta no encontrada" o propietario incorrecto.
• Verificar el ID del programa y la autoridad de actualización de un despliegue.
• Volcar el bytecode .so para comparación de tamaño o hash.
• Inspeccionar rápidamente el alquiler (rent), la longitud de los datos y el saldo de lamports.

Ejemplo de Trabajo

# Inspeccionar el Programa del Sistema (programa nativo)
solana program show 11111111111111111111111111111111
 
# Inspeccionar una billetera o cuenta de datos
solana account "$(solana address)"
 
# JSON para scripting
solana account "$(solana address)" --output json-compact | jq '.account.lamports, .account.owner'
 
# Volcar binario del programa desde devnet/mainnet
solana program dump TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA spl_token.so
ls -la spl_token.so

Lo que esto demuestra:

• program show lista el cargador del propietario, la dirección de los datos del programa, la autoridad y la última ranura de despliegue.
• account imprime lamports, propietario, indicador ejecutable y longitud de datos crudos.
• program dump escribe el ELF en la cadena en disco para inspección o verificación.

Inmersión Profunda

Cómo Funciona

• Cada cuenta almacena lamports, una clave pública de propietario, bytes de datos y banderas.
• Los programas son cuentas marcadas como executable propiedad de un cargador (BPF Loader v3 para programas actualizables).
• solana account recupera a través de la RPC getAccountInfo internamente.
• Los programas actualizables dividen las cuentas de ID de programa y datos de programa.

Campos de Salida de Cuenta

Notas de bash

# Mostrar solo metadatos del programa sin volcar
solana program show <ID_PROGRAMA> --programs
 
# Múltiples cuentas en un solo viaje de ida y vuelta RPC a través de bibliotecas cliente
# La CLI inspecciona una a la vez - usa @solana/kit para lotes

Trampas

• Leer binario como texto - los datos de la cuenta no son UTF-8 para cuentas propiedad de programas. Solución: decodificar con tu IDL, estructuras de cuenta de Anchor o herramientas de diseño de spl-token.
• Cluster incorrecto - la cuenta existe en devnet pero no en mainnet. Solución: solana config get antes de depurar cuentas faltantes.
• Asumir que el ID del programa es igual a los datos del programa - el cargador actualizable usa dos cuentas. Solución: leer ProgramData Address de program show.
• Volcados de cuenta enormes - algunas cuentas son de megabytes. Solución: usar --output json y analizar selectivamente; evitar canalizar binarios crudos a la terminal.
• Visualización obsoleta de la autoridad de actualización - la RPC en caché puede tener retraso. Solución: consultar con compromiso finalized para verificaciones sensibles a la autoridad.

Alternativas

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de Solana CLI - configuración de RPC y cluster
• Despliegue de Programas - lo que program show valida después del despliegue
• CLI de spl-token - decodificación de cuentas específicas de tokens
• Métodos RPC Principales - detalles de getAccountInfo

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.