Версии и миграция

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Статус в сокращении

Самый важный вывод из этой таблицы: AMM v4 не устарел, и CPMM — новый стандарт — но они сосуществуют намеренно. Пулы AMM v4 имеют многолетнюю историю торговли и не подвергаются принудительной миграции. Выбор программы для запуска нового пула — это рекомендация, а не ограничение.

​

AMM v4 — статус и направление развития

AMM v4 — исходный дизайн пула Raydium: ценообразование с постоянным произведением (x · y = k). Он запущен как гибридный AMM с интеграцией биржи OpenBook (ранее Serum), которая зеркалировала части кривой как лимит-ордера на связанном рынке. Интеграция с OpenBook была отключена — пулы больше не делят ликвидность с OpenBook и все своп-операции выполняются чисто против кривой через entrypoint V2. AMM v4 на практике сегодня — это чистый constant-product AMM с сохранёнными, но неактивными учётными записями OpenBook.

​

Что заморожено

• Нет новых комиссионных уровней. Структура комиссий AMM v4 задаётся на уровне пула и устанавливается при развёртывании. Новые пулы используют одинаковую жёстко заданную комиссию за торговлю ~0,25%, ~12% протоколу.
• Нет новых функций. Команда не добавляет новые инструкции в AMM v4 с момента, когда CPMM стал новым стандартом. Программа находится в режиме поддержки — только исправления ошибок, без расширения функциональности.
• Нет поддержки Token-2022. AMM v4 написана до появления Token-2022, и интеграция никогда не была добавлена. Монеты Token-2022 должны использовать CPMM (или CLMM, где уместно).
• Интеграция OpenBook отключена. Каждый пул AMM v4 по-прежнему привязан к соответствующему учётному хранилищу рынка OpenBook на цепи, но пул больше не размещает и не поддерживает ордера на этом рынке. Сбой OpenBook больше не влияет на своп-операции AMM v4.

​

Что по-прежнему работает

• Существующие пулы торгуют обычно. Принудительная миграция состояния не произошла; пулы v4, созданные в 2021 году, по-прежнему остаются активной площадкой для многих высокотоннажных пар в 2026 году.
• LP могут вносить, выводить средства и собирать награды за фарм как обычно. Миграция на CPMM — это добровольный выбор.
• Агрегаторы по-прежнему маршрутизируют через неё. Jupiter и API торговли Raydium оба индексируют пулы v4 как площадки первого класса.

​

Когда всё ещё использовать AMM v4

Честно говоря: редко. Случаи, когда v4 — это лучший выбор, узки:

• На паре уже есть глубокий, хорошо торгуемый пул v4, и вы хотите добавить ликвидность к существующей глубине, а не расщепить рынок.

(OpenBook-интегрированная маршрутизация больше не является причиной для выбора AMM v4 — эта интеграция отключена.) Во всех остальных случаях запускайте новые пулы на CPMM. Полное дерево решений смотрите в user-flows/choosing-a-pool-type.

​

CPMM — кривая внедрения и миграция v4 → CPMM

CPMM (constant-product market maker, внутреннее имя raydium-cp-swap) развёрнута в 2024 году как переписанная с нуля программа, предназначенная быть новым стандартом для constant-product пулов. Это структурно самая простая из программ Raydium: чистое x · y = k, без биржи, встроенная поддержка Token-2022, меньший объём транзакций.

​

Что CPMM даёт вам по сравнению с AMM v4

• Лучшая экономика для LP по умолчанию. AmmConfig CPMM по умолчанию направляет 100% комиссий за торговлю к LP (с возможностью переключить протокольную комиссию для каждого уровня). AMM v4 жёстко кодирует ~12% для протокола.
• Более низкая стоимость создания пула. Рынок OpenBook не требуется. Создание — это одна транзакция, ~0,15 SOL аренды против ~0,6 SOL для v4.
• Token-2022. Монеты с комиссией за передачу, монеты с hooks передачи (с оговорками), конфиденциальные переводы — всё поддерживается на CPMM, ничего из этого на v4.
• Более чистый интерфейс интегратора. CPMM имеет опубликованный крейт, удобный для Anchor-CPI (raydium-cp-swap), более простой список учётных записей и стабильный IDL. AMM v4 поставляется с IDL, но никогда не имела поддерживаемого крейта Rust CPI.
• Меньше учётных записей на swap операцию. ~10 учётных записей против ~17 для v4 (которая несёт учётные записи рынка OpenBook, даже когда они не используются).

