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

# Architektura

Architektura OmniYield je navržena jako modulární, nezávislá na řetězci a vysoce škálovatelná.

Naším hlavním cílem je vytvořit vrstvu pro výnosy nezávislou na řetězci, která maximalizuje výnosy upravené o riziko pro uživatele napříč DeFi. K dosažení tohoto cíle systém využívá rozsáhlou analýzu dat, pokročilé off-chain algoritmy, přísné bezpečnostní protokoly, pravidla diverzifikace a architekturu, která abstrahuje složitost cross-chain interakce.&#x20;

### Klíčové architektonické komponenty

<details>

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

Brána uživatele do OmniYield.

Tyto smart kontrakty v souladu s ERC-4626 bezpečně spravují vklady, přijímají reporty ze strategií a zpracovávají výběry.

Slouží jako hlavní rozhraní koordinující prostředky uživatele s podkladovými Strategiemi.

</details>

<details>

<summary><strong>Vykonávací vrstva (Solver)</strong></summary>

Inteligentní vrstva OmniYield.

Tyto automatizované systémy neustále analyzují DeFi protokoly napříč řetězci, identifikují optimální příležitosti k výnosu, vyhodnocují rizika a určují alokaci aktiv pro Trezory.

Toto zpracování se pro efektivitu počítá off-chain — na-chain se implementují pouze výsledky, což brání napodobování strategií OmniYield.

</details>

<details>

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

S každým Trezorem je spojena alespoň jedna smlouva Strategie.

Tato komponenta převádí rozhodnutí solveru na akce. Zvládá technickou složitost pohybu aktiv, včetně swapů tokenů, poskytování likvidity, půjčování, stakingu atd.

</details>

<details>

<summary><strong>Cíle</strong></summary>

Konkrétní DeFi protokoly, liquidity pooly nebo yield farmy, kam jsou nakonec nasazena aktiva trezoru.

</details>

<details>

<summary><strong>Infrastruktura cross-chain komunikace</strong></summary>

Základní technologie umožňující cross-chain schopnosti, usnadňující komunikaci a převody aktiv mezi různými blockchainy.

</details>

### Životní cyklus aktiv

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

Pochopení toku aktiv pomáhá objasnit fungování systému:

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

Uživatel vloží jeden typ aktiva (např. USDC) do odpovídajícího Trezoru OmniYield na libovolném podporovaném řetězci. Vložená aktiva jsou přesunuta do kontraktu Trezoru na hubu Arbitrum a zpočátku zde nečinně leží.
{% endstep %}

{% step %}
**Cross-chain rebalancování**

* Off-chain komponenta (autonomní Solver) sleduje zůstatky v trezorech a tržní podmínky. Jakmile je dosaženo určité prahové hodnoty nečinných aktiv nebo během pravidelných optimalizačních cyklů, určí optimální alokaci pro aktuální Strategie napříč integrovanými řetězci a navrhne plán rebalancování. Pokud návrh splňuje bezpečnostní a výkonnostní omezení, zahájí rebalancování (např. přesun X množství USDC do Strategie A na Řetězci Y) prostřednictvím kontraktu Trezoru na hubu Arbitrum.&#x20;
* Pomocí LayerZero a Axelar je z hubu odeslána zpráva obsahující pokyny k rebalancování do příslušného kontraktu Trezoru na cílových řetězcích.
* Systém provede nezbytné kroky (jako bridge, swap, vklad atd.) pro provedení rebalancování.
* Aktualizovaná alokace je zaznamenána a potvrzení / aktualizace stavu jsou prostřednictvím vrstvy zpráv odeslány zpět na hub Arbitrum. Tento proces může zahrnovat přesun nečinných prostředků z hubu do Strategie nebo přesun prostředků mezi různými Strategiemi za účelem hledání lepších výnosů.
  {% endstep %}

{% step %}
**Automatické složené úročení a konsolidované reportování**

* Smlouvy Strategie pravidelně nárokují získané odměny z cílových protokolů, převádějí je na základní aktivum trezoru (např. USDC) a automaticky je reinvestují. Tento proces je orchestrán oprávněnými Keepers.&#x20;
* Výkonnostní data, včetně odměn generovaných těmito Strategiemi na všech podporovaných řetězcích, jsou průběžně reportována zpět na hub Arbitrum. Odměny se přičítají k celkové hodnotě trezoru, čímž se výnosy pro vkladatele automaticky skládají.
  {% endstep %}

{% step %}
**Výběr**

* Výběry nejsou omezeny na řetězec vkladu; uživatelé mohou zahájit žádost o výběr kdykoli z libovolného podporovaného řetězce (**nemusí to být stejný řetězec, který byl použit pro vklad**).
* Výkonnostní poplatek ve výši 9 % se vypočítá na základě zisku generovaného vkladem uživatele napříč všemi podkladovými Strategiemi a řetězci.
* Požadavek je směrován na hub Arbitrum. Pokud má Trezor dostatek nečinných prostředků (aktiv, která nejsou aktivně nasazena ve Strategiích), je výběr zpracován okamžitě.
* Pokud má Trezor nedostatek nečinných prostředků, hub dá Strategiím signál, aby vybraly požadovanou částku. Přednostně vybírá ze Strategií, kde je dopad na celkový výnos (APR) minimální. Tento proces může podle podkladových protokolů trvat o něco déle.
  {% endstep %}

{% step %}
**Uplatnění**

* Jakmile je v Trezoru k dispozici dostatečná likvidita, uživatel může svůj výběr uplatnit. Po uplatnění jsou příslušná aktiva přes cross-chain infrastrukturu převedena do peněženky uživatele.
  {% endstep %}
  {% endstepper %}

