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.

Читает, какие управляющие активами в данный момент включены на аккаунте, с их декодированной ончейн-конфигурацией. Возвращает активных управляющих (адрес, протокол, инициатор, декодированные метаданные стратегии, ограничения на проскальзывание и потерю стоимости, получатель комиссии), интенты, на которые они отображаются, и состояние требований Merkl, включая информацию о том, нужно ли ещё регистрировать токены вознаграждения. Управляющие из устаревших развертываний перечислены отдельно в deprecated: передайте их адреса в write.account.automations_delta, чтобы очистить их, или запустите write.account.automations, который отключает их в рамках сохранения. read_ok равен false, когда состояние цепочки не удалось прочитать; в этом случае результат ненадёжен, а не пуст.

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

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

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

Проверяет разрешения 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 для полной картины.

Настраивает автоматизацию аккаунта из списка намерений и возвращает неподписанную транзакцию setAssetManagers. Бэкенд определяет, какие asset managers нужны для каждого намерения, проверяет, что комбинация совместима, кодирует метаданные и формирует calldata — поэтому вы описываете желаемый результат, а не контракты. В режиме 'save' (по умолчанию) массив intents представляет полное желаемое состояние: бэкенд сравнивает его с тем, что сейчас включено, поэтому любая автоматизация, которую вы пропускаете, ОТКЛЮЧАЕТСЯ возвращаемой транзакцией. Передайте одно намерение с enabled: false, чтобы отключить всё. Режим 'preview' проверяет и разрешает намерения БЕЗ чтения состояния цепи и не возвращает транзакцию, потому что его calldata не содержит записей об отключении и только частично применила бы состояние. Используйте его, чтобы проверить, допустима ли комбинация, или показать план; используйте 'save', чтобы получить что-то для подписи. Чтобы переключить одну автоматизацию, не перечисляя остальные, используйте write.account.automations_delta. Intents: - compound_fees: реинвестирует полученные комиссии/вознаграждения обратно в LP. Необязательный 'tokens' ограничивает его по каждому приносящему доход токену. Стейкнутое вознаграждение, не являющееся токеном пула, автоматически обменивается через CowSwap. - claim_rewards: выводит доход. config.mode as_earned выплачивает токены как есть, convert_to обменивает их на config.buy_token через CowSwap. config.convert_tokens конвертирует только часть, а остальное выводит как получено. config.destination — аккаунт или кошелек. - add_to_lp: возвращает простаивающие балансы токенов пула (депозиты, остатки после ребалансировки) обратно в LP. Опционально для каждого токена. - claim_merkl: автоматически забирает стимулирующие вознаграждения Merkl. Независим от триады compounder/claimer/cowswapper и не требует контекста позиции. - rebalance: перемещает LP. Стратегия out_of_range (по умолчанию), take_profit (выполняется на специальном контракте profit-taker) или protocol_owned_liquidity. Передайте position_id (из assets[] в read.account.info), и бэкенд заполнит protocol, is_staked, token0, token1 и reward_tokens за вас; всё, что вы передаёте…

Применяет явное изменение к автоматизациям аккаунта и возвращает неподписанную транзакцию setAssetManagers. В отличие от write.account.automations, это дельта, а не полное желаемое состояние: автоматизации, которые вы не упоминаете, остаются нетронутыми. Используйте её, чтобы включить или выключить одну автоматизацию, не перечисляя остальные. Массив enable принимает интенты для включения (те же формы, что и в write.account.automations). Чтобы ВЫКЛЮЧИТЬ автоматизацию, вызовите read.asset_manager.current, возьмите адрес менеджера, который её обслуживает, и передайте этот адрес в массив disable: интент с enabled: false в enable будет отклонён, потому что бэкенд его проигнорирует. Замещённые или нечитаемые менеджеры, всё ещё установленные на аккаунте, принудительно отключаются в той же транзакции независимо от этого. Интенты: - compound_fees: реинвестирует заработанные комиссии/вознаграждения обратно в LP. Опциональный 'tokens' ограничивает его по каждому доходному токену. Стейкнутое вознаграждение, которое не является токеном пула, автоматически обменивается через CowSwap. - claim_rewards: выводит доход. config.mode: as_earned выплачивает токены как есть, convert_to обменивает их на config.buy_token через CowSwap. config.convert_tokens конвертирует только часть, а остальное выводит как есть. config.destination: аккаунт или кошелёк. - add_to_lp: возвращает простаивающие балансы токенов пула (депозиты, остатки от ребалансировки) обратно в LP. Опционально для каждого токена. - claim_merkl: автоматически забирает вознаграждения Merkl. Независим от триады компаундер/клеймер/ковсваппер и не требует контекста позиции. - rebalance: перебалансирует LP. Стратегия: out_of_range (по умолчанию), take_profit (выполняется на специальном контракте фиксации прибыли) или protocol_owned_liquidity. Передайте position_id (из assets[] в read.account.info), и бэкенд сам заполнит protocol, is_staked, token0, token1 и reward_tokens; всё, что вы передадите явно, имеет приоритет. claim_merkl не требует контекста позиции. Правила, которые бэкенд применяет (нарушение возвращается как ошибка, никогда не записывается в цепочку): - Каждый доходный токен должен быть назначен ровно одному из compound_fees или claim_rewards.

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

Атомарное 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.

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).

Строит неподписанную транзакцию депозита в транш кредитования 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, чтобы проверить, существует ли уже утверждение — пропустите этот шаг, если текущего разрешения достаточно.