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

# Математика маршрутизации

> Роутер не выполняет расчёты цен; каждый хоп делегирует расчёты своему пулу. Проскальзывание на нескольких хопах накапливается; CLMM использует limit_prices.

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

  [Открыть английскую версию →](/products/routing/math)
</Info>

## Роутер не выполняет расчёты

Программа маршрутизации **не реализует никакую логику расчёта цен**. Это чистый оркестратор: он принимает маршрут, передаёт аккаунты дочерним программам и соединяет потоки токенов.

Каждый хоп использует кривую своего пула:

* **AMM v4 хопы:** используют формулу константного произведения (`x · y = k`) с гибридным ценообразованием OpenBook. См. [`products/amm-v4/math`](/ru/products/amm-v4/math).
* **CPMM хопы:** используют формулу константного произведения с настраиваемыми комиссионными уровнями. См. [`products/cpmm/math`](/ru/products/cpmm/math).
* **CLMM хопы:** используют математику сконцентрированной ликвидности. См. [`algorithms/clmm-math`](/ru/algorithms/clmm-math).
* **Stable хопы:** используют кривую стабильного своппа для взаимозаменяемых активов. См. [`products/stable/math`](/ru/products/stable/math).

Участие роутера заключается только в:

1. Вызове инструкции swap каждого пула через CPI.
2. Сборе выходного количества.
3. Передаче его как входного количества для следующего хопа.
4. Проверке финального выхода относительно лимита проскальзывания вызывающей стороны.

## Накопление проскальзывания

На маршруте с несколькими хопами проскальзывание на каждом хопе накапливается. Небольшое проскальзывание на хопе 1 становится бо́льшим на хопе 2, потому что объём, поступающий на хоп 2, уже снижен.

**Пример:**

```
Маршрут: USDC → SOL → STEP

Пул 1 (USDC / SOL):
  Вход: 1000 USDC
  Проскальзывание: 1% (спот дал бы 0.5 SOL, но вы получаете 0.495 SOL)
  Выход: 0.495 SOL

Пул 2 (SOL / STEP):
  Вход: 0.495 SOL (уже снижено)
  Проскальзывание: 1% (спот дал бы 495 STEP, но вы получаете 490 STEP)
  Выход: 490 STEP

Общее эффективное проскальзывание USDC → STEP: 1.99%, не 1% + 1% = 2%.
```

Когда вы указываете `minimum_amount_out`, роутер проверяет ваш финальный выход относительно этого глобального лимита. Каждый хоп также проверяет свой своп относительно своей локальной комиссионной структуры, но роутер не пересчитывает маршрут по ходу — вы должны предварительно вычислить маршрут и заложить достаточный допуск проскальзывания.

## CLMM хопы и limit\_prices

Для каждого хопа в пул CLMM роутер проверяет, что текущая `sqrt_price_x64` пула находится в пределах указанных границ. Границы передаются как `VecDeque<u128>` под названием `limit_prices`:

* Одна `sqrt_price_x64` на каждый CLMM хоп в маршруте.
* `sqrt_price_x64` — это представление цены на основе тиков, используемое CLMM. См. [`algorithms/clmm-math`](/ru/algorithms/clmm-math) для определения.
* Роутер проверяет:

```
  sqrt_price_lower <= pool.sqrt_price_x64 <= sqrt_price_upper
```

для каждого CLMM хопа, отклоняя своп, если цена выходит за пределы.

### Варианты инструкций и limit\_prices

* **`SwapBaseInWithUserAccount`, `SwapBaseOutWithUserAccount` (Legacy, теги 0 и 1):** VecDeque `limit_prices` **обязателен**. Пустая дека отклоняется с ошибкой, если какой-либо хоп является CLMM пулом. Вы должны предоставить одну цену на каждый CLMM хоп по порядку.

* **`SwapBaseIn`, `SwapBaseOut` (Current, теги 8 и 9):** VecDeque `limit_prices` **опционален**. Пустая дека игнорируется молча; проверка цены не выполняется. Новый код должен использовать эти инструкции.

