[카테고리:] 미분류

  • 우분투에서 Cargo로 솔라나 CLI 설치하기

    설치 과정

    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를 통한 설치가 좋은 대안입니다. 약간의 추가 설정이 필요하지만, 완전히 동일한 기능을 제공하며 안정적으로 작동합니다.

    이제 솔라나 개발을 시작할 준비가 완료되었습니다!