Stack peer-to-peer, en Go

De la mano, peer-to-peer, sin nadie en medio.

Bibliotecas en Go para crear apps peer-to-peer. Los peers se encuentran, se conectan directamente y mantienen un log firmado, sin ningún servidor en medio.

v0.1.0 beta · Go 1.26+ · basado en RFC 9162 y RFC 8032

a3f97c21e08d5b4anadieen medio
El stack

Bibliotecas pequeñas, en tres capas.

Cada una hace una sola cosa y tiene su propia documentación. Usa una, o úsalas todas.

Datos

Claves, codificación, un log firmado, y las piezas que lo guardan, lo leen y lo copian.

Red

Encontrar peers por topic, invitarlos a un grupo, hablar con ellos por un canal cifrado y enviar tracks en vivo de datos o de medios.

Servidores que tú ejecutas

El nodo bootstrap de una red propia, y un peer de anclaje que mantiene disponibles los logs cifrados. En tus máquinas, no en las nuestras. Por defecto los ejemplos usan los nodos de entrada públicos que ejecuta Ciranda.

Ver todas las bibliotecas
Por qué Kolo

Cuatro cosas que no vamos a negociar.

Lo de siempre
servidorapagadoservidor

Cada mensaje pasa por una máquina que alguien mantiene, paga y puede apagar.

Con Kolo
aquí no hay nadase fue

Los peers hablan entre sí directamente. Si uno se va, los demás siguen.

  • En lugar de un backend en el camino

    Sin servidor en medio

    Los peers se encuentran y se conectan directamente. Ninguna máquina nuestra transporta tus datos, y con tu propio nodo bootstrap ninguna nuestra tiene que seguir encendida.

  • En lugar de fiarte de quien lo guarda

    Cada entrada va firmada

    Cada entrada del log lleva la firma de quien la escribió. Cualquiera puede comprobarla, y nadie puede cambiarla sin que se note.

  • En lugar de un log que nunca olvida

    Borrar significa algo

    Una marca de borrado pide a las réplicas que descarten los datos. El borrado es de mejor esfuerzo, y la documentación lo deja claro.

  • En lugar de un relay siempre encendido

    Un relay solo si lo pides

    Cuando dos peers no se alcanzan, un relay puede ayudar. Está desactivado hasta que lo actives.

Cómo funciona

Sin servidor por el camino.

  1. Encontrar

    Los peers anuncian un topic y lo buscan en una tabla distribuida. Sin servidor de directorio.

    kolo-dht · kolo-swarm

  2. Conectar

    Abren un canal directo y cifrado. Un relay entra solo cuando no hay otra forma.

    kolo-transport · kolo-secure

  3. Compartir

    Mantienen un log firmado y se lo copian entre sí. Cada entrada se puede comprobar.

    kolo-log · kolo-sync · kolo-kv

Cómo funciona, a fondo
Casos de uso

Lo que puedes construir con él.

Seis cosas que las bibliotecas hacen hoy, cada una con las piezas que necesita y lo que conviene vigilar.

Todos los casos de uso
Código abierto

Léelo, ejecútalo, cámbialo.

Cada biblioteca es de código abierto, con licencia MIT o Apache-2.0 (a tu elección), y se basa en estándares abiertos. Nada ata tu app a nosotros.

Más sobre la licencia
Primeros pasos

Ú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
Dónde estamos

Versión 0.1.0, beta y experimental. Sin rodeos.

La API aún puede cambiar antes de la 1.0. Cada límite está escrito en la documentación, y el borrado es de mejor esfuerzo, porque un peer que ya tiene tus datos se queda con lo que tiene.

El modelo de seguridad está documentado. Léelo antes de confiar en él.