Tudo no Kolo está em beta. Cada biblioteca está em v0.x, e a API de qualquer uma delas pode mudar antes da v1.0.0.
Esta página lista só o que está por vir. O que existe hoje está na página de Bibliotecas. Aqui não há datas, e nada do que vem abaixo fixa uma API: nomes e formatos podem mudar enquanto o trabalho é feito.
Os exemplos que existem hoje estão em Feito com Kolo.
Cada item tem um de três status:
- Planejado pretendemos construir e sabemos para que serve.
- Em exploração ainda estamos vendo se vamos construir, e de que forma.
- Futuro uma ideia que queremos manter à vista; nada foi pesquisado nem planejado ainda.
Cada item mostra também o seu tema: Ponte local, Grupos, Borda web, Peers próximos, Rede, SDKs ou Apps.
Planejado
Hoje você usa o Kolo a partir de Go, dentro do mesmo processo do seu app. A ponte local é para um programa que não é escrito em Go, ou que roda como um processo separado no mesmo computador.
- kolo-ipc PlanejadoPonte local um canal entre um processo do Kolo e outro programa no mesmo computador, aberto só para o mesmo usuário. Com ele, uma interface escrita em outra linguagem pode usar um peer que roda ao lado dela.
- kolo-rpc PlanejadoPonte local pedidos e respostas por esse canal. O outro programa pede algo ao processo do Kolo e recebe um resultado, sem escrever o próprio formato de mensagens.
- Um app de chat PlanejadoApps um app de chat para o dia a dia, construído sobre as bibliotecas do Kolo. O chat do tutorial existe para ensinar; este é feito para ser usado.
- kolo-gossip PlanejadoGrupos uma biblioteca para espalhar mensagens pequenas para muitos membros de um topic sem um relay: cada membro repassa uma mensagem para alguns outros até que todos os membros a tenham. Segue a especificação GossipSub da libp2p, versão 1.1 (uma Candidate Recommendation) com a regra IDONTWANT da versão 1.2 (um Working Draft), com o formato de rede próprio do Kolo, e cada mensagem é assinada pela chave do dispositivo que a escreveu. Planejada, ainda sem código. Vamos dizer que tamanho de grupo ela aguenta, e contra o que ela protege, só depois da nossa própria simulação e dos testes.
- kolo-mls PlanejadoGrupos criptografia de ponta a ponta para grupos, pelo padrão MLS (RFC 9420, arquitetura na RFC 9750), suíte de cifra 0x0001 (X25519, AES-128-GCM, SHA-256, Ed25519). O objetivo: uma pessoa removida de um grupo não lê nada do que for enviado depois que a remoção chegar ao grupo. O que ela recebeu enquanto era membro continua com ela. Planejada, ainda sem código. Vamos dizer que tamanho de grupo ela aguenta, e contra o que ela protege, só depois da nossa própria simulação e dos testes.
Em exploração
- kolo-http Em exploraçãoBorda web uma forma de um navegador ou qualquer cliente HTTP chegar ao que um peer serve. Uma aba do navegador não consegue abrir as conexões UDP que os peers usam, então precisa de um peer que responda por HTTP para ela.
- kolo-ble Em exploraçãoPeers próximos conexões por Bluetooth LE entre peers que
estão perto uns dos outros. O objetivo é a mesma conexão pequena que as
camadas de cima já recebem (
Conn, como na kolo-sync e na kolo-braid), para que a sincronização, os pins, os blobs e os braids funcionem sobre ela sem mudanças. Não começou. O nome segue o jeito como o Kolo dá nome a uma biblioteca pelo que ela é: a kolo-transport é QUIC, e um link Bluetooth é outra coisa. Nada do design está decidido. Um design possível roda a pilha cifrada atual sobre um link de pacotes Bluetooth; outro precisa de um handshake próprio, e de uma revisão de segurança antes de qualquer código. Como peers próximos se encontrariam, e o que alguém por perto poderia observar, são perguntas em aberto. - SDK de JavaScript Em exploraçãoSDKs um cliente fino para JavaScript e TypeScript. No desktop ele fala com um processo do Kolo pela ponte local (kolo-ipc e kolo-rpc), e na web fala com o kolo-http. O peer continua em Go.
- Servidor MCP da documentação Em exploraçãoSDKs um endpoint MCP público ao qual as ferramentas de programação com IA possam se conectar para buscar e ler a documentação do Kolo. Não começou. 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.
- Rotação de chaves em um chat Em exploraçãoApps uma chave nova da conversa depois que um membro é removido. Hoje remover um membro não revoga o acesso dele: o membro removido continua com a chave e ainda consegue ler as mensagens novas pelos pins.
- Contas em vários dispositivos Em exploraçãoApps uma pessoa em vários
dispositivos nos programas de exemplo. A parte das bibliotecas está pronta
e publicada: a kolo-id tem a frase de
recuperação de 24 palavras, a chave da pessoa e os certificados de
dispositivo, a kolo-invite vincula um
dispositivo novo por convite, e o pacote
devicesda kolo-braid guarda a lista de dispositivos de uma pessoa em um grupo. Nenhum programa de exemplo as usa ainda, então nos exemplos uma pessoa com dois dispositivos ainda são dois membros. - Ferramentas de moderação para salas Em exploraçãoApps ferramentas para os admins de uma sala. Hoje um admin pode aprovar pedidos e remover um membro, e nada mais.
- Exemplos para celular Em exploraçãoApps exemplos para celular, iOS e Android, que ensinam a construir com o Kolo: primeiro o chat, e depois o compartilhamento de arquivos, o quadro e as reuniões. Não começou. Antes é preciso pesquisar como levar código Go com as bibliotecas do Kolo para dentro de um app de celular, usando só APIs públicas do celular, e os fluxos de permissão de câmera e microfone que o exemplo de reuniões precisa.
Futuro
- IPv6 FuturoRede hoje as bibliotecas do Kolo funcionam sobre IPv4: os endereços, os nós de entrada, os relays e a DHT usam só IPv4, e as formas IPv6 são recusadas de propósito. Dar suporte a IPv6 é um item futuro, sem plano nem data.
O caminho até a 1.0.0
Estas são as condições para uma v1.0.0. São critérios, não datas.
- A API pública de cada biblioteca foi revisada e congelada.
- A validação em macOS, Linux e Windows está completa para cada biblioteca.
- O modelo de segurança está escrito para cada biblioteca.
- A documentação e os exemplos estão completos.
Quando sabemos de algo que bloqueia uma 1.0.0, isso aparece nesta documentação: veja Limites e Segurança.
Até lá, tudo no Kolo está em beta (v0.x): cada biblioteca, com uma API que pode mudar antes da v1.0.0.