> 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/sk/omniyield/architektura.md).

# Architektúra

Architektúra OmniYield je navrhnutá tak, aby bola modulárna, nezávislá od reťazca a vysoko škálovateľná.

Naším hlavným cieľom je vytvoriť výnosovú vrstvu nezávislú od reťazca, ktorá maximalizuje výnosy upravené o riziko pre používateľov v rámci DeFi. Na dosiahnutie tohto cieľa systém využíva rozsiahlu analýzu dát, pokročilé off-chain algoritmy, prísne bezpečnostné protokoly, pravidlá diverzifikácie a architektúru, ktorá abstrahuje zložitosť cross-chain interakcie.&#x20;

### Kľúčové architektonické komponenty

<details>

<summary><strong>Trezory</strong></summary>

Používateľova brána do OmniYield.

Tieto smart kontrakty kompatibilné s ERC-4626 bezpečne spravujú vklady, prijímajú hlásenia zo stratégií a spracúvajú výbery.

Slúžia ako hlavné rozhranie, ktoré koordinuje prostriedky používateľov so základnými Stratégiami.

</details>

<details>

<summary><strong>Exekučná vrstva (solver)</strong></summary>

Inteligentná vrstva OmniYield.

Tieto automatizované systémy neustále analyzujú DeFi protokoly naprieč reťazcami, identifikujú optimálne výnosové príležitosti, posudzujú riziká a určujú alokáciu aktív pre Trezory.

Toto spracovanie sa pre efektivitu počíta off-chain - na reťazec sa implementujú iba výsledky, čím sa zabraňuje napodobňovaniu stratégií OmniYield.

</details>

<details>

<summary><strong>Stratégie</strong></summary>

Ku každému Trezoru je priradený aspoň jeden kontrakt Stratégie.

Táto komponenta premieňa rozhodnutia solvera na akcie. Zvláda technické zložitosti presunu aktív vrátane výmen tokenov, poskytovania likvidity, požičiavania, stakingu atď.

</details>

<details>

<summary><strong>Ciele</strong></summary>

Konkrétne DeFi protokoly, likviditné pooly alebo výnosové farmy, kde sú aktíva trezoru nakoniec nasadzované.

</details>

<details>

<summary><strong>Infraštruktúra cross-chain správ</strong></summary>

Základná technológia umožňujúca cross-chain funkcie, uľahčujúca komunikáciu a presuny aktív medzi rôznymi blockchainmi.

</details>

### Životný cyklus aktív

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

Pochopenie toku aktív pomáha objasniť fungovanie systému:

{% stepper %}
{% step %}
**Vklad**

Používateľ vloží jeden typ aktíva (napr. USDC) do príslušného Trezoru OmniYield na ľubovoľnom podporovanom reťazci. Vložené aktíva sa presunú do kontraktu Trezoru na Arbitrum hube a spočiatku tam nečinne ležia.
{% endstep %}

{% step %}
**Cross-chain rebalansovanie**

* Off-chain komponent (autonómny solver) monitoruje zostatky trezorov a trhové podmienky. Keď sa dosiahne určitý prah nečinných aktív alebo počas pravidelných optimalizačných cyklov, určí optimálnu alokáciu pre aktuálne Stratégie naprieč integrovanými reťazcami a navrhne plán rebalansovania. Ak návrh spĺňa bezpečnostné a výkonnostné obmedzenia, spustí rebalansovanie (napr. presun X množstva USDC do Stratégie A na Reťazci Y) prostredníctvom kontraktu Trezoru na Arbitrum hube.&#x20;
* Pomocou LayerZero a Axelar sa z hubu odošle správa s inštrukciami na rebalansovanie príslušnému kontraktu Trezoru na cieľových reťazcoch.
* Systém vykoná potrebné kroky (ako bridging, výmeny, vklady atď.) na rebalansovanie.
* Aktualizovaná alokácia sa zaznamená a potvrdenie/aktualizácie stavu sa cez vrstvu správ odošlú späť do Arbitrum hubu. Tento proces môže zahŕňať presun nečinných prostriedkov z hubu do Stratégie alebo presun prostriedkov medzi rôznymi Stratégiami s cieľom dosiahnuť lepšie výnosy.
  {% endstep %}

