Owlio
ES
← Blog
Guía paso a pasoPrincipiante

Cartera, cuenta de tokens o mint en Solana: identifica la dirección

La dirección de una cuenta de tokens, su mint y su propietario cumplen funciones distintas. Un mapa de campos permite identificar el registro en Solana.

Una cuenta de tokens de Solana registra una cantidad de un token para una autoridad propietaria de los tokens. Su dirección es distinta del mint que identifica el token. En el caso habitual de una cartera, la autoridad es la dirección pública de la cuenta seleccionada en tu cartera. Un explorador también puede mostrar un programa propietario: es una función distinta.

Usa esta guía si un registro de tokens muestra una dirección desconocida o dos campos llamados Owner. Obtendrás una breve ficha que relaciona la cuenta de tokens, la autoridad actual, el mint y el programa que rige la cuenta. Es una comprobación de solo lectura basada en la documentación consultada el 10 de noviembre de 2026; no requiere conectar la cartera ni firmar nada.

Empieza por el registro, no por el aspecto de la dirección

La documentación de cuentas de Solana describe cuentas identificadas mediante claves públicas. Una dirección de aspecto familiar no revela qué representan sus datos. Lee el tipo de cuenta y sus campos en el clúster previsto, como Mainnet Beta o Devnet.

La descripción general de tokens distingue estas funciones:

  • Mint M identifica el token y contiene datos comunes, como el suministro y los decimales.
  • Cuenta de tokens T registra una cantidad de ese mint e indica una autoridad propietaria de los tokens.
  • Autoridad A es la dirección registrada como propietaria de esos tokens. Una cuenta de cartera es un ejemplo habitual; no supongas que toda autoridad es una cartera personal convencional.

Si estás comparando con Ethereum, nuestra guía sobre dirección de cartera y contrato de token explica el caso de EVM. En Solana, el registro separado de la cuenta de tokens es la pieza adicional que debes identificar.

Lee los dos campos Owner por separado

En una cuenta de tokens, el propietario que figura dentro de los datos del token es una autoridad para las operaciones con tokens. El propietario a nivel de cuenta es el Token Program o Token Extension Program que la rige. La documentación de cuentas de tokens de Solana distingue expresamente ambos.

El siguiente mapa de campos usa una cuenta de tokens de la respuesta con datos analizados que aparece en la documentación. Un explorador puede usar otras etiquetas. Las letras son ilustrativas; no son direcciones reales ni una prueba de saldo en vivo.

Campo dentro de una entrada devuelta Significado
pubkey Dirección de la cuenta de tokens T
account.owner Programa de tokens que rige la cuenta P
account.data.parsed.type account para esta cuenta de tokens analizada
account.data.parsed.info.mint Mint del token M
account.data.parsed.info.owner Autoridad propietaria actual de los tokens A
account.data.parsed.info.tokenAmount Cantidad indicada para T
Registro ilustrativo de la cuenta de tokens T, con campos separados para la autoridad propietaria de los tokens A, el mint M y el programa que la rige P.
Son relaciones entre cuentas, no una ruta de transferencia. Anota la autoridad A y el programa P en campos separados.

Interpretar P como la dirección de tu cartera mezcla dos significados distintos de propietario. Interpretar M como la dirección de tu cartera selecciona, en cambio, el identificador del activo. Ninguna de las dos lecturas establece la autoridad cuyas tenencias querías consultar.

La ATA es la cuenta predeterminada, no el inventario completo

Una cuenta de tokens asociada, o ATA, es la cuenta de tokens estándar para una cartera, un programa de tokens y un mint. Esos datos determinan su dirección. La cuenta resultante pertenece a su programa de tokens; el Associated Token Program no es su programa propietario.

La descripción general de tokens también señala que una autoridad puede tener varias cuentas de tokens para un mismo mint. Por tanto, encontrar solo la ATA no demuestra que hayas encontrado todas las cuentas. Lee la autoridad registrada actualmente, en lugar de deducirla únicamente de la derivación de una dirección o de una transacción antigua.

Para obtener un inventario más amplio, getTokenAccountsByOwner devuelve las cuentas de una autoridad con un filtro por mint o programa. Un filtro de programa limita esa consulta al programa seleccionado. Esto permite revisar el alcance de un resultado, pero no promete que una sola consulta abarque todas las posiciones de Solana.

Crea una ficha de identificación

  1. Fija el contexto. Anota el clúster y la dirección pública completa de la autoridad que quieres consultar. Para un activo concreto, guarda por separado el mint previsto, tomado de la referencia oficial del emisor.
  2. Consulta la cuenta exacta. Usa un explorador de confianza o una herramienta de consulta de cuentas de solo lectura. Comprueba si el registro decodificado es una cuenta de tokens o un mint. Si el tipo no está disponible, deja la clasificación sin resolver. Si es un mint, registra su dirección como M y su tipo como mint. Los dos pasos siguientes se aplican a cuentas de tokens.
  3. Compara sus campos. Para una cuenta de tokens, compara la autoridad propietaria actual de los tokens y el mint con los valores previstos. Anota por separado el programa que rige la cuenta. Compara direcciones completas, no etiquetas abreviadas.
  4. Conserva la observación. Guarda el clúster, el tipo decodificado, T, A, M, P, la cantidad indicada y el slot de la respuesta o la hora de observación. Marca el resultado como identificado, no coincidente o sin resolver. Una discrepancia significa que el registro no corresponde a la autoridad o al activo elegidos; no explica el motivo.

Una cuenta ausente y un fallo de la herramienta de consulta son resultados distintos. La referencia de getAccountInfo especifica que result.value es null cuando la cuenta no existe en el nivel de confirmación solicitado. Eso, por sí solo, no dice nada sobre otras cuentas de la autoridad. Un error o una respuesta ilegible dejan esta comprobación sin resolver.

Al añadir una dirección a Owlio, usa la dirección pública de la cuenta de cartera que querías seguir. Su comprobación del formato de la dirección no establece si has introducido una autoridad de cartera, un mint o una cuenta de tokens, ni garantiza una cobertura completa de las tenencias. Conserva la ficha de campos de esta comprobación. Si las identidades coinciden pero la cartera mostrada sigue siendo distinta, continúa con la guía sobre diferencias en el saldo de la cartera para examinar la cobertura y la actualidad de los datos.

Preguntas frecuentes

¿La dirección del mint muestra mi saldo personal de tokens?

El mint identifica el token y almacena datos comunes, como su suministro. Tu tenencia queda registrada en cuentas de tokens asociadas a una autoridad propietaria de los tokens. El suministro del mint no equivale a la cantidad que posee esa autoridad.

¿Conocer la dirección de una ATA demuestra que la cuenta existe?

No. La dirección de una ATA puede derivarse de la dirección de la cartera, el programa de tokens y el mint antes de que exista la cuenta. Consulta sus datos actuales en el clúster previsto. La ausencia de la ATA tampoco descarta otras cuentas de tokens para la misma autoridad y el mismo mint.

¿El propietario de los tokens registrado demuestra quién controla los fondos?

Identifica una autoridad en la cadena, no a una persona, ni demuestra que controles esa autoridad. Los delegados y las extensiones de tokens pueden afectar a los permisos. Identificar la cuenta no constituye una comprobación completa de los permisos de transferencia ni de la posibilidad de gastar los fondos.