BBQr é um formato público de transporte da Coinkite. Cada QR começa com B$ e um cabeçalho curto que informa codificação, tipo de arquivo, total de partes e índice; depois vem um segmento em HEX, Base32 ou Zlib fixo seguido de Base32.
BBQr resolve os casos em que uma PSBT, uma transação assinada ou outro arquivo não cabe em um QR razoavelmente legível. O emissor divide os dados em quadros e o receptor os recompõe, permitindo que o arquivo atravesse um air gap sem cabo, cartão ou conexão de rede. O formato não assina nem transmite nada e não faz parte do consenso do Bitcoin. [1]
Cada quadro começa com um cabeçalho de oito caracteres. B$ identifica BBQr; em seguida, um caractere escolhe a codificação, outro o tipo de conteúdo, duas posições base36 dão o total de quadros e as duas últimas o índice. B$HP0301 significa HEX, PSBT, 3 quadros no total e parte de índice 1. Codificação, tipo e quantidade devem ser iguais em toda a série. [1]
O QR usa o modo alfanumérico com um conjunto limitado de caracteres maiúsculos. H grava HEX, 2 usa Base32 sem =, e Z primeiro comprime o arquivo inteiro com Zlib, wbits=10 e sem cabeçalho de arquivo, para depois usar Base32. A compressão pode reduzir uma PSBT, mas ajuda pouco com hashes, UTXO e dados de alta entropia; nesse caso, o codificador deve escolher a menor variante sem compressão. [1]
Os quadros podem ser lidos em qualquer ordem graças ao índice. Porém, não se trata de um fountain code: o receptor precisa obter todas as N partes e não consegue calcular um quadro ausente a partir dos demais. O QR já oferece detecção e correção de erros, por isso a especificação não acrescenta um checksum da série; a discussão de projeto pondera simplicidade, sobrecarga e recuperação de quadros perdidos. [4]
A documentação do projeto descreve BBQr como amplamente implantado e, em 27 de julho de 2026, confirmou código público lançado em vários signers, carteiras móveis e coordenadores, entre eles COLDCARD Q, Sparrow Wallet, Nunchuk Desktop, BTCPay Server, Krux e BlueWallet. O suporte não precisa ser bidirecional: o SeedSigner versão 0.8.7 aparecia apenas como decoder. [2]
Duas posições base36 permitem no máximo 1295 partes, isto é, ZZ. Para a versão QR 40, a especificação cita 4296 caracteres alfanuméricos e um limite teórico sem compressão de 2 776 480 bytes em HEX ou 3 470 600 bytes em Base32. Um dispositivo pode impor menos: a COLDCARD Q aceita até 2 MiB e depois mostra o progresso pela quantidade de partes. [6]
O tipo P indica uma PSBT e T uma transação Bitcoin finalizada; J, C, U, B e X abrangem JSON, CBOR, texto UTF-8, dados binários gerais e executáveis. O tipo ajuda a escolher o parser, mas não prova validade nem segurança. A carteira deve rejeitar um tipo inesperado, e o signer deve mostrar separadamente saídas, valores e taxa antes de assinar. [5]
A implementação deve passar por um round-trip contra o repositório e os dados de teste publicados: codificar o mesmo arquivo, misturar os quadros, lê-los novamente e comparar byte a byte. Quadro ausente ou danificado, H, 2 e Z, um único quadro e limites de memória são testados separadamente. Uma PSBT real ou outros dados sensíveis nunca devem entrar em um gerador web público. [3]
Para ter uma visão mais completa, leia este verbete junto com PSBT, Transação, Hardware Wallet, Air-gapped Wallet, Multisig, Output Descriptor.
01BBQr é o mesmo que SeedQR?+
Não. SeedQR representa um segredo de recuperação BIP39 e deve ser protegido como uma chave privada. BBQr é um envelope geral de transporte para dados divididos, muitas vezes uma PSBT ou transação assinada. Pode carregar conteúdo sensível, mas o nome não implica uma seed e o formato não cifra os dados.
02A transferência por air gap com BBQr torna uma transação segura?+
Não. O canal óptico remove um caminho de rede ou cabo, mas um coordenador malicioso ainda pode preparar uma PSBT com saída alheia, taxa inadequada ou inputs inesperados. Endereços, valores, taxa e regras da carteira devem ser conferidos em um signer confiável; depois, deve-se transmitir exatamente a transação verificada.