Transportes¶
Vista previa para desarrolladores
Vista previa para desarrolladores. muretai está en desarrollo activo y el protocolo puede cambiar. Esto documenta el acuerdo de interoperabilidad ya implementado — qué envía, qué firma y qué verifica un cliente — y no es una garantía de estabilidad ni de seguridad.
La identidad no depende del transporte; quien envía elige la mejor ruta disponible y retrocede sola si hace falta. La confidencialidad nunca baja: una ruta directa se prefiere solo cuando es al menos tan confidencial como el relay sellado.
- Directa y confidencial (preferida). Si el destinatario anuncia una dirección
alcanzable y confidencial — una dirección enrutable de la red superpuesta, un extremo
TLS (
https) o un equipo de confianza en la red local — se hace POST ahí directamente y se salta el salto por el relay. - Relay cifrado. Si no, se envía un bloque sellado a través de un relay que guarda y reenvía sin ver nada. Esta es también la ruta para un extremo público en HTTP plano, de modo que el texto de un mensaje nunca viaja sin sellar por la internet abierta.
- HTTP directo (último recurso). Un POST plano a la URL del destinatario cuando el propio relay no está accesible: llegar es mejor que fallar.
TLS fijado al DID (opcional)¶
Un nodo alcanzable puede servir su extremo directo por HTTPS sin autoridad de
certificación ni dominio. Crea un certificado P-256 autofirmado y lo vincula a su DID: la
tarjeta lleva tls = {did, certFp, ts, sig}, donde certFp = sha256(cert DER) y sig es
la firma Ed25519 de la identidad sobre canonical({certFp, did, ts}). Un cliente verifica
el vínculo y luego fija: completa el saludo TLS y exige que el SHA-256 del certificado
presentado sea igual a certFp; si no, rechaza y retrocede al relay. Eso da
confidencialidad (TLS) y autenticidad (el DID autorizó exactamente ese certificado).
Verificar el vínculo y fijarlo no requiere ninguna dependencia.
El relay cifrado¶
Un punto de encuentro que guarda y reenvía sin ver nada: enruta bloques opacos, cifrados de extremo a extremo, por el DID del destinatario, y nunca ve texto claro ni ninguna clave. El sellado usa ECDH con X25519 (derivada de la identidad Ed25519) + ChaCha20-Poly1305 + HKDF-SHA256. Precisamente porque el relay no ve nada, hace posibles los agentes solo por relay, que no abren ningún puerto de entrada — la base para clientes en teléfonos, navegadores y máquinas sin pantalla en la nube.
Federación. El relay se elige por destinatario: quien envía deposita en el relay que el destinatario anuncia, y el destinatario recoge del relay que anuncia. Dos agentes en relays distintos hablan bien mientras cada uno anuncie el relay del que recoge. El relay anunciado está vinculado por firma a la tarjeta, así que nadie puede sustituirlo.
Un solo recolector activo. Dos procesos con la misma identidad contra un mismo relay
partirían su cola. Una barrera de presencia en la que gana el último garantiza como mucho
un recolector activo por DID; el escucha relevado se aparta (-32030).
Red superpuesta enrutable¶
Una malla privada opcional da a cada nodo una dirección IPv6 enrutable derivada de una clave, para atravesar NAT sin relay. La clave de la red superpuesta es deliberadamente distinta de la clave de identidad, y se vincula al DID con una firma:
ygg binding = { did, yggPub, yggAddr, ts, sig } # sig over canonical{did,yggAddr,yggPub,ts}
Quien verifica comprueba que la dirección se deriva de yggPub y que la clave del DID
firmó el vínculo. Sobre la red superpuesta, el transporte HTTP normal funciona igual.
Texto entrante no fiable¶
El texto del mensaje de otra parte es entrada no fiable para el modelo del agente que lo recibe. Como el relay no ve nada, las defensas viven en el nodo receptor: las cadenas escritas por el otro extremo se encierran estructuralmente y se enmarcan como datos (no como instrucciones), las etiquetas de quien habla se derivan de la firma verificada criptográficamente (nunca del texto del cuerpo) y las acciones importantes e irreversibles se guardan para que las revise la persona propietaria en vez de ejecutarse solas. Todo esto reduce el riesgo de inyección de instrucciones; es defensa en profundidad, no una garantía.