Voltar ao blog
Solana

O que é uma conta de tokens associada (ATA) na Solana?

S
Sol Slugs Team
Sol Incinerator

Sua carteira Solana tem um endereço público, mas a maioria dos tokens não fica armazenada diretamente na conta que mantém seu saldo comum de SOL. Eles ficam em contas de tokens. Uma conta de tokens associada, normalmente abreviada como ATA, é o endereço padrão que os aplicativos usam para os tokens de determinado mint pertencentes a uma carteira.

Entender essa separação explica por que comprar um token pode envolver um depósito de armazenamento e por que vender todo o saldo pode deixar uma conta vazia para trás. Também explica por que o símbolo de um token não basta para reabrir uma conta.

O que é uma conta de tokens associada na Solana?

Uma conta de tokens associada é a conta padrão derivada de um endereço de carteira, um programa de tokens e um endereço de mint. Ela armazena tokens desse mint para a autoridade de conta de tokens da carteira. Seu endereço é previsível, mas criar a conta ainda exige SOL para financiar a reserva de armazenamento on-chain aplicável.

A documentação de criação de contas da Solana descreve o endereço determinístico e a distinção entre proprietário dos tokens e programa proprietário. O Associated Token Program cria a conta; a conta de tokens resultante é regida pelo Token Program correspondente.

Qual é a diferença entre carteira, mint e ATA?

Use três identificações separadas ao inspecionar uma posição em tokens:

Conta ou endereçoPergunta que responde
Endereço da carteiraQual carteira controla esta posição?
Endereço do mintQual é exatamente este token?
Endereço da conta de tokensOnde estão registradas as unidades desse mint pertencentes a este proprietário?

A ATA é uma conta de tokens específica selecionada por uma derivação padrão. Uma carteira também pode controlar outras contas de tokens. Isso significa que a expressão simples “uma conta por token” é útil como introdução, mas incompleta ao inspecionar um inventário real.

Como exemplo ilustrativo, imagine dois mints sem relação entre si usando o símbolo CAT. São tokens diferentes, embora o símbolo seja igual. Suas contas associadas diferem porque seus endereços de mint diferem. Sempre compare o mint ao selecionar uma conta para fechamento, transferência ou recriação.

Por que criar uma ATA bloqueia SOL?

Contas consomem armazenamento on-chain, então sua criação exige um saldo mínimo de lamports. Para contas isentas de aluguel, esse saldo funciona como um depósito de armazenamento, não como uma assinatura descontada diariamente. A quantidade de tokens e o saldo de lamports são valores separados na inspeção.

Uma conta de tokens clássica tem uma estrutura básica conhecida, enquanto extensões Token-2022 podem exigir mais espaço. As configurações de aluguel da rede também podem mudar. Portanto, um valor de um tutorial antigo não é uma cotação permanente para toda nova ATA nem uma previsão exata do retorno de uma conta existente.

Use a prévia atual da transação do aplicativo. Desenvolvedores devem determinar o tamanho de conta necessário e consultar a reserva atual, em vez de fixar no código um valor histórico. O método RPC de isenção de aluguel recebe o comprimento dos dados como entrada.

Quem paga pela criação da conta?

A transação especifica um pagador para a criação. Pode ser você, um remetente ou um aplicativo preparando uma conta de recebimento. Receber tokens não significa necessariamente que sua carteira pagou o depósito original.

Essa distinção também importa ao revisar uma devolução. A operação de fechamento autorizada da conta determina o destino dos lamports liberados. Não se trata de um reembolso com base em comprovante enviado automaticamente a quem financiou a criação inicialmente.

Em um fluxo normal de limpeza de carteira, inspecione o endereço de recebimento e a variação esperada na carteira. Evite tirar conclusões apenas da transação de compra original. O saldo atual da conta e a instrução real de fechamento estabelecem a recuperação disponível e seu destino.

Por que uma ATA vazia permanece aberta após a venda?

Movimentação de tokens e fechamento de conta são operações diferentes. Depois que as unidades saem, uma conta pode continuar disponível para recebimentos futuros. Se um aplicativo a fecha ou não depende da transação que ele constrói.

