Інтеграція та налаштування оракулів і офчейн-даних

Інтеграція блокчейн-оракулів: Chainlink, Pyth, API3

Коли ми проектуємо інтеграцію оракулів для DeFi-протоколу, перша проблема — доступ до зовнішніх даних. Смарт-контракт без оракула детермінований і сліпий. Ціна токена, курс фіату, результат події — все off-chain. Але щойно ви вводите оракул, з'являється oracle manipulation. Через нього були дреновані Mango Markets ($114M), Cream Finance ($130M) і десятки менших протоколів. Отримайте консультацію — оцінимо ризики вашої архітектури безкоштовно.

Чому оракули ламають? І чим небезпечний spot price

Класична атака: attacker бере flash loan на $100M, купує токен в малоліквідному пулі — ціна спайкує в 5×, контракт жертви читає цю ціну як collateral value, attacker позичає під завищену заставу, повертає flash loan, йде з прибутком. Все в одній транзакції.

Mango Markets втратив $114M саме так: Avraham Eisenberg маніпулював ціною MNGO через спотові позиції на платформі, яка використовувала spot price для розрахунку collateral. Це складніше flash loan, але працює на менш ліквідних активах.

Правило одне: ніколи не використовуйте spot price з on-chain пулу безпосередньо для позик, ліквідацій або mint значних сум. Правильна заміна — TWAP (Time-Weighted Average Price). Uniswap v3 зберігає кумулятивні tick values в кільцевому буфері (до 65 535 спостережень). Мінімальний safe TWAP для DeFi — 30 хвилин. Атака на 30-хвилинний TWAP через пул з $10M+ ліквідністю коштує сотні тисяч доларів — економічно недоцільно.

Chainlink Data Feeds під ключ: архітектура та граничні випадки

Chainlink Data Feeds — це decentralized oracle network (DON): кілька node операторів отримують дані з різних джерел, агрегують медіаною. Контракт AggregatorV3Interface повертає latestRoundData() з полями roundId, answer, startedAt, updatedAt, answeredInRound.

Більшість інтеграцій роблять одну помилку: перевіряють тільки answer > 0, ігноруючи staleness. Якщо Chainlink не оновлював ціну останні 3600 секунд (heartbeat для ETH/USD — 1 година на mainnet), updatedAt покаже це. Правильна перевірка:

(, int256 price, , uint256 updatedAt, ) = priceFeed.latestRoundData();
require(price > 0, "Invalid price");
require(block.timestamp - updatedAt <= 3600 + 300, "Stale price"); // heartbeat + buffer

Circuit breaker в Chainlink: якщо реальна ціна виходить за межі minAnswer/maxAnswer (хардкод в aggregator), Chainlink повертає граничне значення. LUNA в травні 2022: коли ціна впала з $80 до $0.10, ряд lending протоколів продовжував отримувати minAnswer = $0.10 замість реального ~$0.0006. Перевіряйте answer != aggregator.minAnswer() && answer != aggregator.maxAnswer() — це "дані обрізані по границі".

Коли використовувати Pyth замість Chainlink?

Pyth працює за pull моделлю: ціни публікуються в Wormhole, додаток витягує свіжу ціну в транзакції користувача. Latency Pyth — 400ms проти 10–60 секунд у Chainlink — це в 25 разів швидше. Для perpetuals і опціонів це виграшно. Для lending з 30-хвилинними TWAP Chainlink достатній. Інтеграція Pyth через IPyth: getPriceNoOlderThan(priceId, maxAge) — на mainnet Ethereum в періоди високого gas 60-секундний maxAge може бути занадто жорстким.

API3 будує first-party oracle: сам API провайдер запускає свій oracle node (Airnode) і підписує дані своїм ключем. Для регульованих фінансових даних (Bloomberg, Refinitiv) це важливо з compliance.

Як вибрати між Chainlink, Pyth та API3?

Що таке circuit breaker і чим він небезпечний?

Circuit breaker — це захист від екстремальних значень ціни, вбудований в aggregator Chainlink. Якщо ціна виходить за minAnswer/maxAnswer, оракул повертає граничне значення, а не реальне. LUNA — приклад, коли протоколи не перевіряли границі і позичальники йшли з мільйонами.

Процес роботи: як ми інтегруємо Chainlink Data Feeds

1. Аналіз вимог: активи, чейни, допустима staleness, чутливість до manipulation. Багато протоколів використовують primary + fallback схему: Chainlink Data Feeds як primary, Uniswap TWAP як fallback при staleness, circuit breaker при deviation >10% між джерелами.
2. Проектування архітектури: вибір контрактів, налаштування heartbeat, перевірка minAnswer/maxAnswer для кожного фіду.
3. Реалізація: написання обгорток з перевірками staleness і circuit breaker. Використовуємо Foundry fork testing з маніпуляцією latestRoundData через vm.mockCall. Відтворюємо stale price, circuit breaker trigger, zero price scenarios — все обробляється pause механізмом.
4. Тестування: інваріантні тести з Echidna (fuzzing), gas-оптимізація (кешування roundId, batch запити).
5. Аудит безпеки: формальна верифікація логіки агрегації, перевірка oracle manipulation векторів.
6. Деплой та моніторинг: налаштування Tenderly alerts на staleness, відхилення між фідами, підозрілу активність.

Ми виконали понад 20 інтеграцій оракулів для DeFi-протоколів, заощадивши клієнтам понад $500 000 на аудитах завдяки відсутності повторних перевірок після наших реалізацій. Середній термін — від 2 до 10 тижнів залежно від складності. Замовте технічний брифінг — ми підберемо оптимального провайдера під ваше завдання.

Орієнтовні терміни

Що входить в роботу

• Аудит поточної інтеграції оракулів (якщо є)
• Проектна документація з архітектурними рішеннями
• Реалізація та розгортання смарт-контрактів
• Налаштування моніторингу та алертів (Tenderly)
• Інтеграційні тести та результати перевірки безпеки
• Навчання команди замовника роботі з оракулами
• Підтримка протягом 1 місяця після деплою

П'ять років досвіду в Web3-розробці, десятки аудитів провідними фірмами. Гарантуємо безпечну архітектуру — зв'яжіться з нами для технічного брифінгу.