⛓️ Blockchain Learning Path

Blockchain no es sinónimo de criptomoneda. En este recorrido aprenderás cuándo una cadena de bloques aporta valor, cuándo una base de datos tradicional es mejor y cómo construir —y llevar a producción— sistemas descentralizados de forma responsable.

🎯 Qué es esto

Un currículo modular y secuencial que cubre el espectro completo de blockchain, paso a paso, en 19 módulos numerados (00→18) agrupados en seis etapas, más un proyecto final. Cada módulo es una carpeta con un README.md que incluye:

• 🎯 Objetivos medibles y resultados de aprendizaje verificables.
• 🗺️ Temas con el porqué de cada uno y conceptos con definiciones.
• 🧩 Esquema visual (diagramas Mermaid que GitHub renderiza nativamente).
• 🧠 Modelo mental con su analogía y los límites de la analogía.
• 🔬 Profundización con ejemplos numéricos y casos reales verificables.
• 🧪 Laboratorio guiado ejecutable y un reto verificable con criterio de aceptación.
• ⚠️ Errores frecuentes (síntoma → causa) y 🛡️ seguridad y ética.
• 🔗 Referencias a los libros y fuentes primarias del área.

No enseña a especular: enseña a decidir cuándo usar la tecnología, a construirla con pruebas y a llevarla a una empresa con infraestructura, costos y casos reales.

📚 Pauta derivada de los mejores libros

Cada etapa se apoya explícitamente en la literatura de referencia del sector; el contenido es original en su redacción y no reproduce las obras.

¿Dónde se usa cada libro? La bibliografía incluye la tabla qué obra sustenta cada módulo: enlaza cada obra con su fuente oficial y con el módulo concreto que la usa, así que puedes ir del libro al módulo o del módulo al libro. Varias de las obras clave —Mastering Bitcoin, Mastering Ethereum, Proofs, Arguments, and Zero-Knowledge— tienen edición legalmente gratuita: el programa completo se puede seguir sin comprar un solo libro.

La bibliografía recoge además los hitos recientes del ecosistema (Merge, Dencun/EIP-4844, Pectra/EIP-7702).

📥 Llévate el curso: apps y manual

Todo el contenido —los 19 módulos, la industria, los laboratorios, los ADR y el proyecto final— viaja contigo. Las apps funcionan sin conexión: sirven para estudiar en el metro o en un aula sin wifi.

Las tres versiones salen del mismo build, así que ninguna se queda atrás. Cada binario se verifica en CI abriéndolo y contando los módulos, las páginas y las preguntas que lleva dentro: un build en verde no prueba que el artefacto contenga el curso.

Los binarios no están firmados con certificado de código (cuesta cientos de dólares al año), así que Windows SmartScreen y Android avisarán del origen desconocido. Compara el SHA256 publicado en la release antes de ejecutarlos.

Para generarlo todo desde el repositorio: pnpm build:manual, pnpm app:windows, pnpm app:android.

🗂️ Los 19 módulos en seis etapas

Cada etapa tiene su índice de currículo con mapa visual. Estúdialos en orden: cada módulo asume el anterior.

🧪 Laboratorios y proyectos ejecutables

• 50 prácticas guiadas con actividad, evidencia y criterio de aceptación (catálogo).
• Contratos con Foundry: vault, protocolos, token, oráculo y gobernador con timelock, con pruebas, fuzzing e invariantes.
• Retos de seguridad: contratos vulnerables y sus correcciones (security-challenges).
• dApp de financiamiento comunitario (viem/TypeScript), indexador de eventos y panel de progreso.
• Bitcoin Core en regtest y un nodo Geth real en Docker para operar infraestructura.

git clone https://github.com/vladimiracunadev-create/blockchain-learning-path.git
cd blockchain-learning-path
corepack enable && pnpm install
pnpm check      # valida estructura, enlaces y conteos
pnpm test       # pruebas de Node y de scripts
pnpm lab:hash   # tu primer laboratorio
pnpm serve      # panel de seguimiento

💻 Sin instalar nada: abre el repo en GitHub Codespaces — el devcontainer deja listos Node, pnpm, Foundry y Docker.

