Skip to main content
Эта страница переведена с помощью ИИ. За эталон принимается английская версия.Открыть английскую версию →
Вся документация предполагает наличие рабочего инструментария разработки Solana. На этой странице перечислены инструменты, версии, известные как совместимые с Raydium по состоянию на сентябрь 2026 года, и специфические подводные камни при установке. Начните отсюда перед запуском любых примеров кода из последующих глав. Имеют значение два набора версий, и они не совпадают. Чтобы собрать или форкировать программы Raydium, вам нужен точный инструментарий, который они закрепляют — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 по состоянию на обновление 2026-09-09. Чтобы интегрироваться с развёрнутыми программами из TypeScript или Python, вам нужна только клиентская библиотека, достаточно свежая для общения с ними, и закрепления носят рекомендательный характер. Каждый раздел ниже указывает, какой случай он охватывает.

Основные инструменты

Solana CLI

Канонический интерфейс командной строки для взаимодействия с кластерами Solana — управление кошельками, RPC-вызовы, развёртывание программ. Установка:
Проверка:
Хост установки переместился. release.solana.com принадлежал Solana Labs; клиент теперь поддерживается Anza как Agave, и релизы распространяются с release.anza.xyz. Самообновляющийся бинарник — это agave-install (solana-install сохранён как устаревший псевдоним), поэтому agave-install update и agave-install init <version> — это текущие написания. Собственная документация Solana также предлагает установщик в одну команду, который загружает CLI, Rust и Anchor вместе:
Этот установщик отслеживает собственное представление о текущем и может дать вам другой Anchor, чем тот, который закрепляют программы Raydium — проверьте anchor --version после этого.
Конфигурация для mainnet:
Для тестирования Raydium вам почти всегда понадобится финансируемый devnet-кошелёк:

SPL Token CLI

Официальный CLI для операций SPL Token / Token-2022 — создание минтов, минтинг токенов, передачи. Установка (включена в Solana CLI):
Типичные операции:

Anchor CLI

Требуется для получения IDL Raydium, построения клиентов и верификации программ. Установка:
Anchor переместился в репозиторий и мажорную версию. Канонический репозиторий теперь github.com/solana-foundation/anchor (раньше был coral-xyz/anchor), и Anchor 1.0 — это первая линия релизов, которую используют программы Raydium — CPMM и LaunchLab оба закрепляют anchor-lang/anchor-spl =1.0.2 по состоянию на обновление 2026-09-09, вверх с 0.32.1. avm может держать несколько версий; avm use 1.0.2 — это то, что заставляет anchor build воспроизводить артефакты Raydium. Anchor 1.1 и 1.2 существуют и хорошо собираются для ваших собственных программ, но CPI-крейт, скомпилированный против другого минора anchor-lang, чем тот, который закрепляет целевая программа, не будет линкован — см. sdk-api/rust-cpi.
Типичные операции:

Установка TypeScript

Основной путь интеграции для Raydium.

Пакеты

Версии, известные как совместимые по состоянию на сентябрь 2026:
@coral-xyz/anchor заморожен; пакет теперь @anchor-lang/core. @coral-xyz/anchor остановился на 0.32.1, когда Anchor вышел из Coral. Anchor 1.x публикуется как @anchor-lang/core, и собственные репозитории программ Raydium переключили свои тестовые наборы на него при обновлении 2026-09-09. Импорты, которые вы фактически используете, не изменились — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — поэтому миграция — это переименование пакета плюс обновление lockfile.Два замечания о поведении, если вы переходите с 0.3x: .accounts({...}) теперь принимает только учётные записи, которые Anchor не может разрешить сам, поэтому построитель, который передаёт полный набор, должен вызвать .accountsPartial({...}) вместо этого; и @anchor-lang/core/dist/cjs/utils/token — это место, куда переместились помощники, такие как ASSOCIATED_PROGRAM_ID.

Минимальный скрипт

Полную справку SDK см. в sdk-api/typescript-sdk.

Установка Rust

Для интеграции CPI и программ в блокчейне.

Инструментарий

Собирайте программы с помощью cargo build-sbf (старое написание cargo build-bpf исчезло).