### Построение limit\_prices

Для маршрута с M CLMM хопами дека должна содержать ровно M записей. Упорядочите их по хопам:

```
limit_prices = [
  sqrt_price_for_first_clmm_hop,
  sqrt_price_for_second_clmm_hop,
  ...
]
```

### Когда проверять limit\_prices

`sqrt_price_x64` — это снимок текущей цены пула. Она постоянно меняется по мере выполнения свопов. Вы должны:

1. Получить текущее состояние пула из сети.
2. Вычислить приемлемые границы (например, ±0.5% от текущей цены).
3. Закодировать эти границы в `limit_prices`.
4. Включить границы в вашу инструкцию роутера.

Если цена пула выйдет за пределы ваших границ до того, как транзакция будет обработана, роутер отклонит её.

## Обработка комиссий

Каждый пул берёт свою комиссию согласно своей конфигурации:

* **AMM v4:** 0.25% (фиксированная) разделена между LP, протоколом и фондом.
* **CPMM:** настраиваемая для каждого `AmmConfig` (по умолчанию 0.25%, разделение зависит от уровня).
* **CLMM:** настраиваемая для каждого пула, взимается с входного количества.
* **Stable:** как AMM v4, 0.25% разделена.

Роутер **не берёт собственную комиссию**. Вся обработка комиссий делегируется каждому дочернему пулу. Выход из хопа N уже имеет вычтенную комиссию этого хопа.

См. документацию по комиссиям отдельного пула:

* [`products/amm-v4/fees`](/ru/products/amm-v4/fees)
* [`products/cpmm/fees`](/ru/products/cpmm/fees)
* [`products/clmm/fees`](/ru/products/clmm/fees) (если доступно)
* [`products/stable/fees`](/ru/products/stable/fees) (если доступно)

## Пример учёта на нескольких хопах

Предположим, вы маршрутизируете USDC → SOL → STEP через два пула константного произведения, каждый с комиссией 0.25%:

```
Вход: 1000 USDC
Пул 1 (USDC/SOL):
  Взятая комиссия: ceil(1000 * 0.25%) = 2.5 USDC
  Чистый вход в кривую: 997.5 USDC
  Выход кривой (без проскальзывания): 0.5 SOL
  Допуск проскальзывания: предположим 1%, получаете ~0.495 SOL

Пул 2 (SOL/STEP):
  Вход: 0.495 SOL
  Взятая комиссия: ceil(0.495 * 0.25%) ≈ 0.001 SOL
  Чистый вход в кривую: 0.494 SOL
  Выход кривой: ~494 STEP
  Допуск проскальзывания: 1%, получаете ~489 STEP

Финальный выход: ~489 STEP
```

Роутер проверяет:

```
489 >= minimum_amount_out  // указано вызывающей стороной
```

Если ложь, весь маршрут атомарно терпит неудачу.

## Соображения точности

Как все программы Solana, роутер использует целочисленную арифметику:

* Все количества — `u64` (lamports или наименьшие единицы токенов).
* Расчёты кривых используют `u128` промежуточные значения где необходимо, чтобы избежать переполнения.
* Соглашения об округлении зависят от дочерней программы. Роутер не переокругляет.

Если хоп выдаёт нулевое количество из-за экстремальных коэффициентов цены (например, своп 1 lamport на пуле 1B:1), роутер передаёт этот нуль следующему хопу, который может затем отклонить его как недостаточный. См. коды ошибок отдельного пула.

## Что дальше

* [`products/amm-v4/math`](/ru/products/amm-v4/math) — математика константного произведения.
* [`products/cpmm/math`](/ru/products/cpmm/math) — CPMM константное произведение с Token-2022.
* [`algorithms/clmm-math`](/ru/algorithms/clmm-math) — ценообразование сконцентрированной ликвидности.
* [`products/stable/math`](/ru/products/stable/math) — кривая стабильного своппа.
* [`products/routing/code-demos`](/ru/products/routing/code-demos) — примеры расчёта цены перед маршрутизацией.