Un bug report en Web3 es un envío estructurado que describe una vulnerabilidad, fallo lógico o defecto descubierto en un contrato inteligente o protocolo. A diferencia de los reportes de bugs tradicionales que rastrean solicitudes de features y problemas menores, los bug reports Web3 a menudo describen condiciones que podrían llevar a pérdida de fondos — y típicamente se envían a través de programas formales de bug bounty o canales de divulgación responsable.
Anatomía de un Bug Report Web3
Componentes Esenciales
- Nivel de severidad: Crítico, alto, medio, bajo o informativo
- Tipo de vulnerabilidad: Reentrancia, manipulación de oráculo, control de acceso, etc.
- Descripción: Explicación clara del problema
- Proof of Concept (PoC): Código o transacción demostrando el exploit
- Impacto: Qué podría lograr un atacante (fondos en riesgo, daño al protocolo)
- Mitigación: Fix sugerido o workaround
Clasificación de Severidad
| Severidad | Impacto | Ejemplo | Bounty Típico |
|---|
| Crítico | Fondos pueden ser robados | Reentrancia en retiro | $50K–$1M+ |
| Alto | Manipulación del protocolo | Manipulación de precio oracle | $10K–$100K |
| Medio | Riesgo limitado de fondos | Ataque de griefing, DoS | $2K–$25K |
| Bajo | Problemas menores | Optimización de gas, edge case | $500–$5K |
| Informativo | Mejores prácticas | Events faltantes, docs | $100–$1K |
Dónde Enviar Bug Reports
- Immunefi: La plataforma más grande de bug bounty Web3
- Sherlock: Concursos de auditoría y bounties continuos para protocolos DeFi
- Code4rena: Concursos competitivos de auditoría con pools de premios
- Hats Finance: Protocolo descentralizado de bug bounty
- Divulgación directa: Muchos protocolos tienen email security@ o canales dedicados
Proceso de Divulgación Responsable
- Reportar privadamente a través del canal designado del protocolo
- No explotar la vulnerabilidad ni divulgarla públicamente
- Dar al equipo tiempo razonable para corregir el problema
- Coordinar la divulgación pública después del despliegue del fix
- Recibir el pago del bounty tras la verificación
Escribir un Bug Report Efectivo
Hacer
- Incluir un PoC mínimo y reproducible — más fácil de reproducir, más rápido el triage
- Indicar los contratos y funciones exactas afectados
- Cuantificar el impacto: cuánto valor está en riesgo
- Sugerir un fix específico cuando sea posible
- Probar tu PoC en una fork de mainnet antes de enviar
No Hacer
- Enviar issues teóricos sin prueba de explotabilidad
- Divulgar públicamente antes de que el equipo corrija la vulnerabilidad
- Exigir pago inmediato antes de la verificación
- Enviar duplicados — revisar reportes existentes primero
- Exagerar la severidad — evaluación honesta construye reputación
Bug Report vs. Hallazgo de Auditoría
| Aspecto | Bug Report | Hallazgo de Auditoría |
|---|
| Contexto de descubrimiento | Investigador independiente | Firma de auditoría contratada |
| Timing | Cualquier momento, a menudo post-lanzamiento | Pre-lanzamiento, programado |
| Compensación | Bounty (variable) | Tarifa fija (ya pagada) |
| Relación | Independiente | Contratada, colaborativa |
| Alcance | Lo que el investigador encuentre | Alcance definido en el engagement |
Por Qué Importa
Los bug reports son la columna vertebral del modelo de seguridad distribuida de Web3. A diferencia del software tradicional donde un equipo de seguridad lo maneja todo, Web3 depende de una red global de investigadores independientes para encontrar y reportar vulnerabilidades antes de que actores maliciosos las exploten. Para los investigadores de seguridad, escribir reports claros e impactantes es una carrera — los top hunters ganan millones anualmente. Para los protocolos, un pipeline saludable de bug reports es más barato y efectivo que cualquier auditoría individual. Para el ecosistema, la divulgación responsable previene exploits que dañarían la confianza en todo el espacio.