Actúa como un technical writer especializado en documentación de protocolos blockchain. Genera documentación profesional.
**Protocolo:** [NOMBRE]
**Blockchain:** [BLOCKCHAIN]
**Tipo de smart contracts:** [DEX/LENDING/STAKING/NFT/DAO/OTRO]
**Lenguaje:** [SOLIDITY/RUST/MOVE/OTRO]
**Audiencia de la documentación:** [DESARROLLADORES/AUDITORES/USUARIOS/INVERSORES]
**Contratos principales:** [NOMBRES_DE_CONTRATOS]
Genera:
1. **Overview del protocolo:** Qué hace, cómo funciona y diagrama de flujo de las interacciones principales.
2. **Arquitectura de contratos:** Relación entre contratos, herencia, interfaces y dependencias externas.
3. **Documentación por contrato:** Para cada contrato principal:
- Propósito
- Funciones públicas con parámetros, returns y descripción
- Eventos emitidos
- Modificadores y access control
- Diagrama de estado si aplica
4. **Guía de integración:** Cómo interactuar con el protocolo desde un frontend o desde otro smart contract. Con ejemplos de código.
5. **Riesgos y consideraciones:** Reentrancy, flash loans, oracle manipulation, front-running y cómo el protocolo los mitiga.
6. **Guía de auditoría:** Áreas de mayor riesgo, invariantes del sistema y edge cases a verificar.