Conceito e filosofia
O Bitcoin Tools assenta em três princípios: auto-custódia, local-first e transparência das fontes.
1. Auto-custódia não negociável
Nenhuma chave privada, frase semente ou senha da carteira passa pelo Bitcoin Tools. O Bitcoin Tools constrói uma PSBT não assinada; o botão «Assinar» apenas entrega essa PSBT à sua carteira (Xverse), que pede a sua aprovação explícita. Depois de aprovar, o Bitcoin Tools recebe a transação finalizada e o seu navegador transmite-a diretamente para o mempool.space (Blockstream.info como alternativa). A garantia é portanto precisa: o Bitcoin Tools não consegue criar uma transação gastável sem a aprovação de assinatura da sua carteira — mas, uma vez assinada, a transmissão pode ocorrer automaticamente.
2. Local-first: a sua IndexedDB é a fonte da verdade
As análises da carteira, os enriquecimentos de UTXO, as seleções e as preferências são guardados no seu navegador em vários armazenamentos locais especializados, na maioria bases de dados IndexedDB. Isto permite:
- navegação instantânea entre ferramentas sem re-fetch,
- análise offline (PSBT Inspector),
- persistência local dos seus resultados: são guardados no seu dispositivo e não são carregados em bloco.
Persistência local não significa isolamento total. Para obter UTXO, enriquecimentos ou estados de transação — e para a análise de IA opcional — são transmitidos endereços Bitcoin, outpoints, identificadores de transação e dados de transação descodificados aos fornecedores de dados e proxies necessários. Esse tráfego é processamento de rede temporário; o que fica guardado de forma duradoura permanece no seu dispositivo.
Principais armazenamentos locais (lista não exaustiva)
| Cache | Conteúdo | TTL |
|---|---|---|
scanCache | Resultado completo da verificação da carteira (ordinais + UTXOs de pagamento + grupos de sats raros) | 7 dias |
ordinalsEnrichmentCache | Enriquecimento Ordiscan por txid:vout (intervalos de sats, inscrições, runes, satributos) | ~permanente |
addressUtxosCache | UTXOs brutos do mempool.space por endereço + impressão digital da rede | invalidado na alteração da impressão digital |
psbtCache | Enriquecimento PSBT indexado por hash SHA-256 do payload | ~permanente |
addressEnrichmentCache | Enriquecimento Ordiscan ao nível do endereço (inscrições, saldos BRC-20) | 120 s (anti-burst) |
paymentRiskScans | Resultado da verificação de risco para o endereço de pagamento | 7 dias |
Esta tabela lista os armazenamentos principais; não é, deliberadamente, um inventário exaustivo de cada cache interna. Note que o histórico detalhado de transações apresentado pelo Bitcoin Tools não é guardado no IndexedDB: reside no localStorage, indexado por rede e endereço.
3. O que toca no servidor (e o que não toca)
O que permanece local
- As suas chaves privadas e seed (sempre dentro do Xverse).
- Todas as verificações de carteira, enriquecimentos e seleções de UTXO.
- PSBTs a serem construídas.
- O histórico funcional completo de transações apresentado pelo Bitcoin Tools (pendentes e confirmadas), guardado no localStorage do seu navegador e indexado por rede e endereço.
Ler e atualizar estes elementos continua a exigir chamadas de rede: endereços, outpoints e identificadores de transação são enviados aos fornecedores de dados descritos abaixo para obter UTXO, enriquecimentos e estados de confirmação.
O que passa pelo servidor
- Chamadas Ordiscan: a sua chave pessoal (BYOK) é cifrada no servidor com AES-256-GCM; só é decifrada em memória durante a chamada e nunca é devolvida ao cliente.
- Proxy mempool.space: retransmissão sem chave usada para tráfego de leitura/consulta (taxas, preços, topo da cadeia, consultas de endereços e UTXO) com uma cache leve no servidor. A transmissão de uma transação assinada não usa este proxy: o seu navegador envia a transação finalizada diretamente para o mempool.space, com o Blockstream.info como alternativa.
- Analítica sem dados pessoais: ao iniciar sessão, são registados o seu
userIdSupabase, país/região (cabeçalhos Cloudflare) e um hash SHA-256 do seu IP. O IP em bruto nunca é armazenado. - Telemetria operacional de utilização: ao transmitir uma transação, a implementação de analítica da aplicação pode registar no servidor um vestígio da operação (identificadores e valores de síntese como o txid, a ferramenta usada, a taxa e o número de entradas). Isto é telemetria, não o histórico detalhado visível na interface, que permanece local.
- Auditoria de IA opcional no inspetor de PSBT (botão explícito): envia o JSON descodificado para uma função Supabase, nunca a sua chave nem informação pessoal.
4. Modo de demonstração
O modo demonstração carrega um instantâneo de carteira (UTXOs, runes, inscrições, BRC-20) capturado previamente por um administrador. Todas as ferramentas se comportam como se estivesse ligado, com uma exceção:
O BRC-20 em tempo real e a sondagem de transações pendentes também estão desativados na demonstração para evitar consumir a sua chave Ordiscan.
5. BYOK: Traga a Sua Própria Chave (Ordiscan)
Ordiscan é a nossa principal fonte para sat-ranges, inscrições, saldos BRC-20 e metadados de runas. Uma chave gratuita dá-lhe 1.000 pedidos por mês — o suficiente para uso pessoal normal.
Pode guardar até 5 chaves. Quando uma atinge a quota, a seguinte é usada automaticamente. Ver pré-requisitos para o procedimento.
6. Papéis das carteiras e emblemas ORD / PAY / CHANGE
No Histórico, nos detalhes das transações e nas pré-visualizações de cada ferramenta, entradas e saídas têm um pequeno emblema que descreve a família de endereço do script, deduzida ao descodificar o script para a rede ativa — e não por comparação de texto com os seus endereços ligados.
- ORD (laranja) — script Taproot (P2TR), a família usada pela carteira Ordinals.
- PAY (azul) — família de pagamento validada: SegWit nativo, ou uma forma de SegWit aninhado validada e suportada.
- CHANGE (azul) — a saída que devolve o restante da transação à sua carteira de pagamento. Substitui o emblema PAY nessa saída; as entradas nunca são marcadas como CHANGE.