# Arquitetura

A arquitetura da OmniYield foi projetada para ser modular, agnóstica à cadeia e altamente escalável.

Nosso principal objetivo é criar uma camada de rendimento agnóstica à cadeia que maximize os retornos ajustados ao risco para os usuários em todo o DeFi. Para isso, o sistema emprega ampla análise de dados, algoritmos avançados off-chain, protocolos rigorosos de segurança, regras de diversificação e uma arquitetura que abstrai a complexidade da interação entre cadeias.

### Componentes Arquiteturais Principais

<details>

<summary><strong>Vaults</strong></summary>

A porta de entrada do usuário para a OmniYield.

Esses contratos inteligentes compatíveis com ERC-4626 gerenciam com segurança os depósitos, recebem relatórios das estratégias e processam saques.

Eles servem como a interface principal que coordena os fundos do usuário com as Estratégias subjacentes.

</details>

<details>

<summary><strong>Camada de Execução (Solver)</strong></summary>

A camada de inteligência da OmniYield.

Esses sistemas automatizados analisam continuamente protocolos DeFi em várias cadeias, identificam oportunidades ideais de rendimento, avaliam riscos e determinam a alocação de ativos para os Vaults.

Esse processamento é realizado off-chain por eficiência — apenas os resultados são implementados onchain, impedindo que as estratégias da OmniYield sejam imitadas.

</details>

<details>

<summary><strong>Estratégias</strong></summary>

Associado a cada Vault está pelo menos um contrato de Estratégia.

Este componente traduz as decisões do solver em ações. Ele lida com as complexidades técnicas da movimentação de ativos, incluindo trocas de tokens, provisão de liquidez, empréstimos, staking, etc.

</details>

<details>

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

Os protocolos DeFi específicos, pools de liquidez ou farms de rendimento onde os ativos do vault são finalmente alocados.

</details>

<details>

<summary><strong>Infraestrutura de Mensageria Entre Cadeias</strong></summary>

A tecnologia fundamental que habilita capacidades entre cadeias, facilitando a comunicação e as transferências de ativos entre diferentes blockchains.

</details>

### O Ciclo de Vida dos Ativos

Entender o fluxo dos ativos ajuda a esclarecer a operação do sistema:

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

Um usuário deposita um único tipo de ativo (por exemplo, USDC) no Vault OmniYield correspondente em qualquer cadeia suportada. Os ativos depositados são movidos para o contrato do Vault no hub Arbitrum e inicialmente ficam parados lá.
{% endstep %}

{% step %}
**Rebalanceamento Entre Cadeias**

* O componente off-chain (Solver autônomo) monitora os saldos dos vaults e as condições de mercado. Quando um certo limite de ativos ociosos é atingido, ou durante ciclos periódicos de otimização, ele determina a alocação ideal para as Estratégias atuais em todas as cadeias integradas e propõe um plano de rebalanceamento. Se a proposta atender aos critérios de segurança e desempenho, inicia um rebalanceamento (por exemplo, movendo X quantidade de USDC para a Estratégia A na Cadeia Y) por meio do contrato do Vault no hub Arbitrum.&#x20;
* Usando LayerZero e Axelar, uma mensagem contendo instruções de rebalanceamento é enviada do hub para o contrato do Vault relevante nas cadeias de destino.
* O sistema executa as etapas necessárias (como ponte, troca, depósito, etc.) para rebalancear.
* A alocação atualizada é registrada, e atualizações de confirmação/status são enviadas de volta ao hub Arbitrum via a camada de mensageria. Esse processo pode envolver mover fundos ociosos do hub para uma Estratégia ou transferir fundos entre diferentes Estratégias para buscar melhores rendimentos.
  {% endstep %}

{% step %}
**Auto-Compounding e Relatórios Consolidados**

* Os contratos de Estratégia reivindicam periodicamente as recompensas obtidas dos protocolos de destino, convertem-nas no ativo base do vault (por exemplo, USDC) e as reinvestem automaticamente. Esse processo é orquestrado por Keepers autorizados.&#x20;
* Os dados de desempenho, incluindo recompensas geradas por essas Estratégias em todas as cadeias suportadas, são continuamente reportados de volta ao hub Arbitrum. As recompensas são adicionadas ao valor total do vault, capitalizando automaticamente os retornos para os depositantes.
  {% endstep %}

{% step %}
**Saque**

* Os saques não se limitam à cadeia do depósito; os usuários podem iniciar uma solicitação de saque a qualquer momento a partir de qualquer cadeia suportada (**não precisa ser a mesma cadeia usada para o depósito**).
* Uma taxa de performance de 9% é calculada com base no lucro gerado por um depósito do usuário em todas as Estratégias e cadeias subjacentes.
* A solicitação é encaminhada para o hub Arbitrum. Se o Vault tiver fundos ociosos suficientes (ativos não alocados ativamente em Estratégias), o saque é processado imediatamente.
* Se o Vault não tiver fundos ociosos suficientes, o hub sinaliza às Estratégias para retirar o valor necessário. Ele prioriza a retirada de Estratégias onde o impacto no rendimento total (APR) é minimizado. Esse processo pode demorar um pouco mais dependendo dos protocolos subjacentes.
  {% endstep %}

{% step %}
**Reivindicar**

* Assim que houver liquidez suficiente no Vault, o usuário pode reivindicar o saque. Ao reivindicar, os ativos correspondentes são transferidos para a carteira do usuário por meio da infraestrutura entre cadeias.
  {% endstep %}
  {% endstepper %}

