Stack peer-to-peer, em Go

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

a3f97c21e08d5b4aninguémno meio
A stack

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.

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.

Ver todas as bibliotecas
Por que Kolo

Quatro coisas que não vamos negociar.

O jeito de sempre
servidordesligadoservidor

Cada mensagem passa por uma máquina que alguém mantém, paga e pode desligar.

Com Kolo
aqui não tem nadasaiu

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.

Como funciona

Sem servidor no caminho.

  1. Encontrar

    Os peers anunciam um topic e o procuram numa tabela distribuída. Sem servidor de diretório.

    kolo-dht · kolo-swarm

  2. Conectar

    Eles abrem um canal direto e criptografado. Um relay entra só quando não há outro jeito.

    kolo-transport · kolo-secure

  3. Compartilhar

    Eles mantêm um log assinado e o copiam entre si. Cada entrada pode ser conferida.

    kolo-log · kolo-sync · kolo-kv

Como funciona, a fundo
Casos de uso

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.

Todos os casos de uso
Código aberto

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.

Mais sobre a licença
Primeiros passos

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
main.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])
        }
    }
}
go get github.com/ciranda-dev/kolo-swarmGo 1.26+ · 27 linhas
Onde estamos

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.