kolo docsbeta

Peers

Un peer es una clave Ed25519. Dos peers son el mismo peer cuando sus claves públicas son iguales.

En esta página

Un peer es un programa que tiene una identidad de kolo-id: un par de claves Ed25519. No hay nombres de usuario ni cuentas. La clave pública es el nombre del peer en la red, y todas las demás bibliotecas se refieren a un peer por ella.

La clave

  • koloid.Generate crea una identidad nueva. Save y SaveNew la escriben en un archivo y Load la vuelve a leer, así que un peer conserva la misma clave entre reinicios.
  • El archivo de clave solo guarda la semilla de 32 bytes, escrita con el modo 0600.
  • PublicKey devuelve la clave pública de 32 bytes, y PublicKeyString la misma clave en hexadecimal. Al imprimir un *Identity solo se muestra la clave pública; la semilla no aparece nunca en ninguna salida.

Qué significa «igual»

Dos peers son el mismo peer cuando sus claves públicas son iguales, byte a byte: a.PublicKey().Equal(b.PublicKey()). Las direcciones no cuentan. Un peer puede cambiar su dirección IP y su puerto y seguir siendo el mismo peer, y dos peers detrás de una misma dirección siguen siendo dos peers.

Los programas suelen mostrar los primeros bytes de una clave como etiqueta corta, como hace el chat de Primeros pasos. Esa etiqueta es para que la lean las personas. No la uses nunca para decidir quién es alguien: compara la clave entera.

Cómo demuestra un peer su clave

  • Una firma de Sign indica una cadena de contexto, como kolo-log/record/v1, y solo se verifica con ese contexto, así que una firma hecha para un tipo de mensaje nunca se acepta como otro.
  • Una conexión de kolo-secure es TLS 1.3 ligado a las claves de los dos peers. Al abrirse, cada lado conoce la clave pública del otro, y quien llama pidiendo una clave concreta recibe esa clave o un error.

Una persona, varios dispositivos

Un peer es una clave de dispositivo. Una persona que usa varios dispositivos tiene una clave en cada uno, y kolo-id puede unirlas a una sola persona:

  • Una frase de recuperación de 24 palabras (BIP-39) da la clave de la persona. La biblioteca nunca la guarda ni la imprime.
  • La clave de la persona certifica dispositivos aprobadores, y un aprobador certifica dispositivos comunes, así que la clave de la persona nunca vive en un dispositivo. Cada dispositivo guarda su propia clave aleatoria y su certificado, en un archivo .cert junto al archivo de clave.
  • VerifyDevice comprueba un mensaje de un dispositivo para la persona que esperas. Un dispositivo perdido se revoca sin perder la identidad.

Consulta Frase de recuperación y dispositivos. kolo-invite vincula un dispositivo nuevo por invitación, y el paquete devices de kolo-braid guarda los dispositivos de una persona en un grupo.

Conviene saber