# Architektura

Architektura OmniYield została zaprojektowana tak, aby była modułowa, niezależna od łańcucha i wysoce skalowalna.

Naszym głównym celem jest stworzenie niezależnej od łańcucha warstwy zysków, która maksymalizuje skorygowane o ryzyko stopy zwrotu dla użytkowników w całym DeFi. Aby to osiągnąć, system wykorzystuje szeroką analizę danych, zaawansowane algorytmy off-chain, ścisłe protokoły bezpieczeństwa, zasady dywersyfikacji oraz architekturę, która abstrahuje złożoność interakcji międzyłańcuchowych.

### Kluczowe komponenty architektury

<details>

<summary><strong>Skarbce</strong></summary>

Brama użytkownika do OmniYield.

Te zgodne ze standardem ERC-4626 inteligentne kontrakty bezpiecznie zarządzają wpłatami, otrzymują raporty ze strategii i przetwarzają wypłaty.

Służą jako główny interfejs koordynujący środki użytkowników z bazowymi Strategiami.

</details>

<details>

<summary><strong>Warstwa wykonawcza (Solver)</strong></summary>

Warstwa inteligencji OmniYield.

Te zautomatyzowane systemy nieustannie analizują protokoły DeFi w różnych łańcuchach, identyfikują optymalne możliwości generowania zysków, oceniają ryzyko i określają alokację aktywów dla Skarbców.

To przetwarzanie jest obliczane off-chain dla zwiększenia wydajności — tylko wyniki są wdrażane onchain, co uniemożliwia kopiowanie strategii OmniYield.

</details>

<details>

<summary><strong>Strategie</strong></summary>

Z każdym Skarbcem powiązany jest co najmniej jeden kontrakt Strategii.

Ten komponent przekłada decyzje solwera na działania. Obsługuje techniczne złożoności przemieszczania aktywów, w tym swapy tokenów, zapewnianie płynności, lending, staking itd.

</details>

<details>

<summary><strong>Miejsca docelowe</strong></summary>

Określone protokoły DeFi, pule płynności lub farmy zysków, do których ostatecznie trafiają aktywa skarbca.

</details>

<details>

<summary><strong>Infrastruktura komunikacji międzyłańcuchowej</strong></summary>

Podstawowa technologia umożliwiająca funkcje międzyłańcuchowe, ułatwiająca komunikację i transfer aktywów między różnymi blockchainami.

</details>

### Cykl życia aktywów

Zrozumienie przepływu aktywów pomaga wyjaśnić działanie systemu:

{% stepper %}
{% step %}
**Wpłata**

Użytkownik wpłaca jeden typ aktywa (np. USDC) do odpowiedniego Skarbca OmniYield na dowolnym obsługiwanym łańcuchu. Wpłacone aktywa są przenoszone do kontraktu Skarbca na hubie Arbitrum i początkowo pozostają tam nieaktywne.
{% endstep %}

{% step %}
**Rebalansowanie międzyłańcuchowe**

* Komponent off-chain (autonomiczny Solver) monitoruje salda skarbców i warunki rynkowe. Gdy zostanie osiągnięty określony próg nieaktywnych aktywów lub podczas okresowych cykli optymalizacji, określa optymalną alokację dla bieżących Strategii w zintegrowanych łańcuchach i proponuje plan rebalansowania. Jeśli propozycja spełnia wymagania bezpieczeństwa i wydajności, inicjuje rebalansowanie (np. przeniesienie X ilości USDC do Strategii A na łańcuchu Y) za pośrednictwem kontraktu Skarbca na hubie Arbitrum.&#x20;
* Korzystając z LayerZero i Axelar, wiadomość zawierająca instrukcje rebalansowania jest wysyłana z huba do odpowiedniego kontraktu Skarbca na docelowych łańcuchach.
* System wykonuje niezbędne kroki (takie jak mostkowanie, swap, wpłata itd.), aby przeprowadzić rebalansowanie.
* Zaktualizowana alokacja jest zapisywana, a potwierdzenia/aktualizacje statusu są odsyłane z powrotem do huba Arbitrum za pośrednictwem warstwy komunikacyjnej. Proces ten może obejmować przenoszenie nieaktywnych środków z huba do Strategii lub przesuwanie środków między różnymi Strategiami w celu uzyskania lepszych zysków.
  {% endstep %}

