설치 과정
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를 통한 설치가 좋은 대안입니다. 약간의 추가 설정이 필요하지만, 완전히 동일한 기능을 제공하며 안정적으로 작동합니다.
이제 솔라나 개발을 시작할 준비가 완료되었습니다!
답글 남기기