Visão geral
O Regtest (modo de Teste de Regressão) é uma rede Bitcoin privada e local que os desenvolvedores podem usar para testes e experimentação. Ao contrário do testnet ou signet, o regtest não se conecta a nenhuma rede externa. Os blocos podem ser gerados instantaneamente via um comando RPC, dando aos desenvolvedores controle total sobre o ambiente de testes sem esperar por tempos de bloco ou adquirir moedas de teste de faucets.
Como o Regtest funciona
Comparação de Redes Bitcoin:
┌──────────┬────────────┬────────────┬────────────┐
│ │ Mainnet │ Testnet │ Regtest │
├──────────┼────────────┼────────────┼────────────┤
│ BTC Real │ Sim │ Não │ Não │
│ Pública │ Sim │ Sim │ Não │
│ Mineração│ PoW │ PoW │ Instantâneo│
│ Pares │ Global │ Global │ Local │
│ Moedas │ Comprar │ Faucet │ Gerar │
│ Resets │ Nunca │ Raramente │ Qualquer │
│ │ │ │ momento │
└──────────┴────────────┴────────────┴────────────┘
Primeiros passos com Regtest
Iniciar um nó Bitcoin Core em modo regtest e gerar blocos é simples:
# Iniciar bitcoind em modo regtest
bitcoind -regtest -daemon
# Criar uma carteira
bitcoin-cli -regtest createwallet "test"
# Gerar um endereço
bitcoin-cli -regtest getnewaddress
# Minerar 101 blocos (100 para madurar coinbase + 1)
bitcoin-cli -regtest generatetoaddress 101 <endereço>
# Agora você tem bitcoin gastável para testes
O comando generatetoaddress cria blocos instantaneamente sem realizar uma prova de trabalho real, tornando o ciclo de testes extremamente rápido.
Casos de uso
- Testes unitários e de integração — Conjuntos de testes automatizados podem criar transações, minerar blocos e verificar o comportamento sem atrasos de rede
- Desenvolvimento da Lightning Network — Desenvolvedores podem abrir e fechar canais de pagamento, simular roteamento e testar casos extremos em um ambiente controlado
- Desenvolvimento de Script — Testar condições de gasto de Bitcoin Script personalizadas sem arriscar fundos reais
- Desenvolvimento de carteiras — Verificar a geração de endereços, construção de transações e lógica de estimativa de taxas
- Simulação de Reorg — Criar deliberadamente reorganizações de cadeia para testar como o software as trata
Vantagens sobre o Testnet
O Regtest oferece vários benefícios comparado ao testnet: os blocos são gerados sob demanda (sem espera), a cadeia pode ser reiniciada a qualquer momento, não há competição por espaço em bloco, sem dependência de faucets para moedas de teste, e sem interferência de outros usuários. Isso torna o regtest o ambiente preferido para desenvolvimento local e pipelines de integração contínua.
Equívoco comum
Regtest não é o mesmo que testnet. O testnet é uma rede pública com sua própria mineração, tempos de bloco e estado compartilhado. O regtest é completamente local e privado. O código que funciona no regtest também deve ser testado no testnet ou signet antes de ser implantado na mainnet, pois esses ambientes simulam mais de perto as condições reais da rede.