infrablockchain-docs
ko
ko
  • 인프라블록체인
    • 배우기
      • 아키텍처
        • 아키텍처
        • 네트워크 참여자
        • 파라체인
          • 시스템 파라체인
      • 프로토콜
        • 시스템 토큰
        • 트랜잭션 수수료
        • Proof of Transaction
      • Substrate
        • 배우기
          • 기초 지식
            • 암호학
            • 블록체인 기본 개념
            • 합의
            • 네트워크와 노드
            • 트랜잭션과 블록 기본 사항
            • 트랜잭션 수명주기
            • 오프체인 작업
            • 라이트 클라이언트
            • Substrate를 위한 Rust
            • 라이브러리 소개
            • 아키텍처와 Rust 라이브러리
            • 파일 구조
            • 계정, 주소 및 키
            • 트랜잭션 형식
            • 난수 생성
          • 프레임
            • FRAME 팔레트
            • FRAME 매크로
            • 커스텀 팔레트
            • 팔레트 커플링
            • Origin
            • 이벤트와 에러
            • 런타임 스토리지 구조
            • 상태 전이와 스토리지
            • SCALE 인코딩
            • 트랜잭션, Weight 및 수수료
            • 런타임 API
            • 런타임 업그레이드
            • 런타임 개발
          • 계정 데이터 구조
          • 주소 형식
          • 용어집
          • cli
            • 아카이브
            • 메모리 프로파일러
            • 노드 템플릿
            • 사이드카
            • srtool
            • 서브키
            • subxt
            • try-runtime
            • tx-wrapper
          • 런타임 개발
            • 기본
              • Genesis 상태 구성하기
              • 런타임 상수 구성
              • 체인 스펙을 커스텀하기
              • 팔레트 가져오기
              • 도우미 함수 사용하기
            • 합의 모델
              • 작업 증명을 사용하는 체인 구성
              • 하이브리드 노드 생성하기
            • 오프체인 워커
              • 오프체인 HTTP 요청하기
              • 오프체인 인덱싱
              • 오프체인 로컬 스토리지
            • 팔레트 설계
              • 크라우드펀딩 구성하기
              • 스토리지 구조체 (struct) 생성하기
              • 잠금 가능한 통화 구현
              • 무작위성 적용하기
              • 느슨한 팔레트 결합 사용하기
              • 타이트한 팔레트 결합 사용하기
            • 파라체인 개발
              • HRMP 채널 추가하기
              • 로컬 파라체인 노드 추가하기
              • 릴레이 체인에 연결하기
              • 솔로 체인을 변환하기
              • 론칭 준비
              • 콜레이터 선택
              • 파라체인 업그레이드
            • 스토리지 마이그레이션
              • 기본 저장소 마이그레이션
              • 스토리지 마이그레이션 트리거
            • 테스트
              • 기본 테스트 설정하기
              • 전송 함수 테스트하기
            • 도구
              • 체인을 위한 txwrapper 생성
              • REST 엔드포인트를 사용하여 체인 데이터 가져오기
              • try-runtime 사용하기
              • Wasm 바이너리 검증하기
            • 가중치
              • 벤치마크 추가
              • 수수료 계산하기
              • 조건부 가중치 사용
              • 사용자 정의 가중치 사용하기
        • 빌드하기
          • 제작할 것을 결정하세요
          • 빌드 프로세스
          • 결정론적 런타임 빌드
          • 체인 스펙
          • Genesis 구성
          • 애플리케이션 개발
          • RPC
          • 문제 해결
        • 튜토리얼
          • 설치하기
            • 개발자 도구
            • 리눅스 개발 환경
            • macOS 개발 환경
            • Rust 툴체인
            • Rust 문제 해결 방법
            • Windows 개발 환경
          • 빠른 시작
            • 코드 탐색하기
            • 런타임 수정하기
            • 노드 시작하기
            • Substrate 한눈에 보기
          • 블록체인 구축
            • 신뢰할 수 있는 노드 추가
            • 특정 노드 승인
            • 로컬 블록체인 구축하기
            • 네트워크 시뮬레이션
            • 실행 중인 네트워크 업그레이드
          • 애플리케이션 로직 구축
            • 런타임에 팔레트 추가하기
            • 오프체인 워커 추가
            • 사용자 정의 팔레트 게시
            • 함수 호출의 출처 지정하기
            • 사용자 정의 팔레트에서 매크로 사용하기
          • 유용한 도구들
            • EVM 계정에 접근하기
            • 이더리움 통합
            • 사이드카 엔드포인트 탐색하기
            • 경량 클라이언트 노드 통합
          • 스마트 컨트랙트
            • 스마트 컨트랙트
            • 토큰 계약 작성하기
            • 스마트 컨트랙트 개발하기
            • 첫 번째 계약 준비하기
            • 스마트 컨트랙트 문제 해결
            • 값 저장을 위한 맵 사용
      • XCM
        • XCM
        • XCM 형식
    • 서비스 체인
      • 인프라DID
      • 인프라EVM
      • URAuth(Universal Resource Auth)
    • 데브 옵스
      • 체인 빌드
      • 배포
      • 모니터링
    • 튜토리얼
      • 기초
        • 시스템 토큰 관리 프로세스
        • 시스템 토큰을 트랜잭션 수수료로 사용해보기
        • 트랜잭션에 투표 포함 시키기
        • 밸리데이터 보상 받기
      • 구축하기
        • 인프라릴레이체인 구축하기
        • 파라체인 구축하기
        • 메시지 전달 채널 열기
        • XCM을 이용하여 토큰 전송하기
        • Asynchronous Backing 적용하기
      • 테스트
        • 벤치마크
        • 런타임 확인
        • 디버그
        • 테스트 네트워크에서 파라체인 시뮬레이션하기
        • 단위 테스트
      • 서비스체인
        • 인프라DID
          • 구축하기
          • 공개키 추가하기
          • 서비스 엔드포인트 등록하기
          • DID 생성하기
        • 인프라EVM
          • 구축하기
          • EVM에 자금 입금 및 인출하기
          • ERC20 토큰 컨트랙트 배포하기
          • ERC721 토큰 컨트랙트 배포하기
          • ERC1155 토큰 컨트랙트 배포하기
  • 뉴날 데이터 마켓
