# Arquitectura

La arquitectura de OmniYield está diseñada para ser modular, agnóstica a la cadena y altamente escalable.

Nuestro objetivo principal es crear una capa de rendimiento agnóstica a la cadena que maximice los rendimientos ajustados al riesgo para los usuarios en DeFi. Para lograrlo, el sistema emplea un análisis exhaustivo de datos, algoritmos avanzados fuera de la cadena, protocolos de seguridad estrictos, reglas de diversificación y una arquitectura que abstrae la complejidad de la interacción entre cadenas.

### Componentes arquitectónicos clave

<details>

<summary><strong>Cajas fuertes</strong></summary>

La puerta de entrada del usuario a OmniYield.

Estos contratos inteligentes compatibles con ERC-4626 gestionan de forma segura los depósitos, reciben informes de las estrategias y procesan las retiradas.

Sirven como la interfaz principal que coordina los fondos del usuario con las estrategias subyacentes.

</details>

<details>

<summary><strong>Capa de ejecución (Solver)</strong></summary>

La capa de inteligencia de OmniYield.

Estos sistemas automatizados analizan constantemente protocolos DeFi en distintas cadenas, identifican oportunidades óptimas de rendimiento, evalúan riesgos y dictan la asignación de activos para las cajas fuertes.

Este procesamiento se calcula fuera de la cadena por eficiencia; solo los resultados se implementan en la cadena, evitando que las estrategias de OmniYield puedan ser imitadas.

</details>

<details>

<summary><strong>Estrategias</strong></summary>

Vinculado a cada caja fuerte hay al menos un contrato de estrategia.

Este componente traduce las decisiones del solver en acciones. Maneja las complejidades técnicas del movimiento de activos, incluidos intercambios de tokens, provisión de liquidez, préstamos, staking, etc.

</details>

<details>

<summary><strong>Destinos</strong></summary>

Los protocolos DeFi específicos, pools de liquidez o granjas de rendimiento donde finalmente se despliegan los activos de la caja fuerte.

</details>

<details>

<summary><strong>Infraestructura de mensajería entre cadenas</strong></summary>

La tecnología fundamental que habilita las capacidades entre cadenas, facilitando la comunicación y las transferencias de activos entre diferentes blockchains.

</details>

### El ciclo de vida de los activos

Comprender el flujo de los activos ayuda a aclarar el funcionamiento del sistema:

{% stepper %}
{% step %}
**Depósito**

Un usuario deposita un solo tipo de activo (por ejemplo, USDC) en la caja fuerte correspondiente de OmniYield en cualquier cadena compatible. Los activos depositados se transfieren al contrato de la caja fuerte en el hub de Arbitrum y, inicialmente, permanecen inactivos allí.
{% endstep %}

{% step %}
**Reequilibrio entre cadenas**

* El componente fuera de la cadena (Solver autónomo) supervisa los saldos de la caja fuerte y las condiciones del mercado. Una vez que se alcanza un cierto umbral de activos inactivos, o durante ciclos periódicos de optimización, determina la asignación óptima para las estrategias actuales en las cadenas integradas y propone un plan de reequilibrio. Si la propuesta cumple con los criterios de seguridad y rendimiento, inicia un reequilibrio (por ejemplo, mover X cantidad de USDC a la Estrategia A en la Cadena Y) a través del contrato de la caja fuerte en el hub de Arbitrum.&#x20;
* Usando LayerZero y Axelar, se envía un mensaje que contiene instrucciones de reequilibrio desde el hub al contrato de caja fuerte correspondiente en las cadenas de destino.
* El sistema ejecuta los pasos necesarios (como puenteo, intercambio, depósito, etc.) para reequilibrar.
* La asignación actualizada se registra, y las confirmaciones/actualizaciones de estado se envían de vuelta al hub de Arbitrum a través de la capa de mensajería. Este proceso puede implicar mover fondos inactivos desde el hub hacia una estrategia o desplazar fondos entre diferentes estrategias para perseguir mejores rendimientos.
  {% endstep %}

