De mãos dadas, peer-to-peer, ninguém no meio.
Bibliotecas em Go para criar apps peer-to-peer. Os peers se encontram, se conectam direto e mantêm um log assinado, sem nenhum servidor no meio.
v0.1.0 beta · Go 1.26+ · baseado em RFC 9162 e RFC 8032
Bibliotecas pequenas, em três camadas.
Cada uma faz uma coisa só e tem a própria documentação. Use uma, ou use todas.
Dados
Chaves, codificação, um log assinado, e as peças que o guardam, leem e copiam.
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.
Quatro coisas que não vamos negociar.
Cada mensagem passa por uma máquina que alguém mantém, paga e pode desligar.
Os peers conversam direto entre si. Se um sai, os outros continuam.
Em vez de um backend no caminho
Sem servidor no meio
Os peers se encontram e se conectam direto. Nenhuma máquina nossa carrega os seus dados, e com o seu próprio nó de bootstrap nenhuma nossa precisa continuar no ar.
Em vez de confiar em quem guarda
Cada entrada é assinada
Cada entrada do log carrega a assinatura de quem a escreveu. Qualquer um pode conferir, e ninguém consegue mudar sem que se perceba.
Em vez de um log que nunca esquece
Apagar significa alguma coisa
Um marcador de exclusão pede às réplicas que descartem os dados. A exclusão é só de melhor esforço, e a documentação deixa isso claro.
Em vez de um relay sempre ligado
Um relay só se você pedir
Quando dois peers não se alcançam, um relay pode ajudar. Fica desligado até você ligar.
Sem servidor no caminho.
Encontrar
Os peers anunciam um topic e o procuram numa tabela distribuída. Sem servidor de diretório.
Conectar
Eles abrem um canal direto e criptografado. Um relay entra só quando não há outro jeito.
O que dá para construir com ele.
Seis coisas que as bibliotecas fazem hoje, cada uma com as peças de que precisa e o que vale observar.
Um chat sem servidor
Dois peers, um topic, uma linha direta e criptografada.
Seus dispositivos, sincronizados
Um log assinado por dispositivo, puxado pelos outros.
Um armazenamento chave-valor que viaja
Um único escritor, quantos leitores conferidos você quiser.
Local primeiro, sincroniza depois
Escreva sem conexão, atualize quando os peers se encontrarem.
Peers atrás do roteador de casa
Pelo NAT quando dá, o seu próprio relay quando não.
Seu próprio nó de bootstrap
O endereço por onde os peers novos entram, numa máquina sua.
Leia, rode, mude.
Cada biblioteca é de código aberto, sob a licença MIT ou Apache-2.0 (à sua escolha), e se baseia em padrões abertos. Nada prende o seu app a nós.
- LicençaMIT ou Apache-2.0, em todos os repositórios.
- PadrõesRFC 9162 para o log, RFC 8032 para as assinaturas, QUIC e TLS 1.3 na rede.
- Seus servidoresRode o seu próprio nó de bootstrap e o seu próprio relay.
Entre em um topic em poucas linhas.
Uma função inicia um swarm, faz o bootstrap com os nós que você passa e entra em um topic. Depois imprime o início da chave pública de cada peer que se conecta.
- Linha 04Inicie um swarm com a sua identidade.
- Linha 09Faça o bootstrap com os nós que você escolher.
- Linha 15Anuncie o topic e procure os peers dele.
- Linha 19Leia cada conexão nova como um evento.
- Go
func join(
ctx context.Context, id *koloid.Identity, nodes []netip.AddrPort,
) error {
sw, err := koloswarm.New(ctx, "127.0.0.1:0", id, nil)
if err != nil {
return err
}
defer sw.Close()
if err := sw.Bootstrap(ctx, nodes); err != nil {
return err
}
topic := koloswarm.Topic(sha256.Sum256([]byte("my first topic")))
opts := &koloswarm.JoinOptions{Announce: true, Lookup: true}
if err := sw.Join(ctx, topic, opts); err != nil {
return err
}
for {
ev, err := sw.Next(ctx)
if err != nil {
return err
}
if ev.Kind == koloswarm.Connected {
fmt.Printf("connected to %x\n", ev.Peer.PublicKey()[:8])
}
}
}
Versão 0.1.0, beta e experimental. Sem rodeios.
A API ainda pode mudar antes da 1.0. Cada limite está escrito na documentação, e a exclusão é só de melhor esforço, porque um peer que já tem os seus dados fica com o que tem.
O modelo de segurança está documentado. Leia antes de confiar nele.