이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
이 문서의 모든 내용은 작동하는 Solana 개발 도구 모음을 전제로 합니다. 이 페이지는 도구, 2026년 9월 기준 Raydium과 호환되는 버전, 그리고 특정 설정 주의사항을 나열합니다. 이후 장의 코드 예제를 실행하기 전에 여기서 시작하세요.두 가지 버전 집합이 중요하며, 서로 다릅니다. Raydium 프로그램을 빌드하거나 포크하려면 정확한 도구 모음이 필요합니다 — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 (2026-09-09 업그레이드 기준). 배포된 프로그램에 TypeScript 또는 Python에서 통합하려면 프로그램과 통신할 수 있을 정도로 최신인 클라이언트 라이브러리만 필요하며, 버전 고정은 권장사항입니다. 아래의 각 섹션에서 어느 경우에 해당하는지 명시합니다.
핵심 도구
Solana CLI
Solana 클러스터와 상호작용하기 위한 표준 명령줄 인터페이스 — 지갑 관리, RPC 호출, 프로그램 배포. 설치:설치 호스트가 변경되었습니다. 이 설치 프로그램은 자체 최신 버전을 추적하며 Raydium 프로그램이 고정한 것과 다른 Anchor를 제공할 수 있습니다 — 이후
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
SPL Token / Token-2022 작업을 위한 공식 CLI — 민트 생성, 토큰 발행, 전송. 설치 (Solana CLI에 포함):Anchor CLI
Raydium IDL 가져오기, 클라이언트 빌드, 프로그램 검증에 필요합니다. 설치:Anchor가 저장소와 메이저 버전을 변경했습니다. 표준 저장소는 이제
github.com/solana-foundation/anchor입니다 (이전: coral-xyz/anchor). Anchor 1.0은 Raydium 프로그램이 사용하는 첫 번째 릴리스 라인입니다 — CPMM과 LaunchLab 모두 2026-09-09 업그레이드 기준 anchor-lang/anchor-spl =1.0.2를 고정하고 있으며, 이전 0.32.1에서 업그레이드되었습니다. avm은 여러 버전을 보유할 수 있습니다. avm use 1.0.2는 anchor build가 Raydium의 아티팩트를 재현하도록 합니다. Anchor 1.1과 1.2가 존재하며 자신의 프로그램을 위해 잘 빌드되지만, 대상 프로그램이 고정한 것과 다른 anchor-lang 마이너 버전에 대해 컴파일된 CPI 크레이트는 링크되지 않습니다 — sdk-api/rust-cpi를 참조하세요.TypeScript 설정
Raydium의 주요 통합 경로입니다.패키지
@coral-xyz/anchor는 고정되었으며 패키지는 이제 @anchor-lang/core입니다. @coral-xyz/anchor는 Anchor가 Coral을 떠났을 때 0.32.1에서 중단되었습니다. 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 표기법은 없어졌습니다).
Raydium CPI 통합을 위한 프로그램 Cargo.toml
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는 유용한 것을 설치하지 않습니다. 그리고 PyPI에 raydium-py 패키지가 없습니다: 커뮤니티 Raydium 헬퍼는 클론하는 저장소입니다, AL-THE-BOT-FATHER/raydium_py, 발행된 배포판이 아닙니다. 이 페이지의 이전 개정판은 작동하지 않는 pip install raydium-py 라인을 나열했습니다.최소 스크립트
sdk-api/python-integration을 참조하세요.
RPC 엔드포인트
공개 메인넷 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"을 통해 devnet을 지원합니다:
포크된 메인넷 상태를 사용한 Localnet
현실적인 테스트를 위해 메인넷 상태를 로컬 검증자로 포크합니다:- 실제 Raydium 프로그램에 대해 CPI 통합을 단위 테스트합니다.
- 수정된 매개변수로 트랜잭션을 재생하여 디버그합니다.
- 큰 합성 거래량으로 스트레스 테스트합니다.
프로젝트 템플릿
TypeScript 통합 스타터
package.json:
Anchor CPI 프로그램 스타터
유용한 CLI 유틸리티
solana-keygen
모든 계정 읽기
프로그램 로그
트랜잭션 검사
환경 위생
목적별 별도 지갑
- 개발 지갑: 테스트넷 SOL을 보유하며, 빌드에 사용됩니다.
- 프로덕션 지갑: 실제 SOL을 보유하며, 배포/멀티시그 제출에만 사용됩니다.
- 봇용 핫 지갑: 작은 잔액, 좁은 권한.
.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 배경.

