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

​

Статус в общих чертах

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

​

AMM v4 — статус и траектория

AMM v4 — это оригинальный дизайн пула Raydium: ценообразование с постоянным произведением (x · y = k). Он был запущен как гибридный AMM с интеграцией биржи OpenBook (ранее Serum), которая отражала части кривой как лимитные ордера на связанном рынке. Интеграция OpenBook с тех пор была деактивирована — пулы больше не делят ликвидность с OpenBook, и все своп-операции выполняются чисто против кривой через точки входа V2. Сегодня AMM v4 — это, по сути, чистый 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 и Raydium Trade API оба индексируют пулы v4 как площадки первого класса.

​

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

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

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

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

​

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

CPMM (маркет-мейкер с постоянным произведением, внутреннее имя raydium-cp-swap) был развёрнут в 2024 году как переписанный с нуля новый стандарт пула с постоянным произведением. Это структурно самая простая из программ 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. Минты с комиссией за передачу, минты с хуком передачи (с оговорками), конфиденциальные передачи — всё поддерживается на CPMM, ничего на v4.
• Более чистая поверхность интегратора. CPMM имеет опубликованный крейт, дружественный к Anchor-CPI (raydium-cp-swap), более простой список учётных записей и стабильный IDL. AMM v4 поставляется с IDL, но никогда не имел поддерживаемого крейта Rust CPI.
• Меньше учётных записей на своп. ~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, чтобы привлечь стимулированных LP в новый пул.
5. Наблюдайте, как объём мигрирует, когда агрегаторы перевешивают в сторону более глубокого пула.

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

​

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

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

• Инструкция SwapV2 добавлена для правильной поддержки математики комиссии за передачу Token-2022. Старый Swap по-прежнему вызываемый; новые интеграции должны нацеливаться на SwapV2.
• Расширения потока вознаграждений — количество слотов RewardInfo было увеличено (оригинальные 3 → по-прежнему 3 в настоящее время, но шаблон резервирования был ужесточен). Миграция данных не требуется.
• Компактность массива тиков — внутренняя оптимизация для снижения CU при своп-операциях, пересекающих много тиков. Внешне невидимо.
• Перестройка Anchor 1.0 (2026-09-30): переход с Anchor 0.32.1 на 1.0.2 и добавление администратора CollectExcessLamports. Никакие инструкции или макеты учётных записей, видимые пользователю, не изменились. См. запись в журнале изменений.

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 также перешёл с обновления на основе слотов на настенные часы и добавил поддержку 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 по-прежнему развёрнуты и вызываемы. Существующие фермы по-прежнему могут распределять ожидающие вознаграждения и принимать выводы.
• Пользовательский интерфейс Raydium по-прежнему отображает фермы v3 и v5 с активными вознаграждениями; как только end_time фермы v3/v5 пройдёт, пользовательский интерфейс скрывает её из “активных”, но сохраняет возможность требования.
• Команда не будет создавать новые фермы v3/v5. Помощники SDK для “создания фермы” маршрутизируют только на v6.
• v3 и v5 получают обновления безопасности, но не работу над функциями. Если обнаружена критическая ошибка, она исправляется; если функция может быть полезной, она добавляется в v6 вместо этого.

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

​

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

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

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