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

> TypeScript-примеры свопов через существующий пул AMM v4 и предоставления ликвидности. Создание новых пулов выходит за рамки — используйте CPMM.

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

  [Открыть английскую версию →](/products/amm-v4/code-demos)
</Info>

<Info>
  **Версия.** Все примеры ориентированы на `@raydium-io/raydium-sdk-v2@0.2.42-alpha` для Solana mainnet-beta, проверено в апреле 2026 года. Program ID: `675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8` (см. [`reference/program-addresses`](/ru/reference/program-addresses)).
</Info>

<Info>
  **Создание новых пулов здесь не показано.** Интерфейс Raydium больше не предлагает создание пулов AMM v4 — новые пары по умолчанию переходят на [CPMM](/ru/products/cpmm/code-demos). Сам программный модуль AMM v4 по-прежнему принимает `Initialize2` на цепи; это просто больше не рекомендуемый путь. Примеры ниже охватывают операции с активными пулами, которые нужны всем интеграторам: своп, депозит, вывод.
</Info>

## Инициализация

```ts theme={null}
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";
import { Raydium, TxVersion } from "@raydium-io/raydium-sdk-v2";
import fs from "node:fs";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner = Keypair.fromSecretKey(
  new Uint8Array(JSON.parse(fs.readFileSync(process.env.KEYPAIR!, "utf8"))),
);
const raydium = await Raydium.load({ owner, connection, cluster: "mainnet" });
```

## Получить пул по ID

```ts theme={null}
import { PublicKey } from "@solana/web3.js";

const poolId = new PublicKey("<AMM_V4_POOL_ID>");

// Pull the SDK-normalized pool object. For AMM v4 this includes the OpenBook
// accounts the instruction builders will need.
const data = await raydium.liquidity.getPoolInfoFromRpc({ poolId });
const { poolInfo, poolKeys, poolRpcData } = data;

console.log("Pair:", poolInfo.mintA.symbol, "/", poolInfo.mintB.symbol);
console.log("Version:", poolInfo.version);       // 4 for AMM v4
console.log("Market:", poolKeys.marketId.toBase58());
```

`poolKeys` — это структура, которую используют построители инструкций. Она содержит все счета AMM v4 и OpenBook в порядке, ожидаемом программой.

## Своп (фиксированный ввод)

```ts theme={null}
import BN from "bn.js";

const amountIn = new BN(1_000_000);            // 1 USDC (6-decimal quote)
const inputMint = new PublicKey(poolInfo.mintB.address);  // USDC
const slippage  = 0.005;

const computed = raydium.liquidity.computeAmountOut({
  poolInfo,
  amountIn,
  mintIn: inputMint,
  mintOut: new PublicKey(poolInfo.mintA.address),
  slippage,
});

const { execute } = await raydium.liquidity.swap({
  poolInfo,
  poolKeys,
  amountIn,
  amountOut: computed.minAmountOut,
  fixedSide: "in",
  inputMint,
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Swap tx:", txId);
```

SDK добавляет все счета OpenBook автоматически. Не пытайтесь заменять их вручную — программа валидирует каждый слот.

## Своп (фиксированный вывод)

```ts theme={null}
const amountOut = new BN(1_000_000_000);       // 1 SOL (9-decimal base)
const slippage  = 0.005;

const computed = raydium.liquidity.computeAmountIn({
  poolInfo,
  amountOut,
  mintOut: new PublicKey(poolInfo.mintA.address),
  mintIn: new PublicKey(poolInfo.mintB.address),
  slippage,
});

const { execute } = await raydium.liquidity.swap({
  poolInfo,
  poolKeys,
  amountIn: computed.maxAmountIn,
  amountOut,
  fixedSide: "out",
  inputMint: new PublicKey(poolInfo.mintB.address),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });
```

## Добавить ликвидность

```ts theme={null}
const amountA = new BN(100_000_000);           // 0.1 SOL

const { anotherAmount, maxAnotherAmount } = raydium.liquidity.computePairAmount({
  poolInfo,
  amount: amountA,
  baseIn: true,
  slippage: 0.01,
});

const { execute } = await raydium.liquidity.addLiquidity({
  poolInfo,
  poolKeys,
  amountInA: amountA,
  amountInB: maxAnotherAmount,
  fixedSide: "a",
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });
```

`fixedSide: "a"` говорит SDK, что вы указали точный `amountInA`, а `amountInB` должен быть не более `maxAnotherAmount`. Ликвидность пула, отражённая в книге заказов, рассчитывается перед расчётом пропорций, поэтому соотношение депозита совпадает с самыми свежими резервами.

## Вывести ликвидность

```ts theme={null}
const lpAmount = new BN(50_000);               // LP to burn

const { execute } = await raydium.liquidity.removeLiquidity({
  poolInfo,
  poolKeys,
  lpAmount,
  baseAmountMin: new BN(0),
  quoteAmountMin: new BN(0),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });
```

Минимумы slippage защищают от изменения состояния пула между вашей котировкой и моментом выполнения.

## Настройка compute unit и приоритетного сбора

Своп AMM v4 требует много compute-ресурсов, потому что каждая инструкция валидирует полное состояние OpenBook. Типичный своп использует 180k–250k CU в зависимости от того, сколько открытых заказов нужно обработать. Всегда указывайте лимит compute unit:

```ts theme={null}
import { ComputeBudgetProgram } from "@solana/web3.js";

const { execute, innerTransactions } = await raydium.liquidity.swap({
  /* ...params... */
  computeBudgetConfig: {
    units: 400_000,
    microLamports: 50_000,       // priority fee
  },
});
```

Если вы не указали `computeBudgetConfig`, SDK может использовать свой собственный default; проверьте `innerTransactions`, чтобы подтвердить. См. [`integration-guides/priority-fee-tuning`](/ru/integration-guides/priority-fee-tuning).

## Прямой Rust CPI

Если вы должны сделать CPI в AMM v4 из своей собственной Anchor-программы, вам понадобится точно воспроизвести список счетов `SwapBaseIn`. Минимальный пример:

```rust theme={null}
use anchor_lang::prelude::*;
use anchor_lang::solana_program::program::invoke_signed;
use anchor_lang::solana_program::instruction::Instruction;

const AMM_V4_PROGRAM_ID: Pubkey = pubkey!("675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8");

#[derive(Accounts)]
pub struct ProxyAmmV4Swap<'info> {
    /// CHECK:
    pub token_program: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm:          UncheckedAccount<'info>,
    /// CHECK:
    pub amm_authority: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm_open_orders: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm_target_orders: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub pool_coin_token_account: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub pool_pc_token_account: UncheckedAccount<'info>,
    /// CHECK:
    pub market_program: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_bids: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_asks: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_event_queue: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_coin_vault: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_pc_vault: UncheckedAccount<'info>,
    /// CHECK:
    pub market_vault_signer: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub user_source: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub user_dest: UncheckedAccount<'info>,
    pub user_owner: Signer<'info>,
}

pub fn proxy_swap(
    ctx: Context<ProxyAmmV4Swap>,
    amount_in: u64,
    minimum_amount_out: u64,
) -> Result<()> {
    // Instruction discriminator for SwapBaseIn is 9 on AMM v4.
    let mut data = vec![9u8];
    data.extend_from_slice(&amount_in.to_le_bytes());
    data.extend_from_slice(&minimum_amount_out.to_le_bytes());

    let ix = Instruction {
        program_id: AMM_V4_PROGRAM_ID,
        accounts: vec![
            AccountMeta::new_readonly(ctx.accounts.token_program.key(), false),
            AccountMeta::new(ctx.accounts.amm.key(), false),
            AccountMeta::new_readonly(ctx.accounts.amm_authority.key(), false),
            AccountMeta::new(ctx.accounts.amm_open_orders.key(), false),
            AccountMeta::new(ctx.accounts.amm_target_orders.key(), false),
            AccountMeta::new(ctx.accounts.pool_coin_token_account.key(), false),
            AccountMeta::new(ctx.accounts.pool_pc_token_account.key(), false),
            AccountMeta::new_readonly(ctx.accounts.market_program.key(), false),
            AccountMeta::new(ctx.accounts.market.key(), false),
            AccountMeta::new(ctx.accounts.market_bids.key(), false),
            AccountMeta::new(ctx.accounts.market_asks.key(), false),
            AccountMeta::new(ctx.accounts.market_event_queue.key(), false),
            AccountMeta::new(ctx.accounts.market_coin_vault.key(), false),
            AccountMeta::new(ctx.accounts.market_pc_vault.key(), false),
            AccountMeta::new_readonly(ctx.accounts.market_vault_signer.key(), false),
            AccountMeta::new(ctx.accounts.user_source.key(), false),
            AccountMeta::new(ctx.accounts.user_dest.key(), false),
            AccountMeta::new_readonly(ctx.accounts.user_owner.key(), true),
        ],
        data,
    };
    invoke_signed(&ix, &ctx.accounts.to_account_infos(), &[])?;
    Ok(())
}
```

AMM v4 не поставляется с Anchor-крейтом для CPI. Пример выше использует вручную созданную инструкцию `Instruction`.

## Подводные камни

* **Отсутствует счет OpenBook.** Все 8 счетов на стороне OpenBook требуются при каждом свопе, депозите и выводе; SDK справляется с этим, ручные инструкции часто нет.
* **Чтение сырых балансов хранилища.** Не отражает суммы в книге заказов или накопленный P\&L. Используйте котировку SDK или `api-v3.raydium.io/pools/info/ids`.
* **Очередь событий OpenBook заполнена.** Пул может вернуть ошибку свопов с `SerumOrderError`, когда очередь событий его маркета нуждается в обработке. Обработка является безпермиссионной (`MonitorStep` на счетах OpenBook маркета).
* **Монеты Token-2022.** Не поддерживаются. Пул AMM v4 не может быть создан для монеты Token-2022; любая пара Token-2022 должна быть на CPMM или CLMM.

## Что дальше

* [`products/amm-v4/instructions`](/ru/products/amm-v4/instructions) — уровень инструкций позади этих примеров.
* [`user-flows/migrate-amm-v4-to-cpmm`](/ru/user-flows/migrate-amm-v4-to-cpmm) — если вы LP, рассматривающий миграцию.
* [`integration-guides/priority-fee-tuning`](/ru/integration-guides/priority-fee-tuning) — размер приоритетного сбора для тяжёлых свопов AMM v4.

Источники:

* [Raydium SDK v2](https://github.com/raydium-io/raydium-sdk-V2)
* [Raydium AMM program](https://github.com/raydium-io/raydium-amm)
