Rovereto, Quinta-feira 19 de Novembro de 2026 · Ano XIII, n.º 323
pt
Bitcoin Valley
ÍndiceFechar

Crónicas do vale onde se paga em bitcoin.

Aprender · Guia · Lição 6

Uma chave com dados

Numa carteira de papel confias tanto quanto confias em quem a fez. Se a fizeres tu, a confiança fica em casa. Aqui está como, com dados em vez do acaso do computador.

O programa é o paperwallet-tools, de Marco Amadori. É software livre, com licença GNU GPL versão 3 ou posterior, e este guia segue a versão 0.1.1. Corre na linha de comandos, está testado em Debian, e faz duas coisas:

  • paperwallet.py cria um endereço bc1q… com a sua chave privada, e imprime-os num cartão do tamanho de um cartão de crédito. Por fora está o endereço, para receber e verificar o saldo. Por dentro, dobrada e coberta por um desenho que a esconde contra a luz, a chave que gasta.
  • paperseed.py cria as palavras de recuperação, 12 ou 24, e imprime-as num cartão maior.

Os dois escrevem um PDF para imprimir frente e verso e um ficheiro .md com os mesmos dados.

Porquê os dados

Sem dados a chave nasce de 32 bytes aleatórios de /dev/random, e é a escolha recomendada. Os dados servem a quem não quer confiar no computador para o acaso: o acaso trazes tu, um lançamento de cada vez. A chave é o SHA-256 do que escreves.

É preciso muito. Para uma chave de 256 bits:

O que lanças Cada lançamento Lançamentos para 256 bits
Dado de 16 faces, de 0 a F um dígito hexadecimal, 4 bits 64
Dado de 6 faces cerca de 2,6 bits 100
Moeda, 1 para cara e 0 para coroa 1 bit 256

Um dado de 16 faces tem os algarismos de 0 a 9 e as letras de A a F: cada lançamento é um dígito hexadecimal. São raros, e a loja da Valley vendia-os. Com o dado de 6 faces escreves os números como saem, de 1 a 6. Espaços e mudanças de linha não contam, nem maiúsculas e minúsculas.

Os teus lançamentos64 com o dado de 16 faces, 100 com o de 6
SHA-256
→
A chave privadadentro do cartão dobrado: quem a tem, gasta
↓ da chave, o endereço ↓
O endereço bc1q…fora do cartão: para receber e verificar o saldo
O acaso trazes tu, a chave nasce dos lançamentos e o endereço da chave. Por fora só se lê o que se pode mostrar.

Três regras:

  1. Cada dígito vem de um lançamento verdadeiro. Não os escrevas a olho nem os corrijas: as pessoas não sabem ser aleatórias.
  2. Nada de frases inventadas. Uma frase ou uma palavra-passe pensadas por uma pessoa são uma brain wallet: mais cedo ou mais tarde alguém as adivinha e esvazia a carteira.
  3. Os lançamentos valem tanto como a chave. Os mesmos lançamentos dão sempre a mesma chave. Se os apontares numa folha, essa folha tem de ser destruída.

O programa estima quanto acaso há no que escreves. Se estiver abaixo dos 256 bits avisa-te antes de pedir mais, e paras com Ctrl-C. A estimativa é otimista: assinala os casos de certeza fracos demais, mas não garante os outros. Mais lançamentos não fazem mal.

O computador e a impressora

  • Uma máquina desligada da rede. Melhor um sistema live como o Tails, com os ficheiros em memória (tmpfs) e a máquina desligada no fim.
  • Uma impressora USB sem memória. Uma impressora de rede, ou com memória interna, pode guardar uma cópia do que imprime.
  • Nunca fotografes o cartão aberto, os lançamentos ou o ecrã.

O programa também faz a sua parte: ao arrancar bloqueia os sockets do Python, para que nem ele nem as suas bibliotecas possam abrir ligações. Protege de uma ligação involuntária, mas não substitui desligar a rede.

Instalar

Instala-se antes, numa máquina que depois vais desligar da rede, ou no sistema live. São precisos o Python 3 e cinco bibliotecas. Em Debian:

sudo apt install libsecp256k1-6 python3-mnemonic python3-pycryptodome python3-reportlab python3-qrcode fonts-open-sans

No Debian 13 trixie a biblioteca chama-se libsecp256k1-2: põe essa em vez de libsecp256k1-6. Também se pode instalar com pip, num ambiente virtual, ou construir o pacote Debian: as instruções estão no README do projeto.

Descarrega o código da página do projeto, depois desliga a rede. Os programas lançam-se a partir da pasta do projeto, como ./paperwallet.py e ./paperseed.py. Se faltar uma biblioteca param e dizem qual.

A carteira de papel, passo a passo

1. Uma prova de impressão

Primeiro experimenta-se com uma carteira descartável, na signet, uma rede de teste cujos satoshis não valem nada: cada painel di-lo na diagonal.

