> 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-br/omniyield/arquitetura.md). # Arquitetura A arquitetura da OmniYield foi projetada para ser modular, agnóstica em relação à blockchain e altamente escalável. Nosso objetivo principal é criar uma camada de rendimento agnóstica em relação à blockchain que maximize os retornos ajustados ao risco para os usuários em todo o DeFi. Para isso, o sistema emprega análise de dados extensiva, algoritmos avançados off-chain, protocolos rígidos de segurança, regras de diversificação e uma arquitetura que abstrai a complexidade da interação entre cadeias. ### Componentes Arquitetônicos Principais
Cofres A porta de entrada do usuário para a OmniYield. Esses contratos inteligentes compatíveis com ERC-4626 gerenciam os depósitos com segurança, recebem relatórios das estratégias e processam os saques. Eles servem como a interface principal que coordena os fundos dos usuários com as Estratégias subjacentes.
Camada de Execução (Solver) A camada de inteligência da OmniYield. Esses sistemas automatizados analisam constantemente protocolos DeFi em várias cadeias, identificam as melhores oportunidades de rendimento, avaliam riscos e determinam a alocação de ativos para os Cofres. Esse processamento é calculado off-chain para maior eficiência - apenas os resultados são implementados on-chain, impedindo que as estratégias da OmniYield sejam imitadas.
Estratégias Vinculado a cada Cofre há 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.
Destinos Os protocolos DeFi específicos, pools de liquidez ou farms de rendimento nos quais os ativos do cofre são finalmente alocados.
Infraestrutura de Mensageria Cross-Chain A tecnologia fundamental que viabiliza capacidades cross-chain, facilitando a comunicação e a transferência de ativos entre diferentes blockchains.
### O Ciclo de Vida dos Ativos
Entender o fluxo dos ativos ajuda a esclarecer o funcionamento do sistema: {% stepper %} {% step %} **Depósito** Um usuário deposita um único tipo de ativo (por exemplo, USDC) no Cofre da OmniYield correspondente em qualquer cadeia suportada. Os ativos depositados são movidos para o contrato do Cofre no hub da Arbitrum e inicialmente ficam inativos lá. {% endstep %} {% step %} **Rebalanceamento Cross-Chain** * O componente off-chain (Solver autônomo) monitora os saldos do cofre e as condições de mercado. Assim que um determinado limite de ativos ociosos é alcançado, 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, ele inicia um rebalanceamento (por exemplo, movendo X quantidade de USDC para a Estratégia A na Cadeia Y) por meio do contrato do Cofre no hub da Arbitrum. * Usando LayerZero e Axelar, uma mensagem contendo instruções de rebalanceamento é enviada do hub para o contrato do Cofre relevante nas cadeias-alvo. * O sistema executa as etapas necessárias (como fazer bridge, trocar, depositar etc.) para rebalancear. * A alocação atualizada é registrada, e atualizações de confirmação/status são enviadas de volta ao hub da Arbitrum por meio da 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 %} **Capitalização Automática e Relatórios Consolidados** * Os contratos de Estratégia periodicamente reivindicam as recompensas obtidas dos protocolos de destino, convertendo-as no ativo base do cofre (por exemplo, USDC) e reinvestindo automaticamente. Esse processo é orquestrado por Keepers autorizados. * Os dados de desempenho, incluindo as recompensas geradas por essas Estratégias em todas as cadeias suportadas, são continuamente reportados de volta ao hub da Arbitrum. As recompensas são adicionadas ao valor total do cofre, 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 pelo depósito de um usuário em todas as Estratégias e cadeias subjacentes. * A solicitação é roteada para o hub da Arbitrum. Se o Cofre tiver fundos ociosos suficientes (ativos não alocados ativamente em Estratégias), o saque é processado imediatamente. * Se o Cofre não tiver fundos ociosos suficientes, o hub sinaliza às Estratégias para retirar o valor necessário. Ele prioriza retiradas das Estratégias em que o impacto no rendimento geral (APR) é minimizado. Esse processo pode levar um pouco mais de tempo dependendo dos protocolos subjacentes. {% endstep %} {% step %} **Resgatar** * Assim que houver liquidez suficiente disponível no Cofre, o usuário pode resgatar seu saque. Ao resgatar, os ativos correspondentes são transferidos para a carteira do usuário por meio da infraestrutura cross-chain. {% endstep %} {% endstepper %} ### Arquitetura Cross-Chain A infraestrutura da OmniYield é construída sobre uma arquitetura robusta hub-and-spoke: * **Hub:** Utilizamos a Arbitrum como nosso hub operacional central (a "main chain"). É aqui que a lógica principal, os cálculos complexos e o gerenciamento geral do estado do protocolo OmniYield residem predominantemente. * **Cadeias satélite:** Todas as outras blockchains suportadas funcionam como ‘cadeias satélite’ ou ‘side chains. Essas 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 de execução, recebendo instruções do Hub.
#### **Fluxo de Comunicação:** {% stepper %} {% step %} **Agregação** Quando uma decisão de rebalanceamento é tomada ou ações do usuário (como depósitos/saques que exigem movimentação cross-chain) ocorrem, mensagens cross-chain são geradas e transmitidas com segurança das cadeias satélite para o hub da Arbitrum. {% endstep %} {% step %} **Computação** O Hub processa essas mensagens recebidas, realiza os cálculos necessários (como otimizar a alocação de ativos em todas as cadeias satélite, calcular o desempenho geral do cofre, 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 das transações são distribuídos de volta da Arbitrum para os contratos inteligentes relevantes nas cadeias satélite 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**\ Esse modelo garante consistência de dados, já que o hub da Arbitrum atua como a única fonte da verdade. A alocação real de capital ocorre nas cadeias satélite, aproveitando as oportunidades exclusivas 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 Protocolo OmniYield se integra a vários primitivos e infraestruturas DeFi, oferecendo a melhor experiência ao usuário e permitindo uma interação perfeita com outras ferramentas financeiras. {% endhint %} ### Comunicação Cross-Chain A operação do nosso modelo hub-and-spoke em diversas blockchains é possível graças ao uso dos principais provedores de mensageria cross-chain: LayerZero e Axelar (e potencialmente outros, adaptados a tokens/cadeias/funções específicos no futuro). O LayerZero permite uma mensageria leve e eficiente, 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 cross-chain generalizadas. * **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 Satélite. Eles fornecem os caminhos essenciais para transmitir dados e instruções entre os limites das blockchains. Todo o encaminhamento, validação e liquidação de mensagens é realizado por meio das vias de mensageria seguras desses provedores. * **Facilitando Operações-Chave:** O LayerZero e o Axelar transmitem mensagens críticas necessárias para funções centrais. Isso inclui: * Notificar o Hub sobre novos depósitos feitos nas cadeias satélite. * Transmitir solicitações de saque dos usuários nas cadeias satélite para o Hub para processamento. * Enviar comandos do Hub para contratos de estratégia nas cadeias satélite para executar depósitos, saques ou rebalanceamentos. * Reportar o rendimento gerado, métricas de desempenho e dados de taxas das estratégias nas cadeias satélite de volta para o Hub. ### Relatórios Consolidados 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 várias 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 na Arbitrum (o hub). {% hint style="success" %} Isso permite: * **Experiência de usuário flexível:** Os usuários não precisam se preocupar com incentivos inconsistentes. Eles podem depositar a partir de qualquer cadeia que preferirem, sabendo que taxas, oportunidades de rendimento e recompensas permanecem consistentes em todo o ecossistema OmniYield. * **Tokenomics compartilhadas:** 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 %}