Documentación del protocolo FHS

Documentación técnica del protocolo, mantenida junto al IDL en docs/ del repositorio.

Para documentación de apps, despliegue y contenedores: galaxIA-Core.

Para empezar

• Protocolo FHS

  Las 10 reglas del protocolo P2P: DHT, GossipSub, dispatch de Missions, privacidad y reputación distribuida. El punto de entrada para entender el sistema.

• Contrato de provider

  Qué debe implementar todo nodo para participar en la red: bootstrap, NodeAdvertise, bid/assign, stream directo, Pulse.

• Vocabulario

  Glosario del vocabulario espacial: Star, Satellite, Nova, Atlas, Navigator, Portal, Mission, Orbit, Beacon y más.

Implementar un provider

• Implementación multi-lenguaje

  Cómo implementar providers FHS en Go, Python, Rust y TypeScript con libp2p. Incluye librerías recomendadas y snippet de bootstrap.

• Beacon Star (LLM provider)

  Campos del Beacon Protobuf y ciclo de vida P2P de un Star.

• Beacon Satellite (tool provider)

  Campos del Beacon Protobuf y ciclo de vida P2P de un Satellite.

Especificación técnica del protocolo

• Arquitectura

  Topología de red, nodos, roles (Star/Satellite/Nova/Navigator/Atlas/Portal) y modelo de federación.

• Red P2P (libp2p)

  DHT Kademlia, GossipSub, descubrimiento de peers, DhtBeaconRecord, NodeAdvertiseMessage y reputación distribuida.

• Identidad

  DID Ed25519, generación de claves, Envelope signature y verificación sin PKI.

• Handshake

  Stream directo /fhs/v1/0.1.0: HandshakeMessage/Ack, Orbit lease, Pulse y cierre graceful.

• Mission

  Ciclo de vida de una tarea: MissionOffer/Bid/Assign, chat, tool dispatch, cancelación y errores.

• Confianza y reputación

  Niveles de confianza (standard/delegated/community/unverified), DelegationToken, reputación en DHT.

• Transporte

  Libp2p + Protobuf como único transporte del protocolo.

• Red — mapa de protocolos

  Mapa completo de la topología libp2p: DHT, GossipSub y streams FHS.

• Ephemeral Satellite

  WASM en dispositivos móviles: cómo un teléfono viejo se une al swarm sin instalación, delegación y confianza.

Definiciones formales (IDL)

Las definiciones canónicas del protocolo viven en idl/ y schemas/:

• fhs-protocol.proto

  Definición Protobuf de todos los mensajes: GossipSub, DHT records, stream directo, handshake. Fuente de verdad para generación de código.

• gossipsub.md

  Especificación de tópicos GossipSub, schemas de mensajes y TTLs.

• flows.md

  Diagramas de secuencia de los 5 flujos principales del protocolo (bootstrap, chat, tool, handshake, errores).

• asyncapi.yaml

  Canales y bindings de la API asíncrona FHS (GossipSub + streams directos).

• idl/network.md

  Stack de red: libp2p transports, multiplexors, security, DHT config y GossipSub params.