Carteira, conta de tokens ou mint Solana: identifique o endereço

Uma conta de tokens Solana registra uma quantidade de um token para uma autoridade proprietária dos tokens. Seu endereço é diferente do mint que identifica o token. No caso de uma carteira comum, a autoridade é o endereço público da conta selecionada na sua carteira. Um explorador também pode mostrar um programa proprietário: essa é uma função separada.

Use este guia quando um registro de token mostrar um endereço desconhecido ou dois campos chamados Owner. O resultado é uma pequena ficha que relaciona a conta de tokens, a autoridade atual, o mint e o programa responsável. Esta é uma consulta somente de leitura, baseada na documentação revisada em 10 de novembro de 2026; ela não exige conexão da carteira nem assinatura.

Comece pelo registro, não pela aparência do endereço

A documentação de contas da Solana descreve contas endereçadas por chaves públicas. Um endereço de aparência familiar não revela o que seus dados representam. Leia o tipo da conta e seus campos no cluster pretendido, como Mainnet Beta ou Devnet.

A visão geral dos tokens separa as funções:

• O mint M identifica o token e guarda dados compartilhados, incluindo a oferta total e o número de casas decimais.
• A conta de tokens T registra uma quantidade de tokens desse mint e indica uma autoridade proprietária dos tokens.
• A autoridade A é o endereço registrado como proprietário desses tokens. Uma conta de carteira é um exemplo comum; não suponha que toda autoridade seja uma carteira pessoal comum.

Se você chegou pensando em uma comparação com Ethereum, nosso guia sobre endereço de carteira e contrato de token trata do caso EVM. Aqui, o registro separado da conta de tokens Solana é a parte adicional a identificar.

Leia os dois campos Owner separadamente

Em uma conta de tokens, o proprietário dentro dos dados do token é uma autoridade para operações com esses tokens. O proprietário no nível da conta é o Token Program ou o Token Extension Program que a rege. A documentação de contas de tokens da Solana distingue os dois explicitamente.

O mapa de campos abaixo usa uma conta de tokens da resposta decodificada documentada. Um explorador pode usar outros rótulos. As letras são ilustrativas, não são endereços reais nem um teste de saldo ao vivo.

Campo dentro de uma entrada retornada	Significado
pubkey	Endereço T da conta de tokens
account.owner	Programa de tokens P que rege a conta
account.data.parsed.type	account para esta conta de tokens decodificada
account.data.parsed.info.mint	Mint M do token
account.data.parsed.info.owner	Autoridade A atualmente proprietária dos tokens
account.data.parsed.info.tokenAmount	Quantidade informada para T

Tratar P como o endereço da sua carteira confunde dois significados diferentes de proprietário. Tratar M como o endereço da carteira seleciona o identificador do ativo. Nenhuma dessas leituras estabelece a autoridade cujos saldos você pretendia consultar.

A ATA é a conta padrão, não o inventário completo

Uma conta de tokens associada, ou ATA, é a conta de tokens padrão para uma carteira, um programa de tokens e um mint. Esses dados determinam seu endereço. A conta resultante pertence ao seu programa de tokens; o Associated Token Program não é seu programa proprietário.

A visão geral dos tokens também observa que uma autoridade pode ter várias contas de tokens para um mint. Portanto, encontrar apenas a ATA não comprova que você encontrou todas as contas. Leia a autoridade registrada atualmente, em vez de inferi-la apenas pela derivação de um endereço ou por uma transação antiga.

Para um inventário mais amplo, getTokenAccountsByOwner retorna contas de uma autoridade com um filtro por mint ou programa. Um filtro específico de programa limita a consulta ao programa selecionado. Essa é uma forma de examinar o alcance de um resultado, não uma promessa de que uma única consulta cobre todas as posições na Solana.

Monte uma ficha de identificação

1. Defina o contexto. Anote o cluster e o endereço público completo da autoridade que pretende consultar. Para um ativo específico, guarde separadamente o mint pretendido, obtido na referência oficial do emissor.
2. Examine a conta exata. Use um explorador confiável ou uma ferramenta de consulta de contas somente de leitura. Verifique se o registro decodificado é uma conta de tokens ou um mint. Se o tipo não estiver disponível, deixe a classificação como não resolvida. Se for um mint, registre seu endereço como M e seu tipo como mint. As próximas duas etapas se aplicam às contas de tokens.
3. Confira os campos. Para uma conta de tokens, compare a autoridade atualmente proprietária dos tokens e o mint com os valores pretendidos. Registre o programa responsável separadamente. Compare os endereços completos, não os rótulos abreviados.
4. Guarde a observação. Mantenha o cluster, o tipo decodificado, T, A, M, P, a quantidade informada e o slot da resposta ou o horário da observação. Marque o resultado como identificado, divergente ou não resolvido. Uma divergência significa que o registro não corresponde à autoridade ou ao ativo escolhido; ela não explica o motivo.

Uma conta ausente e uma falha na ferramenta de consulta são resultados diferentes. A referência de getAccountInfo especifica que result.value é null quando a conta não existe no nível de confirmação solicitado. Isso, por si só, não diz nada sobre outras contas da autoridade. Um erro ou uma resposta ilegível deixa esta verificação não resolvida.

Ao adicionar um endereço ao Owlio, use o endereço público da conta da carteira que pretendia acompanhar. A verificação do formato do endereço não determina se a entrada é uma autoridade de carteira, um mint ou uma conta de tokens, nem garante a inclusão de todos os saldos. Guarde a ficha produzida nesta verificação. Se as identidades corresponderem, mas o portfólio exibido ainda for diferente, continue com o guia de divergências no saldo do portfólio para examinar a cobertura e a atualização dos dados.