{% step %}
**Automatické zhodnocovanie a konsolidované reportovanie**

* Kontrakty Stratégií pravidelne vyberajú získané odmeny z cieľových protokolov, konvertujú ich na základné aktívum trezoru (napr. USDC) a automaticky ich reinvestujú. Tento proces koordinujú oprávnené Keepers.&#x20;
* Výkonnostné údaje vrátane odmien generovaných týmito Stratégiami na všetkých podporovaných reťazcoch sa priebežne reportujú späť do Arbitrum hubu. Odmeny sa pripisujú k celkovej hodnote trezoru, čím sa výnosy pre vkladateľov automaticky úročia.
  {% endstep %}

{% step %}
**Výber**

* Výbery nie sú obmedzené na reťazec vkladu; používatelia môžu kedykoľvek iniciovať žiadosť o výber z ľubovoľného podporovaného reťazca (**nemusí to byť ten istý reťazec, ktorý bol použitý na vklad**).
* Výkonnostný poplatok vo výške 9 % sa vypočíta na základe zisku vygenerovaného vkladom používateľa naprieč všetkými podkladovými Stratégiami a reťazcami.
* Žiadosť sa smeruje do Arbitrum hubu. Ak má Trezor dostatok nečinných prostriedkov (aktíva, ktoré nie sú aktívne nasadené v Stratégiách), výber sa spracuje okamžite.
* Ak má Trezor nedostatočné nečinné prostriedky, hub signalizuje Stratégiám, aby vybrali požadované množstvo. Uprednostňuje sa výber zo Stratégií, kde je dopad na celkový výnos (APR) minimalizovaný. Tento proces môže trvať o niečo dlhšie v závislosti od podkladových protokolov.
  {% endstep %}

{% step %}
**Uplatnenie nároku**

* Keď je v Trezore k dispozícii dostatočná likvidita, používateľ si môže uplatniť svoj výber. Po uplatnení nároku sa príslušné aktíva prevedú do peňaženky používateľa prostredníctvom cross-chain infraštruktúry.
  {% endstep %}
  {% endstepper %}

### Cross-chain architektúra

Infraštruktúra OmniYield je postavená na robustnej architektúre hub-and-spoke:&#x20;

* **Hub:** Ako centrálny operačný hub používame Arbitrum (hlavný reťazec). Tu sa primárne nachádza jadrová logika, zložité výpočty a celkové spravovanie stavu protokolu OmniYield.
* **Ramená:** Všetky ostatné podporované blockchainy fungujú ako „spoke chains“ alebo „vedľajšie reťazce“. Sú to siete, v ktorých môžu vzniknúť vklady používateľov a kde sú nasadené mnohé z podkladových výnosových Stratégií. Primárne slúžia ako koncové body vykonávania a prijímajú pokyny z Hubu.

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

#### **Tok komunikácie:**

{% stepper %}
{% step %}
**Agregácia**

Keď sa prijme rozhodnutie o rebalansovaní alebo nastanú akcie používateľa (ako vklady/výbery vyžadujúce cross-chain presun), vytvoria sa cross-chain správy a bezpečne sa odovzdajú z spoke chainov do Arbitrum hubu.
{% endstep %}

{% step %}
**Výpočty**

Hub spracúva tieto prichádzajúce správy, vykonáva potrebné výpočty (ako optimalizáciu alokácie aktív naprieč všetkými ramenami, výpočet celkového výkonu trezoru, konsolidáciu poplatkov) a prijíma strategické rozhodnutia na základe svojho globálneho pohľadu na systém.
{% endstep %}

{% step %}
**Distribúcia**

Keď sú rozhodnutia prijaté, potrebné pokyny a transakčné dáta sa distribuujú späť z Arbitra do príslušných smart kontraktov na spoke chainoch na vykonanie (napr. vloženie prostriedkov do konkrétnej Stratégie v inej sieti).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Tento modulárny dizajn umožňuje:

