프로그램 배포하기

이 섹션에서는 Solana CLI를 사용하여 Solana 프로그램을 배포하는 기본 과정을 안내합니다.

CLI 명령어 참조

주요 개념

시작하기 전에 몇 가지 용어를 명확히 해보겠습니다:

• 프로그램 ID: 프로그램의 온체인 주소입니다. 사용자는 프로그램 ID를 참조하여 프로그램과 상호작용합니다.
• program account: 프로그램의 메타데이터를 저장하는 온체인 계정입니다. program account의 주소가 프로그램 ID입니다. program account는 또한 programdata account의 주소를 저장합니다.
• programdata account: 배포된 프로그램의 실행 가능한 코드를 저장하는 온체인 계정입니다.
• 프로그램 권한: 프로그램을 업데이트하거나 종료할 수 있는 권한을 가진 계정입니다. 기본적으로 이는 CLI 지갑입니다.

사전 요구사항

$ 
solana-keygen newCopy

$ 
solana config get
Copy
[show output]

$ 
solana config set --url mainnet-beta
Copy
$ 
solana config set --url devnet
Copy
$ 
solana config set --url localhost
Copy
$ 
solana config set --url testnet
Copy
$ 
solana config set --url "https://your-rpc-url.com"Copy

$ 
solana airdrop 2
Copy
[show output]

$ 
solana balance
Copy
[show output]

기본 작업

프로그램 빌드

프로그램을 빌드하려면 cargo build-sbf 명령어를 사용하세요:

$ 
cargo build-sbfCopy

use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,
};

entrypoint!(process_instruction);

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
    msg!("Hello, Solana!");
    Ok(())
}

$ 
cargo build-sbfCopy

$ 
cargo build-sbfCopy

use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,
};

entrypoint!(process_instruction);

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
    msg!("Hello, Solana!");
    Ok(())
}

프로그램 크기 및 비용 확인

프로그램을 배포하려면 프로그램 크기에 따라 프로그램 계정에 SOL을 할당해야 합니다. 프로그램이 클수록 배포에 더 많은 SOL이 필요합니다.

프로그램 크기를 확인하세요:

$ 
wc -c < ./target/deploy/hello_world.so
Copy
[show output]

이 크기(바이트)에 필요한 SOL을 계산하세요:

$ 
solana rent 18504
Copy
[show output]

프로그램 배포

solana program deploy 명령어를 사용하여 프로그램을 배포하세요:

$ 
solana program deploy ./target/deploy/hello_world.so
Copy
[show output]

표시된 프로그램 ID는 네트워크에서 프로그램의 영구 주소입니다.

$ 
solana program deploy ./target/deploy/hello_world.so --program-id ./custom-keypair.jsonCopy

$ 
solana-keygen new -o ./custom-keypair.jsonCopy

프로그램 업데이트

동일한 solana program deploy 명령을 사용하여 프로그램을 업데이트하세요:

1. 프로그램 코드를 변경하세요
2. 프로그램을 다시 빌드하세요: cargo build-sbf
3. 업데이트를 배포하세요:

$ 
solana program deploy ./target/deploy/hello_world.so
Copy
[show output]

$ 
solana program extend 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE 1000
Copy
[show output]

프로그램 관리

프로그램이 배포되면 program account를 관리하기 위한 몇 가지 일반적인 명령어가 있습니다.

프로그램 메타데이터 보기

프로그램 메타데이터를 확인하려면 solana program show 명령어를 사용하세요:

$ 
solana program show 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpECopy

출력 예시:

$ solana program show 7283x8k8fyBcfaFLyPsxbd2VV1AMmZFP7FNoyTXVKJw7
Program Id: 7283x8k8fyBcfaFLyPsxbd2VV1AMmZFP7FNoyTXVKJw7
Owner: BPFLoaderUpgradeab1e11111111111111111111111
ProgramData Address: Gqn7YQVCP8NtYV1qkEqR4Udhj8EJ3fkikvS7HskCNQ7c
Authority: 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1
Last Deployed In Slot: 6573
Data Length: 18504 (0x4848) bytes
Balance: 0.12999192 SOL

프로그램 Authority 이전하기

프로그램 authority를 다른 계정으로 이전하려면 solana program set-upgrade-authority 명령어를 사용하세요:

$ 
solana program set-upgrade-authority 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --new-upgrade-authority ./new-authority-keypair.jsonCopy

프로그램을 변경 불가능하게 만들기

프로그램을 변경 불가능하게 만들려면 solana program set-upgrade-authority 명령어와 함께 --final 플래그를 사용하여 프로그램 authority를 제거하세요:

$ 
solana program set-upgrade-authority 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --final
Copy
[show output]

프로그램 종료하기

프로그램을 종료하고 프로그램 계정에 할당된 SOL을 회수하려면 solana program close 명령어를 사용하세요:

$ 
solana program close 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --bypass-warning
Copy
[show output]

유틸리티 명령어

모든 프로그램 나열하기

현재 지갑이 authority인 모든 프로그램 보기:

$ 
solana program show --programsCopy

출력 예시:

Program Id                                       | Slot       | Authority                                      | Balance
-------------------------------------------------|------------|------------------------------------------------|-------------
7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE     | 249885434  | 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1   | 0.12999192
3KSGCk4m5hqJkTjPHBXUCPcqMwJnK3VmkqEsFUKKGJPK     | 249883212  | 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1   | 0.28654328

배포된 프로그램 다운로드하기

배포된 프로그램을 다운로드하려면 solana program dump 명령어를 사용하세요:

$ 
solana program dump 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE ./downloaded_program.so
Copy
[show output]

고급 옵션

배포 플래그

Solana 네트워크가 혼잡할 때, 프로그램 배포에 도움이 되는 플래그들을 사용하세요.

사용 예시:

$ 
solana program deploy ./target/deploy/hello_world.so \
    --with-compute-unit-price 10000 \
    --max-sign-attempts 10 \
    --use-rpcCopy

옵션 설명:

• --with-compute-unit-price: 컴퓨트 유닛당 마이크로-램포트(0.000001 SOL) 단위로 우선순위 수수료를 설정합니다. 현재 요율은 Helius 우선순위 수수료 API에서 확인하세요. 우선순위 수수료는 트랜잭션의 우선순위를 높이기 위해 현재 리더에게 지불하는 추가 수수료입니다.
• --max-sign-attempts: 트랜잭션이 만료될 경우 새로운 블록해시로 재시도할 횟수입니다. (기본값: 5)
• --use-rpc: 구성된 RPC로 트랜잭션을 전송합니다. 이 플래그는 Triton 또는 Helius와 같은 제공업체의 스테이크 가중치 RPC 연결이 필요합니다.