Powered by GitBook
On this page
  • 모의 런타임에서 팔레트 로그 테스트
  • 모의 런타임에서 스토리지 테스트
  • 모의 런타임에서 이벤트 테스트
  • 제네시스 구성
  • 블록 생성
  1. 인프라블록체인
  2. 튜토리얼
  3. 테스트

단위 테스트

런타임 로직에 대한 기본 단위 테스트를 설명합니다.

Previous테스트 네트워크에서 파라체인 시뮬레이션하기Next서비스체인

Last updated 1 year ago

런타임 로직을 구축하는 동안 로직이 예상대로 작동하는지 정기적으로 테스트하고 싶을 것입니다. Rust에서 제공하는 를 사용하여 런타임에 대한 단위 테스트를 생성할 수 있습니다. 하나 이상의 단위 테스트를 생성한 후 cargo test 명령을 사용하여 테스트를 실행할 수 있습니다. 예를 들어, 다음 명령을 실행하여 런타임에 대해 생성한 모든 테스트를 실행할 수 있습니다:

cargo test

Rust cargo test 명령과 테스트 프레임워크를 사용하는 더 많은 정보를 얻으려면 다음 명령을 실행하세요:

cargo help test

모의 런타임에서 팔레트 로그 테스트

Rust 테스트 프레임워크로 수행할 수 있는 단위 테스트 외에도, 모의 런타임 환경을 구성하여 런타임의 로직을 확인할 수 있습니다. Test 구성 타입은 모의 런타임에서 사용되는 팔레트 구성 특성 각각에 대한 Rust enum으로 정의됩니다.

frame_support::construct_runtime!(
 pub enum Test where
  Block = Block,
  NodeBlock = Block,
  UncheckedExtrinsic = UncheckedExtrinsic,
 {
  System: frame_system::{Pallet, Call, Config, Storage, Event<T>},
  TemplateModule: pallet_template::{Pallet, Call, Storage, Event<T>},
 }
);

impl frame_system::Config for Test {
 // -- 생략 --
 type AccountId = u64;
}

Test가 pallet_balances::Config를 구현한다면, 할당은 Balance 타입에 u64를 사용할 수 있습니다. 예를 들어:

impl pallet_balances::Config for Test {
 // -- 생략 --
 type Balance = u64;
}

