Use o fluxo de PSBT

Nível de leitura: guia avançado. Primeiro, prepare uma carteira de hardware verificada e a sua cópia de segurança independente.

Uma transação Bitcoin parcialmente assinada (PSBT) é um ficheiro que transporta uma transação e as informações necessárias a quem a assina. Ela permite separar a preparação no computador da assinatura numa carteira de hardware. Uma PSBT pode revelar endereços, valores e informações da carteira, portanto, trate-a como privada mesmo antes de ela poder gastar qualquer coisa.

Prepare a ligação da carteira

Precisa de um registo compatível de carteira de hardware no Ginger, vinculado às chaves do dispositivo de assinatura. Para uma exportação JSON compatível de carteira Coldcard, adicione o ficheiro com Import File. Use as instruções atuais de exportação do fabricante para aquela versão de firmware; um ficheiro de transação PSBT não é um ficheiro de importação de carteira.

A exportação contém informações públicas da conta e uma impressão digital do dispositivo, não as palavras de recuperação. Verifique que o endereço de receção do Ginger corresponde ao dispositivo antes de depositar fundos na carteira. Uma conta importada com outro caminho de derivação ou outra frase de segurança pode ser uma carteira diferente, mesmo quando o dispositivo é o mesmo.

Exporte uma transação

1. Abra a carteira de hardware no Ginger. Em Wallet Settings → General, ative PSBT workflow.
2. Escolha Send e prepare o destino e o valor como de costume. Reveja as entradas selecionadas, o troco e a taxa.
3. Na pré-visualização, escolha Save PSBT file e guarde a transação proposta. A alternativa Send Now segue a assinatura imediata em vez de guardar para o fluxo por ficheiros.
4. Transfira o ficheiro para o dispositivo de assinatura pelo método compatível, como um suporte amovível. Siga as instruções do dispositivo e examine o destino, o valor, a taxa e o troco no seu ecrã de confiança.
5. Guarde o resultado assinado sem confundi-lo com a proposta original não assinada.

Não aprove uma transação apenas porque o Ginger a preparou. O dispositivo deve autorizar o pagamento pretendido. Mantenha as palavras de recuperação fora do ficheiro PSBT e do computador.

Importe e transmita

Volte à carteira de hardware no Ginger e escolha Broadcast, visível com o fluxo de PSBT. O diálogo de ficheiros Import Transaction aceita ficheiros de transação compatíveis, incluindo PSBT e ficheiros de transação. Selecione o resultado assinado e examine o ecrã de transmissão antes de enviá-lo para a rede.

Uma PSBT não assinada ou incompletamente assinada não pode ser transmitida como pagamento válido. Uma assinatura bem-sucedida também não garante a aceitação se suas entradas já foram gastas ou sua taxa já não cumpre as condições da rede. Mantenha a carteira original disponível, sincronize e verifique o histórico antes de criar outro pagamento.

Depois que uma transação é transmitida, o dispositivo de assinatura não precisa mais ficar ligado para que ela seja confirmada. Verifique a entrada final no histórico e as confirmações no Ginger. Excluir um ficheiro assinado não cancela uma transação que outra pessoa já poderia transmitir.

Trate os ficheiros com cuidado

Use nomes de ficheiro distintos para propostas e resultados assinados. Não envie PSBTs por e-mail nem as carregue num descodificador on-line para examinar sua própria transação. Proteja também as exportações sensíveis de contas: uma chave pública estendida pode revelar muitos endereços, embora não possa assinar diretamente um gasto.

Esse fluxo documenta a interface de carteira de hardware desta versão. Ele não estabelece um coordenador geral de múltiplas assinaturas, uma API de assinatura para programadores nem compatibilidade com todo formato PSBT produzido por outros programas.