Solana에서 스마트 계약 구축: Rust 초보자를 위한 가이드

솔라나의 실행 환경 이해하기

1. Solana는 Sealevel이라는 병렬 런타임을 사용합니다. 이를 통해 프로그램이라고 알려진 수천 개의 스마트 계약이 여러 계정에서 동시에 실행될 수 있습니다.

2. 이더리움의 EVM과 달리 솔라나는 글로벌 상태 머신에 의존하지 않습니다. 대신 각 프로그램은 격리된 계정 데이터를 기반으로 작동하여 엄격한 소유권 및 권한 모델을 시행합니다.

3. Solana의 프로그램은 BPF(Berkeley Packet Filter) 바이트코드로 컴파일되므로 개발자는 Rust 또는 C로 작성하고 이 대상 아키텍처로 컴파일해야 합니다.

4. 계정 임대료 면제는 필수입니다. 모든 온체인 계정은 저장소 임대료를 감당할 만큼 충분한 SOL을 보유해야 합니다. 그렇지 않으면 원장에서 제거될 위험이 있습니다.

5. 거래 수수료는 결정론적이며 매우 낮습니다. 가스 추정이 아닌 소비된 컴퓨팅 단위를 기준으로 계산되므로 비용 예측이 더욱 정확해집니다.

Rust 개발 스택 설정

1. 공식 Rust 설치 프로그램을 통해 Rustup을 설치하여 툴체인을 관리한 다음, Rustup 대상 add bpfel-unknown-elf 와 함께 BPF 대상을 추가합니다.

2. Solana CLI를 사용하여 로컬 유효성 검사기를 구성하고, 키 쌍을 생성하고, 프로그램을 배포합니다. solana-test-validator 와 같은 명령은 로컬 클러스터를 즉시 시작합니다.

3. 앵커는 필수는 아니지만 널리 채택됩니다. 계정 직렬화, CPI 처리, 오류 정의와 같은 상용구를 재사용 가능한 매크로 및 특성으로 추상화합니다.

4. solana 프로그램 크레이트는 Pubkey, AccountInfo, ProgramResult와 같은 핵심 유형을 제공하여 모든 Solana 프로그램의 기초를 형성합니다.

5. 디버깅은 메시지를 통한 로깅에 크게 의존합니다! 매크로 - 이는 트랜잭션 로그에 나타나며 개발 중 실행 흐름을 추적하는 데 중요합니다.

첫 번째 온체인 프로그램 작성

1. 최소 프로그램은 진입점을 내보냅니다! 명령어 데이터와 계정 참조 조각을 받아들이고 런타임에 대한 유일한 인터페이스 역할을 하는 매크로입니다.

2. 명령어 역직렬화는 명시적이어야 합니다. 개발자는 원시 바이트를 수동으로 구문 분석하거나 Anchor의 InstructionData 파생 매크로를 사용하여 직렬 변환기를 자동 생성합니다.

3. 프로그램에 전달된 각 계정은 상태 변경이 발생하기 전에 소유권, 변경 가능성, 서명자 상태 및 임대료 면제에 대해 검증되어야 합니다.

4. 프로그램은 임의의 데이터 구조를 직접 저장할 수 없습니다. 종종 Borsh 또는 Bincode를 사용하여 직렬화된 바이트를 계정 데이터 버퍼에 기록하여 상태를 유지합니다.

5. CPI(교차 프로그램 호출)를 위해서는 적절하게 서명된 계정으로 명령어 구조를 구성해야 합니다. 필수 서명자를 포함하지 않으면 즉시 거래가 실패하게 됩니다.

테스트 및 배포 워크플로

1. 단위 테스트는 solana-program-test를 사용하여 오프체인에서 실행되며 네트워크 상호 작용 없이 계정 생성, 명령 제출 및 상태 어설션을 시뮬레이션합니다.

2. 통합 테스트는 컴파일된 프로그램을 로컬 테스트 유효성 검사기에 배포하고 TypeScript에서 @solana/web3.js를 사용하여 실제 클라이언트 상호 작용을 시뮬레이션합니다.

3. devnet에 배포하려면 SOL로 프로그램 주소에 자금을 조달하고 ELF 바이트코드를 업로드하고 고유한 Pubkey를 할당하는 solana 프로그램 배포를 실행해야 합니다.

4. 업그레이드 가능한 프로그램은 버퍼 계정 및 업그레이드 권한과 함께 배포됩니다. 이러한 분리를 통해 사용자 데이터를 마이그레이션하지 않고도 패치 논리를 적용할 수 있습니다.

5. 버전 관리는 수동입니다. 내장된 계약 버전 레지스트리가 없으므로 개발자는 계정 데이터 또는 명령 판별자에 버전 식별자를 삽입합니다.

자주 묻는 질문

Q: 솔라나 스마트 컨트랙트를 작성하기 위해 JavaScript나 Python을 사용할 수 있나요? A: 아니요. Solana는 BPF 바이트코드만 실행합니다. Rust와 C만이 이 대상으로 안정적으로 컴파일됩니다. 고급 언어는 클라이언트 측 논리 또는 IDL 정의를 생성할 수 있지만 온체인 프로그램을 대체할 수는 없습니다.

Q: 계정을 수정하려고 할 때 "다른 프로그램이 소유한 계정"이라는 메시지가 나타나는 이유는 무엇입니까? A: 이는 계정의 소유자 필드가 다른 프로그램의 Pubkey를 가리킬 때 발생합니다. CPI 또는 프로그램 파생 주소를 통해 명시적으로 위임되지 않는 한 소유 프로그램만 해당 계정에 쓸 수 있습니다.

Q: 내 프로그램이 실행 중에 컴퓨팅 예산을 초과하면 어떻게 됩니까? A: 트랜잭션이 즉시 중지되고 모든 상태 변경 사항을 되돌리고 "ComputationalBudgetExceeded" 오류를 반환합니다. 개발자는 루프를 최적화하고, 반복을 제한하고, 무제한 메모리 할당을 방지해야 합니다.

Q: 다른 프로그램의 계정 데이터를 호출하지 않고도 읽을 수 있나요? 답: 그렇습니다. 실행 불가능하고 공개적으로 읽을 수 있는 것으로 표시된 모든 계정은 getAccountInfo 와 같은 RPC 엔드포인트를 통해 가져올 수 있습니다. 그러나 실행 가능한 프로그램과 개인 데이터는 적절한 권한 없이는 액세스할 수 없습니다.