Descripción general
Regtest (modo de Pruebas de Regresión) es una red Bitcoin privada y local que los desarrolladores pueden usar para pruebas y experimentación. A diferencia de testnet o signet, regtest no se conecta a ninguna red externa. Los bloques pueden generarse instantáneamente mediante un comando RPC, dando a los desarrolladores control completo sobre el entorno de pruebas sin esperar tiempos de bloque ni adquirir monedas de prueba de faucets.
Cómo funciona Regtest
Comparación de Redes Bitcoin:
┌──────────┬────────────┬────────────┬────────────┐
│ │ Mainnet │ Testnet │ Regtest │
├──────────┼────────────┼────────────┼────────────┤
│ BTC Real │ Sí │ No │ No │
│ Pública │ Sí │ Sí │ No │
│ Minería │ PoW │ PoW │ Instantáneo│
│ Pares │ Global │ Global │ Local │
│ Monedas │ Comprar │ Faucet │ Generar │
│ Reinicios│ Nunca │ Raramente │ Cuando │
│ │ │ │ quieras │
└──────────┴────────────┴────────────┴────────────┘
Primeros pasos con Regtest
Iniciar un nodo Bitcoin Core en modo regtest y generar bloques es sencillo:
# Iniciar bitcoind en modo regtest
bitcoind -regtest -daemon
# Crear una billetera
bitcoin-cli -regtest createwallet "test"
# Generar una dirección
bitcoin-cli -regtest getnewaddress
# Minar 101 bloques (100 para madurar coinbase + 1)
bitcoin-cli -regtest generatetoaddress 101 <dirección>
# Ahora tienes bitcoin gastable para pruebas
El comando generatetoaddress crea bloques instantáneamente sin realizar una prueba de trabajo real, haciendo el ciclo de pruebas extremadamente rápido.
Casos de uso
- Pruebas unitarias y de integración — Los conjuntos de pruebas automatizadas pueden crear transacciones, minar bloques y verificar el comportamiento sin retrasos de red
- Desarrollo de Lightning Network — Los desarrolladores pueden abrir y cerrar canales de pago, simular enrutamiento y probar casos extremos en un entorno controlado
- Desarrollo de Script — Probar condiciones de gasto de Bitcoin Script personalizadas sin arriesgar fondos reales
- Desarrollo de billeteras — Verificar la generación de direcciones, construcción de transacciones y lógica de estimación de comisiones
- Simulación de Reorg — Crear deliberadamente reorganizaciones de cadena para probar cómo el software las maneja
Ventajas sobre Testnet
Regtest ofrece varios beneficios comparado con testnet: los bloques se generan bajo demanda (sin esperas), la cadena puede reiniciarse en cualquier momento, no hay competencia por espacio en bloque, no hay dependencia de faucets para monedas de prueba, y no hay interferencia de otros usuarios. Esto hace que regtest sea el entorno preferido para el desarrollo local y las canalizaciones de integración continua.
Concepto erróneo común
Regtest no es lo mismo que testnet. Testnet es una red pública con su propia minería, tiempos de bloque y estado compartido. Regtest es completamente local y privado. El código que funciona en regtest también debe probarse en testnet o signet antes de desplegarse en mainnet, ya que esos entornos simulan más de cerca las condiciones reales de la red.