21 bibliotecas pequeñas, en tres capas.
Cada biblioteca es su propio módulo de Go bajo github.com/ciranda-dev, con su propia documentación, un ejemplo compilado, su API y sus límites. Encajan entre sí, pero ninguna necesita el stack entero. Todas están en la versión 0.1.0, en beta y experimentales, y necesitan Go 1.26 o más reciente.
Cómo encajan
- Datos: kolo-id da al peer su clave. kolo-log mantiene un log firmado y append-only, kolo-store lo guarda en disco, kolo-kv lo lee como un almacén clave-valor, kolo-sync lo copia a otros peers, y kolo-codec codifica cada mensaje. kolo-blobs guarda archivos cifrados, y kolo-files añade nombres, carpetas y versiones encima.
- Red: kolo-dht y kolo-swarm encuentran a los peers de un topic y se conectan a ellos por kolo-transport y kolo-secure. kolo-relay ayuda a dos peers que no se alcanzan, solo si lo activas. kolo-invite permite a un miembro traer a alguien a un grupo con un código de invitación. kolo-moq publica tracks en vivo y se suscribe a ellos por esas conexiones, y un relay comparte una suscripción entre muchos suscriptores. kolo-media añade un catálogo, un reloj y la reproducción de frames de audio y video ya codificados.
- Servidores que tú ejecutas: kolo-node ejecuta el servidor bootstrap por el que entran los peers nuevos, y kolo-pin ejecuta un peer de anclaje que guarda logs que no puede leer.
Datos
Claves, codificación, un log firmado, y las piezas que lo guardan, lo leen y lo copian.
- kolo-idIdentidad del peer. Claves Ed25519 e identificadores cortos, una frase de recuperación de 24 palabras y certificados de dispositivo.beta
- kolo-codecCodificación binaria compacta para mensajes.beta
- kolo-logLog firmado, append-only, con pruebas de Merkle, según el RFC 9162.beta
- kolo-storeAlmacenamiento local para logs y claves, sobre Pebble.beta
- kolo-blobsAlmacenamiento de archivos cifrado y direccionado por contenido, legible en cualquier rango.beta
- kolo-filesCarpetas, nombres y versiones cifrados sobre kolo-blobs.beta
- kolo-syncCopia un log de un peer a otro. Solo en modo pull.beta
- kolo-kvUn almacén clave-valor sobre un log, con un solo escritor.beta
- kolo-braidLos logs firmados de varios miembros, unidos en un solo orden determinista.beta
Red
Encontrar peers por topic, invitarlos a un grupo, hablar con ellos por un canal cifrado y enviar tracks en vivo de datos o de medios.
- kolo-transportConexiones entre peers, directas cuando se puede.beta
- kolo-secureCanal TLS 1.3 ligado a la clave del peer.beta
- kolo-dhtEncuentra peers por topic, sin servidor.beta
- kolo-swarmÚnete a un topic y recibe peers conectados.beta
- kolo-relayUn relay opcional para peers sin camino directo.beta
- kolo-inviteCódigos de invitación para un grupo o un dispositivo nuevo: crea uno, únete con él, aprueba o rechaza.beta
- kolo-moqPublica, suscríbete y reenvía tracks en vivo, con MoQ Transport draft 22.beta
- kolo-mediaUn catálogo, un reloj, la reproducción y la sincronía A/V de frames de audio y video sobre kolo-moq.beta
- kolo-audioDispositivos de audio, reproducción, remuestreo, mezcla y Opus, sin cgo.beta
- kolo-videoCaptura de cámara, frames I420, VP8 y VP9, y H.264 opcional con el códec del sistema operativo.beta
Servidores que tú ejecutas
El nodo bootstrap de una red propia, y un peer de anclaje que mantiene disponibles los logs cifrados. En tus máquinas, no en las nuestras. Por defecto los ejemplos usan los nodos de entrada públicos que ejecuta Ciranda.
Una biblioteca que aún no tiene una versión etiquetada lo dice aquí y en la documentación. 21 es el número de hoy; esta página crece con el stack. Otras dos bibliotecas están planeadas, aún sin código, como se explica en la hoja de ruta de la documentación: kolo-gossip, que difunde mensajes pequeños a muchos miembros de un grupo, y kolo-mls, que añade cifrado de extremo a extremo para grupos con el estándar MLS.