> ## Documentation Index
> Fetch the complete documentation index at: https://nekzus-32.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos del Cliente

> Cómo los Nodos Agentes aprovechan la Malla LIOP para descubrimiento y ejecución

En el Logic-Injection-on-Origin Protocol, un "Cliente" es un **Nodo Agente** (Agent Node) o un orquestador de Inteligencia. Mientras el Servidor garantiza una ejecución segura, el Cliente es responsable de descubrir datos, definir intenciones y tejer la lógica que atraviesa la red.

Los Nodos Agentes operan la Malla a través de tres mecanismos: **Descubrimiento (DHT)**, **Handshakes de Elicitación** e **Inyección de Lógica**.

## 1. Descubrimiento de Red (Kademlia DHT)

A diferencia de las arquitecturas tradicionales donde el Cliente debe conocer la IP o el DNS del servidor, los Nodos Agentes en LIOP operan en una topología descentralizada:

<Frame>
  <img className="block dark:hidden w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/client-dht-light.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=6e3df71e8259d079eefbc1d6b5658167" alt="Enrutamiento por Tabla de Hash Distribuida" width="800" height="320" data-path="images/client-dht-light.svg" />

  <img className="hidden dark:block w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/client-dht-dark.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=1c253f1f1d783155f08971a7396baa74" alt="Enrutamiento por Tabla de Hash Distribuida" width="800" height="320" data-path="images/client-dht-dark.svg" />
</Frame>

* **Peer IDs**: Cada nodo genera una identidad Ed25519 al iniciar.
* **Kademlia DHT**: Los nodos forman una Tabla de Hash Distribuida.
* **Consulta por Capacidad**: Para acceder a un recurso (ej., `SQL_Database`), el Agente pregunta al enjambre: *"¿Quién posee esta capacidad?"*.
* **Ruta Optimizada**: El algoritmo DHT calcula la ruta más corta, resolviendo IPs dinámicas detrás de NATs y firewalls sin registros centrales.

## 2. Handshakes de Elicitación y Confianza

La confianza no depende de CAs centralizadas. LIOP emplea un handshake **Zero-Trust** antes de ejecutar lógica:

* **Noise Protocol**: Las conexiones QUIC se cifran usando claves derivadas de la identidad del Agente.
* **PQC (Kyber)**: Las Elicitaciones encapsulan intenciones con ML-KEM-768, protegiendo la comunicación contra futuras amenazas cuánticas (*Harvest Now, Decrypt Later*).

Si se requiere intervención humana, el Nodo de Datos solicita ámbitos de OAuth al Agente/Usuario de forma nativa.

## 3. Inyección de Lógica (El Payload)

Tras establecer la confianza, el Cliente inyecta el binario de ejecución:

<Frame>
  <img className="block dark:hidden w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/sdk-flow-light.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=6ccfdd4e3353a5d451734dec54763597" alt="Flujo E2E TypeScript SDK" width="1000" height="480" data-path="images/sdk-flow-light.svg" />

  <img className="hidden dark:block w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/sdk-flow-dark.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=1eadbc86165658b22468d6e7f95a62de" alt="Flujo E2E TypeScript SDK" width="1000" height="480" data-path="images/sdk-flow-dark.svg" />
</Frame>

1. **Compilación**: El SDK traduce la lógica de alto nivel (JS/Python) en un módulo binario WebAssembly.
2. **GuardianTS**: Inspección heurística del `.wasm` para bloquear escapes del sandbox antes de la emisión.
3. **Sellado (Crypto)**: El payload se cifra con `Kyber768` y `AES-256-GCM`.
4. **Streaming (MeshNode)**: El binario se transmite vía `Yamux` y `Noise` a la malla destino.
5. **Verificación ZK**: El Agente valida el **ZK-Receipt** recibido, garantizando la integridad del cómputo.

## 4. Modelo de Tiempo de Ejecución (Node.js Tier-0)

El SDK está diseñado para manejar límites de seguridad y cifrado intensivo sin bloquear el **Event Loop** principal de Node.js.

<Frame>
  <img className="block dark:hidden w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/animated-sdk-flow-light.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=3a334dad8170517c76b00aa1e9862ea8" alt="Flujo de Runtime Animado SDK" width="800" height="400" data-path="images/animated-sdk-flow-light.svg" />

  <img className="hidden dark:block w-full" src="https://mintcdn.com/nekzus-32/CeoRGheNFctGW1BW/images/animated-sdk-flow-dark.svg?fit=max&auto=format&n=CeoRGheNFctGW1BW&q=85&s=13c07368a47b845590663000ab2e90f9" alt="Flujo de Runtime Animado SDK" width="800" height="400" data-path="images/animated-sdk-flow-dark.svg" />
</Frame>

Componentes clave dentro del `@nekzus/liop`:

#### 1. Agent App

El punto de origen que define el "Intento" y genera la lógica inicial que se empujará a la red.

#### 2. GuardianTS

Primer escudo de defensa. Usa la compilación de V8 como paso heurístico para detectar importaciones ilegales al sistema antes de que el payload llegue al módulo criptográfico.

#### 3. Worker Pool (Piscina)

Para evitar saturar el hilo principal con cálculos matemáticos costosos, LIOP delega el cifrado y descifrado a un pool de hilos nativos.

* **Outbound**: Los hilos cifran el `.wasm` con Kyber y AES en paralelo.
* **Inbound**: Los resultados y recibos ZK se verifican concurrentemente, salvando el hilo principal de Node.js.

#### 4. MeshNode

La interfaz hacia la red descentralizada. Gestiona la puerta de enlace `libp2p`, el túnel `Noise` y la multiplexación `Yamux`, permitiendo cientos de inyecciones simultáneas sobre una sola conexión QUIC/TLS con latencia cero.
