Guía de Contribución y Modelo de Desarrollo
⏱ 4 min de lectura
“Talk is cheap. Show me the code.” — Linus Torvalds
1. Filosofía de Desarrollo: El Modelo Linux
Section titled “1. Filosofía de Desarrollo: El Modelo Linux”El protocolo Lineal Qorum Finternet opera bajo la misma premisa técnica que construyó el kernel de Linux: un núcleo sagrado y soberano, y una comunidad global de constructores federados que aportan mediante código probado y estandarizado.
El código de Lineal Qorum es libre para ser clonado, auditado, desafiado y extendido. No contratamos ejércitos de programadores con nóminas corporativas infladas. Operamos por mérito técnico y aportes directos:
- El Kernel es innegociable: El núcleo de seguridad (
LinealKernel,LinealQorumcon consenso 3CL,LinealTransactionsyLinealToken) es custodiado con rigor absoluto por el Arquitecto Principal (NeoQuor). Nada entra al árbol principal si pone en riesgo la invariante matemática o la seguridad de los fondos institucionales. - Los Módulos son abiertos: Extensiones de banca, nuevos conectores financieros, SDKs para otros lenguajes, herramientas de análisis, interfaces de usuario y adaptadores de pago están 100% abiertos a la comunidad.
- Pagas por valor real: Si construyes una funcionalidad que se convierte en un estándar o resuelve una necesidad crítica del protocolo, envías un Pull Request. Yo personalmente lo reviso, calculo su valor de mercado, te lo pago y lo integro al árbol oficial del protocolo.
2. Flujo de Trabajo para Contribuidores
Section titled “2. Flujo de Trabajo para Contribuidores”flowchart TD
Fork["1. Forkear Repositorio\ngithub.com/lineal-qorum"] --> Build["2. Construir & Testear\n100% Cobertura de Tests"]
Build --> PR["3. Enviar Pull Request\nDocumentación + Métricas"]
PR --> Review["4. Revisión por NeoQuor\nAuditoría Técnica y Arquitectura"]
Review --> Valuation{"¿Aprobado?"}
Valuation -->|"Sí"| Pay["5. Tasación de Mercado\nPago al Desarrollador"]
Valuation -->|"No"| Feedback["Retroalimentación Técnica\nCorrecciones requeridas"]
Feedback --> Build
Pay --> Merge["6. Merge Oficial en Core\nCesión Formal de IP"]
Paso 1: Forkear el Repositorio Oficial
Section titled “Paso 1: Forkear el Repositorio Oficial”Clona el repositorio oficial de contratos o servicios a tu propia cuenta de GitHub:
- Repositorio Core: github.com/lineal-qorum
Paso 2: Desarrollo y Estándares de Ingeniería
Section titled “Paso 2: Desarrollo y Estándares de Ingeniería”Todo contrato o servicio propuesto debe adherirse a los patrones arquitectónicos del sistema:
- Heredar de
LinealQorumoLinealQantumcuando la operación requiera validación multifirma (máquinas, instituciones, humanos) o pruebas ZK (Groth16). - Usar errores personalizados (
error MyError();) en lugar de strings enrequirepara eficiencia de gas. - Incluir mocks y suite de pruebas completas en Foundry o Hardhat.
Paso 3: Auditoría y Verificación Local
Section titled “Paso 3: Auditoría y Verificación Local”Antes de enviar el PR, tu código debe superar:
# Compilación limpiaforge build
# Tests con reporte de gasforge test --gas-report
# Análisis estático de seguridadslither .Paso 4: Creación del Pull Request (PR)
Section titled “Paso 4: Creación del Pull Request (PR)”Abre un Pull Request hacia la rama main del repositorio oficial detallando:
- Problema resuelto / Funcionalidad: Explicación técnica del aporte y su caso de uso institucional.
- Arquitectura afectada: Contratos, interfaces o endpoints modificados.
- Reporte de Tests: Cobertura demostrada (> 95% de cobertura requerida).
- Estimación de esfuerzo: Detalle de horas de ingeniería dedicadas.
3. Evaluación, Tasación y Pago de Aportes
Section titled “3. Evaluación, Tasación y Pago de Aportes”Una vez recibido el Pull Request, el proceso de revisión por parte de NeoQuor sigue un estándar de tres pasos:
1. Auditoría de Seguridad y Calidad de Código
Section titled “1. Auditoría de Seguridad y Calidad de Código”Se analiza que el código no contenga vectores de ataque (reentrancy, overflow, manipulación de storage, desincronización de nonces en el tren de firmas) y que respete la Ley de Conservación de Liquidez (LCL).
2. Tasación del Valor de Mercado
Section titled “2. Tasación del Valor de Mercado”Si el código es de nivel de producción y se considera apto para ser adoptado como estándar del ecosistema:
- Se evalúa la complejidad técnica, impacto en la red y las horas de desarrollo invertidas (utilizando como benchmark tarifas de ingeniería senior internacional).
- Se fija el monto de recompensa (bounty) en dólares estadounidenses o stablecoin institucional (
LinealToken).
3. Pago y Merge en el Protocolo
Section titled “3. Pago y Merge en el Protocolo”- Se procesa el pago acordado directamente a la billetera del contribuidor.
- Cesión de Propiedad Intelectual (IP): Al aceptar el pago, el desarrollador cede formalmente los derechos patrimoniales del código a la Fundación Lineal Qorum, garantizando que la tecnología permanezca soberana, unificada y legalmente protegida ante auditorías institucionales.
- Se hace el merge formal en el árbol principal (
main) y se integran automáticamente las interfaces en el SDK React Native (@linealqorum/sdk).
4. Áreas Prioritarias para Contribuir
Section titled “4. Áreas Prioritarias para Contribuir”Si buscas proponer Pull Requests remunerados, estas son las áreas con mayor demanda en el ecosistema:
| Área | Tecnologías | Tipos de Aportes Buscados |
|---|---|---|
| Conectores Bancarios | Node.js / TypeScript | Adaptadores ISO 20022, webhooks de core bancarios locales, conciliares automáticos. |
| SDKs Multiplataforma | Flutter, Python, Go | SDKs clientes para interactuar con el tren de servidores firmadores (signer-server). |
| Circuitos ZK Adicionales | Circom, Snarkjs | Nuevos circuitos de privacidad para votación anónima y transacciones confidenciales. |
| Dashboards de Auditoría | Next.js, Tailwind | Paneles visuales para supervisar el estado de las subcuentas bancarias y licitaciones on-chain. |
| Integraciones DeFi | Solidity | Adaptadores de liquidez para AMMs externos y bridges federados. |