./paperwallet.py --network signet -o prova

Imprime prova.pdf em A4, à escala 100% (não «ajustar à página»), frente e verso, a virar pelo lado comprido. Olha para a folha contra a luz: as marcas no centro das margens têm de coincidir. Depois apaga os ficheiros de teste.

2. A carteira, com os teus lançamentos

./paperwallet.py --entropy-prompt -o wallet

O programa pede os lançamentos e não os mostra enquanto escreves. Saem wallet.pdf e wallet.md. No ecrã só aparecem dados públicos, como o endereço: nunca a chave.

Também podes ler os lançamentos de um ficheiro, com --entropy-file dadi.txt: esse ficheiro é um segredo como a chave, e tem de ficar em memória e ser apagado. Existe também --entropy-string, mas o texto iria parar ao histórico da shell.

Se quiseres a chave protegida por uma palavra-passe acrescenta --bip38: a palavra-passe é pedida duas vezes e nunca se vê. Com as duas cópias de série, uma fica em claro e outra cifrada.

3. Imprime, corta, dobra

Cada folha tem duas tiras: de série duas cópias da mesma carteira, para guardar em sítios diferentes. Corta pelas marcas e dobra seguindo os passos impressos no verso: lado da chave para cima, depois as linhas 1, 2 e 3 por ordem. Por fora ficam o endereço e a capa, por dentro a chave, sob pelo menos duas camadas de papel de cada lado.

Fecha a borda aberta com fita-cola nas duas faixas SEAL, e assina por cima da fita: se alguém abrir o cartão, vê-se.

4. A verificação do endereço

Antes de lá pores dinheiro, importa a chave do ficheiro .md numa carteira offline e vê se dá o endereço impresso. Com o Electrum arranca-se assim:

electrum --offline

Depois crias uma carteira nova com «Import Bitcoin addresses or private keys» e colas o texto do QR da chave, o que começa por p2wpkh:.

5. Apaga, e desliga

Apaga wallet.pdf e wallet.md, ou põe-nos num arquivo cifrado. Depois desliga a máquina.

As palavras de recuperação com dados

O mesmo vale para as palavras de recuperação:

./paperseed.py --entropy-prompt -o parole

Saem 24 palavras, ou 12 com --words 12, num cartão por folha A4 que dobrado mede 148 × 60 mm.

Por dentro estão as palavras numeradas e um SeedQR, que o SeedSigner, a Blockstream Jade e a BlueWallet leem, entre outros, mais um segundo QR com as palavras em claro para as carteiras que não leem o SeedQR, como o Electrum. Por fora está a chave pública estendida da conta, a xpub: chega a uma carteira só de leitura para seguir o saldo, e não gasta.

Com --passphrase acrescentas uma passphrase: pedida duas vezes, nunca impressa. O cartão só diz que é precisa.

Prova de impressão, corte, dobra e selo são iguais. Depois, como para as palavras no metal da lição 6, antes de confiares experimenta restaurar a carteira a partir do cartão, com poucos satoshis. No fim apaga parole.pdf e parole.md, ou cifra-os.

Para quem recebe o cartão

Uma carteira de papel é uma boa prenda. As instruções para quem a recebe estão impressas por dentro; em resumo:

  1. Verifica o saldo só com o endereço, numa carteira só de leitura (watch-only). Como fazê-lo em privado está na lição 3. Para uma olhadela rápida há o ericonto: apontas ao endereço e vês o saldo.
  2. Quando quiseres gastar, faz o sweep: abres o cartão e, a partir de um aparelho em que confias, passas todo o saldo para uma carteira tua. No Electrum é Wallet › Private keys › Sweep, e apontas ao QR da chave. No Sparrow é Tools › Sweep Private Key: escolhe Native SegWit e introduz a chave sem p2wpkh:.
  3. Tudo de uma vez. Depois do sweep a chave não se usa mais, e não se recebe lá mais dinheiro.
  4. Destrói todas as cópias do cartão.

Para verificar o endereço e para o sweep recomendamos com gosto dois programas livres e não custodial: o Electrum e o Sparrow.

O que faz o programa, e o que fica a teu cargo

O programa:

  • bloqueia os sockets do Python ao arrancar;
  • não usa ficheiros temporários, e escreve o PDF e o .md uma só vez, legíveis só por ti;
  • antes de escrever verifica o próprio trabalho: da chave ao endereço, das palavras à semente;
  • no ecrã só mostra dados públicos.

Fica a teu cargo o que o programa não pode controlar: a fila de impressão do sistema, que escreve no disco, as impressoras de rede ou com memória, o swap. E a memória do computador: o Python não garante que apaga os segredos. Por isso o ideal continua a ser um sistema live desligado da rede, uma impressora USB sem memória e a máquina desligada no fim.

Volta à lição 6: guardar, e deixar Todas as lições