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

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

> История выпусков для каждой программы Raydium, статус устаревания каждого поколения и практические пути миграции между ними.

<Info>
  **Эта страница переведена с помощью ИИ. За эталон принимается английская версия.**

  [Открыть английскую версию →](/protocol-overview/versions-and-migration)
</Info>

<Info>
  Raydium существует пять лет. Несколько его программ находятся в третьем или четвёртом поколении. На этой странице приведён взгляд оператора на вопросы: «какую версию программы использовать, какой статус у старых версий и как перейти с одной на другую, если я сейчас работаю на старой версии?»
</Info>

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

| Программа     | Текущая             | Устарела | Новые развёртывания               | Существующие экземпляры                                      |
| ------------- | ------------------- | -------- | --------------------------------- | ------------------------------------------------------------ |
| **AMM v4**    | v4 (одно поколение) | Нет      | Не рекомендуется, но принимается  | Полностью рабочая                                            |
| **CPMM**      | v1                  | —        | **Рекомендуется по умолчанию**    | Полностью рабочая                                            |
| **CLMM**      | v1                  | —        | Рекомендуется для LP с диапазоном | Полностью рабочая                                            |
| **Farm**      | v6                  | v3, v5   | Только v6                         | v3 + v5 в процессе завершения (в основном только для чтения) |
| **LaunchLab** | v1                  | —        | Рекомендуется для новых запусков  | Полностью рабочая                                            |

Самый важный вывод из этой таблицы: **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`](/ru/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`](/ru/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`](https://github.com/raydium-io/raydium-idl/blob/master/raydium_clmm/raydium_clmm.json) (смотрите [`sdk-api/anchor-idl`](/ru/sdk-api/anchor-idl)). Если вы запускаете более старый SDK против текущей программы, худший случай — это отсутствие новых инструкций.

## Farm v3 → v5 → v6

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

### Поколения

| Версия | Выпущена | Статус                                                                   | Ключевые функции                                                                                                                            |
| ------ | -------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **v3** | 2021     | **Завершение.** Существующие фермы работают; новые фермы не принимаются. | Один поток вознаграждений. Эмиссия на основе слотов.                                                                                        |
| **v5** | Окт 2022 | **Завершение.** Существующие фермы работают; новые фермы не принимаются. | До 2 потоков вознаграждений. Эмиссия на основе слотов. Целое число `per_second`.                                                            |
| **v6** | 2024     | **Текущая.** Все новые фермы.                                            | До 5 потоков вознаграждений. Эмиссия по стеной-часам. Q64.64 fixed-point `per_second`. Поддержка Token-2022 для стейкинга + вознаграждений. |

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

* **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`](/ru/products/farm-staking/accounts) и [`products/farm-staking/instructions`](/ru/products/farm-staking/instructions).

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

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

Что развивалось через обновления:

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

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

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

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

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

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

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

Источники:

* Страницы глав по продуктам, цитируемые выше в тексте.
* [Raydium SDK v2](https://github.com/raydium-io/raydium-sdk-V2) — логика диспетчеризации с учётом версии подтверждает, какой программе принадлежит данный пул.
* [`reference/program-addresses`](/ru/reference/program-addresses) — канонические ID для каждой версии.