Caso de uso
Un chat sin servidor.
Dos personas se unen al mismo topic, se encuentran y hablan por una conexión directa y cifrada. El nodo bootstrap solo les ayuda a encontrarse; los mensajes nunca pasan por él.
Las piezas
Las bibliotecas que hacen falta. Cada una tiene pasos de instalación y un ejemplo compilado en su documentación.
Cómo va
Cada peer recibe una clave
Un peer es una clave Ed25519 de kolo-id. Su clave pública es su nombre en la red; no hay cuentas.
Los dos se unen a un topic
Un topic son 32 bytes que acuerdan, como el hash del nombre de una sala. kolo-swarm lo anuncia y lo busca a través de un nodo bootstrap.
Hablan directamente
La conexión es un canal kolo-secure ligado a las dos claves, así que cada lado sabe con qué clave está hablando. Cada mensaje viaja en su propio stream.
Únete a un topic en unas pocas líneas.
Una función arranca un swarm, hace el bootstrap con los nodos que le pasas y se une a un topic. Después imprime el inicio de la clave pública de cada peer que se conecta.
- Línea 04Arranca un swarm con tu identidad.
- Línea 09Haz el bootstrap con los nodos que elijas.
- Línea 15Anuncia el topic y busca a sus peers.
- Línea 19Lee cada conexión nueva como un 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])
}
}
}
Conviene saber
Un topic no es un secreto: cualquiera que conozca los 32 bytes puede unirse. Decide quién puede leer qué con claves, no con el topic. Trata lo que recibes como no fiable: el ejemplo de la documentación limita cada mensaje y descarta los caracteres de control.