# 값 저장을 위한 맵 사용 [스마트 컨트랙트 개발](/infrablockchain-docs/ko/infrablockchain/learn/substrate/tutorials/smart-contracts/develop-a-smart-contract.md)에서는 하나의 숫자 값을 저장하고 검색하는 스마트 컨트랙트를 개발했습니다. 이 튜토리얼에서는 스마트 컨트랙트의 기능을 확장하여 각 사용자마다 하나의 숫자를 관리하는 방법을 설명합니다. 이를 위해 [`Mapping`](https://docs.rs/ink/4.0.0-beta.1/ink/storage/struct.Mapping.html) 타입을 사용합니다. ink! 언어는 맵 타입을 제공하여 데이터를 키-값 쌍으로 저장할 수 있게 합니다. 예를 들어, 다음 코드는 사용자를 숫자에 매핑하는 방법을 보여줍니다: ```rust // `Mapping` 타입을 가져옵니다 use ink::storage::Mapping; #[ink(storage)] pub struct MyContract { // AccountId를 u32에 매핑하는 맵을 저장합니다 my_map: Mapping, } ``` `Mapping` 데이터 타입을 사용하면 각 키에 대해 고유한 저장 값 인스턴스를 저장할 수 있습니다. 이 튜토리얼에서는 각 `AccountId`가 하나의 `my_map`에 매핑되는 키를 나타냅니다. 각 사용자는 자신의 `AccountId`와 연결된 값을 저장, 증가, 검색할 수 있습니다. ### `Mapping` 초기화 첫 번째 단계는 `AccountId`와 저장된 값 사이의 매핑을 초기화하는 것입니다. * 매핑 키와 해당 키에 매핑된 값을 지정하세요. 다음 예제는 `Mapping`을 초기화하고 값을 검색하는 방법을 보여줍니다: ```rust #![cfg_attr(not(feature = "std"), no_std)] #[ink::contract] mod mycontract { use ink::storage::Mapping; #[ink(storage)] pub struct MyContract { // AccountId를 u32에 매핑하는 맵을 저장합니다 my_map: Mapping, } impl MyContract { #[ink(constructor)] pub fn new(count: u32) -> Self { let mut my_map = Mapping::default(); let caller = Self::env().caller(); my_map.insert(&caller, &count); Self { my_map } } // 호출자의 AccountId에 연결된 숫자를 가져옵니다 (존재하는 경우) #[ink(message)] pub fn get(&self) -> u32 { let caller = Self::env().caller(); self.my_map.get(&caller).unwrap_or_default() } } } ``` #### 계약 호출자 식별 앞의 예제에서 `Self::env().caller()` 함수 호출을 볼 수 있습니다. 이 함수는 계약 로직 전체에서 사용할 수 있으며 항상 **계약 호출자**를 반환합니다. 계약 호출자는 **원래 호출자**와 다릅니다. 사용자가 계약에 접근하여 다른 계약을 호출하는 경우, 두 번째 계약의 `Self::env().caller()`는 첫 번째 계약의 주소가 됩니다. #### 계약 호출자 사용 계약 호출자를 사용할 수 있는 많은 시나리오가 있습니다. 예를 들어, `Self::env().caller()`를 사용하여 사용자가 자신의 값에만 액세스할 수 있는 액세스 제어 계층을 만들 수 있습니다. 또한 `Self::env().caller()`를 사용하여 계약 배포 중에 계약 소유자를 저장할 수 있습니다. 예를 들어: ```rust #![cfg_attr(not(feature = "std"), no_std)] #[ink::contract] mod my_contract { #[ink(storage)] pub struct MyContract { // 계약 소유자를 저장합니다 owner: AccountId, } impl MyContract { #[ink(constructor)] pub fn new() -> Self { Self { owner: Self::env().caller(), } } /* --snip-- */ } } ``` `owner` 식별자를 사용하여 계약 호출자를 저장했으므로 나중에 현재 계약 호출자가 계약의 소유자인지 확인하는 함수를 작성할 수 있습니다. ### 스마트 컨트랙트에 맵 추가 이제 `incrementer` 계약에 저장 맵을 추가할 준비가 되었습니다. `incrementer` 계약에 저장 맵을 추가하려면 다음 단계를 수행하세요: 1. 필요한 경우 컴퓨터에서 터미널 셸을 엽니다. 2. `incrementer` 프로젝트 폴더에 있는지 확인하세요. 3. 텍스트 편집기에서 `lib.rs` 파일을 엽니다. 4. `Mapping` 타입을 가져옵니다. ```rust #[ink::contract mod incrementer { use ink::storage::Mapping; ``` 5. `AccountId`에서 `i32` 데이터 타입으로 저장되는 `my_map`에 매핑 키를 추가합니다. ```rust pub struct Incrementer { value: i32, my_map: Mapping, } ``` 6. `new` 생성자에서 새로운 `Mapping`을 생성하고 이를 계약에 초기화합니다. ```rust #[ink(constructor)] pub fn new(init_value: i32) -> Self { let mut my_map = Mapping::default(); let caller = Self::env().caller(); my_map.insert(&caller, &0); Self { value: init_value, my_map, } } ``` 7. `default` 생성자에 기존의 기본 `value`와 함께 새로운 기본 `Mapping`을 추가합니다. ```rust #[ink(constructor)] pub fn default() -> Self { Self { value: 0, my_map: Mapping::default(), } } ``` 8. `Mapping` API의 `get()` 메서드를 사용하여 `my_map`을 읽고 `my_map`을 계약 호출자에 대해 반환하는 `get_mine()` 함수를 추가합니다. ```rust #[ink(message)] pub fn get_mine(&self) -> i32 { let caller = self.env().caller(); self.my_map.get(&caller).unwrap_or_default() } ``` 9. 초기 계정을 확인하는 새로운 테스트를 추가합니다. ```rust #[ink::test] fn my_map_works() { let contract = Incrementer::new(11); assert_eq!(contract.get(), 11); assert_eq!(contract.get_mine(), 0); } ``` 10. 변경 사항을 저장하고 파일을 닫습니다. 11. 다음 명령을 실행하여 `test` 하위 명령과 `nightly` 도구 체인을 사용하여 작업을 테스트합니다. ```bash cargo test ``` 명령은 다음과 유사한 출력을 표시하여 테스트가 성공적으로 완료되었음을 나타냅니다. ``` running 3 tests test incrementer::tests::default_works ... ok test incrementer::tests::it_works ... ok test incrementer::tests::my_map_works ... ok test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s ``` ### 값 삽입, 업데이트 또는 제거 `Incrementer` 계약의 마지막 단계는 사용자가 자신의 값을 업데이트할 수 있도록 하는 것입니다. 스마트 컨트랙트에서 이 기능을 제공하기 위해 Mapping API를 호출할 수 있습니다. `Mapping`은 저장 항목에 직접 액세스할 수 있습니다. 예를 들어, `Mapping::insert()`를 호출하여 기존 키에 대한 이전 값이 저장 항목에서 대체될 수 있습니다. 또한 `Mapping::get()`을 사용하여 저장소에서 값을 읽은 다음 `Mapping::insert()`로 값을 업데이트할 수 있습니다. 주어진 키에 기존 값이 없는 경우 `Mapping::get()`은 `None`을 반환합니다. Mapping API는 저장소에 직접 액세스할 수 있으므로 `Mapping::remove()` 메서드를 사용하여 주어진 키의 값을 저장소에서 제거할 수 있습니다. 계약에 삽입 및 제거 기능을 추가하려면 다음 단계를 수행하세요: 1. 필요한 경우 컴퓨터에서 터미널 셸을 엽니다. 2. `incrementer` 프로젝트 폴더에 있는지 확인하세요. 3. 텍스트 편집기에서 `lib.rs` 파일을 엽니다. 4. `inc_mine()` 함수를 추가합니다. 이 함수는 계약 호출자가 `my_map` 저장 항목을 가져오고 증가된 `value`를 매핑에 삽입합니다. ```rust #[ink(message)] pub fn inc_mine(&mut self, by: i32) { let caller = self.env().caller(); let my_value = self.get_mine(); self.my_map.insert(caller, &(my_value + by)); } ``` 5. `remove_mine()` 함수를 추가합니다. 이 함수는 계약 호출자가 `my_map` 저장 항목을 저장소에서 제거할 수 있도록 합니다. ```rust #[ink(message)] pub fn remove_mine(&self) { let caller = self.env().caller(); self.my_map.remove(&caller) } ``` 6. `inc_mine()` 함수가 예상대로 작동하는지 확인하는 새로운 테스트를 추가합니다. ```rust #[ink::test] fn inc_mine_works() { let mut contract = Incrementer::new(11); assert_eq!(contract.get_mine(), 0); contract.inc_mine(5); assert_eq!(contract.get_mine(), 5); contract.inc_mine(5); assert_eq!(contract.get_mine(), 10); } ``` 7. `remove_mine()` 함수가 예상대로 작동하는지 확인하는 새로운 테스트를 추가합니다. ```rust #[ink::test] fn remove_mine_works() { let mut contract = Incrementer::new(11); assert_eq!(contract.get_mine(), 0); contract.inc_mine(5); assert_eq!(contract.get_mine(), 5); contract.remove_mine(); assert_eq!(contract.get_mine(), 0); } ``` 8. `test` 하위 명령을 사용하여 작업을 확인합니다. ```bash cargo test ``` 명령은 다음과 유사한 출력을 표시하여 테스트가 성공적으로 완료되었음을 나타냅니다. ``` running 5 tests test incrementer::tests::default_works ... ok test incrementer::tests::it_works ... ok test incrementer::tests::remove_mine_works ... ok test incrementer::tests::inc_mine_works ... ok test incrementer::tests::my_map_works ... ok test result: ok. 5 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s ``` ### 다음 단계로 넘어가기 이 튜토리얼에서는 `ink::storage::Mapping` 타입과 Mapping API를 스마트 컨트랙트에서 사용하는 방법을 배웠습니다. 예를 들어, 이 튜토리얼에서는 다음과 같은 내용을 설명했습니다: * 키-값 쌍을 저장하기 위해 매핑을 초기화하는 방법. * 스마트 컨트랙트에서 계약 호출자를 식별하고 사용하는 방법. * 스마트 컨트랙트를 사용하여 사용자가 맵에 저장된 값을 삽입하고 제거하는 함수를 추가하는 방법. 이 튜토리얼의 최종 코드 예제는 [smart-contracts](https://github.com/substrate-developer-hub/substrate-docs/blob/main/static/assets/tutorials/smart-contracts/incrementer-mapping.rs)의 자산에서 찾을 수 있습니다. 다음 주제에서 스마트 컨트랙트 개발에 대해 더 자세히 알아볼 수 있습니다: * [ERC20 토큰 계약 빌드](/infrablockchain-docs/ko/infrablockchain/learn/substrate/tutorials/smart-contracts/build-a-token-contract.md) * [스마트 컨트랙트 문제 해결](/infrablockchain-docs/ko/infrablockchain/learn/substrate/tutorials/smart-contracts/troubleshoot-smart-contracts.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.infrablockchain.net/infrablockchain-docs/ko/infrablockchain/learn/substrate/tutorials/smart-contracts/use-maps-for-storing-values.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.