{% step %}
**Auto-compound y reporte consolidado**

* Los contratos de estrategia reclaman periódicamente las recompensas obtenidas de los protocolos de destino, las convierten al activo base de la caja fuerte (por ejemplo, USDC) y las reinvierten automáticamente. Este proceso está orquestado por Guardianes con permisos.&#x20;
* Los datos de rendimiento, incluidas las recompensas generadas por estas estrategias en todas las cadenas compatibles, se reportan continuamente de vuelta al hub de Arbitrum. Las recompensas se añaden al valor total de la caja fuerte, capitalizando automáticamente los rendimientos para los depositantes.
  {% endstep %}

{% step %}
**Retirada**

* Las retiradas no se limitan a la cadena de depósito; los usuarios pueden iniciar una solicitud de retirada en cualquier momento desde cualquier cadena compatible (**no tiene que ser la misma cadena utilizada para el depósito**).
* Se calcula una comisión de rendimiento del 9 % basándose en el beneficio generado por el depósito de un usuario a través de todas las estrategias y cadenas subyacentes.
* La solicitud se enruta al hub de Arbitrum. Si la caja fuerte tiene suficientes fondos inactivos (activos no desplegados activamente en estrategias), la retirada se procesa inmediatamente.
* Si la caja fuerte no tiene suficientes fondos inactivos, el hub señala a las estrategias que retiren la cantidad requerida. Prioriza retirar de las estrategias donde el impacto en el rendimiento general (APR) se minimiza. Este proceso puede tardar un poco más dependiendo de los protocolos subyacentes.
  {% endstep %}

{% step %}
**Reclamar**

* Una vez que haya suficiente liquidez disponible en la caja fuerte, el usuario puede reclamar su retirada. Al reclamar, los activos correspondientes se transfieren a la billetera del usuario a través de la infraestructura entre cadenas.
  {% endstep %}
  {% endstepper %}

### Arquitectura entre cadenas

La infraestructura de OmniYield se construye sobre una sólida arquitectura de hub-and-spoke:&#x20;

* **Hub:** Utilizamos Arbitrum como nuestro centro operativo principal (la "cadena principal"). Aquí reside principalmente la lógica central, los cálculos complejos y la gestión general del estado del protocolo OmniYield.
* **Spokes:** Todas las demás blockchains compatibles funcionan como 'cadenas spoke' o 'side chains'. Estas son las redes de las que pueden originarse los depósitos de los usuarios y donde se despliegan muchas de las estrategias de rendimiento subyacentes. Actúan principalmente como puntos finales de ejecución, recibiendo instrucciones desde el Hub.

<figure><img src="https://896082207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcMcq7CdPxVFPVJMUzlcn%2Fuploads%2FBtawLgOlAjrD8wyj0BEj%2Fimage.avif?alt=media&#x26;token=d98a07d3-6b84-4c1b-bab0-3e2c1ed7870d" alt=""><figcaption></figcaption></figure>

#### **Flujo de comunicación:**

{% stepper %}
{% step %}
**Agregación**

Cuando se toma una decisión de reequilibrio o se producen acciones de usuario (como depósitos/retiros que requieren movimiento entre cadenas), se generan mensajes entre cadenas que se transmiten de forma segura desde las cadenas spoke al hub de Arbitrum.
{% endstep %}

{% step %}
**Cálculo**

El Hub procesa estos mensajes entrantes, realiza los cálculos necesarios (como optimizar la asignación de activos entre todos los spokes, calcular el rendimiento general de la caja fuerte, consolidar comisiones) y toma decisiones estratégicas basadas en su visión global del sistema.
{% endstep %}

{% step %}
**Distribución**

Una vez tomadas las decisiones, las instrucciones necesarias y los datos de la transacción se distribuyen de vuelta desde Arbitrum a los contratos inteligentes relevantes en las cadenas spoke para su ejecución (por ejemplo, depositar fondos en una estrategia específica en una red diferente).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Este diseño modular permite:

