런타임 수정하기

기본 노드 템플릿을 수정하여 사용자 정의 런타임을 만드는 간단한 변경 사항을 만들어보세요.

에서 기본 노드 템플릿을 구성하는 매니페스트 파일과 Rust 모듈에 대해 배웠습니다. 이제 런타임 소스 코드가 어떻게 구성되어 있는지 대략적으로 알았으니, 몇 가지 간단한 변경 사항을 통해 런타임을 사용자 정의하는 방법을 알아보겠습니다.

이 간단한 데모에서 다음과 같은 작업을 수행할 것입니다:

사용하고 싶은 기능을 가진 팔레트를 추가합니다.
일부 상수 값을 변경합니다.
런타임 버전을 업데이트합니다.
변경 사항을 포함한 런타임을 다시 컴파일합니다.
체인에 저장된 런타임을 업데이트하기 위해 트랜잭션을 제출합니다.

또한 Polkadot-JS API를 사용하는 다른 응용 프로그램을 보고, 호스팅된 버전의 해당 응용 프로그램을 사용하여 체인 상태를 확인하고 트랜잭션을 제출하는 방법을 알아볼 것입니다.

시작하기 전에

--dev 커맨드 라인 옵션을 사용하여 개발 모드에서 노드를 실행하면 첫 번째 블록과 함께 깨끗한 상태로 시작됩니다. 런타임을 수정하고 업데이트하는 방법을 가장 잘 설명하기 위해, 기본 노드 템플릿을 기본 런타임으로 다시 시작하여 블록을 생성하도록 해보겠습니다.

기본 런타임으로 노드를 다시 시작하려면 다음 단계를 따르세요:

컴퓨터에서 터미널 쉘을 엽니다.
Substrate 노드 템플릿을 컴파일한 루트 디렉토리로 이동합니다.
다음 명령을 실행하여 개발 모드에서 로컬 노드를 시작합니다:
```
cargo run --release -- --dev
```

노드를 시작한 후, Polkadot-JS API를 사용하여 노드에 연결할 수 있습니다.

실행 중인 노드에 연결하려면 다음 단계를 따르세요:

Firefox와 같은 보다 제한적인 브라우저를 사용하는 경우, Polkadot/Substrate Portal과 노드 간의 연결이 차단될 수 있습니다.
개발 네트워크와 기본 로컬 노드 엔드포인트 127.0.0.1:9944에 연결합니다.
개발 환경에서 노드 템플릿 버전이 기본 버전 100임을 확인하세요.

팔레트 추가하기

Substrate와 FRAME을 사용하여 개발을 시작하는 가장 일반적인 방법은 기존 라이브러리에서 팔레트를 가져오거나 직접 만들어서 팔레트를 추가하는 것입니다. 팔레트를 처음부터 직접 만드는 것은 어렵지 않지만, 응용 프로그램 로직, 스토리지 요구 사항, 오류 처리 등을 설계하는 데 더 많은 작업이 필요합니다. 간단하게 유지하기 위해, 기존 라이브러리에서 팔레트를 가져와 추가해보겠습니다.

Utility 팔레트를 추가하려면 다음 단계를 따르세요:

컴퓨터에서 두 번째 터미널 쉘을 열고, 노드 템플릿 루트 디렉토리로 이동합니다.
런타임 매니페스트인 runtime/Cargo.toml 파일을 코드 편집기에서 엽니다.
[dependencies] 섹션을 찾아 Utility 팔레트를 종속성으로 추가합니다.
예를 들어, 다음과 유사한 한 줄을 추가해야 합니다.
```
pallet-utility = { version = "4.0.0-dev", default-features = false, git = "https://github.com/paritytech/polkadot-sdk.git", branch = "polkadot-vX.Y.Z" }
```
branch = "polkadot-vX.Y.Z"를 다른 팔레트에 사용된 Polkadot 브랜치와 동일한 값으로 바꿔야 합니다.
pallet-utility 종속성의 branch 설정이 다른 팔레트의 branch 설정과 동일하도록 하기 위해 기존 팔레트 종속성을 모델로 복사할 수 있습니다.
[features] 섹션을 찾아 표준 바이너리의 기본 기능 목록에 Utility 팔레트를 추가합니다.
예를 들어:
```
[features]
default = ["std"]
std = [
   ...
   "pallet-utility/std",
   ...
]
```
변경 사항을 저장하고 Cargo.toml 파일을 닫습니다.
코드 편집기에서 runtime/src/lib.rs 파일을 엽니다.

Utility 팔레트에 대한 Config 트레이트 구현을 추가합니다.

예를 들어:

impl pallet_utility::Config for Runtime {
   type RuntimeEvent = RuntimeEvent;
   type RuntimeCall = RuntimeCall;
   type PalletsOrigin = OriginCaller;
   type WeightInfo = pallet_utility::weights::SubstrateWeight<Runtime>;
}

construct_runtime! 매크로 내부에 Utility 팔레트를 추가합니다.

예를 들어:

