Un topic son 32 bytes en los que los peers se ponen de acuerdo, normalmente
un hash como sha256("kolo chat example"). Da nombre a lo que los peers
quieren compartir: una sala de chat, un documento, un log. Kolo no
guarda ninguna lista de topics, y esos bytes no significan nada para él.
Anunciar y buscar
Un lookup, paso a paso
Este ejemplo usa IDs de 8 bits. Los IDs reales tienen 256 bits, la tabla guarda 20 servidores por bucket y van hasta 10 consultas a la vez.
- Tu tabla de rutas da los servidores que conoce más cercanos al topic: aquí A, B y C. La distancia es el XOR de los dos IDs.
- Envías LOOKUP a todos a la vez. Cada respuesta trae servidores más cercanos al topic, un token y los registros que haya.
- C conoce a D y a E, que están más cerca. Les preguntas en cuanto llega la respuesta: no hay rondas fijas.
- E conoce a F y a G, más cerca todavía. La lista se ordena por distancia tras cada respuesta.
- La búsqueda para cuando los 20 servidores más cercanos que conoce han respondido o han agotado su tiempo, o tras 100 consultas. Cada registro lo firma el peer que lo anunció, y la firma se comprueba.
- Un lookup devuelve registros, no conexiones. Connect es una llamada aparte, a través de un servidor que guardó el registro.
Conectar a través de dos NAT
Los dos peers están detrás de routers domésticos. Un nodo bootstrap en internet los pone en contacto; después los paquetes van directos.
- A y B anuncian cada uno un registro firmado del topic a un nodo bootstrap, cada uno desde detrás de su propio NAT.
- A busca el topic. La respuesta trae el registro firmado de B, con su clave pública y su dirección, y el nodo que lo guardó.
- A envía CONNECT a ese nodo, que pasa la petición a B. Ninguno alcanza todavía al otro: los dos NAT solo dejan entrar respuestas.
- Los dos se envían paquetes PUNCH a la vez. Cada NAT ve salir el paquete de su propio peer y abre un mapeo, así que deja entrar los del otro.
- El camino directo queda abierto: los paquetes van entre A y B sin pasar por el nodo. Después kolo-secure prueba las dos claves en la conexión.
kolo-dht es una tabla hash distribuida, repartida entre los peers que funcionan como servidores, como kolo-node.
- Para que lo encuentren, un peer anuncia el topic: guarda un registro, firmado con su clave, en cada uno de los hasta 20 servidores más cercanos que respondieron a su búsqueda del topic; basta con que uno lo guarde. Lo renueva cada 15 segundos. Un servidor descarta un registro 20 minutos después de su última renovación.
- Para encontrar a otros, un peer busca el topic. Recibe los registros firmados de los peers que están en él, comprueba cada firma y después puede conectarse a ellos. El servidor que guardó un registro ayuda a los dos peers a abrir un camino directo a través de sus NAT.
kolo-swarm hace las dos cosas por ti: Join
anuncia el topic, lo busca o hace ambas cosas, y mantiene conexiones con los
peers que encuentra.
Los grupos grandes son una dirección planificada, con dos bibliotecas planificadas y todavía sin código: kolo-gossip, para pasar mensajes pequeños de miembro a miembro de un topic sin un relay, según la especificación GossipSub (versión 1.1 con la regla IDONTWANT de la versión 1.2), y kolo-mls, para cifrar un grupo de extremo a extremo con MLS (RFC 9420). Consulta Planificado en la hoja de ruta.
Un peer nuevo necesita una primera dirección
Un peer entra en la DHT a través de uno o varios servidores conocidos, las direcciones de bootstrap. Si no le das ninguna, usa los dos nodos de entrada públicos que ejecuta Ciranda, incluidos en kolo-dht: gratis y sin garantía de disponibilidad mientras Kolo sea una beta. Para una red propia, le das tus direcciones, y las públicas no se usan. Lo habitual es ejecutar unos cuantos servidores kolo-node en máquinas con una dirección IPv4 pública.
Conviene saber
- Los servidores del camino ven qué direcciones anuncian y buscan un topic.
- Kolo solo usa IPv4. Las direcciones IPv6 se rechazan.