Notas de construcción · Descifrado de Medios de WhatsApp y Motor de Streaming CAS

El pipeline de medios de WhatsApp que se quedó sin memoria: Descifrado HKDF Nativo y Streaming CAS

Descifrado Nativo HKDF-SHA256, Almacenamiento Direccionable por Contenido y Streaming por Rangos de Bytes RFC 7233

23 de septiembre de 2026 · rendimiento de medios y streaming · Fundador, Klaros

Status: Resolved. This postmortem is a historical log. The issue discussed below has been fully fixed.

Cuando miles de notas de voz, fotos de productos de alta resolución y facturas PDF fluyen a través de la bandeja de entrada del equipo, las arquitecturas estándar de CRM de WhatsApp colapsan. A continuación se detalla cómo reemplazamos la sobrecarga Base64 WebSocket de Chrome DevTools Protocol con derivación nativa de claves HKDF, Almacenamiento Direccionable por Contenido y streaming por rangos de bytes RFC 7233.

Figura 1: Arquitectura de Descifrado de Medios con Latencia Cero y Streaming CAS de Klaros

1. Criptografía HKDF Nativa: Eliminando Congelamientos de Pestañas en Chrome y Sobrecarga de Memoria

Cuando un cliente envía una nota de voz o una imagen en WhatsApp, el archivo binario no se almacena en los servidores de señalización. En su lugar, se carga en nodos CDN de WhatsApp en mmg.whatsapp.net. El paquete de datos del mensaje contiene únicamente metadatos: la URL cifrada, hashes SHA256 del archivo y una clave mediaKey de 32 bytes.

Para descifrar el contenido de forma nativa sin ejecutar scrapers de navegadores en modo headless, la clave mediaKey de 32 bytes debe expandirse utilizando HKDF-SHA256 (RFC 5869) con un salt nulo de 32 bytes y etiquetas descriptivas UTF-8 específicas para cada tipo:

• Imagen: "WhatsApp Image Keys"
• Video: "WhatsApp Video Keys"
• Audio / Nota de Voz (PTT): "WhatsApp Audio Keys"
• Documento: "WhatsApp Document Keys"

La derivación HKDF genera 112 bytes de material de clave pseudoaleatorio, fragmentados en cuatro claves funcionales:

// src/local-modules/wa-media-decryptor.mjs
import crypto from 'node:crypto';

export function deriveMediaKeys(mediaKey, type = 'image') {
  const infoStr = INFO_MAP[type] || INFO_MAP.image;
  const salt = Buffer.alloc(32, 0);
  const hkdfOutput = crypto.hkdfSync('sha256', mediaKey, salt, Buffer.from(infoStr, 'utf8'), 112);

  return {
    iv: Buffer.from(hkdfOutput.slice(0, 16)),
    cipherKey: Buffer.from(hkdfOutput.slice(16, 48)),
    macKey: Buffer.from(hkdfOutput.slice(48, 80)),
    refKey: Buffer.from(hkdfOutput.slice(80, 112)),
  };
}

export function decryptMediaBuffer(encryptedBlob, mediaKey, type = 'image') {
  const ciphertext = encryptedBlob.subarray(0, encryptedBlob.length - 10);
  const macTrailer = encryptedBlob.subarray(encryptedBlob.length - 10);
  const { iv, cipherKey, macKey } = deriveMediaKeys(mediaKey, type);

  // Validar la integridad del remate HMAC-SHA256 truncado a 10 bytes
  const hmac = crypto.createHmac('sha256', macKey);
  hmac.update(iv);
  hmac.update(ciphertext);
  const computedMac = hmac.digest().subarray(0, 10);

  if (!crypto.timingSafeEqual(computedMac, macTrailer)) {
    throw new Error('Verificación HMAC fallida: contenido corrupto');
  }

  const decipher = crypto.createDecipheriv('aes-256-cbc', cipherKey, iv);
  return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
}

