Skip to content

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:

  1. El Kernel es innegociable: El núcleo de seguridad (LinealKernel, LinealQorum con consenso 3CL, LinealTransactions y LinealToken) 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.
  2. 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.
  3. 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.

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"]

Clona el repositorio oficial de contratos o servicios a tu propia cuenta de GitHub:

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 LinealQorum o LinealQantum cuando la operación requiera validación multifirma (máquinas, instituciones, humanos) o pruebas ZK (Groth16).
  • Usar errores personalizados (error MyError();) en lugar de strings en require para eficiencia de gas.
  • Incluir mocks y suite de pruebas completas en Foundry o Hardhat.

Antes de enviar el PR, tu código debe superar:

Terminal window
# Compilación limpia
forge build
# Tests con reporte de gas
forge test --gas-report
# Análisis estático de seguridad
slither .

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).

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).
  • 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).

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.