Program Cargo.toml для интеграции Raydium CPI

Закрепляйте anchor-lang и anchor-spl с помощью = к версии, которую закрепляет целевая программа. По состоянию на 2026-09 CPMM закрепляет =1.0.2, а CLMM всё ещё закрепляет =0.32.1, поэтому один крейт не может делать CPI в оба — см. sdk-api/rust-cpi. Функция "cpi" импортирует модуль cpi с помощниками CPI (поэтому вы можете raydium_cp_swap::cpi::swap_base_input(...)). См. sdk-api/rust-cpi.

Установка Python

Вторичный путь интеграции — распространён среди разработчиков ботов.

Пакеты

Версии:
Две ловушки с именами. RPC-клиент импортируется как solana, но проект называется solana-py — pip install solana-py не устанавливает ничего полезного. И нет пакета raydium-py на PyPI: помощник Raydium сообщества — это репозиторий, который вы клонируете, AL-THE-BOT-FATHER/raydium_py, а не опубликованное распределение. Более ранние версии этой страницы содержали строку pip install raydium-py, которая никогда не работала.

Минимальный скрипт

См. sdk-api/python-integration.

RPC-эндпоинты

Публичный mainnet RPC (api.mainnet-beta.solana.com) сильно ограничен по частоте запросов и дросселируется под любой нагрузкой. Для нетривиального использования получите приватный эндпоинт: Конфигурация:
Некоторые RPC-операции требуют расширенных возможностей:
  • getProgramAccounts — неограниченные сканирования дорогие; некоторые провайдеры ограничивают или берут плату за сканирование.
  • getPriorityFeeEstimate — специфичный для Helius эндпоинт; у других есть эквиваленты.
  • geyser / WebSocket-потоковая передача — требуется для низколатентных ботов; не все провайдеры её предоставляют.

Devnet и localnet

Devnet

Публичный тестовый кластер Solana. Raydium имеет частичное развёртывание на devnet:
  • Некоторые пулы CPMM существуют для тестирования.
  • AMM v4 имеет исторические пулы devnet.
  • CLMM имеет несколько демо-пулов.
  • Farm v6 развёрнут.
SDK поддерживает devnet через cluster: "devnet":
Оговорка: пулы devnet имеют тонкую ликвидность и могут иметь устаревшее состояние. Не полагайтесь на devnet для обнаружения цен; используйте его только для построения и тестирования потоков инструкций.

Localnet с форкированным состоянием mainnet

Для реалистичного тестирования форкируйте состояние mainnet в локальный валидатор:
Это клонирует специфичное состояние программы/учётной записи на localhost, где вы можете свободно совершать транзакции. Идеально для:
  • Модульного тестирования вашей интеграции CPI против реальной программы Raydium.
  • Воспроизведения транзакции с изменённым параметром для отладки.
  • Стресс-тестирования с большими синтетическими объёмами.
Команда Raydium широко использует форкированный localnet для регрессионного тестирования перед развёртыванием на mainnet.

Шаблоны проектов

Стартер интеграции TypeScript

Минимальный package.json:

Стартер программы Anchor CPI

С Anchor 1.0:

Полезные утилиты CLI

solana-keygen

Чтение любой учётной записи

Полезно для быстрого просмотра состояния пула без декодера.

Логи программы

Инспекция транзакции

Или через explorer — вставьте подпись и посмотрите на вкладку “Program Logs”.

Гигиена окружения

Отдельные кошельки для разных целей

  • Кошелёк разработки: содержит testnet SOL, используется для построения.
  • Кошелёк продакшена: содержит реальный SOL, используется только для развёртываний / отправок multisig.
  • Горячий кошелёк для ботов: небольшой баланс, узкие разрешения.
Ключи никогда не должны быть жёстко закодированы. Используйте переменные окружения или менеджеры секретов.

Паттерн .env

Закрепление версий

Закрепляйте все зависимости экосистемы Solana. Экосистема движется быстро; минорное обновление версии @solana/web3.js ранее вводило критические изменения. Используйте package-lock.json / Cargo.lock религиозно.

Ссылки

Источники: