arcadia-finance/mcp-server

ТОЛЬКО ДЛЯ РАЗРАБОТКИ — Подписывает и отправляет неподписанную транзакцию, используя локальный приватный ключ (переменная окружения PK). Для продакшена используйте выделенный MCP-сервер кошелька (Fireblocks, Safe, Turnkey и т.д.) вместо этого инструмента. Принимает объект транзакции, возвращённый любым инструментом write.*, и отправляет его в ончейн.

Получает исторические значения залога и долга для учетной записи Arcadia за период. Возвращает временной ряд снимков (временная метка, стоимость залога, сумма долга, чистая стоимость). Каждое значение — это чистая стоимость учетной записи в долларах США (в удобном для чтения виде, не в сырых единицах). Полезно для построения графиков производительности учетной записи за период.

Получить полный обзор аккаунта Arcadia: фактор здоровья, стоимость залога, долг, депонированные активы, цена ликвидации и статус автоматизации. Фактор здоровья = 1 - (used_margin / liquidation_value): 1 = нет долга (самый безопасный), >0 = здоровый, 0 = порог ликвидации, <0 = после ликвидации. Чем выше, тем безопаснее. На всех поддерживаемых цепочках возвращает объект `automation`, показывающий, какие менеджеры активов включены (rebalancer, compounder, yield_claimer, merkl_operator, gas_relayer, cow_swapper). Обнаружение автоматизации охватывает каждую версию менеджера активов, развернутую на выбранной цепочке — регистрации, сделанные на старых версиях, всё ещё считаются активными. Возвращаемое значение — это пользовательский dex_protocol (например, 'slipstream') без суффикса версии. Позиции LP в assets[] содержат поле dex_protocol (slipstream, slipstream_v2, slipstream_v3, staked_slipstream, staked_slipstream_v2, staked_slipstream_v3, uniV3, uniV4) — используйте его как параметр dex_protocol для инструментов write.asset_manager.*. Slipstream V2 доступен только на Base. V3 доступен на Base и Optimism. Unichain поддерживает только Slipstream V1, uniV3 и uniV4. Объект automation использует внутренние ключи AM (slipstreamV1, slipstreamV2, slipstreamV3, uniV3, uniV4): сопоставьте slipstreamV1 → 'slipstream'/'staked_slipstream', slipstreamV2 → 'slipstream_v2'/'staked_slipstream_v2', slipstreamV3 → 'slipstream_v3'/'staked_slipstream_v3', uniV3 → 'uniV3', uniV4 → 'uniV4'. Числовые поля без суффикса _usd указаны в сырых единицах расчетного токена аккаунта (делить на 10^decimals: 6 для USDC, 18 для WETH, 8 для cbBTC). Поля, оканчивающиеся на _usd, указаны в USD с 18 десятичными знаками (делить на 1e18). health_factor безразмерный. Количество активов указано в сырых единицах токена. Чтобы получить список всех аккаунтов для кошелька, используйте read.wallet.accounts.

Получить PnL (cost basis) и заработанный доход для аккаунта Arcadia. Возвращает суммарные показатели за всё время: cost basis в сравнении с текущей стоимостью (отрицательный cost_basis = чистая выведенная прибыль), чистые переводы на токен, общий заработанный доход в USD и на токен. cost_basis, current_value, cost_diff указаны в USD (человекочитаемый формат). Поля на токен (net_transfers, summed_yields_earned) указаны в сырых единицах токена.

Перечисляет поддерживаемые залоговые активы в Arcadia. Возвращает компактный список (адрес, символ, десятичные разряды, тип). Используйте поиск для фильтрации по подстроке символа. Для цен в USD используйте read.asset.prices.

Выведи список всех доступных интентов автоматизации с их названиями инструментов, обязательными параметрами и поддерживаемыми цепочками. Используй это, чтобы узнать, какие автоматизации можно настроить и что каждая из них делает. У каждого интента есть соответствующий инструмент write.asset_manager.{id}, который возвращает закодированные аргументы. Чтобы применить автоматизации, вызови инструменты интентов, затем передай объединённый результат в write.account.set_asset_managers. Все инструменты интентов принимают enabled=false для отключения. Несколько интентов можно объединить, слив их возвращаемые массивы в один вызов set_asset_managers.

Получить цены в USD для одного или нескольких адресов активов. Передайте один адрес или адреса через запятую. Возвращает карту цен, где ключ — адрес.

