21 bibliotecas pequenas, em três camadas.
Cada biblioteca é o próprio módulo Go sob github.com/ciranda-dev, com a própria documentação, um exemplo compilado, a API e os limites. Elas se encaixam, mas nenhuma precisa da stack inteira. Todas estão na versão 0.1.0, beta e experimentais, e precisam de Go 1.26 ou mais novo.
Como elas se encaixam
- Dados: a kolo-id dá ao peer a sua chave. A kolo-log mantém um log assinado e append-only, a kolo-store o guarda em disco, a kolo-kv o lê como um armazenamento chave-valor, a kolo-sync o copia para outros peers, e a kolo-codec codifica cada mensagem. A kolo-blobs guarda arquivos criptografados, e a kolo-files acrescenta nomes, pastas e versões por cima.
- Rede: a kolo-dht e a kolo-swarm encontram os peers de um topic e se conectam a eles por kolo-transport e kolo-secure. A kolo-relay ajuda dois peers que não se alcançam, só se você ligar. A kolo-invite permite que um membro traga alguém para um grupo com um código de convite. A kolo-moq publica tracks ao vivo e os assina por essas conexões, e um relay compartilha uma assinatura entre muitos assinantes. A kolo-media acrescenta um catálogo, um relógio e a reprodução de frames de áudio e vídeo já codificados.
- Servidores que você roda: o kolo-node roda o servidor de bootstrap por onde os peers novos entram, e a kolo-pin roda um peer de fixação que guarda logs que não consegue ler.
Dados
Chaves, codificação, um log assinado, e as peças que o guardam, leem e copiam.
- kolo-idIdentidade do peer. Chaves Ed25519 e IDs curtos, uma frase de recuperação de 24 palavras e certificados de dispositivo.beta
- kolo-codecCodificação binária compacta para mensagens.beta
- kolo-logLog assinado, só de acréscimo, com provas de Merkle, conforme a RFC 9162.beta
- kolo-storeArmazenamento local para logs e chaves, sobre Pebble.beta
- kolo-blobsArmazenamento de arquivos criptografado e endereçado por conteúdo, lido em qualquer intervalo.beta
- kolo-filesPastas, nomes e versões criptografados sobre a kolo-blobs.beta
- kolo-syncCopia um log de um peer para outro. Só pull.beta
- kolo-kvUm armazenamento chave-valor sobre um log, com um único escritor.beta
- kolo-braidOs logs assinados de vários membros, unidos em uma única ordem determinística.beta
Rede
Encontrar peers por topic, convidá-los para um grupo, falar com eles por um canal criptografado e enviar tracks ao vivo de dados ou de mídia.
- kolo-transportConexões entre peers, diretas quando possível.beta
- kolo-secureCanal TLS 1.3 ligado à chave do peer.beta
- kolo-dhtEncontre peers por topic, sem servidor.beta
- kolo-swarmEntre em um topic e receba peers conectados.beta
- kolo-relayUm relay opcional para peers sem caminho direto.beta
- kolo-inviteCódigos de convite para um grupo ou um dispositivo novo: crie um, entre com ele, aprove ou recuse.beta
- kolo-moqPublique, assine e repasse tracks ao vivo, com MoQ Transport draft 22.beta
- kolo-mediaUm catálogo, um relógio, a reprodução e a sincronia A/V de frames de áudio e vídeo sobre a kolo-moq.beta
- kolo-audioDispositivos de áudio, reprodução, reamostragem, mistura e Opus, sem cgo.beta
- kolo-videoCaptura de câmera, frames I420, VP8 e VP9, e H.264 opcional pelo codec do sistema operacional.beta
Servidores que você roda
O nó de bootstrap de uma rede própria, e um peer de fixação que mantém logs criptografados disponíveis. Nas suas máquinas, não nas nossas. Por padrão os exemplos usam os nós de entrada públicos que a Ciranda mantém no ar.
Uma biblioteca que ainda não tem uma versão etiquetada diz isso aqui e na documentação. 21 é o número de hoje; esta página cresce com a stack. Outras duas bibliotecas estão planejadas, ainda sem código, como descrito no roadmap da documentação: kolo-gossip, que espalha mensagens pequenas para muitos membros de um grupo, e kolo-mls, que adiciona criptografia de ponta a ponta para grupos com o padrão MLS.