ColombiaP2P
La plataforma digital de la comunidad Bitcoin colombiana.
ColombiaP2P es una comunidad abierta de bitcoiners colombianos que promueve la educación, adopción y uso de Bitcoin y sus tecnologías asociadas — Lightning Network, Nostr y P2P — sin intermediarios, sin custodios, sin permisos.
"No tus llaves, no tus bitcoins."
¿Qué es esta plataforma?
Una SPA (Single-Page Application) construida sobre Nostr + Bitcoin Lightning que sirve como punto de encuentro digital de los miembros de ColombiaP2P. Combina identidad soberana (Nostr), economía libre (Lightning), gobernanza comunitaria (méritos C2PM) y participación presencial (eventos + check-in QR).
Funcionalidades principales
| Módulo | Descripción |
|---|
| 🪪 Pasaporte | Identidad Nostr — sin usuario/contraseña, clave privada cifrada localmente |
| 📅 Eventos | Calendario de meetups con check-in QR presencial |
| 🎯 Misiones | Tareas educativas para ganar XP |
| ⭐ Méritos C2PM | Sistema de reputación en 4 categorías + ciudadanía en 6 niveles |
| 💬 Comunidad | Chat descentralizado vía Nostr (NIP-01/04/44) |
| ⚡ Lightning | Donaciones y aportaciones económicas vía LNURL ([email protected]) |
| 🔍 Tesorería | Transparencia de fondos comunitarios (colsats.com / LNbits) |
| 🏛️ Gobernanza | Propuestas y votaciones con peso por méritos |
| 🗺️ Mapa | Red de nodos físicos y miembros |
| 📊 Estadísticas | Métricas comunitarias en tiempo real (PocketBase) |
| 🆔 NIP-05 | Identidad verificable [email protected] para miembros |
| 🔥 Rachas | Actividad diaria consecutiva con XP acumulado |
| 👥 Referidos | Links de invitación con recompensa en XP |
Sistema de XP
| Nivel | XP requerido |
|---|
| 🥉 Fiatelo | 0 |
| 🪙 Plebeyo | 20 |
| 💎 Hodler | 50 |
| ⚡ Noder | 100 |
| 🟠 Bitcoiner | 200 |
| 🔥 Maximalist | 500 |
| 👑 Satoshi | 1.000+ |
El XP se obtiene participando en eventos (+puntos por check-in), completando misiones, manteniendo rachas diarias (+5/día, +35 cada 7 consecutivos) y refiriendo nuevos miembros.
Sistema de ciudadanía (Méritos C2PM)
| Nivel | Méritos C2PM |
|---|
| 👋 Amigo | 0 |
| 🪪 E-Residency | 100+ |
| 🤝 Colaborador | 500+ |
| 🛂 Ciudadano Senior | 1.000+ |
| 🌍 Custodio | 2.000+ |
| 👑 Génesis | 3.000+ |
Los méritos se acumulan en 4 categorías:
- Económica (peso 1.0) — aportaciones económicas al ecosistema
- Productiva (peso 1.0) — contribuciones de trabajo y producción
- Responsabilidad (peso 1.2) — requiere 1.000+ méritos en otras categorías
- Financiada (peso 0.6) — actividad financiada por la comunidad
Stack técnico
| Capa | Tecnología |
|---|
| Frontend | Vanilla JavaScript SPA (sin build, sin bundler) |
| Identidad | Nostr — NIP-01, NIP-07, NIP-19, NIP-49, NIP-65 |
| Mensajería | NIP-44 (XChaCha20-Poly1305) + NIP-04 (fallback) |
| Wallet | Lightning Address + WebLN + NIP-47 (Nostr Wallet Connect) |
| Lightning | [email protected] — LNURL-pay proxiado en Vercel |
| NIP-05 | [email protected] — resolución dinámica vía PocketBase |
| Backend | PocketBase (api.colombiap2p.com) — 12 colecciones |
| Relays | Privado: relay.colombiap2p.com (pendiente); públicos: relay.damus.io, nos.lol |
| Despliegue | Vercel (colombiap2p.com) — auto-deploy en push a main |
Colecciones PocketBase
| Colección | Propósito |
|---|
stamps | Definición de sellos (NFT simbólicos de eventos) |
user_stamps | Sellos obtenidos por usuario |
badges | Definición de badges/logros |
user_badges | Badges otorgados |
missions | Misiones educativas |
merit_contributions | Contribuciones de méritos C2PM |
events | Eventos de la comunidad |
event_checkins | Check-ins presenciales con token QR |
xp_transactions | Historial de XP (fuente, razón, cantidad) |
nip05_identities | Identidades [email protected] activas |
user_streaks | Rachas diarias de actividad |
referrals | Registro de referidos y recompensas |
Arquitectura
┌──────────────────────────────────────────────────────┐
│ Cliente (Vanilla JS SPA — Vercel) │
│ ┌──────────┐ ┌──────────┐ ┌────────────────────┐ │
│ │ UI │ │ LBW_* │ │ C2P_* modules │ │
│ │ scripts │ │ modules │ │ (Eventos, Rachas, │ │
│ │ │ │ │ │ Treasury, Stats) │ │
│ └────┬─────┘ └─────┬────┘ └────────────────────┘ │
└───────┼──────────────┼────────────────────────────────┘
│ │
│ ├──► Relays Nostr (privado + públicos según kind)
│ │ ↑ identidad, gobernanza, méritos, DMs
│ │
│ └──► Vercel /api/* (serverless)
│ ├─► PocketBase (api.colombiap2p.com)
│ ├─► LNURL proxy → colsats.com
│ └─► NIP-05 → PocketBase query
│
└─────────────────► Wallets Lightning (WebLN, NWC, LNURL)
- Nostr es la fuente de verdad para identidad, mensajes cifrados, gobernanza y méritos.
- PocketBase almacena eventos, check-ins, XP, rachas, referidos y NIP-05.
- Las claves privadas (nsec, NWC) viven cifradas con contraseña (NIP-49) en
localStorage o en extensión NIP-07 — nunca en texto plano.
Cache busting (Service Worker)
El SW usa cache-first para JS. Cada cambio en un archivo .js debe subir su parámetro ?v= en index.html para que el SW descargue la versión nueva. Al hacer refactorizaciones grandes, subir también CACHE_NAME en sw.js.
Variables de entorno (Vercel)
| Variable | Uso |
|---|
LNBITS_URL | URL de la instancia LNbits (ej. https://colsats.com) |
LNBITS_READ_KEY | Invoice/read key para consultar balance y pagos |
LNBITS_WALLET_ID | (Opcional) Wallet ID para filtrar pagos |
Entorno local
git clone https://github.com/colombiap2p/colombiap2p-app.git
cd colombiap2p-app
npx serve .
Requiere navegador moderno con extensión Nostr (ej. Alby, nos2x) para el flujo NIP-07.
Las serverless functions (/api/*) solo funcionan en Vercel. Localmente las llamadas LNURL devolverán 404 — esperable.
Cómo contribuir
- Fork del repositorio
- Rama:
git checkout -b feat/mi-mejora
- Commit:
git commit -m "feat: descripción"
- Pull Request describiendo qué hace y por qué
Convenciones de commit: Conventional Commits.
Contacto y comunidad
Licencia
MIT — consulta el archivo LICENSE para más detalles.
