Estas respostas dizem o que é verdade no Kolo hoje, cada uma com um link para a página que mostra isso. O que ainda não foi construído está no Roadmap.
O Kolo já está em produção?
Ainda não. Todo o Kolo é uma beta (0.1): as bibliotecas e os apps de exemplo estão sendo testados, e a API ainda pode mudar antes da 1.0.0. O Roadmap lista o que não foi construído e o que uma 1.0.0 precisa.
O Kolo é de código aberto?
Sim. Toda biblioteca do Kolo tem a licença MIT ou Apache-2.0, à sua escolha, no seu próprio repositório. Os exemplos de desktop (Kolo Chat, Kolo Share, Kolo Meet e Kolo Board) e os starters deles têm só a licença Apache-2.0. Veja Código aberto em kolo.ciranda.dev.
O Kolo funciona sem servidor?
Os peers se conectam diretamente entre si, e nenhum servidor nosso fica no
caminho dos seus dados. Para se encontrarem pela internet, os exemplos usam nós
de entrada (bootstrap), que não carregam dados da aplicação. Por padrão
usam os dois nós de entrada públicos que a Ciranda mantém no ar, embutidos
nas bibliotecas, então não há nada para configurar. Você pode usar os seus
próprios nós de entrada com -bootstrap, ou deixar tudo num só computador
com -local nos exemplos que têm essa opção. Um relay é opcional e só é usado
quando dois computadores não conseguem se conectar diretamente. O Kolo Chat
pode usar também um pin, que guarda uma cópia cifrada das mensagens para
quem está offline. O pin é opcional: sem ele, as mensagens só chegam a quem
está online. O Kolo Share, o Kolo Meet e o Kolo Board não usam nenhum. Veja Rode a sua própria infraestrutura
e Feito com Kolo.
Preciso rodar um servidor para usar o Kolo?
Não. As bibliotecas e os exemplos entram por padrão na rede pública, por dois
nós de entrada públicos que a Ciranda mantém no ar, de graça e sem garantia
de disponibilidade enquanto o Kolo for uma beta. Duas pessoas em redes
diferentes se encontram sem configurar nada. Você só roda algo por conta
própria se quiser a sua rede (um nó de entrada com kolo-node run -first,
usado com -bootstrap), ou se pessoas atrás de um NAT restritivo precisarem
se conectar: isso exige um relay, e você mesmo o roda. Veja
Rode a sua própria infraestrutura.
Existe um relay ou um pin público?
Não. Não existe relay público nem pin público, e o Kolo nunca usa um por
padrão. O que a Ciranda mantém no ar são dois nós de entrada públicos
(bootstrap), que as bibliotecas e os exemplos usam por padrão, de graça e sem
garantia de disponibilidade enquanto o Kolo for uma beta. Os endereços deles
ficam embutidos na biblioteca (kolodht.PublicServers). Para usar os seus
próprios nós de entrada, passe -bootstrap; numa biblioteca, passe a sua
própria lista a Bootstrap, e uma lista vazia que não é nil é recusada,
então uma rede privada nunca entra por engano na pública. Os comandos de um
relay, de um pin e dos seus próprios nós de entrada estão em
Rode a sua própria infraestrutura.
O que quem opera um relay consegue ver?
Os dois peers rodam a própria conexão cifrada pelo relay, então o relay copia bytes que não consegue ler. Nas palavras do README da kolo-relay:
O que o relay fica sabendo: as duas chaves de cada sessão, os endereços dos dois clientes, quais chaves têm reservas, quando as sessões começam e terminam, e o tamanho e o ritmo dos pacotes internos. Ele não consegue lê-los nem alterá-los, e sempre pode descartá-los, atrasá-los ou encerrá-los.
Veja a kolo-relay e Relay.
Um pin consegue ler as minhas mensagens?
Não. Um pin guarda texto cifrado sem as chaves: ele armazena e serve registros assinados, textos cifrados e marcas de exclusão, e nunca recebe as chaves das entradas. Mesmo assim ele vê quais chaves de dono e IDs de log hospeda, o tamanho deles, quando crescem, e a chave, o endereço e o momento de cada pedido. Veja a kolo-pin.
Por que o Kolo usa só IPv4?
De propósito: as bibliotecas usam só IPv4, e qualquer forma de IPv6, incluindo a IPv4 mapeada, é recusada. O suporte a IPv6 é um item Futuro no Roadmap, sem plano nem data. Veja a kolo-node e a kolo-swarm para ver onde os endereços são verificados.
Remover um membro tira o acesso dele?
Não. No Kolo Chat, um admin pode tirar um membro da lista de membros, e os outras cópias param de falar com ele quando ficam sabendo. O membro removido continua com a chave da conversa, então ainda consegue ler as mensagens novas pelos pins, até o chat ter uma rotação de chave, que hoje ele não tem (está Em exploração no Roadmap). Veja Passo 7: Combine membros e salas com o kolo-braid e as chaves derivadas da kolo-log.
Posso usar uma conta em vários dispositivos?
Nos exemplos, ainda não. O Kolo não tem contas: uma identidade é uma chave
da kolo-id, e nos exemplos um kolo-id vive em um só
dispositivo. As bibliotecas têm as peças: a kolo-id tem uma frase de
recuperação de 24 palavras e certificados de dispositivo assinados pela
chave da pessoa, a kolo-invite vincula um
dispositivo novo por convite, e o pacote devices da
kolo-braid guarda os dispositivos de uma pessoa
em um grupo. Nenhum exemplo as usa ainda; isso está Em exploração no
Roadmap. Nunca copie a pasta de dados de um exemplo para um
segundo dispositivo.
Por que o chat de exemplo não coloca as mensagens no braid?
As mensagens não precisam de uma ordem combinada: cada membro escreve o próprio log, e duas mensagens escritas no mesmo momento podem aparecer em qualquer ordem. A lista de membros e a de salas são estado compartilhado com que todos os membros precisam terminar iguais, então só elas vão para um braid. Veja Passo 7: Combine membros e salas com o kolo-braid.
O Kolo funciona no celular ou por Bluetooth?
Ainda não. Os exemplos para celular e uma biblioteca de Bluetooth LE estão no Roadmap como Em exploração, sem ter começado. Hoje os exemplos rodam no macOS, no Windows e no Linux.
Existe um servidor MCP da documentação?
Ainda não: ele está no Roadmap como Em exploração. Hoje toda
página desta documentação tem uma versão em Markdown em inglês, espanhol e
português, e o site publica llms.txt e llms-full.txt para cada idioma, como
/pt/llms.txt.
Como testo em dois computadores?
Inicie cada exemplo sem flags: os dois entram na rede pública, então dois
computadores em redes diferentes se encontram. Para a sua própria rede, rode
um nó de entrada num computador que os dois alcancem e inicie cada exemplo com
-bootstrap apontando para ele; para ficar num só computador, use
-local. Adicione um relay com -relay quando os dois computadores não
conseguirem se conectar diretamente. Os comandos estão em
Rode a sua própria infraestrutura, e o
README de cada exemplo tem uma seção Try it com um comando por bloco para dois
computadores: os repositórios estão linkados em
Feito com Kolo.