Guía visual y práctica para aprender Stellar + Soroban desde cero, con rutas por perfil, contratos listos, integraciones reales y playbooks de producto.
¿Quieres dar un curso completo sobre Stellar? Hay una capa pedagógica lista para enseñar en
course/: syllabus, teoría (consenso SCP, arquitectura), plan de clase semana a
semana, labs calificados, banco de quizzes, rúbricas y proyecto final.
- Programa completo: course/syllabus.md
- Mapa del curso: course/README.md
- Teoría de consenso (SCP/FBA): course/teoria/02-consenso-scp.md
El curso reutiliza los docs/, contracts/ y examples/ de este repo como material de laboratorio.
Guía práctica para aprender haciendo: pagos, contratos e integraciones en Stellar.
- Terminal básica.
- Ganas de probar cosas.
- JS o Rust ayudan, pero no son obligatorios para arrancar.
flowchart LR
start["0. Inicio"] --> docs["1. Fundamentos y CLI"]
docs --> payments["2. Pagos en Testnet"]
payments --> contracts["3. Contratos Soroban"]
contracts --> integrations["4. Integraciones externas"]
integrations --> playbooks["5. Playbooks E2E"]
playbooks --> release["6. Checklist pre-mainnet"]
- Stellar: red para pagos y activos digitales.
- Soroban: plataforma de smart contracts en Stellar.
- Testnet: red de pruebas (sin dinero real).
- SEP: estándares para que wallets/proveedores se entiendan entre sí.
- Adapter: capa que conecta tu app con un proveedor externo.
| Bloque | Qué resuelve | Dónde empezar |
|---|---|---|
| Fundamentos | Cuentas, red, CLI y flujos base | docs/introduccion.md |
| Pagos | Crear cuentas y enviar XLM | exercises/01-pago-simple.md |
| Contratos | Casos de negocio en Soroban | docs/contratos-casos-uso.md |
| Frontend | Probar funciones de contrato desde UI | docs/frontend-contratos.md |
| Integraciones | Conectar protocolos externos | docs/integraciones-protocolos.md |
| Operación | Hardening y salida a producción | docs/checklist-pre-mainnet.md |
| Área | Lenguajes/Tecnologías |
|---|---|
| Red y estándares | Stellar, SEP-1, SEP-6, SEP-10, SEP-12, SEP-24, SEP-31, SEP-38 |
| Contratos | Soroban, Rust, WASM |
| Integraciones | JavaScript (Node.js), Fetch API, adapters por proveedor |
| DevEx | Stellar CLI, Cargo, Mermaid, Markdown |
flowchart LR
docs["docs/"] --> learn["Onboarding y referencia"]
exercises["exercises/"] --> practice["Práctica guiada"]
contracts["contracts/"] --> onchain["Lógica on-chain Soroban"]
integrations["examples/integrations/"] --> offchain["Adapters off-chain"]
onchain --> playbooks["Playbooks E2E"]
offchain --> playbooks
playbooks --> release["Checklist pre-mainnet"]
docs/ Guías, estándares, playbooks, operación
exercises/ Ejercicios prácticos
contracts/ Contratos Soroban listos para compilar y testear
examples/integrations/ Adapters y demos de integraciones externas
assets/ Recursos visuales
- docs/introduccion.md
- docs/instalacion.md
- docs/comandos-basicos.md
- docs/flujos-mermaid.md
- exercises/01-pago-simple.md
- docs/guia-0-a-builder.md
- docs/contratos-casos-uso.md
contracts/payrollcontracts/savingscontracts/loan,contracts/yield,contracts/nft-membership
- docs/sep-estandares-anclas.md
- docs/integraciones-protocolos.md
examples/integrations/*- docs/playbooks-producto.md
| Contrato | Caso de uso | Estado |
|---|---|---|
contracts/payroll |
Dispersión de nómina por periodo | Listo |
contracts/savings |
Ahorro por metas con penalización temprana | Listo |
contracts/loan |
Préstamo colateralizado base | Listo |
contracts/yield |
Vault por shares (deposit/harvest/withdraw) | Listo |
contracts/nft-membership |
NFT de membresía/certificado | Listo |
| Integración | Carpeta | Operaciones base |
|---|---|---|
| Soroswap | examples/integrations/soroswap |
healthcheck, quote, execute |
| Etherfuse | examples/integrations/etherfuse |
lookupStablebonds, quoteOnramp, quoteOfframp |
| Defindex | examples/integrations/defindex |
getApy, getBalance, deposit, withdraw |
| Pollar | examples/integrations/pollar |
createSession, getRampQuote |
| ZKProof | examples/integrations/zkproof |
generateProof, verifyLocal, verifyOnChainAttestation |
Si quieres testear contratos desde UI (en vez de solo CLI), usa esta guía:
Incluye:
- estructura mínima de frontend,
- setup de SDK,
- ejemplo de invocación de contrato,
- ejemplo de UI con botón de ejecución.
flowchart LR
setup["Configurar entorno"] --> tests["Correr tests"]
tests --> contracts["Probar contratos Soroban"]
contracts --> adapters["Probar adapters en mock/real"]
adapters --> e2e["Ejecutar playbook E2E"]
sequenceDiagram
participant User
participant App
participant Adapter
participant Contract
participant Stellar
User->>App: Solicita operación (ej. ahorro, swap, préstamo)
App->>Adapter: Cotiza/consulta proveedor externo
Adapter-->>App: Datos normalizados
App->>Contract: Invoca función Soroban
Contract->>Stellar: Ejecuta transacción
Stellar-->>App: Hash + estado
App-->>User: Resultado final
cd examples/integrations
cp .env.example .env
npm install
INTEGRATIONS_USE_MOCK=true npm test
INTEGRATIONS_USE_MOCK=true npm run smoke:allcargo test -p payroll -p savings -p loan -p yield -p nft-membershipstellar tx new payment \
--source <CUENTA_ORIGEN> \
--destination <CUENTA_DESTINO_PUBLICA> \
--asset native \
--amount 100- Cambia montos y vuelve a correr
payrollysavings. - Modifica un adapter en
examples/integrationspara añadir un campo nuevo endata. - Crea un mini flujo: ahorro (
savings) + prueba (zkproof) y documenta tu resultado.
- Guía principal: docs/guia-0-a-builder.md
- SEP y anclas: docs/sep-estandares-anclas.md
- Integraciones: docs/integraciones-protocolos.md
- Frontend + contratos: docs/frontend-contratos.md
- Playbooks E2E: docs/playbooks-producto.md
- Checklist producción: docs/checklist-pre-mainnet.md
- Troubleshooting: docs/troubleshooting-integraciones.md
| Contrato | ID | Enlaces |
|---|---|---|
| Dispersor de Nóminas | CBM3OJUPURMLBUN563QN7I62J3SF4OYVIDDN3HPEROCQ3V4AL4VDEZXD |
Stellar Lab · Stellar Expert |
MIT
Hecho por Gerry Vela.