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
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.
Cuatro cosas que no vamos a negociar.
Cada mensaje pasa por una máquina que alguien mantiene, paga y puede apagar.
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.
Sin servidor por el camino.
Encontrar
Los peers anuncian un topic y lo buscan en una tabla distribuida. Sin servidor de directorio.
Conectar
Abren un canal directo y cifrado. Un relay entra solo cuando no hay otra forma.
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.
Un chat sin servidor
Dos peers, un topic, una línea directa y cifrada.
Tus dispositivos, sincronizados
Un log firmado por dispositivo, que los demás traen.
Un almacén clave-valor que viaja
Un solo escritor, tantos lectores comprobados como quieras.
Primero local, sincroniza después
Escribe sin conexión, ponte al día cuando los peers se encuentren.
Peers detrás del router de casa
A través del NAT cuando se puede, tu propio relay cuando no.
Tu propio nodo bootstrap
La dirección por la que entran los peers nuevos, en una máquina tuya.
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.
- LicenciaMIT o Apache-2.0, en todos los repositorios.
- EstándaresRFC 9162 para el log, RFC 8032 para las firmas, QUIC y TLS 1.3 en la red.
- Tus servidoresEjecuta tu propio nodo bootstrap y tu propio relay.
Ú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])
}
}
}
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.