Solana CLI 툴체인 설치와 기본 명령어

솔라나 CLI는 블록체인과 대화하는 가장 기본적인 도구입니다. 그래픽 인터페이스 없이 터미널에서 지갑을 만들고, 잔액을 확인하고, 트랜잭션을 보냅니다. 이 글에서는 CLI를 설치하고 자주 쓰는 명령어를 익힙니다.

CLI 설치

macOS와 Linux에서는 공식 설치 스크립트를 사용합니다. 터미널에서 아래 명령을 실행합니다.

$ sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

설치가 끝나면 버전을 확인합니다.

$ solana --version
solana-cli 1.18.x

Windows에서는 WSL 환경을 권장합니다. WSL 안에서 동일한 설치 스크립트를 사용할 수 있습니다.

설정 확인

CLI는 현재 바라보는 클러스터와 사용할 키페어 경로를 설정 파일로 저장합니다. 현재 설정을 확인합니다.

$ solana config get
RPC URL: https://api.mainnet-beta.solana.com
Keypair Path: ~/.config/solana/id.json

기본값은 메인넷입니다. 학습 단계에서는 Devnet으로 전환하는 것이 안전합니다.

$ solana config set --url devnet

지갑 생성

새 키페어를 만듭니다. 시드 문구가 출력되는데 안전한 곳에 적어 두세요.

$ solana-keygen new --outfile ~/.config/solana/id.json

공개키(지갑 주소)를 확인합니다.

$ solana address

잔액 확인

현재 설정된 지갑의 잔액을 봅니다.

$ solana balance

다른 지갑의 잔액을 확인할 때는 주소를 인자로 줍니다.

$ solana balance <주소>

SOL 보내기

다른 주소로 SOL을 전송합니다.

$ solana transfer <받는 주소> 1

트랜잭션 서명이 반환되며, 익스플로러에서 확인할 수 있습니다.

자주 쓰는 명령어 요약

• solana config set --url <cluster> — 클러스터 전환
• solana-keygen new — 새 키페어 생성
• solana address — 현재 지갑 주소
• solana balance — 잔액 확인
• solana airdrop <SOL> — Devnet에서 무료 SOL
• solana transfer <주소> <SOL> — 송금
• solana transaction-history <주소> — 거래 내역

다음 단계

CLI에 익숙해지면 로컬 검증자 실행 글로 넘어가 내 컴퓨터에서 블록체인을 직접 실행해 보세요. 키페어의 구조가 궁금하다면 키페어와 시드 문구 글을 함께 읽어 보세요.