* **Lógica centralizada, ejecución descentralizada**\
  Este modelo garantiza la consistencia de los datos, ya que el hub de Arbitrum actúa como la única fuente de verdad. El despliegue real de capital ocurre en las cadenas spoke, aprovechando las oportunidades únicas que ofrece cada cadena.
* **Modularidad y extensibilidad**\
  Se pueden integrar nuevas cadenas, activos, estrategias y destinos de forma plug-and-play con cambios mínimos en la base de código existente.\
  Esto garantiza una superficie de ataque reducida al tiempo que facilita el desarrollo de productos adicionales. Para mejorar aún más su robustez y funcionalidad, el Protocolo OmniYield se integra con varios primitivos e infraestructuras DeFi, ofreciendo la mejor experiencia de usuario y permitiendo una interacción fluida con otras herramientas financieras.
  {% endhint %}

### Comunicación entre cadenas

El funcionamiento de nuestro modelo hub-and-spoke a través de numerosas blockchains es posible gracias al uso de los principales proveedores de mensajería entre cadenas: LayerZero y Axelar (y potencialmente otros adaptados a tokens/cadenas/funciones específicos en el futuro).&#x20;

LayerZero permite una mensajería ligera y eficiente, garantizando una latencia mínima y una interoperabilidad sin necesidad de confianza entre las redes compatibles. Axelar complementa esto con un enrutamiento de alto nivel y una entrega segura de mensajes generales entre cadenas.

* **La columna vertebral de la comunicación:** Estos protocolos actúan como la infraestructura de comunicación segura y fiable que conecta nuestro Hub (Arbitrum) con todas las cadenas Spoke. Proporcionan las vías esenciales para transmitir datos e instrucciones a través de las fronteras de blockchain. Todo el reenvío, la validación y la liquidación de mensajes se realiza a través de los canales de mensajería seguros de estos proveedores.
* **Facilitando operaciones clave:** LayerZero y Axelar transmiten mensajes críticos necesarios para las funciones centrales. Esto incluye:
  * Notificar al Hub de nuevos depósitos realizados en las cadenas spoke.
  * Transmitir solicitudes de retiro de usuarios en cadenas spoke al Hub para su procesamiento.
  * Enviar comandos desde el Hub a los contratos de estrategia en las cadenas spoke para ejecutar depósitos, retiros o reequilibrios.
  * Informar del rendimiento generado, métricas de rendimiento y datos de comisiones desde las estrategias en las cadenas spoke de vuelta al Hub.

### Reporte consolidado de comisiones

En las configuraciones multichain típicas, cada cadena suele actuar como un silo con lógica y reporte de rendimiento aislados. OmniYield adopta un enfoque radicalmente diferente. Creemos que nuestro ecosistema debe operar como un único protocolo unificado, no como una colección fragmentada de despliegues específicos por cadena.

Aunque OmniYield genera comisiones a partir de estrategias de rendimiento que operan en numerosas cadenas, el protocolo implementa un reporte consolidado de comisiones, un proceso en el que los datos de generación de comisiones de todas las cadenas compatibles se agregan, normalizan y calculan en Arbitrum (el hub).&#x20;

{% hint style="success" %}
Esto permite:

* **Experiencia de usuario flexible:** Los usuarios no necesitan preocuparse por incentivos inconsistentes. Pueden depositar desde cualquier cadena que prefieran sabiendo que las comisiones, las oportunidades de rendimiento y las recompensas permanecen consistentes en todo el ecosistema de OmniYield.
* **Tokenomics compartidos:** Todas las comisiones del protocolo, independientemente de la cadena de origen, contribuyen al mismo modelo de ingresos global.
* **Métricas transparentes:** Los informes unificados eliminan discrepancias y mejoran la auditabilidad.
  {% endhint %}