### Arquitetura Entre Cadeias

A infraestrutura da OmniYield é construída sobre uma robusta arquitetura hub-and-spoke:&#x20;

* **Hub:** Utilizamos o Arbitrum como nosso hub operacional central (a "cadeia principal"). É aqui que a lógica central, os cálculos complexos e a gestão geral do estado do protocolo OmniYield residem principalmente.
* **Spokes:** Todas as outras blockchains suportadas funcionam como ‘cadeias spoke’ ou ‘cadeias laterais’. São as redes onde os depósitos dos usuários podem se originar e onde muitas das Estratégias de rendimento subjacentes são implantadas. Elas atuam principalmente como pontos finais de execução, recebendo instruções do Hub.

<figure><img src="https://2406595562-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>

#### **Fluxo de Comunicação:**

{% stepper %}
{% step %}
**Agregação**

Quando uma decisão de rebalanceamento é tomada ou ocorrem ações do usuário (como depósitos/saques que exigem movimentação entre cadeias), mensagens entre cadeias são geradas e transmitidas com segurança das cadeias spoke para o hub Arbitrum.
{% endstep %}

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

O Hub processa essas mensagens recebidas, realiza os cálculos necessários (como otimizar a alocação de ativos em todos os spokes, calcular o desempenho geral do vault, consolidar taxas) e toma decisões estratégicas com base em sua visão global do sistema.
{% endstep %}

{% step %}
**Distribuição**

Uma vez tomadas as decisões, as instruções necessárias e os dados da transação são distribuídos de volta do Arbitrum para os contratos inteligentes relevantes nas cadeias spoke para execução (por exemplo, depositar fundos em uma Estratégia específica em uma rede diferente).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Este design modular permite:

* **Lógica centralizada, execução descentralizada**\
  Este modelo garante a consistência dos dados, pois o hub Arbitrum atua como a única fonte de verdade. A alocação real de capital ocorre nas cadeias spoke, aproveitando as oportunidades únicas que cada cadeia oferece.
* **Modularidade e extensibilidade**\
  Novas cadeias, ativos, estratégias e destinos podem ser integrados de forma plug-and-play com mudanças mínimas na base de código existente.\
  Isso garante uma superfície de ataque reduzida ao mesmo tempo em que facilita o desenvolvimento de produtos adicionais. Para aprimorar ainda mais sua robustez e funcionalidade, o OmniYield Protocol integra-se com vários primitivos e infraestruturas DeFi, proporcionando a melhor experiência ao usuário e permitindo uma interação perfeita com outras ferramentas financeiras.
  {% endhint %}

### Comunicação Entre Cadeias

A operação do nosso modelo hub-and-spoke em numerosas blockchains é possibilitada pelo uso dos principais provedores de mensageria entre cadeias: LayerZero e Axelar (e potencialmente outros adaptados a tokens/cadeias/funções específicos no futuro).&#x20;

O LayerZero permite mensagens leves e eficientes, garantindo latência mínima e interoperabilidade sem confiança entre as redes suportadas. O Axelar complementa isso com roteamento de alto nível e entrega segura de mensagens generalizadas entre cadeias.

* **A Espinha Dorsal da Comunicação:** Esses protocolos atuam como a infraestrutura de comunicação segura e confiável que conecta nosso Hub (Arbitrum) a todas as cadeias Spoke. Eles fornecem os caminhos essenciais para a transmissão de dados e instruções entre fronteiras de blockchain. Todo o encaminhamento, validação e liquidação de mensagens é realizado por meio das rotas seguras de mensageria desses provedores.
* **Facilitando Operações-Chave:** LayerZero e Axelar transmitem mensagens críticas necessárias para as funções centrais. Isso inclui:
  * Notificar o Hub sobre novos depósitos realizados nas cadeias spoke.
  * Encaminhar solicitações de saque de usuários nas cadeias spoke para o Hub para processamento.
  * Enviar comandos do Hub para contratos de estratégia nas cadeias spoke para executar depósitos, saques ou rebalanceamentos.
  * Reportar o rendimento gerado, métricas de desempenho e dados de taxas das estratégias nas cadeias spoke de volta ao Hub.

### Relato Consolidado de Taxas

Em configurações multichain típicas, cada cadeia frequentemente atua como um silo com lógica e relatórios de desempenho isolados. A OmniYield adota uma abordagem radicalmente diferente. Acreditamos que nosso ecossistema deve operar como um único protocolo unificado, e não como uma coleção fragmentada de implantações específicas por cadeia.

Embora a OmniYield gere taxas a partir de estratégias de rendimento operando em numerosas cadeias, o protocolo implementa relatórios consolidados de taxas, um processo no qual os dados de geração de taxas de todas as cadeias suportadas são agregados, normalizados e calculados no Arbitrum (o hub).&#x20;

{% hint style="success" %}
Isso possibilita:

* **Experiência do usuário flexível:** Os usuários não precisam se preocupar com incentivos inconsistentes. Eles podem depositar a partir de qualquer cadeia de sua preferência, sabendo que taxas, oportunidades de rendimento e recompensas permanecem consistentes em todo o ecossistema OmniYield.
* **Tokenomics compartilhada:** Todas as taxas do protocolo, independentemente da cadeia de origem, contribuem para o mesmo modelo global de receita.
* **Métricas transparentes:** Relatórios unificados eliminam discrepâncias e melhoram a auditabilidade.
  {% endhint %}