Получите руководства по рабочим процессам Arcadia и справочную документацию. Вызывайте этот инструмент перед многошаговыми рабочими процессами (открытие позиций LP, включение автоматизации, закрытие позиций) или когда вам нужны адреса контрактов, адреса управляющих активами или параметры стратегий. Темы: обзор (адреса + каталог инструментов), автоматизация (настройка ребалансера/компаундера), стратегии (пошаговые шаблоны), выбор (как оценивать и задавать параметры стратегий).

Получите таблицу лидеров очков Arcadia (с пагинацией). Для баланса очков конкретного кошелька используйте read.wallet.points.

Получает подробную информацию об одном кредитном пуле, включая историю APY за всё время. Полезно для анализа трендов ставок и сравнения пулов. Используйте read.pool.list, чтобы найти адреса пулов.

Перечисли все пулы кредитования Arcadia: TVL, загрузка, доступная ликвидность. Ключевые поля: interest_rate = текущая стоимость заимствования, lending_apy = доходность кредитора. Все ставки указаны в десятичных дробях (1.0 = 100%, 0.06 = 6%). Для истории APY по конкретному пулу используйте read.pool.info.

Получить полную информацию о конкретной LP-стратегии по ID: включает APY в зависимости от ширины диапазона (более узкий диапазон = выше APY, но больше затрат/риска на ребалансировку), информацию о пуле и конфигурацию. Используйте read.strategy.list, чтобы узнать ID стратегий. Все значения APY: десятичные дроби (1.0 = 100%, 0.05 = 5%).

Получите стратегии Arcadia LP. Используйте featured_only=true для отобранных лучших стратегий (рекомендуется первый вызов). Возвращает постраничный список со средним APY за 7 дней для диапазона по умолчанию каждой стратегии. Увеличьте limit или используйте offset для постраничного вывода. Все значения APY — десятичные дроби (1.0 = 100%, 0.05 = 5%). Для получения полной информации о конкретной стратегии (APY для каждой ширины диапазона) используйте read.strategy.info.

Получите рекомендацию по ребалансировке для аккаунта Arcadia: предлагает изменения в активах для оптимизации доходности. Использует APY за 1 день (не 7 дней, как read.strategy.list), поэтому рекомендуемые стратегии могут отличаться от рейтинга в списке. Значения APY: десятичные дроби (0.05 = 5%). weekly_earning_difference указана в долларах США.

Выводит список всех аккаунтов Arcadia, принадлежащих адресу кошелька. Возвращает сводку по каждому аккаунту (адрес, имя). Вызовите read.account.info с конкретным account_address для получения полной информации, такой как коэффициент здоровья, обеспечение и долг.

Проверьте лимиты (allowances) ERC20 токенов для адреса расходчика. Используйте перед write.wallet.approve, чтобы избежать лишних подтверждений — пропускайте подтверждение, если текущий лимит уже достаточен.

Получает балансы нативного ETH и ERC20-токенов для адреса кошелька. Читает напрямую из блокчейна через RPC multicall. Используйте перед вызовом write.account.add_liquidity или write.account.deposit, чтобы проверить, хватает ли у кошелька токенов. Возвращает как сырой баланс (в минимальной единице/wei), так и форматированный (человекочитаемый) для каждого токена.

Получить баланс очков Arcadia для конкретного адреса кошелька.

Многошаговое flash-действие: атомарно объединяет [депозит из кошелька] + [использование залога счёта] + [своп до оптимального соотношения] + [выпуск LP] + [заимствование при использовании кредитного плеча] в ОДНУ транзакцию. НЕ вызывайте write.account.deposit отдельно. Источники капитала: токены кошелька (массив deposits), существующий залог счёта (use_account_assets=true) или оба. Сначала проверьте allowances (read.wallet.allowances), затем подтвердите при необходимости (write.wallet.approve). Поддерживает депонирование нескольких токенов и выпуск нескольких LP-позиций в одной транзакции. Работает как с маржинальными счетами (можно использовать кредитное плечо), так и со спотовыми счетами (без кредитного плеча). Для рабочих процессов вызовите read.guides('strategies'). Возвращаемые calldata чувствительны ко времени — подпишите и отправьте в течение 30 секунд. Если транзакция откатывается из-за изменения цены, пересоберите и подпишите снова немедленно (повторите хотя бы один раз, прежде чем сдаться). Ответ включает tenderly_sim_url и tenderly_sim_status для проверки перед отправкой. expected_value_change указывается в сырых единицах нумерарного токена счёта (6 знаков после запятой для USDC, 18 для WETH). Отрицательное значение = стоимость открытия, положительное = полученная выгода. Сравните before.total_account_value и after.total_account_value для полной картины.

Создайте неподписанную транзакцию для займа из пула кредитования Arcadia под залог счета. НЕ нужно для маржинированной ликвидности (leveraged LP) — write.account.add_liquidity обрабатывает заимствование внутри, когда leverage > 0. Работает только с маржинальными счетами (созданными с кредитором/пулом кредитования). Спотовые счета (без кредитора) не могут брать займы — инструмент это проверит и отклонит. Перед заимствованием убедитесь, что у счета положительная свободная маржа через read.account.info: collateral_value должна превышать used_margin.

Атомарное flash-действие, которое закрывает позицию в аккаунте Arcadia за ОДНУ транзакцию. Атомарно объединяет до 3 шагов: [сжечь LP-позицию] + [обменять все токены на один целевой актив] + [погасить долг]. Токены остаются в аккаунте после закрытия — используйте write.account.withdraw, чтобы отправить их в кошелёк. ВСЕГДА сначала пробуйте этот инструмент при закрытии/выходе из позиции. Используйте отдельные инструменты (write.account.remove_liquidity, write.account.swap, write.account.deleverage, write.account.withdraw) только если этот не сработал. Поддерживает два режима: - close_lp_only=true: Сжигает LP и оставляет базовые токены в аккаунте. Используйте как шаг 1, если полное закрытие не удалось, затем вызовите снова с close_lp_only=false, чтобы обменять и погасить оставшиеся токены. - close_lp_only=false (по умолчанию): Полное атомарное закрытие — сжигает LP, обменивает всё на receive_assets, гасит долг. Оставшиеся токены остаются в аккаунте. После этого вызовите write.account.withdraw, чтобы отправить в кошелёк. Поддерживает несколько receive-активов с произвольным распределением. Возвращаемые calldata чувствительны ко времени — подпишите и отправьте в течение 30 секунд. Если транзакция откатится из-за изменения цены, пересоберите и подпишите снова немедленно (повторите хотя бы один раз, прежде чем сдаться). Ответ включает tenderly_sim_url и tenderly_sim_status для проверки до отправки.

Создайте неподписанную транзакцию для создания нового счета Arcadia через контракт Factory. account_version: 3 с кредитором → маржинальный счет V3 (можно занимать/использовать кредитное плечо). account_version: 0 или 4 → спотовый счет V4 (нет заимствования, кредитор игнорируется, разрешены любые ERC20). Возвращает предсказанный адрес счета (детерминированный через CREATE2).

Многошаговое flash-действие: продает залог аккаунта в токен долга и погашает в одной атомарной транзакции — не нужны токены из кошелька. Чтобы погасить из токенов кошелька, используйте write.account.repay. ПРИМЕЧАНИЕ: Если вы закрываете позицию (remove LP + swap + repay + withdraw), используйте write.account.close, который объединяет всё атомарно. Используйте этот инструмент только для отдельного погашения, сохраняя позицию активной. Возвращаемые calldata чувствительны ко времени — подпишите и отправьте в течение 30 секунд. Если транзакция откатывается из-за движения цены, пересоберите и подпишите снова немедленно (повторите попытку хотя бы один раз, прежде чем сдаться). Ответ включает tenderly_sim_url и tenderly_sim_status для проверки перед отправкой — если tenderly_sim_status равен 'false', НЕ отправляйте транзакцию.

Создайте неподписанную транзакцию для внесения активов в счёт Arcadia в качестве залога. Поддерживает токены ERC20 и NFT ERC721 (позиции LP). НЕ требуется перед write.account.add_liquidity — этот инструмент вносит депозит из кошелька атомарно. Сначала убедитесь, что счёт одобрен (вызовите read.wallet.allowances для проверки, затем write.wallet.approve при необходимости). Версия счёта определяется автоматически по цепочке (переопределите с помощью account_version при необходимости).

Flash-action: ЧАСТИЧНО уменьшает ликвидность из LP-позиции. Позиция остаётся открытой с уменьшенной ликвидностью; базовые токены остаются на счёте. Для ПОЛНОГО выхода из позиции (сжечь LP + обменять + погасить + вывести) используйте write.account.close — он объединяет всё в одну атомарную транзакцию. Возвращаемые calldata чувствительны ко времени — подписывайте и отправляйте в течение 30 секунд. Если транзакция откатывается из-за движения цены, пересоберите и подпишите заново немедленно (повторите попытку хотя бы один раз, прежде чем сдаться). Ответ включает tenderly_sim_url и tenderly_sim_status для проверки перед отправкой.

Погашает долг перед пулом кредитования Arcadia токенами из кошелька (требуется предварительное разрешение на ERC20). Чтобы погасить за счёт залога на счёте (токены с кошелька не нужны), используй write.account.deleverage. Сначала проверь allowance (read.wallet.allowances), при необходимости разреши пулу списание (write.wallet.approve). Узнай непогашенный долг через read.account.info.

Создаёт неподписанную транзакцию setAssetManagers из закодированных аргументов намерения. Берёт массивы { asset_managers, statuses, datas }, возвращённые инструментами намерения write.asset_manager.*, и собирает одну неподписанную tx, направленную на аккаунт. Чтобы объединить несколько автоматизаций в одну tx, склейте массивы из нескольких вызовов инструментов намерения, прежде чем передавать их сюда. Пример: чтобы включить rebalancer + merkl_operator, вызовите оба инструмента намерения, объедините их массивы, затем передайте объединённые массивы этому инструменту. Возвращает { transaction: { to, data, value, chainId } }.

Flash-action: стейк, анстейк или получение наград для LP позиции в одной атомарной транзакции. Используйте параметр `action` для выбора операции. `asset_address` — контракт менеджера позиции: передавайте адрес PM без стейкинга при стейке или адрес PM со стейкингом при анстейке. Возвращаемые calldata чувствительны ко времени: подпишите и отправьте в течение 30 секунд. Если транзакция откатывается из-за движения цены, пересоберите и подпишите заново немедленно (повторите попытку хотя бы один раз, прежде чем сдаться). Симуляция Tenderly может быть недоступна для этой конечной точки: проверьте существование позиции через read.account.info перед подписью.

Flash-action: обменивает активы внутри аккаунта Arcadia одной атомарной транзакцией. Бэкенд находит оптимальный маршрут обмена. ПРИМЕЧАНИЕ: Если вы закрываете позицию (обмен + погашение + вывод), используйте write.account.close — он объединяет всё в одну атомарную операцию. Используйте этот инструмент только для отдельных обменов внутри активной позиции. Возвращаемые calldata чувствительны ко времени — подпишите и отправьте в течение 30 секунд. Если транзакция откатится из-за изменения цены, пересоберите и подпишите заново (повторите хотя бы один раз, прежде чем сдаться). Ответ включает tenderly_sim_url и tenderly_sim_status для проверки перед отправкой — если tenderly_sim_status равен 'false', НЕ отправляйте транзакцию.

Создаёт неподписанную транзакцию для вывода активов из аккаунта Arcadia в кошелёк владельца. Выводить может только владелец аккаунта. Вернёт ошибку, если у аккаунта есть долг и вывод сделает его недостаточно обеспеченным. Не поддерживает max_uint256 — передавайте точные суммы из read.account.info. Версия аккаунта определяется автоматически в цепочке (при необходимости переопределите через account_version).

Кодирует аргументы для автономной автоматизации компаундирования. Забирает накопленные комиссии LP и реинвестирует их обратно в позицию (сложный процент). Только комиссии LP — НЕ забирает награды за стейкинг вроде AERO; используйте write.asset_manager.compounder_staked для стейкнутых позиций, которые приносят эмиссионные токены. В паре с ребалансировщиком ребалансировщик компаундирует в момент ребалансировки — добавление компаундера также начисляет проценты между ребалансировками, повышая эффективную годовую доходность. Возвращает { asset_managers, statuses, datas } — передавайте в write.account.set_asset_managers. Совместим с другими intent-инструментами.

Закодируй аргументы для Compounder, объединённого с CowSwap для стейкнутых LP-позиций (например, застейканные Slipstream/Aerodrome). Стейкнутые позиции приносят награды за стейкинг (например, AERO на Aerodrome), а не комиссии за LP. Забирает эти награды за стейкинг, обменивает их на целевой токен через пакетные аукционы CowSwap (с защитой от MEV), а затем реинвестирует обратно в LP-позицию. Устанавливает метаданные НА ОБОИХ: CowSwapper и Compounder за один вызов. sell_tokens - это список адресов токенов наград (например, [AERO_address]). buy_token должен быть основным токеном в паре (USDC, WETH, cbBTC). Возвращает { asset_managers, statuses, datas } с двумя записями (cowswapper + compounder). Только Base. Сочетается с другими инструментами.

