A frase secreta é a única forma de recuperar a Gram Wallet em um dispositivo novo ou depois de apagar o aplicativo. Uma carteira nova gera uma frase de 12 palavras. Você pode ver a frase de novo em Settings → Security → Back Up, e restaurar a carteira com o botão Import Existing Wallet na tela inicial. Servem frases de 12 ou 24 palavras, inclusive as do antigo wallet.ton.org e de outras carteiras TON. Uma frase esquecida não pode ser recuperada por ninguém: a carteira é sem custódia, e nem a equipe nem o Telegram têm cópia das chaves. Tudo foi verificado na versão 26.9.9 e no código aberto em 6 de outubro de 2026.
O que é a frase secreta
Da frase é calculada a chave privada da carteira, e da chave, o endereço. Quem tem a frase controla a carteira por completo, em qualquer dispositivo e em qualquer aplicativo compatível. A senha e a biometria na Gram Wallet protegem só a cópia da chave naquele dispositivo: em outro dispositivo, elas não são necessárias se você tiver a frase.
| De onde vem a frase | Palavras | O que ela dá na Gram Wallet |
|---|---|---|
| Gram Wallet nova | 12 | endereços nas vinte redes |
| Antigo wallet.ton.org, Tonkeeper, Tonhub | 24 | só um endereço na TON |
| Carteira embutida do Telegram | 12, 24 após a troca de chave | o suporte apareceu no código em 6 de outubro, veja abaixo |
| Outras carteiras BIP39 | 12 ou 24 | endereços nas redes que a carteira conhece |
A diferença entre 12 e 24 palavras não está no tamanho, e sim no padrão. A Gram Wallet cria as doze palavras pelo BIP39, o padrão comum a Ethereum, Solana e Bitcoin, e de uma única frase são derivados endereços em todas as redes. A frase de 24 palavras das carteiras TON mais antigas foi criada pelas regras próprias da TON e gera só um endereço na TON. Por isso, uma carteira antiga importada não vai ganhar outras redes.
Como ver a frase de novo
- Abra Settings → Security.
- Digite a senha ou confirme com a biometria.
- Toque em Back Up e confirme os três avisos.
A Gram Wallet mostra as mesmas palavras da criação. Se a verificação das palavras foi pulada na criação, a tela principal exibe o aviso “Wallet is not backed up”. Em uma build comum não é possível pulá-la, então isso só acontece com carteiras de versões de teste.
Como guardar a frase
A tela das palavras avisa em vermelho: não mostre a frase a ninguém e não a digite em lugar nenhum. Na prática, isso significa:
- anotar em papel, na ordem e com os números, em duas cópias guardadas em lugares diferentes;
- não fotografar nem copiar para notas, mensageiros ou nuvens: o botão Copy to Clipboard coloca a frase na área de transferência, e qualquer aplicativo com acesso a ela poderá lê-la;
- não digitar em sites nem em bots que prometem “verificar”, “sincronizar” ou “desbloquear” a carteira. A frase só é digitada na própria carteira, ao restaurá-la.
A proteção contra o roubo da frase vem da confirmação em dois fatores pelo Telegram, Settings → Security → 2FA with Telegram. Com ela, só a frase não basta para enviar fundos: cada operação precisa ser confirmada no bot @tgmfabot pela sua conta do Telegram. A proteção vale só para ativos na TON e exige uma carteira da versão W5. A ativação custa 0,15 Gram.
Como restaurar a carteira
- Instale a Gram Wallet ou abra wallet.ton.org.
- Marque “I agree to use the wallet responsibly” e toque em Import Existing Wallet.
- Escolha Secret Words e digite as 12 ou 24 palavras na ordem.
- Defina uma nova senha ou a biometria.
A senha antiga não é necessária para restaurar: ela protegia a cópia no dispositivo anterior e ficou lá junto com ela.
Além da frase, a importação aceita uma chave privada de 64 caracteres hexadecimais. Na mesma tela há mais duas opções: Ledger conecta uma carteira de hardware, e View Any Address abre qualquer endereço só para visualização, sem permissão para enviar.
Se o saldo estiver vazio depois de restaurar
Na TON, uma única frase gera vários endereços, um para cada versão do contrato da carteira: v3R1, v3R2, v4R2, W5. A Gram Wallet cria as carteiras novas na W5, enquanto a frase de uma carteira antiga pode ter sido usada com v4R2 ou v3R2. As moedas não sumiram: elas estão no endereço de outra versão.
A Gram Wallet verifica as outras versões por conta própria. Se houver tokens nelas, ela oferece importá-las, e nas configurações aparece o item Wallet Versions, onde é possível trocar para a versão necessária. Qual endereço a carteira usava antes pode ser conferido no histórico de transferências em um explorador da blockchain.
A frase da carteira embutida do Telegram
A carteira embutida no Telegram, por enquanto, só existe em versões beta, e a frase dela funciona de outro jeito:
- na criação são geradas 12 palavras. Após uma troca de chave, mais 12 são adicionadas, e a frase passa a ter 24 palavras: a primeira metade continua definindo o endereço, e a segunda assina as transferências;
- por padrão, uma cópia da chave fica guardada na nuvem do Telegram: a chave é criptografada, dividida em três partes e armazenada em data centers de três continentes. Ela só pode ser remontada nos dispositivos do dono. A cópia pode ser desligada, e então será preciso digitar a frase em cada nova sessão do Telegram;
- na beta há uma string dizendo que na carteira embutida só é possível importar uma frase criada no Telegram.
O caminho no sentido inverso está sendo preparado: em 6 de outubro, a versão de contrato telegram e o reconhecimento de uma frase formada por duas metades de 12 palavras foram adicionados ao código aberto da Gram Wallet. Isso significa que uma carteira do Telegram poderá ser aberta no aplicativo independente com a sua frase. A versão 26.9.9, que hoje roda em wallet.ton.org, ainda não tem isso.
Por que a carteira do Telegram precisa trocar de chave
O endereço de uma carteira TON comum é preso à chave: trocar a chave significa mudar para um endereço novo. O contrato telegram funciona como um contrato trampolim: todas as carteiras do Telegram têm o mesmo código, e o código executável é buscado na configuração da blockchain. O endereço é calculado a partir da primeira metade da frase e não muda, enquanto o direito de assinatura passa para a nova chave. Assim, a chave pode ser trocada, por exemplo, se a frase puder ter vazado, e o endereço para o qual as pessoas já enviam Gram continua o mesmo. Se a segunda metade da frase não corresponder à chave atual, a carteira responde que a chave talvez já tenha sido trocada.
Se a frase foi perdida
Enquanto a carteira abrir em algum dispositivo, você pode ver a frase em Back Up e anotá-la de novo. Se não houver frase e a carteira não abrir em lugar nenhum, o acesso está perdido. O suporte @mysupport não consegue devolvê-lo: ele não tem as chaves.
Se você esqueceu só a senha e tem a frase, remova a carteira do dispositivo e restaure-a pela frase com uma nova senha.
