> 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/pl/omniyield/architektura.md).
# Architektura
Architektura OmniYield została zaprojektowana tak, aby była modułowa, agnostyczna względem łańcucha i wysoce skalowalna.
Naszym głównym celem jest stworzenie warstwy zysków agnostycznej względem łańcucha, która maksymalizuje zyski skorygowane o ryzyko dla użytkowników w całym DeFi. Aby to osiągnąć, system wykorzystuje rozbudowaną 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
Skarbce
Brama użytkownika do OmniYield.
Te zgodne ze standardem ERC-4626 inteligentne kontrakty bezpiecznie zarządzają depozytami, odbierają raporty od strategii i przetwarzają wypłaty.
Służą jako główny interfejs koordynujący środki użytkowników z leżącymi u podstaw Strategiami.
Warstwa wykonawcza (Solver)
Warstwa inteligencji OmniYield.
Te zautomatyzowane systemy stale analizują protokoły DeFi w różnych łańcuchach, identyfikują optymalne możliwości generowania zysku, oceniają ryzyko i określają alokację aktywów dla Skarbców.
To przetwarzanie jest wykonywane off-chain dla zwiększenia wydajności — tylko wyniki są wdrażane on-chain, zapobiegając kopiowaniu strategii OmniYield.
Strategie
Do każdego Skarbca jest przypisany co najmniej jeden kontrakt Strategii.
Ten komponent przekłada decyzje solvera na działania. Obsługuje techniczne złożoności przemieszczania aktywów, w tym wymiany tokenów, zapewnianie płynności, pożyczanie, staking itp.
Miejsca docelowe
Konkretne protokoły DeFi, pule płynności lub farmy zysków, do których ostatecznie trafiają aktywa skarbca.
Infrastruktura komunikacji międzyłańcuchowej
Podstawowa technologia umożliwiająca funkcje międzyłańcuchowe, ułatwiająca komunikację i transfer aktywów między różnymi blockchainami.
### Cykl życia aktywów
Zrozumienie przepływu aktywów pomaga wyjaśnić działanie systemu:
{% stepper %}
{% step %}
**Wpłata**
Użytkownik wpłaca jeden rodzaj aktywa (np. USDC) do odpowiedniego Skarbca OmniYield na dowolnym obsługiwanym łańcuchu. Wpłacone aktywa są przenoszone do kontraktu Skarbca w hubie Arbitrum i początkowo tam pozostają bezczynne.
{% endstep %}
{% step %}
**Równoważenie międzyłańcuchowe**
* Komponent off-chain (autonomiczny Solver) monitoruje salda skarbca i warunki rynkowe. Gdy zostanie osiągnięty określony próg bezczynnych 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 kryteria bezpieczeństwa i wydajności, inicjuje rebalans (np. przeniesienie X kwoty USDC do Strategii A na Łańcuchu Y) za pośrednictwem kontraktu Skarbca w hubie Arbitrum.
* Korzystając z LayerZero i Axelar, wiadomość zawierająca instrukcje dotyczące równoważenia jest wysyłana z huba do odpowiedniego kontraktu Skarbca na docelowych łańcuchach.
* System wykonuje niezbędne kroki (takie jak mostkowanie, wymiana, depozyt itp.), aby przeprowadzić rebalans.
* Zaktualizowana alokacja jest zapisywana, a potwierdzenia/aktualizacje statusu są odsyłane do huba Arbitrum przez warstwę komunikacyjną. Proces ten może obejmować przeniesienie bezczynnych środków z huba do Strategii lub przesunięcie środków między różnymi Strategiami w celu osiągnięcia lepszych zysków.
{% endstep %}
{% step %}
**Auto-komponowanie i skonsolidowane raportowanie**
* Kontrakty Strategii okresowo odbierają naliczone nagrody z docelowych protokołów, konwertowane na bazowy aktyw skarbca (np. USDC) i automatycznie reinwestowane. Proces ten jest koordynowany przez uprawnionych Keeperów.
* 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 zyski 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órego użyto do wpłaty**).
* Opłata za wynik 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ące bezczynne środki (aktywa niezaangażowane aktywnie w Strategie), wypłata jest przetwarzana natychmiast.
* Jeśli Skarbiec nie ma wystarczających bezczynnych środków, hub sygnalizuje Strategiom konieczność wypłaty wymaganej kwoty. Priorytetowo traktuje wypłaty ze Strategii, w których wpływ na ogólny zysk (APR) jest minimalizowany. Proces ten może potrwać nieco dłużej w zależności od bazowych protokołów.
{% endstep %}
{% step %}
**Odbierz**
* Gdy w Skarbcu dostępna jest wystarczająca płynność, użytkownik może odebrać swoją wypłatę. Po odebraniu odpowiadające 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:
* **Hub:** Wykorzystujemy Arbitrum jako nasz centralny hub operacyjny („główny łańcuch”). To tutaj przede wszystkim znajdują się logika rdzeniowa, złożone obliczenia i ogólne zarządzanie stanem protokołu OmniYield.
* **Szprychy:** Wszystkie inne obsługiwane blockchainy funkcjonują 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. Działają one głównie jako punkty końcowe wykonania, odbierając instrukcje z Huba.
#### **Przepływ komunikacji:**
{% stepper %}
{% step %}
**Agregacja**
Gdy zostanie podjęta decyzja o rebalansowaniu lub zachodzą działania użytkownika (takie jak wpłaty/wypłaty wymagające ruchu międzyłańcuchowego), generowane są komunikaty międzyłańcuchowe i bezpiecznie przekazywane 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 swojego globalnego obrazu systemu.
{% endstep %}
{% step %}
**Dystrybucja**
Gdy decyzje zostaną podjęte, niezbędne instrukcje i dane transakcyjne są przekazywane z powrotem z Arbitrum do odpowiednich inteligentnych kontraktów na łańcuchach szprychowych w celu wykonania (np. wpłacenia środków do określonej Strategii w innej sieci).
{% endstep %}
{% endstepper %}
{% hint style="success" %}
Ta modułowa konstrukcja umożliwia:
* **Scentralizowana logika, zdecentralizowane wykonanie**\
Ten model zapewnia spójność danych, ponieważ hub Arbitrum działa jako pojedyncze źródło prawdy. Faktyczne lokowanie kapitału odbywa się na łańcuchach szprychowych, wykorzystując unikalne możliwości, jakie oferuje każdy łańcuch.
* **Modułowość i rozszerzalność**\
Nowe łańcuchy, aktywa, strategie i miejsca docelowe mogą być integrowane 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ć solidność i funkcjonalność, protokół OmniYield integruje się z różnymi prymitywami i infrastrukturami DeFi, zapewniając najlepsze doświadczenie użytkownika i umożliwiając bezproblemową interakcję z innymi narzędziami finansowymi.
{% endhint %}
### Komunikacja międzyłańcuchowa
Działanie naszego modelu hub-and-spoke w wielu blockchainach jest możliwe dzięki wykorzystaniu wiodących dostawców komunikatów międzyłańcuchowych: LayerZero i Axelar (a w przyszłości potencjalnie także innych, dostosowanych do konkretnych tokenów/łańcuchów/funkcji).
LayerZero umożliwia lekką i wydajną komunikację, zapewniając minimalne opóźnienia i bezzaufaną interoperacyjność między obsługiwanymi sieciami. Axelar uzupełnia to o wysokopoziomowe routowanie i bezpieczne dostarczanie uogólnionych komunikatów międzyłańcuchowych.
* **Kręgosłup komunikacji:** 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 ponad granicami blockchainów. Całe przekazywanie wiadomości, walidacja i rozliczanie odbywają się za pośrednictwem bezpiecznych torów komunikacyjnych tych dostawców.
* **Ułatwianie kluczowych operacji:** LayerZero i Axelar przekazują kluczowe wiadomości niezbędne do podstawowych funkcji. Obejmuje to:
* Powiadamianie Huba o nowych wpłatach dokonanych na łańcuchach szprychowych.
* Przekazywanie żądań wypłat 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 rebalansów.
* Raportowanie generowanych zysków, wskaźników 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 jako silos z odizolowaną logiką i raportowaniem wyników. OmniYield przyjmuje radykalnie inne podejście. Wierzymy, że nasz ekosystem powinien działać jako jeden zunifikowany protokół, a nie rozdrobniony zbiór wdrożeń specyficznych dla poszczególnych łańcuchów.
Chociaż OmniYield generuje opłaty z strategii zysków działających w licznych łańcuchach, protokół wdraża skonsolidowane raportowanie opłat — proces, w którym dane o generowaniu opłat ze wszystkich obsługiwanych łańcuchów są agregowane, normalizowane i obliczane na Arbitrum (hubie).
{% hint style="success" %}
Umożliwia to:
* **Elastyczne doświadczenie użytkownika:** Użytkownicy nie muszą martwić się niespójnymi zachętami. Mogą wpłacać z dowolnego łańcucha, który wybiorą, wiedząc, że opłaty, możliwości zysku 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 wskaźniki:** Ujednolicone raportowanie eliminuje rozbieżności i poprawia możliwość audytu.
{% endhint %}