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

  1. 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.

  2. 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.

  3. 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
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 líneas

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.

Siguiente