​

Когда миграция имеет смысл

Для активно торгуемого пула повышение LP-комиссии само по себе обычно оправдывает миграцию в течение нескольких месяцев. Расчёт: пул, зарабатывающий 0,25% × $X дневного объёма, отдаёт 0,03% протоколу на v4 (отсутствующие 12%). На CPMM это возвращается к LP. За год это складывается значительно. Для низкотоннажного пула миграция больше о будущем — лучшие настройки по умолчанию, поддержка Token-2022, если она когда-нибудь понадобится, более простые интеграции.

​

Как работает миграция

Обновления на месте нет. Миграция — это последовательность создать-новый-пул, опустошить-старый-пул, переполнить-новый-пул. Полный пошаговый процесс находится в user-flows/migrate-amm-v4-to-cpmm; общая структура:

1. Создайте новый пул CPMM для той же пары на том же уровне комиссии, который вы хотите сохранить.
2. Скоординируйте LP: объявите окно, в течение которого старый пул опустошается, а новый пул наполняется.
3. Каждый LP выводит средства из пула v4 и вносит их в новый пул CPMM.
4. (Необязательно) Установите ферму CPMM, чтобы привлечь incentivized LP в новый пул.
5. Наблюдайте, как объём переходит на более глубокий пул по мере того, как агрегаторы перераспределяют вес.

Сама цепь не требует ничего из этого — API и фронтенд Raydium просто отдают предпочтение более глубокому пулу, а агрегаторы маршрутизируют через тот, который дешевле для пользователя.

​

CLMM — одна программа, стабильная во всех версиях

CLMM находится в своей первой версии программы. Никогда не было v2 — улучшения поставляются как обновления на месте в том же ID программы (позади 24-часового заблокированного многоподписи), а не как новое поколение. Это значит, что нет истории миграции CLMM: существующие позиции остаются там, где они были, и поведение программы может измениться незначительно при развёртывании обновления, но макеты учётных записей и PDA остаются стабильными. Что изменилось через обновления CLMM:

• Инструкция SwapV2 добавлена для правильной поддержки математики комиссий за передачу Token-2022. Старая Swap по-прежнему вызываемая; новые интеграции должны ориентироваться на SwapV2.
• Расширения потока вознаграждений — количество слотов RewardInfo было увеличено (оригинальное 3 → до сих пор 3, но шаблон резервирования был ужесточен). Миграция данных не требуется.
• Компактизация tick-array — внутренняя оптимизация для снижения CU при своп-переходе через много тиков. Внешне невидимо.

IDL находится в выделенном репозитории raydium-idl (смотрите sdk-api/anchor-idl). Если вы запускаете более старый SDK против текущей программы, худший случай — это отсутствие новых инструкций.

​

Farm v3 → v5 → v6

Из всех программ Raydium, Farm имеет самую явную историю версий и единственный путь принудительной миграции. Три поколения — это отдельные программы с отдельными ID программ и отдельными макетами состояния.

​

Поколения

​

Почему существуют три поколения

• v3 → v5: требовались несколько одновременных потоков вознаграждений (например, фермы с двойным стимулом). Дизайн v3 с одним потоком не мог это поддерживать без переделки.
• v5 → v6: целое число u64 для скорости эмиссии v5 ограничивает минимально выражаемую скорость значением «1 токен-единица в секунду». Для монеты с 9 десятичными знаками это 1 лампорт/сек — слишком грубо для низкоэмиссионных программ. Q64.64 дробная скорость v6 исправляет это. v6 также перешла с обновления на основе слотов на wall-clock и добавила поддержку Token-2022.

​

Что остаётся прежним во всех поколениях