É por isso que uma venda concluída e uma conta vazia podem coexistir. Não resta uma posição em tokens nessa conta de saldo zero, mas seus lamports ainda podem estar alocados ao armazenamento. Um inventário somente leitura pode identificar essas contas sem pedir que você destrua nada.

Não confunda saldo zero de tokens com um valor em dólares arredondado. Um saldo minúsculo ou um token sem fonte de preço ainda representa tokens em posse. Queimar ou fechar explica por que isso muda a ação que você autorizaria.

É possível recuperar o aluguel de uma ATA sem queimar tokens?

Se a conta estiver vazia e for elegível para fechamento, você pode fechá-la sem queimar um saldo. O fluxo de recuperação não destrutiva do Sol Incinerator ajuda a inspecionar essas candidatas e o retorno atual antes de assinar.

Para contas compatíveis que deseja manter, uma retirada autorizada de excedente pode recuperar lamports acima da reserva atual, deixando os dados dos tokens inalterados. Esse caminho é separado da recuperação do saldo restante por fechamento. Ele não pode retirar a reserva ainda necessária para manter a conta aberta.

Consulte Recuperar SOL excedente sem fechar contas se seu objetivo for manter uma posição. Possuir um token não dá permissão para retirar SOL de toda conta associada ao seu mint ou aos seus metadados.

O que acontece se você receber o token novamente?

Uma conta fechada pode precisar ser criada novamente. O endereço associado é derivado das mesmas entradas, mas sua existência e seu financiamento de armazenamento ainda precisam ser providenciados. Alguns aplicativos preparam a conta de recebimento durante uma transferência ou um resgate; outros esperam que a preparação aconteça antes.

Use a ferramenta Reabrir conta de tokens para um mint compatível quando precisar especificamente dessa conta. Verifique o mint e a carteira e revise o custo de criação. Recriar a conta não restaura tokens queimados ou transferidos.

Como inspecionar uma ATA antes de agir?

Registre o endereço da carteira, o mint, o programa de tokens, a quantidade de tokens, o estado da conta e o saldo de lamports. Depois, expresse seu objetivo em linguagem simples: manter a conta, recuperar excedente compatível ou fechar uma conta vazia.

Essa pequena separação evita vários erros comuns: selecionar outro mint com o mesmo símbolo, esperar que todo o armazenamento de um NFT seja uma única ATA ou tratar todo SOL associado a um ativo como disponível para retirada pelo detentor. Faça a ação corresponder à conta que você realmente controla.

Sol Incinerator

Sol Incinerator

Inspecione contas de tokens sem uso e revise a recuperação de SOL elegível na sua carteira.

Experimente agora

Leituras relacionadas

Perguntas frequentes

O que é uma conta de tokens associada na Solana?

Uma conta de tokens associada é o endereço padrão de conta de tokens derivado de uma carteira, um programa de tokens e um mint. Ela armazena unidades desse mint para seu proprietário. É separada do endereço da carteira e da conta de mint, e sua criação exige financiamento para armazenamento on-chain.

O aluguel de uma ATA é uma taxa recorrente da Solana?

Não. Uma ATA isenta de aluguel mantém um saldo de armazenamento reembolsável, em vez de cobrar uma assinatura recorrente. Seu mínimo obrigatório depende do tamanho da conta e da configuração da rede. Fechar uma conta elegível libera seus lamports restantes, enquanto uma retirada autorizada de excedente recupera somente um saldo compatível acima da reserva exigida.

Cada token Solana precisa de uma ATA separada?

Uma ATA é específica para uma combinação de carteira, programa de tokens e mint. Portanto, mints diferentes usam endereços associados diferentes. Uma carteira também pode controlar contas de tokens não associadas, e NFTs comprimidos usam outro modelo de armazenamento. Não deduza que todo ativo exibido corresponde a um depósito de aluguel de ATA padrão.

O que é uma conta de tokens associada (ATA) na Solana? | Sol Incinerator