> For the complete documentation index, see [llms.txt](https://docs.omniyield.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omniyield.finance/es/omniyield/arquitectura.md).

# 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 todo DeFi. Para lograrlo, el sistema emplea un amplio análisis de datos, algoritmos avanzados fuera de la cadena, estrictos protocolos de seguridad, reglas de diversificación y una arquitectura que abstrae la complejidad de la interacción entre cadenas.&#x20;

### Componentes arquitectónicos clave

<details>

<summary><strong>Bóvedas</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 los retiros.

Sirven como la interfaz principal que coordina los fondos de los usuarios 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 determinan la asignación de activos para las bóvedas.

Este procesamiento se calcula fuera de la cadena por eficiencia: solo los resultados se implementan en la cadena, lo que impide que las estrategias de OmniYield sean imitadas.

</details>

<details>

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

Vinculado a cada bóveda 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 swaps 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 bóveda.

</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

<div data-with-frame="true"><figure><img src="/files/2468a2d8064b1a34a0999318e17542bc26b58cbf" alt=""><figcaption></figcaption></figure></div>

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

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

Un usuario deposita un único tipo de activo (por ejemplo, USDC) en la bóveda OmniYield correspondiente en cualquier cadena compatible. Los activos depositados se trasladan al contrato de la bóveda 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 bóveda y las condiciones del mercado. Una vez que se alcanza un determinado 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 requisitos 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 bóveda en el hub de Arbitrum.&#x20;
* Usando LayerZero y Axelar, se envía desde el hub un mensaje con instrucciones de reequilibrio al contrato de la bóveda correspondiente en las cadenas de destino.
* El sistema ejecuta los pasos necesarios (como puente, intercambio, depósito, etc.) para reequilibrar.
* La asignación actualizada se registra y las actualizaciones de confirmación/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 del hub a una estrategia o transferir fondos entre distintas estrategias para buscar mejores rendimientos.
  {% endstep %}

{% step %}
**Auto-compounding e informes consolidados**

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

{% step %}
**Retiro**

* Los retiros no están limitados a la cadena de depósito; los usuarios pueden iniciar una solicitud de retiro en cualquier momento desde cualquier cadena compatible (**no tiene por qué ser la misma cadena utilizada para el depósito**).
* Se calcula una comisión de rendimiento del 9% basada 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 bóveda tiene fondos inactivos suficientes (activos que no están desplegados activamente en estrategias), el retiro se procesa de inmediato.
* Si la bóveda no tiene fondos inactivos suficientes, el hub indica a las estrategias que retiren la cantidad requerida. Prioriza los retiros de las estrategias en las que el impacto sobre el rendimiento global (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 bóveda, el usuario puede reclamar su retiro. Al reclamarlo, los activos correspondientes se transfieren a la cartera 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 hub-and-spoke:&#x20;

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

<div data-with-frame="true"><figure><img src="/files/006fb307cd6e0d24fcacd4cde3ef4c46f86917c6" alt=""><figcaption></figcaption></figure></div>

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

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

Cuando se toma una decisión de reequilibrio o ocurren acciones de usuario (como depósitos/retiros que requieren movimiento entre cadenas), se generan mensajes entre cadenas y se transmiten de forma segura desde las spoke chains 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 en todas las spoke chains, calcular el rendimiento global de la bóveda, consolidar las 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 transacción se distribuyen de nuevo desde Arbitrum a los contratos inteligentes correspondientes en las spoke chains 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 coherencia 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 spoke chains, 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 baja superficie de ataque al mismo tiempo que facilita el desarrollo de productos adicionales. Para mejorar aún más su solidez y funcionalidad, el protocolo OmniYield se integra con diversos primitivos e infraestructuras DeFi, proporcionando la mejor experiencia de usuario y permitiendo una interacción fluida con otras herramientas financieras.
  {% endhint %}

### Comunicación entre cadenas

La operación de nuestro modelo hub-and-spoke en 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 confianza entre las redes compatibles. Axelar complementa esto con enrutamiento de alto nivel y entrega segura de mensajes generalizados entre cadenas.

* **La columna vertebral de la comunicación:** Estos protocolos actúan como la infraestructura de comunicación segura y confiable 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 las blockchains. 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 spoke chains.
  * Transmitir solicitudes de retiro de usuarios en spoke chains al Hub para su procesamiento.
  * Enviar comandos desde el Hub a los contratos de estrategia en spoke chains para ejecutar depósitos, retiros o reequilibrios.
  * Informar del rendimiento generado, las métricas de desempeño y los datos de comisiones desde las estrategias en spoke chains de vuelta al Hub.

### Informe consolidado de comisiones

En las configuraciones multi-cadena típicas, cada cadena suele actuar como un silo con lógica y reportes 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 tienen que preocuparse por incentivos inconsistentes. Pueden depositar desde cualquier cadena que prefieran sabiendo que las comisiones, las oportunidades de rendimiento y las recompensas siguen siendo consistentes en todo el ecosistema de OmniYield.
* **Tokenómica compartida:** Todas las comisiones del protocolo, independientemente de la cadena de origen, contribuyen al mismo modelo global de ingresos.
* **Métricas transparentes:** Los informes unificados eliminan discrepancias y mejoran la auditabilidad.
  {% endhint %}

<div align="right"><figure><img src="/files/156fb60e5b504456fab43974b94058a2dadd23d4" alt="" width="17"><figcaption></figcaption></figure></div>