pallet_balances::Balance와 frame_system::AccountId를 u64로 할당함으로써, 테스트 계정과 잔액은 모의 런타임에서 (AccountId: u64, Balance: u64) 매핑만 추적하면 됩니다.

모의 런타임에서 스토리지 테스트

다음 예제는 ExtBuilder라는 구조체를 정의하여 TestExternalities의 인스턴스를 빌드하고 블록 번호를 1로 설정하는 방법을 보여줍니다.

pub struct ExtBuilder;

impl ExtBuilder {
 pub fn build(self) -> sp_io::TestExternalities {
  let mut t = system::GenesisConfig::default().build_storage::<TestRuntime>().unwrap();
  let mut ext = sp_io::TestExternalities::new(t);
  ext.execute_with(|| System::set_block_number(1));
  ext
 }
}

단위 테스트에서 테스트 환경을 생성하려면 빌드 메서드를 호출하여 기본 genesis 구성을 사용하여 TestExternalities를 생성합니다.

#[test]
fn fake_test_example() {
 ExtBuilder::default().build_and_execute(|| {
  // ...테스트 로직...
 });
}

모의 런타임에서 이벤트 테스트

fn fake_test_example() {
 ExtBuilder::default().build_and_execute(|| {
  System::set_block_number(1);
  // ... FakeEvent1을 발생시키는 테스트 로직 ...
  System::assert_has_event(Event::FakeEvent1{}.into())
  System::assert_last_event(Event::FakeEvent2 { data: 7 }.into())
  assert_eq!(System::events().len(), 2);
 });
}

주의해야 할 몇 가지 사항은 다음과 같습니다:

  • 이벤트는 제네시스 블록에서 발생하지 않으므로, 이 테스트가 통과하려면 블록 번호를 설정해야 합니다.

  • 팔레트 이벤트를 인스턴스화한 후 .into()를 사용해야 하며, 이렇게 하면 일반 이벤트로 변환됩니다.

고급 이벤트 테스트

팔레트에서 이벤트를 테스트할 때, 자신의 팔레트에서 발생한 이벤트에만 관심이 있는 경우가 많습니다. 다음 도우미 함수는 이벤트를 필터링하여 사용자 정의 이벤트 유형으로 변환하는 방법을 보여줍니다. 이러한 유형의 도우미 함수는 일반적으로 모의 런타임에서 테스트하기 위한 mock.rs 파일에 배치됩니다.

fn only_example_events() -> Vec<super::Event<Runtime>> {
 System::events()
  .into_iter()
  .map(|r| r.event)
  .filter_map(|e| if let RuntimeEvent::TemplateModule(inner) = e { Some(inner) } else { None })
  .collect::<Vec<_>>();
}

또한, 테스트가 시퀀스로 이벤트를 발생시키는 작업을 수행하는 경우, 마지막 확인 이후에 발생한 이벤트만 볼 수 있도록 할 수도 있습니다.

다음 예제는 앞서 언급한 도우미 함수를 활용합니다.

parameter_types! {
 static ExamplePalletEvents: u32 = 0;
}

fn example_events_since_last_call() -> Vec<super::Event<Runtime>> {
 let events = only_example_events();
 let already_seen = ExamplePalletEvents::get();
 ExamplePalletEvents::set(events.len() as u32);
 events.into_iter().skip(already_seen as usize).collect()
}

이렇게 하면 마지막 확인 이후에 발생한 이벤트만 반환합니다.

이전 이벤트 테스트를 이 새로운 함수로 다시 작성하면 다음과 같은 코드가 됩니다.

fn fake_test_example() {
 ExtBuilder::default().build_and_execute(|| {
  System::set_block_number(1);
  // ... FakeEvent1을 발생시키는 테스트 로직 ...
  assert_eq!(
   example_events_since_last_call(),
   vec![Event::FakeEvent1{}]
  );
  // ... FakeEvent2를 발생시키는 테스트 로직 ...
  assert_eq!(
   example_events_since_last_call(),
   vec![Event::FakeEvent2{}]
  );
 });
}

제네시스 구성

이전 예제에서 ExtBuilder::build() 메서드는 모의 런타임 환경을 구축하기 위해 기본 genesis 구성을 사용했습니다. 많은 경우, 테스트 전에 스토리지를 설정하는 것이 편리합니다. 예를 들어, 테스트 전에 계정 잔액을 미리 설정하고 싶을 수 있습니다.