{% step %}
**Automatyczne kapitalizowanie zysków i skonsolidowane raportowanie**

* Kontrakty Strategii okresowo pobierają wypracowane nagrody z protokołów docelowych, zamieniają je na bazowe aktywo skarbca (np. USDC) i automatycznie reinwestują. Proces ten jest koordynowany przez uprawnionych Keeperów.&#x20;
* Dane o wynikach, w tym nagrody generowane przez te Strategie na wszystkich obsługiwanych łańcuchach, są stale raportowane z powrotem do huba Arbitrum. Nagrody są dodawane do całkowitej wartości skarbca, automatycznie kapitalizując zwroty dla deponentów.
  {% endstep %}

{% step %}
**Wypłata**

* Wypłaty nie są ograniczone do łańcucha wpłaty; użytkownicy mogą zainicjować żądanie wypłaty w dowolnym momencie z dowolnego obsługiwanego łańcucha (**nie musi to być ten sam łańcuch, który został użyty do wpłaty**).
* Opłata za wyniki w wysokości 9% jest obliczana na podstawie zysku wygenerowanego przez wpłatę użytkownika we wszystkich bazowych Strategiach i łańcuchach.
* Żądanie jest kierowane do huba Arbitrum. Jeśli Skarbiec ma wystarczającą ilość nieaktywnych środków (aktywów niezaangażowanych aktywnie w Strategie), wypłata jest przetwarzana natychmiast.
* Jeśli Skarbiec ma niewystarczającą ilość nieaktywnych środków, hub sygnalizuje Strategiom, aby wypłaciły wymaganą kwotę. Priorytetowo traktuje wypłaty ze Strategii, w których wpływ na ogólny zysk (APR) jest najmniejszy. Proces ten może potrwać nieco dłużej w zależności od bazowych protokołów.
  {% endstep %}

{% step %}
**Odbiór**

* Gdy w Skarbcu dostępna jest wystarczająca płynność, użytkownik może odebrać swoją wypłatę. Po odebraniu odpowiednie aktywa są transferowane do portfela użytkownika za pośrednictwem infrastruktury międzyłańcuchowej.
  {% endstep %}
  {% endstepper %}

### Architektura międzyłańcuchowa

Infrastruktura OmniYield opiera się na solidnej architekturze hub-and-spoke:&#x20;

* **Hub:** Wykorzystujemy Arbitrum jako nasz centralny hub operacyjny ("główny łańcuch"). To tutaj przede wszystkim znajdują się logika rdzeniowa, złożone obliczenia oraz ogólne zarządzanie stanem protokołu OmniYield.
* **Szprychy:** Wszystkie inne obsługiwane blockchainy działają jako „łańcuchy szprychowe” lub „łańcuchy boczne”. To sieci, z których mogą pochodzić wpłaty użytkowników i na których wdrażanych jest wiele bazowych Strategii zysków. Pełnią one głównie rolę punktów wykonawczych, odbierając instrukcje z Huba.

<figure><img src="/files/06998f2387a1137dc742abcd924b70a44f600d5e" alt=""><figcaption></figcaption></figure>

#### **Przepływ komunikacji:**

{% stepper %}
{% step %}
**Agregacja**

Gdy zostanie podjęta decyzja o rebalansowaniu lub wystąpią działania użytkownika (takie jak wpłaty/wypłaty wymagające ruchu międzyłańcuchowego), generowane są wiadomości międzyłańcuchowe i bezpiecznie przesyłane z łańcuchów szprychowych do huba Arbitrum.
{% endstep %}

{% step %}
**Obliczenia**

Hub przetwarza te przychodzące wiadomości, wykonuje niezbędne obliczenia (takie jak optymalizacja alokacji aktywów we wszystkich szprychach, obliczanie ogólnych wyników skarbca, konsolidacja opłat) i podejmuje strategiczne decyzje na podstawie globalnego obrazu systemu.
{% endstep %}

{% step %}
**Dystrybucja**

Po podjęciu decyzji niezbędne instrukcje i dane transakcyjne są rozsyłane z powrotem z Arbitrum do odpowiednich inteligentnych kontraktów na łańcuchach szprychowych w celu wykonania (np. zdeponowania środków w konkretnej Strategii w innej sieci).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Taka modułowa konstrukcja umożliwia:

