Encontrar, conectar, cifrar, replicar.
Cuatro pasos, y ningún servidor nuestro en el camino de tus datos. Cada paso son una o dos bibliotecas, y cada biblioteca tiene su propia página en la documentación.
Encontrar
Los peers anuncian un topic y lo buscan en una tabla hash distribuida. Sin servidor de directorio.
Un topic son 32 bytes que los peers acuerdan, normalmente un hash. Kolo no guarda ninguna lista de topics; los bytes no significan nada para él.
Para que lo encuentren, un peer guarda un registro firmado con su clave en los 20 servidores más cercanos al topic, y lo renueva cada 15 segundos. Un servidor descarta un registro 20 minutos después de la última renovación.
Para encontrar a los demás, un peer busca el topic, recibe sus registros firmados y comprueba cada firma. kolo-swarm hace las dos cosas y mantiene conexiones con los peers que encuentra.
Un peer nuevo necesita una primera dirección. Si no le das ninguna, usa los dos nodos de entrada públicos que ejecuta Ciranda, incluidos en kolo-dht. Para una red propia, le das uno o más nodos bootstrap que ejecutas tú, y los públicos no se usan.
Conectar
Los peers abren una conexión directa, a través de sus routers cuando pueden. Un relay entra solo si ejecutas uno y lo pides.
kolo-transport es una conexión QUIC entre dos peers, con streams en los dos sentidos y límites estrictos de datos sin leer, streams y conexiones. La DHT comparte su socket UDP.
El servidor que guardó un registro reenvía una petición de conexión, y los dos peers atraviesan sus NAT. Cuando el NAT de un lado elige puertos aleatorios, lo atraviesan con la técnica del cumpleaños.
Una pareja que no puede atravesar sus NAT recibe un error, no un plan B silencioso. Tu app puede entonces pasar la dirección y la clave de un kolo-relay que ejecutas tú; los peers se conectan de extremo a extremo a través de él y el relay reenvía texto cifrado que no puede leer.
Cifrar
Cada conexión es TLS 1.3, ligada a las claves de los dos peers. Cada firma tiene su propio contexto. Cada entrada del log tiene su propia clave.
kolo-transport por sí solo cifra frente a observadores pasivos, pero no dice quién está al otro lado. kolo-secure añade eso: tras el handshake cada peer firma el valor exportador de la conexión con su clave kolo-id, y la conexión se devuelve solo cuando la firma del otro lado es correcta.
La firma vale para esa única conexión, así que no se puede reutilizar en otra. Cualquier clave válida se autentica; decidir si confiar en ella es cosa de tu app.
Cada firma es Ed25519 con una cadena de contexto (RFC 8032), así que una firma hecha para un tipo de mensaje nunca se verifica como otro.
Cada entrada del log se cifra con su propia clave aleatoria. Un peer puede guardar una entrada, servirla y comprobar sus pruebas sin poder leerla.
Replicar
Cada peer mantiene un log firmado y append-only. Los demás lo traen y comprueban cada pieza antes de guardarla.
kolo-log · kolo-store · kolo-sync · kolo-kv
Un log pertenece a una clave, su escritor. Las entradas son las hojas de un árbol de Merkle con hashes según el RFC 9162, y el dueño firma el head del árbol: el tamaño del log y el hash de la raíz.
Una prueba de inclusión muestra que una entrada está en un head firmado. Una prueba de consistencia muestra que un head más nuevo solo añadió entradas a uno más viejo. Un lector confía en dos cosas, la clave pública del dueño y el ID del log, y comprueba todo lo demás contra ellas.
kolo-sync copia un log solo tirando de él. Una réplica que recibe un head, una prueba o una entrada incorrectos no guarda nada y se queda como estaba. Si el dueño firmó dos historias distintas, los dos heads son la prueba.
Borrar una entrada destruye su clave y firma una marca de borrado; todas las pruebas siguen valiendo. Es de mejor esfuerzo: un peer que ya tenía la clave puede quedársela. kolo-kv construye un almacén clave-valor de un solo escritor sobre un log así.
Qué no está en el camino
- Ninguna máquina nuestra transporta tus datos. Los peers se encuentran a través de dos nodos de entrada públicos que ejecuta Ciranda, o de nodos bootstrap tuyos. No hay ningún relay público: el relay lo ejecutas tú, y está desactivado hasta que lo actives.
- Ninguna cuenta. Un peer es una clave, y dos peers son el mismo peer cuando sus claves públicas son iguales, byte a byte.
- Nada de IPv6 todavía. Kolo es solo IPv4 en la versión 0.1.0, y la documentación lo dice en cada página donde importa.
Cómo construimos
- Firmado y comprobado
- Cifrado entre peers
- Directo cuando se puede
- Sin servidor central
- Bibliotecas pequeñas
- Solo criptografía estándar