2. Almacenamiento Direccionable por Contenido (CAS) y Matemática de CLS Cero: Deteniendo los Saltos de Diseño de Imágenes

Los archivos descifrados se procesan en el Almacenamiento Direccionable por Contenido (CAS), indexados por los hashes SHA256 del contenido o las claves de mensaje. Los archivos se escriben mediante un patrón de escritura atómica (escribiendo en un archivo .tmp antes de ejecutar un reemplazo atómico con fs.renameSync()) para evitar caídas por bloqueos del sistema de archivos en entornos Windows.

Junto con los archivos binarios, CAS genera archivos auxiliares .meta.json persistentes que almacenan las dimensiones analizadas, las relaciones de aspecto, Thumbhashes de micro-desenfoque y valores de orientación de la etiqueta EXIF 0x0112. Las fotos tomadas en vertical en smartphones se corrigen automáticamente para que nunca se rendericen de lado.

Las relaciones de aspecto precalculadas se inyectan directamente en estilos integrados (aspect-ratio: 1.778), reservando las dimensiones exactas en pantalla antes de que los bytes binarios terminen de cargarse a través de la red. Esto produce una puntuación de Cambio de Diseño Acumulado (CLS) de 0.00 en todas las vistas de la bandeja de entrada del equipo.

Figura 2: Motor de Medios Universal — Modo A (Carrusel Visualizador Lightbox) y Modo B (Selector de Tarjetas del Compositor)

3. Streaming HTTP 206 RFC 7233: Eliminando el Bloqueo de Notas de Voz y la Latencia Audio de 4 Segundos

Los reproductores HTML5 <audio> y <video> requieren respuestas de rango de contenido parcial HTTP 206 Partial Content para buscar, desplazarse y transmitir audio sin descargar archivos completos de 50 MB en memoria. Klaros implementa el análisis completo de rangos RFC 7233 admitiendo bytes=100-499, peticiones abiertas bytes=500- y peticiones de sufijo final (bytes=-500 para la búsqueda de encabezados atom MOOV en archivos MP4).

// src/routes/whatsapp-chats.mjs
const range = parseRangeHeader(req.headers.range, fileSize);

if (range) {
  res.status(206);
  res.setHeader('Content-Range', `bytes ${range.start}-${range.end}/${fileSize}`);
  res.setHeader('Content-Length', range.chunkSize);

  const fileStream = fs.createReadStream(filePath, { start: range.start, end: range.end });
  req.on('close', () => fileStream.destroy()); // Destruir transmisión si el usuario cancela la solicitud a mitad de lectura
  fileStream.pipe(res);
}

4. Modo Privado de Safari y Web Crypto Edge: Previniendo Bloqueos de Almacenamiento IndexedDB

Al ejecutarse en navegadores web o en Edge Workers, las interfaces de almacenamiento local presentan restricciones específicas de cada plataforma. En el modo de navegación privada de Safari, abrir IndexedDB lanza una excepción inatrapable DOMException: UnknownError o QuotaExceededError. Klaros envuelve las llamadas a IndexedDB en un bloque try-catch que recurre automáticamente a una memoria caché LRU MemoryBlobMap en el espacio heap de JavaScript, garantizando cero bloqueos o pantallas en blanco para los clientes.

Además, en entornos Cloudflare Workers V8 donde los módulos nativos en C++ de Node no están disponibles, la derivación de claves utiliza la API estándar Web Crypto (crypto.subtle.importKey y crypto.subtle.deriveBits), ofreciendo una portabilidad universal entre procesos de escritorio en Node.js y trabajadores aislados en el edge.

5. Comparativa Arquitectónica: Klaros frente a Plataformas de WhatsApp Tradicionales

6. Evaluación de Rendimiento Empírico: Puente Scraper frente a Motor CAS Edge

Escrito el 23 de septiembre de 2026. Klaros — Diseñado para recordar su historia. Relacionado: nuestra filosofía, notas de rendimiento, todas las notas de construcción.