> 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/pt/omniyield/arquitetura.md).

# Arquitetura

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

O nosso objetivo principal é criar uma camada de rendimento agnóstica à cadeia que maximize os retornos ajustados ao risco para os utilizadores em todo o DeFi. Para alcançar isto, o sistema emprega análise de dados extensa, algoritmos avançados fora da cadeia, protocolos de segurança rigorosos, regras de diversificação e uma arquitetura que abstrai a complexidade da interação entre cadeias.&#x20;

### Componentes Arquitetónicos Principais

<details>

<summary><strong>Cofres</strong></summary>

A porta de entrada do utilizador para a OmniYield.

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

Servem como a interface principal que coordena os fundos dos utilizadores com as Estratégias subjacentes.

</details>

<details>

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

A camada de inteligência da OmniYield.

Estes sistemas automatizados analisam constantemente protocolos DeFi em várias cadeias, identificam oportunidades ótimas de rendimento, avaliam riscos e ditam a alocação de ativos para os Cofres.

Este processamento é computado fora da cadeia para maior 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 Cofre existe pelo menos um contrato de Estratégia.

Este componente traduz as decisões do solver em ações. Trata das 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 cofre são, em última instância, alocados.

</details>

<details>

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

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

</details>

### O Ciclo de Vida dos Ativos

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

Compreender o fluxo dos ativos ajuda a clarificar o funcionamento do sistema:

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

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

{% step %}
**Reequilíbrio Entre Cadeias**

* O componente fora da cadeia (Solver autónomo) monitoriza os saldos dos cofres e as condições de mercado. Assim que é atingido um certo limiar de ativos inativos, ou durante ciclos periódicos de otimização, determina a alocação ótima para as Estratégias atuais nas cadeias integradas e propõe um plano de reequilíbrio. Se a proposta cumprir os requisitos de segurança e desempenho, inicia um reequilíbrio (por exemplo, mover X quantidade de USDC para a Estratégia A na Cadeia Y) através do contrato do Cofre no hub Arbitrum.&#x20;
* Usando LayerZero e Axelar, é enviada do hub para o contrato do Cofre relevante nas cadeias de destino uma mensagem contendo instruções de reequilíbrio.
* O sistema executa os passos necessários (como transferência por ponte, troca, depósito, etc.) para reequilibrar.
* A alocação atualizada é registada, e atualizações de confirmação/estado são enviadas de volta ao hub Arbitrum através da camada de mensagens. Este processo pode envolver mover fundos inativos do hub para uma Estratégia ou transferir fundos entre diferentes Estratégias para procurar rendimentos melhores.
  {% endstep %}

{% step %}
**Autoacumulação e Relatório Consolidado**

* Os contratos de Estratégia reclamam periodicamente as recompensas obtidas dos protocolos de destino, convertidas no ativo base do cofre (por exemplo, USDC) e reinvestidas automaticamente. Este processo é orquestrado por Keepers autorizados.&#x20;
* Os dados de desempenho, incluindo as recompensas geradas por estas 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 cofre, acumulando automaticamente os retornos para os depositantes.
  {% endstep %}

{% step %}
**Levantamento**

* Os levantamentos não estão limitados à cadeia do depósito; os utilizadores podem iniciar um pedido de levantamento a qualquer momento a partir de qualquer cadeia suportada (**não tem de ser a mesma cadeia usada para o depósito**).
* É calculada uma comissão de desempenho de 9% com base no lucro gerado pelo depósito de um utilizador em todas as Estratégias e cadeias subjacentes.
* O pedido é encaminhado para o hub Arbitrum. Se o Cofre tiver fundos inativos suficientes (ativos não ativamente alocados em Estratégias), o levantamento é processado imediatamente.
* Se o Cofre não tiver fundos inativos suficientes, o hub sinaliza às Estratégias para levantarem o montante necessário. Dá prioridade aos levantamentos de Estratégias onde o impacto no rendimento global (APR) é minimizado. Este processo pode demorar um pouco mais, dependendo dos protocolos subjacentes.
  {% endstep %}

{% step %}
**Reclamar**