Luego empieza por curriculum/00-orientacion. Cada una de las 50 prácticas trae su resolución explicada —cómo se implementa, el comando, la salida esperada y su interpretación— en el cuaderno de laboratorios.

🏭 La industria por dentro

Además del currículo, la sección Industria es la lectura profesional extendida: cómo se construye una red, el stack real del ecosistema, cómo trabajan y se comunican los equipos, casos empresariales (éxitos y fracasos) y modelos de negocio. Y para llevarlo a la práctica, los módulos 16–18 lo convierten en laboratorios: infraestructura real, caso de negocio con costos e implementación end-to-end. Incluye una guía dedicada de cómo explicar blockchain a clientes y personas no técnicas: discurso de 30 segundos, traducción de jerga y manejo de objeciones.

👩‍🏫 Para instructores

El programa está listo para el aula: guía del instructor, syllabus de 26 semanas, checklist de laboratorios y rúbricas de evaluación. Los archivos de solutions/ son criterios de revisión, no respuestas para copiar. El estudiante lleva su avance en una copia de student/progress.example.json.

🚀 Cómo usar el programa

1. Sigue el orden. La numeración 00→18 es secuencial por diseño: cada módulo asume el anterior.
2. Aplica el ciclo de cada módulo: comprender → experimentar → explicar → construir → verificar.
3. Ejecuta los laboratorios en local (Anvil) o testnet; registra la evidencia en tu bitácora de progreso.
4. Haz el reto verificable de cada módulo: ahí se fija el aprendizaje con un criterio de aceptación explícito.
5. Comprueba tu trabajo sin depender de nadie: 31 de las 50 prácticas traen verificación ejecutable (pnpm test, forge test), así que estudiando solo tienes señal inmediata de si tu solución funciona. El resto produce una evidencia revisable con rúbrica.
6. Cierra con la autoevaluación del módulo (4 preguntas al final de cada uno, también en el sitio y en las apps). Cada opción incorrecta es un error frecuente documentado en ese mismo módulo: si fallas, la explicación te dice exactamente qué releer. Al terminar el programa, el quiz global repasa las 19 etapas.
7. Usa los libros de referencia de cada área para profundizar.

Plan completo en el ROADMAP de 26 semanas · ruta intensiva en docs/ruta-rapida.md.

🧭 Rutas por perfil profesional

Recorridos ordenados para desarrollo, arquitectura, auditoría, producto, investigación y empresa: elige el tuyo en learning-paths.

✅ Calidad y CI

• CI: lint de Markdown, JavaScript (ESLint) y Solidity (forge fmt), validación de estructura, enlaces, autoevaluación y cadena de módulos (pnpm check), pruebas de Node y de contratos con Foundry, y análisis estático con Slither.
• Security: escaneo de secretos con gitleaks en cada push y semanalmente, más CodeQL sobre el JavaScript.
• Enlaces: revisión semanal de los ~240 enlaces externos del material; si alguno muere, se abre un issue.
• Apps: cada binario se construye y se abre en CI para contar los módulos, las páginas y las preguntas que lleva dentro. Compilar no es evidencia de que el artefacto contenga el curso.
• Deploy Pages: el sitio y el manual en PDF se generan desde el repo y se publican automáticamente.
• Dependabot mantiene al día las dependencias y las GitHub Actions.

Consulta la guía de contribución, el código de conducta y la política de seguridad.

🎯 Qué es y qué no es este programa

✅ Lo que sí es

• Un currículo para entender, construir y llevar a producción blockchain de forma responsable.
• Material original, con fuentes citadas y actualizado a los hitos recientes del ecosistema.
• Laboratorios ejecutables en local/testnet, con criterios de aceptación verificables.

❌ Lo que no es

• No es asesoría financiera, tributaria ni legal, ni promete rentabilidad alguna.
• No es una guía para especular con criptomonedas ni para operar con fondos reales.
• No sustituye una auditoría profesional ni la operación real de una infraestructura.

💡 Idea fuerza

La madurez técnica no se demuestra usando blockchain en todo, sino sabiendo cuándo aporta valor, cuándo una base de datos es mejor, y cómo llevar a producción con seguridad aquello que sí lo justifica.

📄 Licencia

Código bajo MIT. Contenido educativo bajo CC BY 4.0.