* **Centralizovaná logika, decentralizované vykonávanie**\
  Tento model zabezpečuje konzistentnosť dát, keďže Arbitrum hub funguje ako jediný zdroj pravdy. Skutočné nasadzovanie kapitálu prebieha naprieč spoke chainmi a využíva jedinečné príležitosti, ktoré každý reťazec ponúka.
* **Modularita a rozšíriteľnosť**\
  Nové reťazce, aktíva, stratégie a ciele možno integrovať spôsobom plug-and-play s minimálnymi zmenami v existujúcej kódovej báze.\
  Tým sa zabezpečuje malá útočná plocha a zároveň sa uľahčuje vývoj ďalších produktov. Na ďalšie posilnenie odolnosti a funkčnosti sa protokol OmniYield integruje s rôznymi DeFi primitívami a infraštruktúrami, čím poskytuje najlepší používateľský zážitok a umožňuje bezproblémovú interakciu s ďalšími finančnými nástrojmi.
  {% endhint %}

### Cross-chain komunikácia

Fungovanie nášho hub-and-spoke modelu naprieč mnohými blockchainmi je možné vďaka využívaniu popredných poskytovateľov cross-chain správ: LayerZero a Axelar (a potenciálne ďalších, prispôsobených pre konkrétne tokeny/reťazce/funkcie v budúcnosti).&#x20;

LayerZero umožňuje ľahké a efektívne zasielanie správ, zabezpečuje minimálnu latenciu a trustless interoperabilitu naprieč podporovanými sieťami. Axelar to dopĺňa routovaním na vysokej úrovni a bezpečným doručovaním všeobecných cross-chain správ.

* **Komunikačná chrbtica:** Tieto protokoly slúžia ako bezpečná a spoľahlivá komunikačná infraštruktúra spájajúca náš Hub (Arbitrum) so všetkými spoke chainmi. Poskytujú základné cesty na prenos dát a inštrukcií cez hranice blockchainov. Všetko preposielanie správ, overovanie a vyrovnanie sa vykonáva prostredníctvom bezpečných messaging rails týchto poskytovateľov.
* **Uľahčovanie kľúčových operácií:** LayerZero a Axelar prenášajú kritické správy potrebné pre základné funkcie. To zahŕňa:
  * Oznámenie Hubu o nových vkladoch uskutočnených na spoke chainoch.
  * Sprostredkovanie žiadostí o výber od používateľov na spoke chainoch do Hubu na spracovanie.
  * Odosielanie príkazov z Hubu na kontrakty stratégií na spoke chainoch na vykonanie vkladov, výberov alebo rebalansovaní.
  * Hlásenie generovaných výnosov, výkonnostných metrík a údajov o poplatkoch zo stratégií na spoke chainoch späť do Hubu.

### Konsolidované reportovanie poplatkov

V bežných multi-chain nastaveniach každý reťazec často funguje ako silo s izolovanou logikou a reportovaním výkonu. OmniYield zvolil radikálne odlišný prístup. Veríme, že náš ekosystém by mal fungovať ako jeden jednotný protokol, nie ako fragmentovaná zbierka nasadení špecifických pre jednotlivé reťazce.

Hoci OmniYield generuje poplatky zo výnosových stratégií fungujúcich naprieč mnohými reťazcami, protokol implementuje konsolidované reportovanie poplatkov, čo je proces, pri ktorom sa údaje o tvorbe poplatkov zo všetkých podporovaných reťazcov agregujú, normalizujú a vyhodnocujú na Arbitre (hub).&#x20;

{% hint style="success" %}
To umožňuje:

* **Flexibilný používateľský zážitok:** Používatelia sa nemusia obávať nekonzistentných stimulov. Môžu vkladať z ktoréhokoľvek reťazca, ktorý preferujú, s vedomím, že poplatky, výnosové príležitosti a odmeny zostávajú konzistentné v celom ekosystéme OmniYield.
* **Zdieľaná tokenomika:** Všetky poplatky protokolu bez ohľadu na pôvodný reťazec prispievajú do rovnakého globálneho modelu príjmov.
* **Transparentné metriky:** Zjednotené reportovanie odstraňuje nezrovnalosti a zlepšuje auditovateľnosť.
  {% endhint %}

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