kolo docsbeta

Perguntas frequentes

Respostas curtas a perguntas comuns sobre o Kolo, cada uma com um link para a página que mostra isso. O que ainda não foi construído está no Roadmap.

Nesta página

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.