Caso de uso
Um chat sem servidor.
Duas pessoas entram no mesmo topic, se encontram e conversam por uma conexão direta e criptografada. O nó de bootstrap só ajuda a se encontrarem; as mensagens nunca passam por ele.
As peças
As bibliotecas necessárias. Cada uma tem passos de instalação e um exemplo compilado na documentação.
Como funciona na prática
Cada peer recebe uma chave
Um peer é uma chave Ed25519 da kolo-id. A chave pública é o seu nome na rede; não há contas.
Os dois entram em um topic
Um topic são 32 bytes combinados entre eles, como o hash do nome de uma sala. A kolo-swarm o anuncia e o procura por meio de um nó de bootstrap.
Eles conversam direto
A conexão é um canal kolo-secure ligado às duas chaves, então cada lado sabe com qual chave está falando. Cada mensagem viaja no seu próprio stream.
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])
}
}
}
Bom saber
Um topic não é um segredo: quem conhecer os 32 bytes pode entrar. Decida quem pode ler o quê com chaves, não com o topic. Trate o que você recebe como não confiável: o exemplo da documentação limita cada mensagem e descarta os caracteres de controle.