### Cross-chain architektura

Infrastruktura OmniYield je postavena na robustní architektuře hub-and-spoke:&#x20;

* **Hub:** Jako náš centrální provozní hub („hlavní řetězec“) využíváme Arbitrum. Právě zde primárně sídlí hlavní logika, složité výpočty a celková správa stavu protokolu OmniYield.
* **Spokes:** Všechny ostatní podporované blockchainy fungují jako „spoke chains“ nebo „side chains“. To jsou sítě, odkud mohou pocházet uživatelské vklady a kde jsou nasazeny mnohé podkladové yield Strategie. Slouží především jako výkonnostní koncové body, které přijímají pokyny z Hubu.

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

#### **Tok komunikace:**

{% stepper %}
{% step %}
**Agregace**

Když je učiněno rozhodnutí o rebalancování nebo dojde k uživatelským akcím (jako vklady/výběry vyžadující pohyb mezi řetězci), jsou generovány cross-chain zprávy a bezpečně předávány ze spoke chainů na hub Arbitrum.
{% endstep %}

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

Hub zpracovává tyto příchozí zprávy, provádí nezbytné výpočty (například optimalizaci alokace aktiv napříč všemi spokes, výpočet celkové výkonnosti trezoru, konsolidaci poplatků) a činí strategická rozhodnutí na základě svého globálního pohledu na systém.
{% endstep %}

{% step %}
**Distribuce**

Jakmile jsou rozhodnutí učiněna, potřebné instrukce a transakční data jsou z Arbitra distribuovány zpět do příslušných smart kontraktů na spoke chainech k vykonání (např. vložení prostředků do konkrétní Strategie na jiné síti).
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Tento modulární návrh umožňuje:

* **Centralizovaná logika, decentralizované vykonávání**\
  Tento model zajišťuje konzistenci dat, protože hub Arbitrum funguje jako jediný zdroj pravdy. Skutečné nasazení kapitálu probíhá napříč spoke chainy a využívá jedinečné příležitosti, které každý řetězec nabízí.
* **Modularita a rozšiřitelnost**\
  Nové řetězce, aktiva, strategie a cíle lze integrovat plug-and-play způsobem s minimálními změnami v existující codebase.\
  To zajišťuje malou útočnou plochu a zároveň usnadňuje vývoj dalších produktů. Aby se dále zvýšila robustnost a funkčnost, protokol OmniYield se integruje s různými DeFi primitivy a infrastrukturami, poskytuje nejlepší uživatelský zážitek a umožňuje bezproblémovou interakci s dalšími finančními nástroji.
  {% endhint %}

### Cross-chain komunikace

Provoz našeho modelu hub-and-spoke napříč mnoha blockchainy je umožněn využitím předních poskytovatelů cross-chain zpráv: LayerZero a Axelar (a potenciálně i dalších, přizpůsobených pro konkrétní tokeny/řetězce/funkce v budoucnu).&#x20;

LayerZero umožňuje lehké a efektivní zasílání zpráv, zajišťuje minimální latenci a trustless interoperabilitu napříč podporovanými sítěmi. Axelar to doplňuje o high-level routování a bezpečné doručování generalizovaných cross-chain zpráv.

* **Komunikační páteř:** Tyto protokoly fungují jako bezpečná a spolehlivá komunikační infrastruktura propojující náš Hub (Arbitrum) se všemi spoke chainy. Poskytují nezbytné cesty pro přenos dat a pokynů napříč hranicemi blockchainů. Veškeré přeposílání zpráv, validace a vypořádání probíhá prostřednictvím bezpečných messaging rails těchto poskytovatelů.
* **Usnadnění klíčových operací:** LayerZero a Axelar předávají kritické zprávy potřebné pro klíčové funkce. To zahrnuje:
  * Oznámení Hubu o nových vkladech provedených na spoke chainech.
  * Přeposílání požadavků na výběr od uživatelů na spoke chainech do Hubu ke zpracování.
  * Odesílání příkazů z Hubu do strategií na spoke chainech k provedení vkladů, výběrů nebo rebalancování.
  * Reportování generovaného výnosu, výkonnostních metrik a dat o poplatcích ze strategií na spoke chainech zpět do Hubu.

### Konsolidované reportování poplatků

V typických multi-chain nastaveních funguje každý řetězec často jako silo s izolovanou logikou a reportováním výkonnosti. OmniYield přistupuje zcela odlišně. Věříme, že náš ekosystém by měl fungovat jako jediný sjednocený protokol, nikoli jako fragmentovaná sada nasazení specifických pro jednotlivé řetězce.

Zatímco OmniYield generuje poplatky z výnosových strategií fungujících napříč mnoha řetězci, protokol implementuje konsolidované reportování poplatků, proces, při kterém jsou data o generování poplatků ze všech podporovaných řetězců agregována, normalizována a počítána na Arbitru (hubu).&#x20;

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

* **Flexibilní uživatelský zážitek:** Uživatelé se nemusí starat o nekonzistentní pobídky. Mohou vkládat z libovolného řetězce, který preferují, s vědomím, že poplatky, příležitosti k výnosu a odměny zůstávají konzistentní napříč celým ekosystémem OmniYield.
* **Sdílená tokenomika:** Všechny poplatky protokolu, bez ohledu na původní řetězec, přispívají ke stejnému globálnímu modelu příjmů.
* **Transparentní metriky:** Sjednocené reportování eliminuje nesrovnalosti a zlepšuje auditovatelnost.
  {% endhint %}

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