frame_system::Config의 구현에서 AccountId와 Balance 모두 u64로 설정되어 있습니다. 계정 잔액으로 (AccountId, Balance) 쌍을 시드로 사용하려면 balances 벡터에 (1, 10), (2, 20), (3, 30), (4, 40), (5, 50), (6, 60)과 같은 형태로 넣을 수 있습니다.예를 들어,

impl ExtBuilder {
 pub fn build(self) -> sp_io::TestExternalities {
  let mut t = frame_system::GenesisConfig::default().build_storage::<Test>().unwrap();
  pallet_balances::GenesisConfig::<Test> {
   balances: vec![
    (1, 10),
    (2, 20),
    (3, 30),
    (4, 40),
    (5, 50),
    (6, 60)
   ],
  }
   .assimilate_storage(&mut t)
   .unwrap();

  let mut ext = sp_io::TestExternalities::new(t);
  ext.execute_with(|| System::set_block_number(1));
  ext
 }
}

이 예제에서는 계정 1의 잔액이 10, 계정 2의 잔액이 20 등으로 설정됩니다.

팔레트의 제네시스 구성을 정의하는 데 사용되는 정확한 구조는 팔레트의 GenesisConfig 구조체 정의에 따라 다릅니다. 예를 들어, Balances 팔레트에서는 다음과 같이 정의됩니다:

pub struct GenesisConfig<T: Config<I>, I: 'static = ()> {
 pub balances: Vec<(T::AccountId, T::Balance)>,
}

블록 생성

블록 생성을 시뮬레이션하여 블록 생성 간에 예상한 동작이 유지되는지 확인하는 것이 유용합니다.

이를 수행하는 간단한 방법은 System 모듈의 블록 번호를 on_initialize 및 on_finalize 호출 사이에서 증가시키는 것입니다. 이때 모든 모듈에서 System::block_number()를 유일한 입력으로 사용합니다. 런타임 코드에서 스토리지 또는 시스템 모듈 호출을 캐시하는 것이 중요하지만, 테스트 환경 구조는 향후 유지 보수를 용이하게 하기 위해 가독성을 우선시해야 합니다.

fn run_to_block(n: u64) {
 while System::block_number() < n {
  if System::block_number() > 0 {
   ExamplePallet::on_finalize(System::block_number());
   System::on_finalize(System::block_number());
  }
  System::reset_events();
  System::set_block_number(System::block_number() + 1);
  System::on_initialize(System::block_number());
  ExamplePallet::on_initialize(System::block_number());
 }
}

on_finalize 및 on_initialize 메서드는 팔레트 특성이 각 블록 전후에 런타임 메서드에 인코딩된 로직을 실행하기 위해 frame_support::traits::{OnInitialize, OnFinalize} 특성을 구현하는 경우에만 ExamplePallet에서 호출됩니다.

그런 다음 이 함수를 다음과 같은 방식으로 호출합니다.

#[test]
fn my_runtime_test() {
 with_externalities(&mut new_test_ext(), || {
  assert_ok!(ExamplePallet::start_auction());
  run_to_block(10);
  assert_ok!(ExamplePallet::end_auction());
 });
}

크레이트는 모의 환경에서 스토리지를 테스트하기 위해 사용할 수 있는 구현을 노출합니다. 이는 에서 인메모리 해시맵 기반의 외부성을 위한 타입 별칭으로 TestExternalities 로 참조됩니다.

의 사용자 정의 구현을 통해 외부 노드의 기능에 액세스할 수 있는 런타임 환경을 구축할 수 있습니다. 이와 관련된 또 다른 예는 모듈에서 찾을 수 있습니다. offchain 모듈은 자체 Externalities 구현을 유지합니다.

스토리지 외에도 체인에서 발생하는 이벤트를 테스트하는 것도 중요할 수 있습니다. deposit_event를 generate_deposit 매크로와 함께 사용하는 경우, 모든 팔레트 이벤트는 system / events 키 아래에 로 저장됩니다.

이벤트 레코드는 System::events()를 통해 직접 액세스하고 반복할 수 있지만, 테스트에 사용할 수 있는 몇 가지 도우미 메서드도 시스템 팔레트에 정의되어 있습니다. 와 입니다.

단위 테스트 프레임워크
sp-io
TestExternalities
substrate_state_machine
Externalities
offchain
EventRecord
assert_last_event
assert_has_event