Lograr el ciclo completo de cifrado y descifrado extremo a extremo (E2E) de mensajes DIDComm v2 (anoncrypt) entre dos motores distintos:

• Veramo (@veramo/did-comm, JavaScript)
• didcomm-node (binding WASM del motor de Rust didcomm)

La meta es demostrar que un mensaje cifrado por uno de los motores puede ser descifrado por el otro y viceversa, resolviendo los DIDs contra el resolver real de LACChain (https://dev-identity-resolver.l-net.io).

Se cubren las dos direcciones:

Para la secuencia 1 (cifrar en Veramo → descifrar en didcomm-node) es necesario aplicar un fix en el módulo didcomm.js de Veramo.

El motor didcomm-node valida el campo apv del header protegido (apv = base64url(SHA-256(kid_del_destinatario))). La versión original de @veramo/did-comm ignora el apv que se le pasa por options y no lo escribe en el header, por lo que el mensaje generado por Veramo es rechazado al desempaquetarlo con didcomm-node.

Se modifica @veramo/did-comm/build/didcomm.js para que respete el apv recibido por options y se lo pase al encrypter:

+ if (options.apv) protectedHeader.apv = options.apv;
...
- return a256gcmAnonEncrypterX25519WithA256KW(recipient.publicKeyBytes, recipient.kid);
+ return a256gcmAnonEncrypterX25519WithA256KW(recipient.publicKeyBytes, recipient.kid, options.apv);

El archivo con el fix ya aplicado está versionado en este repositorio en:

fix-veramo-didcom/@veramo/build/didcomm.js

Copiar el archivo corregido sobre el de node_modules (conviene respaldar el original primero):

# Respaldo del original (si no existe ya)
cp node_modules/@veramo/did-comm/build/didcomm.js \
   node_modules/@veramo/did-comm/build/didcomm-ori.js

# Aplicar el fix
cp fix-veramo-didcom/@veramo/build/didcomm.js \
   node_modules/@veramo/did-comm/build/didcomm.js

Nota: node_modules/@veramo/did-comm/build/didcomm-ori.js es el backup del original sin modificar. Como el fix vive en node_modules, debe reaplicarse después de cada npm install.

• Node.js ≥ 20.12 (se usa process.loadEnvFile() nativo para leer el .env, sin dependencias extra). Probado con Node 22.
• Dependencias del proyecto instaladas:

npm install

• Aplicar el fix de Veramo.

Toda la configuración está centralizada en config.mjs, que expone un objeto agrupado por script. Cada valor se lee de una variable de entorno y, si no está definida, usa un valor por defecto (los datos reales de prueba). Por eso los scripts funcionan aunque el .env esté vacío.

• config.mjs — carga ./.env (si existe) y resuelve cada propiedad como process.env.VARIABLE || valor_por_defecto.
• .env — plantilla con todas las variables. Vienen vacías: al no tener valor, se aplican los defaults de config.mjs. Para sobrescribir un valor, asígnalo a la derecha del =.

🔐 Seguridad: el .env puede contener claves privadas. Si las defines, añade .env a tu .gitignore.

Regla general: primero se ejecuta el encrypt-* (genera el archivo) y luego el decrypt-* correspondiente (lo lee).

# 1) Cifrar con Veramo  -> genera msg-encrypted-veramo.json
node encrypt-veramo.mjs

# 2) Descifrar con didcomm-node  <- lee msg-encrypted-veramo.json
node decrypt-didcomm-node.mjs

Salida esperada del paso 2: el mensaje en claro {"content":"Hola mundo lnet"}.

Esta secuencia requiere el fix de Veramo descrito arriba.

# 1) Cifrar con didcomm-node  -> genera msg-encrypted-didcomm-node.json
node encrypt-didcomm-node.mjs

# 2) Descifrar con Veramo  <- lee msg-encrypted-didcomm-node.json
node decrypt-veramo.mjs

Salida esperada del paso 2: packing: anoncrypt y la credencial verificable (ISSUED_VERIFIABLE_CREDENTIAL).

El acoplamiento real entre los módulos es el par DID destinatario ↔ su clave privada X25519:

• La clave pública X25519 publicada on-chain para el destinatario debe derivar de la clave privada configurada en el lado que descifra (x25519.getPublicKey(privada) === x_publicada_en_el_DID).
• Si cambias el destinatario en un encrypt-*, debes tener su clave privada en el decrypt-* correspondiente; de lo contrario el ECDH no cuadra y el desempaquetado falla con "unable to decrypt …".

Los datos de prueba por defecto usan el destinatario did:lac:openprotest:0x3c1a…, cuya clave privada (0x6c3f…) deriva exactamente en su clave pública on-chain, garantizando la compatibilidad E2E en ambas direcciones.