* Assim que houver liquidez suficiente disponível no Cofre, o utilizador pode reclamar o seu levantamento. Ao reclamar, os ativos correspondentes são transferidos para a carteira do utilizador através da infraestrutura entre cadeias.
  {% endstep %}
  {% endstepper %}

### Arquitetura Entre Cadeias

A infraestrutura da OmniYield assenta numa arquitetura robusta de hub and spoke:&#x20;

* **Hub:** Utilizamos Arbitrum como o nosso hub operacional central (a "main chain"). É aqui que a lógica central, os cálculos complexos e a gestão global do estado do protocolo OmniYield residem principalmente.
* **Spokes:** Todas as outras blockchains suportadas funcionam como 'spoke chains' ou 'side chains'. São as redes de onde podem originar-se os depósitos dos utilizadores e onde muitas das Estratégias de rendimento subjacentes são implementadas. Funcionam principalmente como pontos finais de execução, recebendo instruções do Hub.

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

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

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

Quando é tomada uma decisão de reequilíbrio ou ocorrem ações do utilizador (como depósitos/levantamentos que exigem movimento entre cadeias), são geradas mensagens entre cadeias e transmitidas de forma segura das cadeias spoke para o hub Arbitrum.
{% endstep %}

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

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

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

Uma vez tomadas as decisões, as instruções e os dados de transação necessários são distribuídos de volta do Arbitrum para os contratos inteligentes relevantes nas cadeias spoke para execução (por exemplo, depositar fundos numa Estratégia específica numa 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, uma vez que o hub Arbitrum atua como a única fonte de verdade. A implantaçã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 alterações mínimas na base de código existente.\
  Isto garante uma baixa superfície de ataque, ao mesmo tempo que facilita o desenvolvimento de produtos adicionais. Para reforçar ainda mais a sua robustez e funcionalidade, o OmniYield Protocol integra-se com vários primitivos e infraestruturas DeFi, proporcionando a melhor experiência de utilizador e permitindo uma interação fluida com outras ferramentas financeiras.
  {% endhint %}

### Comunicação Entre Cadeias

A operação do nosso modelo hub and spoke em inúmeras blockchains é possível graças ao aproveitamento dos principais fornecedores de mensagens entre cadeias: LayerZero e Axelar (e potencialmente outros, adaptados a tokens/cadeias/funções específicas no futuro).&#x20;

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

* **A Espinha Dorsal da Comunicação:** Estes protocolos atuam como a infraestrutura de comunicação segura e fiável que liga o nosso Hub (Arbitrum) a todas as cadeias Spoke. Fornecem os caminhos essenciais para transmitir dados e instruções através das fronteiras das blockchains. Todo o reencaminhamento, validação e liquidação de mensagens é realizado através dos canais de mensagens seguros destes fornecedores.
* **Facilitação de Operações-Chave:** LayerZero e Axelar transmitem mensagens críticas necessárias para funções centrais. Isto inclui:
  * Notificar o Hub de novos depósitos efetuados nas cadeias spoke.
  * Encaminhar pedidos de levantamento de utilizadores nas cadeias spoke para o Hub para processamento.
  * Enviar comandos do Hub para os contratos de estratégia nas cadeias spoke para executar depósitos, levantamentos ou reequilíbrios.
  * Reportar o rendimento gerado, métricas de desempenho e dados de taxas das estratégias nas cadeias spoke de volta ao Hub.

### Relatório Consolidado de Taxas

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

Embora a OmniYield gere taxas a partir de estratégias de rendimento que operam em inúmeras cadeias. O protocolo implementa um relatório consolidado 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" %}
Isto permite:

* **Experiência de utilizador flexível:** Os utilizadores não precisam de se preocupar com incentivos inconsistentes. Podem depositar a partir de qualquer cadeia que prefiram, sabendo que as taxas, oportunidades de rendimento e recompensas permanecem consistentes em todo o ecossistema OmniYield.
* **Tokenomics partilhada:** Todas as taxas do protocolo, independentemente da cadeia de origem, contribuem para o mesmo modelo de receita global.
* **Métricas transparentes:** O relatório unificado elimina discrepâncias e melhora a auditabilidade.
  {% endhint %}

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