설치 과정
1. 공식 설치 스크립트 시도 (실패)
솔라나 공식 설치 스크립트를 시도했지만 525 에러가 발생했습니다.
# 시도했지만 실패한 방법들
sh -c "$(curl -sSfL https://release.solana.com/v1.18.18/install)"
sh -c "$(curl -sSfL https://release.solana.com/stable/install)"
curl -k -sSfL https://release.solana.com/stable/install | sh
wget -O - https://release.solana.com/stable/install | sh
모든 방법에서 curl: (22) The requested URL returned error: 525 에러가 발생했습니다.
2. Cargo를 통한 설치 (성공)
공식 설치가 안 되어서 Rust의 Cargo 패키지 매니저를 통해 설치했습니다.
시스템 의존성 설치
먼저 컴파일에 필요한 시스템 패키지들을 설치했습니다:
sudo apt update
sudo apt install -y pkg-config libudev-dev libusb-1.0-0-dev libhidapi-dev
sudo apt install -y build-essential libssl-dev
Cargo로 솔라나 CLI 설치
cargo install solana-cli
설치 과정에서 hidapi 관련 에러가 발생했지만, 의존성 패키지 설치 후 성공적으로 완료되었습니다.
별도로 keygen 도구 설치
솔라나 CLI에는 solana-keygen이 포함되지 않아서 별도로 설치했습니다:
cargo install solana-keygen
설치 확인 및 설정
1. 버전 확인
solana --version
# 출력: solana-cli 2.2.7 (src:00000000; feat:463342092, client:Agave)
2. 네트워크 설정
개발용으로 Devnet에 연결했습니다:
solana config set --url https://api.devnet.solana.com
설정 확인:
solana config get
출력 결과:
Config File: /home/hjh/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: /home/hjh/.config/solana/id.json
Commitment: confirmed
3. 키페어 생성
새로운 지갑(키페어)을 생성했습니다:
solana-keygen new
생성된 정보:
- 공개키 주소:
F47drTp6DdmohFCgHgTeGui2zeaALKp3hGRRJuGeP9FN - 시드 구문:
analyst exhibit sketch sound bonus social city cricket ecology year planet endless
4. 테스트용 SOL 받기
Devnet에서 테스트용 SOL을 받았습니다:
solana airdrop 1
solana balance
# 출력: 1 SOL
주요 명령어
설치 완료 후 사용할 수 있는 기본 명령어들:
# 잔액 확인
solana balance
# 공개키 주소 확인
solana address
# 설정 확인
solana config get
# SOL 전송
solana transfer <수신자주소> <금액>
# 트랜잭션 히스토리
solana transaction-history <주소>
# 계정 정보 확인
solana account <주소>
보안 주의사항
시드 구문 보관
생성된 12개 단어 시드 구문은 매우 중요합니다:
- 지갑 복구에 필요한 유일한 방법
- 절대 타인과 공유하지 말 것
- 안전한 오프라인 장소에 보관
시드 구문 보안 수준
솔라나는 다양한 길이의 시드 구문을 지원합니다:
# 12개 단어 (기본값) - 132비트 엔트로피
solana-keygen new
# 24개 단어 (최고 보안) - 264비트 엔트로피
solana-keygen new --word-count 24
- 12개 단어: 5.4 × 10^39 가지 조합
- 24개 단어: 3.0 × 10^79 가지 조합
문제 해결
PATH 설정
만약 solana-keygen 명령어를 찾을 수 없다면:
# Cargo bin을 PATH에 추가
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
의존성 에러
컴파일 중 hidapi 에러가 발생하면:
sudo apt install -y pkg-config libudev-dev libusb-1.0-0-dev libhidapi-dev
마무리
우분투에서 공식 설치 스크립트가 작동하지 않을 때, Cargo를 통한 설치가 좋은 대안입니다. 약간의 추가 설정이 필요하지만, 완전히 동일한 기능을 제공하며 안정적으로 작동합니다.
이제 솔라나 개발을 시작할 준비가 완료되었습니다!