• Шаблон учёта «депозит LP, накопление счётчика на акцию, требование при выводе» идентичен во всех v3/v5/v6. Математика не изменяется; только точность счётчика скорости и количество поддерживаемых потоков.
• UserStake (v3/v5) и UserLedger (v6) концептуально одна и та же запись с различными макетами. SDK нормализует оба.

​

Путь миграции

Обновления на месте между версиями ферм нет. Для перехода с v3/v5 на v6:

1. Подождите, пока эмиссия существующей фермы закончится (или уменьшится).
2. Стейкеры выводят средства и требуют ожидающих вознаграждений на старой ферме.
3. Оператор фермы создаёт новую ферму v6 для той же монеты стейкинга.
4. Стейкеры вновь вносят средства в новую ферму.

Реальность на цепи — две несвязанные учётные записи фермы. Пользователь, имеющий стейк в обеих, имеет две записи UserLedger (v6) / UserStake (v5).

​

Что означает «завершение» для v3 и v5

• Программы v3 и v5 по-прежнему развёрнуты и вызываемы. Существующие фермы могут по-прежнему распределять ожидающие вознаграждения и принимать выводы.
• UI Raydium по-прежнему отображает фермы v3 и v5 с активными вознаграждениями; как только истечёт end_time фермы v3/v5, UI скрывает её из «активных», но держит её заявляемой.
• Команда не будет создавать новые фермы v3/v5. Помощники SDK для «создания фермы» маршрутизируют только на v6.
• v3 и v5 получают обновления безопасности, но не функциональные работы. Если обнаружена критическая ошибка, она исправляется; если функция может быть полезна, она добавляется в v6.

Полная информация по каждой версии находится в products/farm-staking/accounts и products/farm-staking/instructions.

​

LaunchLab — одна программа, развивающаяся конфигурация

LaunchLab находится в своей первой версии программы. Как и CLMM, улучшения поставляются как обновления на месте позади 24-часового timelock — не как новые поколения. Что развивалось через обновления:

• Слот комиссии создателя. Добавлен для того, чтобы запуски могли маршрутизировать часть комиссий CPMM торговли после выпускной к первоначальному создателю. Смотрите products/launchlab/creator-fees.
• Конфигурируемость формулы кривой. Первоначально жёстко кодирована как квадратичная; теперь LaunchConfig выбирает из небольшого набора форм кривых.

Существующие запуски LaunchLab не затронуты обновлениями — как только запуск инициализирован, его параметры заморожены до выпускной.

​

Совместимость версий между программами

Несколько замечаний о совместимости между продуктами, которые интеграторы постоянно встречают:

• CLMM SwapV2 — это не та же инструкция, что и Swap. Если ваш клиент поддерживает только Swap, он молча неправильно обработает комиссии за передачу Token-2022 — математика ошибочна на размер комиссии. Обновитесь на SwapV2.
• Стейкинг на Farm v6 с позициями CLMM не поддерживается так же, как стейкинг LP-токенов. Позиции CLMM — это NFT, не взаимозаменяемые LP-токены. CLMM имеет свой собственный встроенный механизм вознаграждения — смотрите products/clmm/fees.
• Пулы CPMM, поддерживаемые монетами Token-2022, работают в фермах только на Farm v6. v3 и v5 отклоняют монеты стейкинга Token-2022.
• Пулы AMM v4 никогда не имеют LP-монет Token-2022. Если вы видите одну, это подделка — AMM v4 не поддерживает эту комбинацию.

​

Что читать далее

• introduction/history-and-milestones — хронологическая временная шкала выпусков и причины, почему каждая версия приземлилась, когда она это сделала.
• user-flows/migrate-amm-v4-to-cpmm — справочник оператора для перехода v4 → CPMM.
• user-flows/choosing-a-pool-type — дерево решений для новых развёртываний пулов.
• products/farm-staking/accounts — схема рядом с рядом для v3 / v5 / v6.
• reference/changelog — что изменилось в этой документации по мере развития версий программ.

Источники:

• Страницы глав по продуктам, цитируемые выше в тексте.
• Raydium SDK v2 — логика диспетчеризации с учётом версии подтверждает, какой программе принадлежит данный пул.
• reference/program-addresses — канонические ID для каждой версии.