Кодирует аргументы для автономного прямого режима CowSwap. Позволяет CowSwapper обменивать любые ERC20 → ERC20 через пакетные аукционы CoW Protocol (с защитой от MEV). В отличие от compounder_staked или yield_claimer_cowswap, этот режим НЕ привязан к какой-либо другой автоматизации — каждый обмен требует дополнительной подписи от владельца аккаунта. Доступен только на Base (8453). Возвращает { asset_managers, statuses, datas } — передайте в write.account.set_asset_managers. Сочетается с другими инструментами намерений.

Закодируйте аргументы для автоматизации оператора Merkl. Зачисляет на аккаунт внешние стимулирующие вознаграждения протокола Merkl - это дополнительные награды от команд токенов сверх обычных комиссий пула ликвидности. Включайте, когда в пуле есть активные кампании Merkl (проверьте разбивку APY в read.strategy.list). Всегда комбинируйте с ребалансером, когда оба актуальны - нет конфликта, дополнительный бесплатный доход. Доступно на всех поддерживаемых цепочках. Возвращает { asset_managers, statuses, datas } - передайте в write.account.set_asset_managers. Комбинируется с другими инструментами намерений.

Закодируйте аргументы для автоматизации ребалансировки. Когда позиция LP выходит за диапазон, бот Arcadia переставляет её, центрируя по текущей цене. Все ожидающие комиссии и награды за стейкинг собираются и реинвестируются в новую позицию. Конфигурация стратегии: 'default' (все параметры по умолчанию) использует when_out_of_range - ребалансирует ровно в момент выхода цены за диапазон. 'custom' (любой параметр отличается) использует time_and_price_based_triggers - добавляет настраиваемые смещения триггеров, задержки и состав токенов. Возвращает { asset_managers, statuses, datas } - передайте в write.account.set_asset_managers, чтобы сформировать неподписанную транзакцию. Можно комбинировать: объедините массивы из нескольких инструментов намерений, чтобы настроить несколько автоматизаций в одной транзакции. trigger_lower_ratio и trigger_upper_ratio независимы - асимметричные конфигурации допустимы (например, trigger_lower_ratio=-50000, trigger_upper_ratio=0 означает: срабатывание за 5% тикового диапазона до достижения нижней границы, но срабатывание только точно на верхней границе). Коэффициенты показывают расстояние в тиках, а не цену: коэффициент 50000 сдвигает триггер на 5% от (tick_upper - tick_lower) тиков, что не то же самое, что 5% цены.

Кодирует аргументы для автоматизации получения доходов в автономном режиме. Периодически забирает накопленные комиссии/эмиссии и отправляет их указанному получателю (кошельку, другому аккаунту или любому адресу). Возвращает { asset_managers, statuses, datas } — передавайте в write.account.set_asset_managers. Можно комбинировать с другими такими вызовами.

Закодировать аргументы для сборщика доходности в связке с CowSwap. Собирает комиссии LP, затем обменивает собранные токены на целевой токен через пакетные аукционы CowSwap (защита от MEV). Для стейкнутых LP sell_tokens — это список токенов вознаграждения за стейкинг (например, [AERO_address]). Для нестейкнутых LP sell_tokens — все токены комиссий LP, кроме buy_token — например, для пары WETH/USDC, забирающей комиссии в USDC, используйте sell_tokens: [WETH_address], buy_token: USDC_address. Устанавливает метаданные И на CowSwapper, И на Yield Claimer. Возвращает { asset_managers, statuses, datas } с двумя записями (cowswapper + yield_claimer). Только Base. Сочетается с другими инструментами intent.

Создайте неподписанную транзакцию депозита в кредитный транш Arcadia (ERC-4626). Кредиторы вносят базовый актив пула (USDC/WETH/cbBTC) и получают доли транша, на которые начисляются проценты от заёмщиков. Требуется предварительное одобрение ERC-20 для транша (см. write.wallet.approve). Чтобы проверить текущую доходность кредитора, вызовите read.pool.list или read.pool.info.

Создаёт неподписанную транзакцию погашения для вывода из кредитного транша Arcadia (ERC-4626). Сжигает доли транша и возвращает соответствующее количество базового актива, включая начисленные проценты. Владелец должен быть держателем долей. Получатель — адрес, куда отправляется базовый актив.

Создайте неподписанную транзакцию одобрения. Для токенов ERC20: генерирует approve(spender, amount). Для NFT ERC721/ERC1155 (например, LP позиций): генерирует setApprovalForAll(operator, true). Требуется перед write.account.deposit или write.account.add_liquidity (при депозите из кошелька). Совет: сначала вызовите read.wallet.allowances, чтобы проверить, есть ли уже одобрение - пропустите этот шаг, если текущего разрешения достаточно.