construct_runtime!(
  pub struct Runtime
  where
     Block = Block,
     NodeBlock = opaque::Block,
     UncheckedExtrinsic = UncheckedExtrinsic
  {
         System: frame_system,
         RandomnessCollectiveFlip: pallet_randomness_collective_flip,
         Timestamp: pallet_timestamp,
         Aura: pallet_aura,
         ...
         Utility: pallet_utility, // 이 줄을 추가합니다
         ...
  }

상수 값 변경하기

기본 노드 템플릿의 Balances 팔레트는 EXISTENTIAL_DEPOSIT 상수를 정의합니다. EXISTENTIAL_DEPOSIT는 유효한 활성 계정으로 간주되기 위해 계정이 가져야 하는 최소 잔액을 나타냅니다. 기본적으로 이 상수는 128비트 부호 없는 정수 형식으로 정의되며 값은 500입니다. 간단하게 유지하기 위해, 이 상수의 값을 500에서 1000으로 변경하겠습니다.

상수 값을 업데이트하려면 다음 단계를 따르세요:

코드 편집기에서 runtime/src/lib.rs 파일을 엽니다.

Balances 팔레트의 EXISTENTIAL_DEPOSIT를 찾습니다.

/// Existential deposit.
pub const EXISTENTIAL_DEPOSIT: u128 = 500;

EXISTENTIAL_DEPOSIT의 값을 업데이트합니다.

pub const EXISTENTIAL_DEPOSIT: u128 = 1000 // 이 값을 업데이트합니다.

런타임 버전 업데이트하기

기본 노드 템플릿에서는 VERSION 상수를 사용하여 기본 런타임 버전을 spec_version과 100의 값으로 식별합니다. 기본 런타임에 대한 변경 사항을 알리기 위해 spec_version을 100에서 101로 변경하겠습니다.

빠른 시작 에서 기본 런타임에 대한 변경 사항을 수행하는 데는 spec_version을 업데이트하는 것이 엄격히 필요하지 않습니다. 그러나 버전을 업데이트하면 포크리스 업그레이드를 수행하는 기본 단계를 확인할 수 있습니다.

런타임 버전을 업데이트하려면 다음 단계를 따르세요:

코드 편집기에서 runtime/src/lib.rs 파일을 엽니다.

runtime_version 매크로를 찾습니다.

#[sp_version::runtime_version]
pub const VERSION: RuntimeVersion = RuntimeVersion {
     spec_name: create_runtime_str!("node-template"),
     impl_name: create_runtime_str!("node-template"),
     authoring_version: 1,
     spec_version: 100,
     impl_version: 1,
     apis: RUNTIME_API_VERSIONS,
     transaction_version: 1,
     state_version: 1,
};

spec_version을 새로운 런타임 버전으로 지정합니다.

spec_version: 101,  // spec_version을 100에서 101로 변경합니다

변경 사항을 저장하고 runtime/src/lib.rs 파일을 닫습니다.

런타임 다시 컴파일하기

수정한 런타임을 사용하도록 노드 템플릿을 업데이트하기 전에, 런타임을 다시 컴파일해야 합니다.

런타임 패키지를 다시 컴파일하려면 다음 단계를 따르세요:

두 번째 터미널 쉘을 열고, 노드 템플릿을 컴파일한 루트 디렉토리로 이동합니다.
다음 명령을 실행하여 런타임을 다시 컴파일합니다:
```
cargo build --release --package node-template-runtime
```
--release 커맨드 라인 옵션은 더 긴 컴파일 시간이 필요합니다. 그러나 블록체인 네트워크에 제출하기에 더 적합한 더 작은 빌드 아티팩트를 생성합니다. 스토리지 최적화는 어떤 블록체인에 있어서도 _중요_합니다. 이 명령을 사용하면 빌드 아티팩트가 target/release 디렉토리에 출력됩니다. WebAssembly 빌드 아티팩트는 target/release/wbuild/node-template-runtime 디렉토리에 있습니다. 예를 들어, target/release/wbuild/node-template-runtime 디렉토리의 내용을 나열하면 다음과 같은 WebAssembly 빌드 아티팩트가 표시됩니다:
```
node_template_runtime.compact.compressed.wasm
node_template_runtime.compact.wasm
node_template_runtime.wasm
```

트랜잭션 제출하기

이제 수정된 런타임을 설명하는 업데이트된 WebAssembly 객체가 있습니다. 그러나 실행 중인 노드는 아직 업그레이드된 런타임을 사용하지 않고 있습니다. 체인에 저장된 런타임을 업데이트하려면, WebAssembly 객체를 변경하는 트랜잭션을 제출해야 합니다.

런타임을 업데이트하려면 다음 단계를 따르세요:

관리용 Alice 계정을 선택합니다.
sudo 팔레트와 sudoUncheckedWeight(call, weight) 함수를 선택합니다.
system을 선택하고 **setCode(code)**를 호출하는 호출을 Alice 계정을 사용하여 만듭니다.
파일 업로드를 클릭한 다음, 업데이트된 런타임을 위해 생성한 압축된 WebAssembly 파일인 node_template_runtime.compact.compressed.wasm을 선택하거나 드래그하여 업로드합니다.
예를 들어, target/release/wbuild/node-template-runtime 디렉토리로 이동하고 node_template_runtime.compact.compressed.wasm을 업로드할 파일로 선택합니다.
weight 매개변수를 모두 기본값인 0으로 설정합니다.
트랜잭션 제출을 클릭합니다.
권한을 검토한 후 Sign and Submit을 클릭합니다.

수정된 런타임 확인하기

트랜잭션이 블록에 포함되면 수정된 런타임을 사용하는지 확인할 수 있습니다.

변경 사항을 확인하려면 다음 단계를 따르세요:

노드 템플릿 버전이 이제 101인지 확인합니다.
예를 들어:
Developer를 클릭하고 Extrinsics를 선택합니다.
다음 엑스트린식 제출을 클릭하고 목록의 맨 아래로 스크롤하여 utility 팔레트가 옵션으로 사용 가능한지 확인합니다.
balances 팔레트를 선택하고 existentialDeposit를 선택한 다음 **+**를 클릭하여 상수 값을 쿼리합니다.

다음 단계로 넘어가기

변경 사항을 확인한 후, 사용자 정의 버전의 노드 템플릿이 실행 중이며 로컬 노드를 수정된 런타임을 사용하도록 성공적으로 업그레이드했음을 알게 되었습니다.

Previous코드 탐색하기 Next노드 시작하기

Last updated 1 year ago