* **Scentralizowaną logikę, zdecentralizowane wykonanie**\
  Model ten zapewnia spójność danych, ponieważ hub Arbitrum działa jako pojedyncze źródło prawdy. Faktyczne rozmieszczenie kapitału odbywa się w łańcuchach szprychowych, wykorzystując unikalne możliwości, jakie zapewnia każdy łańcuch.
* **Modułowość i rozszerzalność**\
  Nowe łańcuchy, aktywa, strategie i miejsca docelowe można integrować w modelu plug-and-play przy minimalnych zmianach w istniejącej bazie kodu.\
  Zapewnia to niską powierzchnię ataku, jednocześnie ułatwiając rozwój dodatkowych produktów. Aby jeszcze bardziej zwiększyć odporność i funkcjonalność, protokół OmniYield integruje się z różnymi prymitywami i infrastrukturami DeFi, zapewniając najlepsze doświadczenie użytkownika i umożliwiając płynną interakcję z innymi narzędziami finansowymi.
  {% endhint %}

### Komunikacja międzyłańcuchowa

Działanie naszego modelu hub-and-spoke w licznych blockchainach jest możliwe dzięki wykorzystaniu wiodących dostawców komunikacji międzyłańcuchowej: LayerZero i Axelar (a w przyszłości potencjalnie także innych, dopasowanych do konkretnych tokenów/łańcuchów/funkcji).&#x20;

LayerZero umożliwia lekką i wydajną komunikację, zapewniając minimalne opóźnienia i bezzaufową interoperacyjność w obsługiwanych sieciach. Axelar uzupełnia to wysokopoziomowym routowaniem i bezpiecznym dostarczaniem uogólnionych wiadomości międzyłańcuchowych.

* **Szkielet komunikacyjny:** Protokoły te działają jako bezpieczna i niezawodna infrastruktura komunikacyjna łącząca nasz Hub (Arbitrum) ze wszystkimi łańcuchami szprychowymi. Zapewniają niezbędne ścieżki do przesyłania danych i instrukcji pomiędzy granicami blockchainów. Całe przekazywanie, walidacja i rozliczanie wiadomości odbywa się za pośrednictwem bezpiecznych kanałów komunikacyjnych tych dostawców.
* **Ułatwianie kluczowych operacji:** LayerZero i Axelar przekazują kluczowe wiadomości wymagane do podstawowych funkcji. Obejmuje to:
  * Powiadamianie Huba o nowych wpłatach dokonanych na łańcuchach szprychowych.
  * Przekazywanie żądań wypłaty od użytkowników na łańcuchach szprychowych do Huba w celu przetworzenia.
  * Wysyłanie poleceń z Huba do kontraktów strategii na łańcuchach szprychowych w celu wykonania wpłat, wypłat lub rebalansowania.
  * Raportowanie zysków, metryk wydajności i danych o opłatach ze strategii na łańcuchach szprychowych z powrotem do Huba.

### Skonsolidowane raportowanie opłat

W typowych konfiguracjach wielołańcuchowych każdy łańcuch często działa jak silos z odizolowaną logiką i raportowaniem wyników. OmniYield przyjmuje zupełnie inne podejście. Wierzymy, że nasz ekosystem powinien działać jako jeden ujednolicony protokół, a nie rozdrobniony zbiór wdrożeń specyficznych dla poszczególnych łańcuchów.

Chociaż OmniYield generuje opłaty ze strategii zysków działających w wielu łańcuchach. Protokół wdraża skonsolidowane raportowanie opłat, czyli proces, w którym dane o generowaniu opłat ze wszystkich obsługiwanych łańcuchów są agregowane, normalizowane i obliczane na Arbitrum (hubie).&#x20;

{% hint style="success" %}
Umożliwia to:

* **Elastyczne doświadczenie użytkownika:** Użytkownicy nie muszą martwić się o niespójne zachęty. Mogą wpłacać z dowolnego łańcucha, który preferują, wiedząc, że opłaty, możliwości zysków i nagrody pozostają spójne w całym ekosystemie OmniYield.
* **Wspólna tokenomika:** Wszystkie opłaty protokołu, niezależnie od łańcucha źródłowego, zasilają ten sam globalny model przychodów.
* **Przejrzyste metryki:** Ujednolicone raportowanie eliminuje rozbieżności i poprawia możliwość audytu.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.omniyield.finance/pl/omniyield/architektura.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
