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. Substrate
  4. 배우기
  5. 프레임

이벤트와 에러

런타임에서 이벤트와 오류를 발생시키는 방법을 설명합니다.

팔렛은 런타임에서 변경 사항이나 조건에 대한 알림을 사용자, 체인 익스플로러 또는 dApp과 같은 외부 개체에게 보내고자 할 때 이벤트를 발생시킬 수 있습니다.

커스텀 팔렛에서는 다음을 정의할 수 있습니다:

  • 발생시키고자 하는 이벤트의 유형

  • 이벤트에 포함되는 정보

  • 이벤트가 발생하는 시점

이벤트 선언하기

이벤트는 #[pallet::event] 매크로를 사용하여 생성됩니다. 예를 들어:

#[pallet::event]
#[pallet::generate_deposit(pub(super) fn deposit_event)]
pub enum Event<T: Config> {
	/// 값을 설정합니다.
	ValueSet { value: u32, who: T::AccountId },
}

그런 다음, 런타임에서 이벤트를 집계하기 위해 RuntimeEvent 타입이 필요합니다.

#[pallet::config]
	pub trait Config: frame_system::Config {
		/// 전체적인 이벤트 유형입니다.
		type RuntimeEvent: From<Event<Self>> + IsType<<Self as frame_system::Config>::RuntimeEvent>;
	}

런타임에 이벤트 노출하기

팔렛에서 정의한 모든 이벤트는 /runtime/src/lib.rs 파일에서 런타임에 노출되어야 합니다.

이벤트를 런타임에 노출하려면 다음을 수행합니다:

  1. 텍스트 편집기에서 /runtime/src/lib.rs 파일을 엽니다.

  2. 팔렛의 구성 트레이트에서 RuntimeEvent 타입을 구현합니다:

    impl template::Config for Runtime {
    	 type RuntimeEvent = RuntimeEvent;
    }
  3. construct_runtime! 매크로에 RuntimeEvent 타입을 추가합니다:

    construct_runtime!(
    	 pub enum Runtime where
     	 Block = Block,
    	   NodeBlock = opaque::Block,
    	   UncheckedExtrinsic = UncheckedExtrinsic
    	 {
        // --snip--
    	   TemplateModule: template::{Pallet, Call, Storage, Event<T>},
    	   //--add-this------------------------------------->
    		 }
    );

    이 예제에서 이벤트는 제네릭 타입이며 <T> 매개변수가 필요합니다. 이벤트가 제네릭을 사용하지 않는 경우 <T> 매개변수는 필요하지 않습니다.

이벤트 발생시키기

Substrate는 매크로를 사용하여 이벤트를 발생시키는 기본 구현을 제공합니다. 이벤트를 발생시키는 구조는 다음과 같습니다:

// 1. 이벤트 열거형을 선언할 때 `generate_deposit` 속성을 사용합니다.
#[pallet::event]
	#[pallet::generate_deposit(pub(super) fn deposit_event)] // <------ 여기 ----
	#[pallet::metadata(...)]
	pub enum Event<T: Config> {
		// --snip--
	}

// 2. 디스패처 함수 내에서 `deposit_event`를 사용합니다.
#[pallet::call]
	impl<T: Config> Pallet<T> {
		#[pallet::weight(1_000)]
		pub(super) fn set_value(
			origin: OriginFor<T>,
			value: u64,
		) -> DispatchResultWithPostInfo {
			let sender = ensure_signed(origin)?;
			// --snip--
			Self::deposit_event(RawEvent::ValueSet(value, sender));
		}
	}

이 함수는 해당 블록의 시스템 팔렛(System Pallet)의 스토리지에 이벤트를 저장합니다. 새로운 블록이 시작될 때, 시스템 팔렛은 이전 블록에서 저장된 모든 이벤트를 자동으로 제거합니다.

지원되는 타입

이벤트 수신하기

오류

각 FRAME 팔렛은 #[pallet::error] 매크로를 사용하여 커스텀 DispatchError를 정의할 수 있습니다. 예를 들어:

#[pallet::error]
pub enum Error<T> {
		/// 에러 이름은 설명적이어야 합니다.
		InvalidParameter,
		/// 에러에는 유용한 문서가 있어야 합니다.
		OutOfSpace,
	}
frame_support::ensure!(param < T::MaxVal::get(), Error::<T>::InvalidParameter);

다음 단계로 넘어가기

PreviousOriginNext런타임 스토리지 구조

Last updated 1 year ago

이 함수의 기본 동작은 FRAME 시스템에서 를 호출하여 이벤트를 스토리지에 기록하는 것입니다.

발생된 이벤트는 와 같은 하위 라이브러리에서 직접 지원됩니다. 그러나 이벤트를 다르게 처리하고 싶다면 자체 deposit_event 함수를 구현할 수도 있습니다.

이벤트는 를 사용하여 타입 인코딩을 지원하는 모든 타입을 발생시킬 수 있습니다.

AccountId나 Balances와 같은 런타임 제네릭 타입을 사용하려는 경우, 해당 타입을 정의하기 위해 을 포함해야 합니다. 위의 예제에서 보여진 대로 정의합니다.

Substrate RPC는 이벤트를 직접 쿼리할 수 있는 엔드포인트를 제공하지 않습니다. 기본적으로 System 팔렛의 스토리지를 쿼리하여 현재 블록의 이벤트 목록을 볼 수 있습니다. 그렇지 않은 경우, 는 런타임 이벤트에 대한 WebSocket을 지원합니다.

런타임 코드는 명시적으로 모든 오류 상황을 처리해야 합니다. 런타임 코드의 함수는 컴파일러를 시키지 않는 함수여야 합니다. Rust에서 패닉이 발생하지 않는 코드를 작성하는 일반적인 관용구는 을 반환하는 함수를 작성하는 것입니다. Result 열거형 타입은 함수가 성공적으로 실행되지 못했음을 패닉하지 않고 알릴 수 있는 Err을 가지고 있습니다. FRAME 개발은 런타임으로 디스패치될 수 있는 함수 호출에 대해 오류를 만났을 경우 를 낼 수 있는 을 반환해야 합니다.

FRAME Support 모듈에는 전처리 조건을 확인하고 오류를 발생시킬 수 있는 유용한 도 포함되어 있습니다.

deposit_event
Polkadot-JS API
SCALE 코덱
where 절
Polkadot-JS API
패닉
Result 타입
DispatchError
DispatchResult 타입
ensure! 매크로
Frame 매크로
construct_runtime! 매크로
#[frame_support::pallet] 매크로
[pallet::error] 매크로