Skip to content

Genesis protocol

El Genesis Protocol es la secuencia de arranque inicial de flota que utiliza cada nodo os-infrastructure en su primer arranque. Permite que un nodo se vuelva operativo en hardware aislado — sin configuración previa, sin conexión a ningún plano de control y sin conocimiento de la flota a la que eventualmente se unirá — y que permanezca en un estado seguro y reclamable hasta que un administrador esté listo para incorporarlo a la gestión. El protocolo invierte el supuesto convencional de que el plano de control debe existir antes de que se pueda añadir cómputo a él.

El problema que resuelve

La gestión convencional de flotas requiere una dependencia de secuenciación: el plano de control debe estar configurado, la red debe estar enrutada y el nodo debe estar inscrito antes de que sea útil. Para un operador que envía hardware a una ubicación remota, esto crea un problema de coordinación — el hardware llega al sitio remoto antes de que la capa de gestión de flotas esté lista, o viceversa.

El Genesis Protocol elimina la dependencia de secuenciación. Un nodo puede enviarse a cualquier ubicación, arrancar en cualquier entorno de red y alcanzar un estado seguro y autónomo sin ningún aprovisionamiento previo. El administrador lo reclama cuando esté listo.

Los cinco pasos

1 — Arranque ciego

En el primer arranque, el kernel seL4 genera un par de claves fiduciarias de Nivel 1 a partir de entropía de hardware. A continuación, el nodo entra en modo de arranque ciego: deliberadamente ignora DHCP y DNS, rechazando adquirir una dirección de red mediante mecanismos convencionales. Esto impide que el nodo sea alcanzado por, o se comunique con, cualquier infraestructura que no haya verificado previamente.

2 — Exploración

El nodo explora la red local en busca de una baliza os-network-admin en el puerto de malla PPN. La exploración utiliza la clave pública fiduciaria del nodo como identidad que presenta — de modo que solo una instancia legítima de os-network-admin que posea el material de clave administrativa correspondiente puede responder con autoridad.

3 — Bifurcación génesis

Si la exploración no encuentra ninguna baliza os-network-admin dentro de la ventana de exploración, el nodo forma una Red Privada de Uno. Sella todos los puertos externos excepto uno, un único punto de acceso reforzado. No intenta contactar ningún servicio externo. No falla. Espera.

Un nodo que ha realizado la bifurcación génesis está completamente operativo: tiene su par de claves, tiene un perímetro de red sellado y está esperando una reclamación. No es un nodo defectuoso — es un nodo preparado para la flota que aún no ha sido reclamado.

4 — Patrón de espera

El único punto de acceso abierto es una interfaz WebSocket reforzada. Solo acepta una clase de mensaje: una solicitud de reclamación administrativa que presente un par de claves fiduciarias válido. Cualquier otro intento de conexión se descarta silenciosamente. El nodo no emite ninguna información identificativa a la red; para un observador externo, el punto de acceso es opaco.

5 — Reclamación

Cuando un administrador arranca os-network-admin y presenta la clave fiduciaria administrativa, el punto de acceso en patrón de espera verifica la clave contra el par de claves almacenado localmente en el nodo. Si el par verifica:

  1. El nodo se vincula a la flota, aceptando la instancia de os-network-admin como su autoridad
  2. El nodo recibe su configuración WireGuard de malla y se une a la malla soberana
  3. El par de claves fiduciarias del nodo se registra en el registro de emparejamiento de os-network-admin como emparejamiento ADMIN
  4. Los puertos externos sellados se abren de acuerdo con la política del Diode Standard de la flota

Si la clave no verifica, la reclamación se rechaza silenciosamente. El nodo permanece en su patrón de espera y no emite ninguna respuesta de error.

Ensamblaje de flota diferido

El Genesis Protocol está diseñado para el caso en que el hardware se envía antes de que el administrador esté listo para gestionarlo. Un operador puede enviar cincuenta servidores a cincuenta ubicaciones remotas. Cada uno llega, arranca y forma una PPN de un solo nodo. Cuando el administrador esté listo — días, semanas o meses después — os-network-admin reclama los cincuenta en secuencia. Cada uno verifica la reclamación y se une a la flota. El operador nunca necesita tocar físicamente los nodos después del envío inicial.

Este patrón funciona porque el patrón de espera es indefinidamente estable. Un nodo en patrón de espera consume energía mínima, mantiene su perímetro sellado y no presenta ninguna superficie de ataque más allá del punto de acceso de reclamación reforzado.

Relación con la autorización basada en máquina

El Genesis Protocol es la fase de aprovisionamiento de la autorización basada en máquina. El par de claves fiduciarias generado en el primer arranque se convierte en la entrada de emparejamiento ADMIN de ese nodo en el registro de emparejamiento de la flota. Tras la reclamación:

  • El material de clave del nodo es la única base para toda la autenticación posterior — nunca se transmite ninguna contraseña
  • El emparejamiento puede revocarse eliminando la entrada ADMIN del registro; el nodo se vuelve ingobernable por la flota (aunque continúa ejecutando sus cargas de trabajo de forma autónoma)
  • La autoridad de clave fiduciaria administrativa reside físicamente con el administrador — nunca se delega a un servicio en la nube

Véase también

  • infrastructure-os — el sustrato de cómputo que ejecuta el Genesis Protocol en el primer arranque
  • os-network-admin — el plano de control que ejecuta la secuencia de reclamación
  • sovereign-mesh — la superposición WireGuard a la que se une el nodo tras una reclamación exitosa
  • machine-based-auth — el sistema de pares de claves fiduciarias en el que se basa el protocolo
  • diode-standard — la jerarquía de autoridad que rige la flota después de la reclamación
Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →