⛓️ Blockchain Learning Path GitHub

Proyecto final (capstone)

Objetivo y qué demuestra

Construye un protocolo pequeño que resuelva un problema real y permita demostrar dominio integral del programa: diseño con criterio, contratos probados con rigor, una interfaz utilizable, datos accesibles y una defensa técnica honesta. El capstone no busca originalidad absoluta, sino evidencia de que sabes tomar decisiones, justificarlas y verificar que el sistema hace lo que afirmas.

Un capstone aprobado demuestra que puedes: elegir blockchain solo cuando corresponde, escribir contratos que resisten fuzzing e invariantes, razonar sobre amenazas antes de que ocurran y comunicar todo eso a un evaluador escéptico.

Requisitos mínimos

  1. Protocolo con contratos probados con Foundry, incluyendo pruebas unitarias, de integración, fuzzing e invariantes sobre las propiedades críticas del sistema. Contratos documentados con NatSpec.
  2. dApp o interfaz accesible que permita ejercitar los flujos principales (no hace falta diseño pulido; sí estados de transacción claros y manejo de errores).
  3. Indexador o estrategia de datos explícita: subgraph, indexador propio, eventos + consultas RPC o equivalente, con justificación de la elección.
  4. Documento de arquitectura estilo módulo 18-implementacion-empresarial: contexto, ADR "¿por qué blockchain y qué alternativa se descartó?", diagrama de componentes y límites de confianza.
  5. Threat model: actores, superficies de ataque, privilegios administrativos declarados, plan de incidentes. Puedes apoyarte en docs/threat-model-project.md.
  6. Despliegue reproducible local y en testnet mediante scripts (quien clona el repositorio debe poder levantar todo con instrucciones de un solo documento).
  7. Estimación de gas y operación: costos aproximados de las funciones principales y qué implica operar el sistema.
  8. Plan de infraestructura estilo módulo 16-infraestructura-nodos: nodos requeridos, disponibilidad, monitoreo y respaldo, y cómo se opera el sistema en el tiempo.
  9. Caso de negocio estilo módulo 17-blockchain-en-la-empresa: problema, usuarios, propuesta de valor y viabilidad; por qué el proyecto justifica su costo y mantenimiento.

Ideas de proyecto con alcance acotado

Además del protocolo de financiamiento comunitario que sirve de hilo conductor del repositorio, estas tres ideas tienen un alcance realista para un capstone individual:

1. Registro de certificados verificables

2. Mercado de escrow con árbitro opcional

3. Tesorería con gobernanza mínima

Cualquier otra idea es válida si cabe en las fases siguientes y el instructor aprueba la propuesta. Regla práctica de alcance: si no puedes enumerar las invariantes críticas en cinco líneas, el proyecto es demasiado grande.

Fases y entregables

Fase Entregable Criterio de salida
1. Propuesta Problema, usuarios, criterios de éxito y ADR inicial El instructor confirma que el alcance es realista
2. Diseño Documento de arquitectura, threat model v1, esquema de datos Límites de confianza y privilegios declarados
3. Construcción Contratos + pruebas, interfaz, indexación, scripts de despliegue Suite verde con fuzzing e invariantes
4. Endurecimiento Análisis estático, revisión del threat model, informe de auditoría propio Hallazgos corregidos o justificados por escrito
5. Demo y defensa Demo funcional en testnet + defensa de 10 minutos Responde la rúbrica sin depender de la suerte
flowchart LR
  A["Propuesta"] --> B["Diseño"]
  B --> C["Construcción"]
  C --> D["Endurecimiento"]
  D --> E["Demo y defensa"]

Rúbrica de defensa técnica

Qué se pregunta Qué se espera
¿Por qué blockchain y no una base de datos? ADR con alternativa concreta descartada y trade-offs honestos
¿Cuáles son las invariantes críticas y cómo las pruebas? Invariantes formuladas como propiedades y verificadas con Foundry
¿Qué puede hacer el administrador y qué pasa si su clave se compromete? Privilegios enumerados, mitigaciones (multisig, timelock) y plan de incidentes
¿Cómo falla el sistema? (oráculo caído, reorg, front-running) Modos de falla identificados en el threat model con respuesta definida
¿Cuánto cuesta usarlo y operarlo? Estimación de gas por función y análisis de operación
Muestra el peor bug que encontraste y cómo lo detectaste Evidencia de proceso: prueba que falló, causa raíz, corrección

Preparación de la demo y defensa

Criterios de excelencia

Qué NO hace falta

Puertas de calidad

No se aprueba si usa fondos reales, expone secretos, oculta privilegios administrativos o carece de pruebas para invariantes críticas.

Cómo presentarlo en el portafolio

Navegación