kolo docsbeta

Topics

Un topic es un valor de 32 bytes. Los peers anuncian los topics en los que están y buscan a los demás, sin ningún servidor de directorio.

En esta página

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

Todos los pasos

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.

  1. 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.
  2. Envías LOOKUP a todos a la vez. Cada respuesta trae servidores más cercanos al topic, un token y los registros que haya.
  3. C conoce a D y a E, que están más cerca. Les preguntas en cuanto llega la respuesta: no hay rondas fijas.
  4. E conoce a F y a G, más cerca todavía. La lista se ordena por distancia tras cada respuesta.
  5. 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.
  6. Un lookup devuelve registros, no conexiones. Connect es una llamada aparte, a través de un servidor que guardó el registro.
Todos los pasos

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.

  1. A y B anuncian cada uno un registro firmado del topic a un nodo bootstrap, cada uno desde detrás de su propio NAT.
  2. 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ó.
  3. 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.
  4. 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.
  5. 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.