Эта страница переведена с помощью ИИ. За эталон принимается английская версия.Открыть английскую версию →
Основные инструменты
Solana CLI
Канонический интерфейс командной строки для взаимодействия с кластерами Solana — управление кошельками, RPC-вызовы, развёртывание программ. Установка:Хост установки переместился. Этот установщик отслеживает собственное представление о текущем и может дать вам другой Anchor, чем тот, который закрепляют программы Raydium — проверьте
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 --version после этого.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.Пакеты
@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-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) сильно ограничен по частоте запросов и дросселируется под любой нагрузкой. Для нетривиального использования получите приватный эндпоинт:
Конфигурация:
getProgramAccounts— неограниченные сканирования дорогие; некоторые провайдеры ограничивают или берут плату за сканирование.getPriorityFeeEstimate— специфичный для Helius эндпоинт; у других есть эквиваленты.geyser/ WebSocket-потоковая передача — требуется для низколатентных ботов; не все провайдеры её предоставляют.
Devnet и localnet
Devnet
Публичный тестовый кластер Solana. Raydium имеет частичное развёртывание на devnet:- Некоторые пулы CPMM существуют для тестирования.
- AMM v4 имеет исторические пулы devnet.
- CLMM имеет несколько демо-пулов.
- Farm v6 развёрнут.
cluster: "devnet":
Localnet с форкированным состоянием mainnet
Для реалистичного тестирования форкируйте состояние mainnet в локальный валидатор:- Модульного тестирования вашей интеграции CPI против реальной программы Raydium.
- Воспроизведения транзакции с изменённым параметром для отладки.
- Стресс-тестирования с большими синтетическими объёмами.
Шаблоны проектов
Стартер интеграции TypeScript
package.json:
Стартер программы Anchor CPI
Полезные утилиты CLI
solana-keygen
Чтение любой учётной записи
Логи программы
Инспекция транзакции
Гигиена окружения
Отдельные кошельки для разных целей
- Кошелёк разработки: содержит testnet SOL, используется для построения.
- Кошелёк продакшена: содержит реальный SOL, используется только для развёртываний / отправок multisig.
- Горячий кошелёк для ботов: небольшой баланс, узкие разрешения.
Паттерн .env
Закрепление версий
Закрепляйте все зависимости экосистемы Solana. Экосистема движется быстро; минорное обновление версии@solana/web3.js ранее вводило критические изменения. Используйте package-lock.json / Cargo.lock религиозно.
Ссылки
sdk-api/typescript-sdk— справка TypeScript SDK.sdk-api/rust-cpi— использование Rust CPI.sdk-api/python-integration— установка Python.solana-fundamentals/programs-and-anchor— справка Anchor.

