Настройка аналитики блокчейн-проекта (DefiLlama) — TVL, субграф, Dune

TVL — ключевая метрика для любого DeFi-протокола. По данным DefiLlama, проекты без листинга теряют до 70% видимости для институциональных инвесторов. Причина не в сложности, а в типичных ошибках адаптера: неправильный учёт factory-пулов, doublecount, неверная обработка historical blocks. Мы разберём каждую проблему и покажем, как их избежать.

Мы, как блокчейн-инженеры с опытом листинга десятков протоколов, знаем эти проблемы изнутри. Правильный TypeScript-адаптер настраивается за 1-2 дня, но без опыта вы рискуете потратить недели на отладку. Наш подход — модульные тесты на 100+ блоках, использование Multicall3 для батчинга запросов и формальная верификация через Slither. Самостоятельная разработка занимает в 2-3 раза больше времени, чем заказ у нас, а экономия бюджета достигает 30%.

Как устроен адаптер DefiLlama

Каждый протокол в DefiLlama представлен модулем из репозитория DefiLlama/DefiLlama-Adapters. Этот модуль экспортирует функцию tvl(), которая по запросу платформы с параметрами цепочки и блока возвращает текущие балансы в виде {token_address: amount}. DefiLlama периодически дёргает эту функцию для исторических блоков — критично, чтобы адаптер работал корректно не только на свежих, но и на старых данных.

Структура адаптера

async function tvl(api: ChainApi) {
  const balance = await api.call({
    abi: 'erc20:balanceOf',
    target: tokenAddress,
    params: [protocolVaultAddress],
  })
  api.add(tokenAddress, balance)
}

module.exports = {
  ethereum: { tvl },
  arbitrum: { tvl },
}

Динамические адреса контрактов

Factory-паттерн (как в Uniswap: один factory создаёт тысячи пулов) делает хардкод адресов невозможным. Наш опыт показывает, что без использования api.multiCall индексация 10 000 пар займёт часы и десятки тысяч RPC-запросов. Используем Multicall3 для батчинга — сотня вызовов за один запрос.

const pairsCount = await api.call({ abi: 'uint256:allPairsLength', target: factory })
const pairs = await api.multiCall({
  abi: 'function allPairs(uint256) returns (address)',
  target: factory,
  calls: Array.from({ length: Number(pairsCount) }, (_, i) => ({ params: [i] })),
})

Как избежать двойного учёта TVL?

Если ваш протокол задействует Aave или Compound, их токены уже учтены в TVL этих платформ. Добавление тех же активов в адаптер — doublecount, который DefiLlama понижает. Выход — считаем только нативные позиции или явно ставим doublecounted: true в конфиге.

Верификация и ошибки

После отправки PR DefiLlama проверяет данные. Алерты при скачках TVL ±50% между соседними блоками — признак edge case (балансы до инициализации пула). На этапе тестов запускаем адаптер локально через npx defillama test adapter.js, прогоняем на 50 случайных блоках. Если ошибка не воспроизводится — симулируем через Tenderly.

Какие метрики критичны для DeFi-протокола?

Листинг на DefiLlama — это первый шаг. Параллельно настраиваем субграф на The Graph для отслеживания объёмов торгов, числа уникальных пользователей и истории транзакций. Субграф — фундамент вашего дашборда. Для детального on-chain анализа подключаем Dune с SQL-запросами по decoded данным — DefiLlama и Dune работают в связке.

Почему выбирают нас?

Наша команда выполнила листинг для 12+ DeFi-протоколов на Ethereum, Arbitrum, Polygon и BNB Chain. Среднее время от запроса до отображения на DefiLlama — 5 рабочих дней. Мы гарантируем корректность исторических данных и прозрачность метрик. Используем формальную верификацию через Slither и Echidna для контрактов — это снижает риск реджекта PR на 80%.

Что входит в нашу работу

• Разработка и тестирование адаптера TypeScript под все сети вашего протокола.
• Исправление edge case (factory, doublecount, reinitialization).
• Отправка PR и прохождение ревью в DefiLlama.
• Настройка субграфа и развёртывание на hosted service.
• Подготовка SQL-запросов для Dune Analytics.
• Документация по поддержке и обновлению адаптера.

Как мы работаем

1. Анализ архитектуры протокола: контракты, сети, factory.
2. Написание адаптера с модульными тестами.
3. Локальный прогон на исторических данных (минимум 100 блоков).
4. Отправка PR и устранение замечаний DefiLlama.
5. Параллельно развёртывание субграфа.
6. Передача готовой инфраструктуры: доступы, документация, обучение команды.

Сроки и стоимость

• Односетевой адаптер: 1-2 дня разработки + 2-7 дней ревью.
• Мультичейн с factory: 2-3 дня.
• Субграф дополнительно: 2-4 дня.

Стоимость рассчитывается индивидуально. Получите консультацию: напишите нам, и мы оценим ваш проект за 24 часа. Мы также предлагаем экспресс-аудит текущего адаптера с выявлением ошибок за один рабочий день.

Разработка DeFi-протоколов

Мы проектируем модульные DeFi-протоколы, в которых математика стейблкоинов, ликвидности и оракулов работает без сбоев. Mango Markets — краш-тест: атакующий манипулировал spot price через один аккаунт, взял кредит под завышенный collateral и вывел $114 млн. Оракул брал цену с единственного источника без TWAP. Не баг в коде — это архитектурное решение, которое стало уязвимостью. Наш опыт показывает: любой DeFi-протокол — это система ставок на то, что все компоненты, от расчётов до экономических стимулов, выстроены правильно одновременно.

Мы не пишем код под «если всё работает, не трогай». Мы моделируем стресс-сценарии: каскадные ликвидации, депег, флеш-кредиты. И только после этого — события, которые не сломают протокол.

Почему оракулы — критический компонент DeFi?

Большинство крупных взломов DeFi начинались с манипуляции оракулом. Разберём три слоя, которые мы используем в каждом проекте.

Spot price как оракул — не вариант. Uniswap v2 spot price можно сдвинуть flash loan за одну транзакцию. Цена в конце блока — единственное, что попадает в state, её и читает оракул. Схема атаки: занять через flash loan → купить актив в пул → цена поднялась → взять кредит под завышенный collateral → продать актив → вернуть flash loan. Одна транзакция.

TWAP как защита. Uniswap v3 observe() усредняет цену за период (30 минут). Манипуляция требует удерживать цену несколько блоков — это стоит дорого. Но TWAP медленно реагирует на легитимные изменения, что открывает окно для arbitrage на liquidation при резких движениях.

Chainlink Price Feeds — агрегация от множества data providers с медианой. Стандарт для lending. Проблема: heartbeat 1–24 часа и deviation threshold 0.5%. Если цена не двигается, фид может не обновляться сутки. В волатильном рынке — lag.

В продакшене мы используем двухуровневую проверку: Chainlink aggregator + Uniswap v3 TWAP как верификатор. Если расхождение больше N% — транзакция отклоняется, система ставится на паузу.

Как защитить DeFi-протокол от flash loan атак?

Flash loan превращает любого пользователя в обладателя неограниченного капитала на одну транзакцию. Поэтому при проектировании контрактов мы предполагаем: доступ к неограниченному капиталу есть у всех. Это меняет threat model полностью.

Легитимные применения flash loan — arbitrage, liquidation, самоликвидация. Но протокол должен проверять, что заём не используется для манипуляции: оракул не должен читать цену из пула, который можно сдвинуть за одну транзакцию. Мы добавляем проверки на block.timestamp и минимальную глубину ликвидности.

Ключевые компоненты DeFi-архитектуры

AMM: от x*y=k до concentrated liquidity

Uniswap v2 использует x * y = k. LP-токены ERC-20 — каждый пул выпускает свой токен пропорционально доле. Проблема: ликвидность размазана по всей кривой, большая часть не используется.

Uniswap v3 и позиции ERC-721: concentrated liquidity — LP предоставляет ликвидность в диапазоне [priceLow, priceHigh]. Capital efficiency до 4000x для стабильных пар. Но ERC-721 ломает vault-стратегии под ERC-20. Управление ranges — отдельная инженерная задача: позиция выходит из диапазона при движении цены, перестаёт зарабатывать fees, становится single-asset. Протоколы типа Arrakis Finance автоматически rebalance. Если строите vault поверх v3, нужен собственный range manager или интеграция с существующим.

Slippage в v3 рассчитывается через sqrtPriceX96 — 96-битная fixed-point математика. Ошибки на фронтенде приводят к расхождению между видимым и фактическим slippage.

Curve для пар с близкими ценами (stablecoin/stablecoin, stETH/ETH) использует инвариант, комбинирующий constant product и constant sum. Меньше slippage в диапазоне peg. Контракты на Vyper, код математически плотный, аудировать сложно.

Lending протоколы: collateral, liquidation, bad debt

LTV определяет максимальный кредит под collateral. Liquidation threshold — уровень ликвидации. Разница — буфер для liquidator. Типичный пример: LTV 75%, liquidation threshold 80%, bonus 5%. Если цена падает на 20%+, позиция открыта к ликвидации.

Каскадные ликвидации: много позиций ликвидируется одновременно → ликвидаторы продают collateral → цена падает → следующая волна. LUNA/UST 2022 — классический каскад.

Если collateral обесценивается быстрее ликвидации, протокол получает bad debt. Aave использует Safety Module (застейканный AAVE), Compound — reserves. Без backstop bad debt социализируется через dilution supply-токена или взаимозачёт.

Проектирование системы ликвидации требует моделирования стресс-сценариев: падение единственного liquidation bot, высокий gas, делистинг collateral.

Yield farming и incentive mechanics

Liquidity mining — раздача governance-токенов LP-провайдерам. Проблема mercenary capital: фармеры приходят, продают токены, уходят. TVL фиктивный.

Устойчивые механики: protocol-owned liquidity (Olympus bonding), veToken (CRV locked → boost + governance), locked staking с penalty. Ve-модель при неправильной реализации создаёт governance concentration. Нужен timelock на изменения gauge weights и лимиты на votingPower.

Что входит в нашу разработку DeFi-протоколов

• Архитектурная документация: диаграммы взаимодействия контрактов, стресс-тесты ликвидаций, расчёты оракулов.
• Реализация на Solidity 0.8.x с OpenZeppelin 5.x (AccessControl, ReentrancyGuard, Pausable, TimelockController) и Solmate для gas-optimised base contracts.
• Foundry fork-тесты на реальном mainnet (Uniswap, Chainlink, Aave) — тесты до деплоя покрывают все сценарии.
• Аудит: минимум два независимых аудитора для TVL от $1M. Code4rena или Sherlock для bug bounty.
• Деплой с Gnosis Safe 3/5 multisig + timelock 48–72 часа.
• Мониторинг через Tenderly (alerts, симуляции), OpenZeppelin Defender (automation), Forta (on-chain threat detection).
• Поддержка после запуска: обновления, патчи, апгрейды через proxy.

Наши компетенции и опыт

Мы разрабатываем DeFi-протоколы с 2020 года — за это время реализовали 30+ проектов с общим TVL более $150 млн. Среди клиентов — протоколы в топ-20 по TVL на Ethereum, Arbitrum и Base. Команда сертифицированных разработчиков Solidity, прошедших аудиторские треки ConsenSys Diligence.

DeFi на Wikipedia — базовые принципы, которые мы применяем на практике.

Сроки

• DEX с AMM (Uniswap v2 fork): 6–10 недель
• Lending protocol (Aave-style, один collateral): 3–5 месяцев
• Yield aggregator с несколькими стратегиями: 2–4 месяца
• Полноценный DeFi-протокол с governance: 5–8 месяцев включая аудит

Стоимость рассчитывается индивидуально — свяжитесь для оценки вашего проекта.

Получите консультацию по архитектуре DeFi-протокола — мы проанализируем риски и предложим оптимальное решение.