# Bytes In, Bytes Out ## 1. 코드 읽어보기 ```rust #![no_main] #![no_std] extern crate alloc; #[global_allocator] static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT; use alloc::vec::Vec; use stylus_sdk::stylus_proc::entrypoint; #[entrypoint] fn user_main(input: Vec) -> Result, Vec> { Ok(input) } ``` ## 2. 코드 분석 ### `#![no_main] 및 #![no_std]` `#![no_main]`: 이 선언은 Rust의 표준 `main` 함수를 사용하지 않음을 선언한다. 대신 직접 정의한 entrypoint를 사용한다. `#![no_std]`: 이 선언은 Rust의 표준 라이브러리(std)를 사용하지 않음을 선언한다. 대신 `alloc` `crate`와 같은 `core` 기능만 사용할 수 있다. ### `[global_allocator]` `wee_alloc::WeeAlloc`을 사용하여 전역 메모리 할당자를 설정한다. `wee_alloc`은 작은 크기의 메모리 할당을 최적화한 할당자이다. ### `use` 문 `alloc::vec::Vec`: 가변 길이 벡터를 사용하기 위해 `alloc` `crate`에서 `Vec`을 import 한다. ### `stylus_sdk::stylus_proc::entrypoint` `stylus_sdk`에서 제공하는 `entrypoint` 매크로를 import 한다. 이 매크로는 스마트 계약의 진입점(entry point)을 정의하는 데 사용된다. ### `#[entrypoint]` 함수 `entrypoint` 매크로에 의해 `user_main` 함수가 진입점으로 정의된다. 함수 시그니처는 `Vec` 타입의 입력을 받고, `Result, Vec>` 타입의 결과를 반환한다. - `Ok(input)`: 입력으로 받은 바이트 벡터를 그대로 반환한다. - `Err(err)`: 에러가 발생했을 때 처리할 수 있는 방법을 제공한다. # 3. Quest ### 아래 한국어로 된 빈칸에 올 내용을 담아서 캡쳐해서 제출하자. ### `Mission1` : Import Alloc Crate , Rust의 동적 메모리 할당을 하기위한 임포트를 해보자. ```rust extern [동적 메모리 생성]; ``` ### `Mission2` : 전역 메모리 할당자 선언해보자. ```rust #[전역할당자 선언] ``` ### `Mission3` : `wee_alloc`을 사용한 전역 메모리 할당 초기화 해보자. - `wee_alloc`을 사용하는 이유 : rust의 기본할당자와 비교 했을 때 wee_alloc은 기능적으로 더 단순하지만 메모리 사용 효율성에 최적화 되있고, 특히 WebAseembly와 같은 제약이 있는 환경에서 스마트 컨트랙트의 컴파일 후에 바이너리 크기를 크게 줄일 수 있기 때문이다. 이는 제약이 많은 스마트 컨트랙트의 환경에서 적합하다. ```rust [전역] ALLOC: wee_alloc::WeeAlloc = [메모리 할당자 초기화]; ``` ### `Mission4` : `use`문을 통해 가변배열 vec와 entrypoint을 임포트 해보자. ```rust use [가변배열 할당]; use [사용자 지정 entrypoint 지정]; ``` ### `Mission5` : `Vec` 을 input으로 받고, 결과로 `, Vec>` 타입을 반환해보자. 성공하면 입력으로 받은 바이트 벡터를 그대로 반환한다. ```rust #[entrypoint] fn user_main([Vec 입력받기]) -> [결과로 타입 반환] { [성공하면 입력으로 받은 바이트 벡터를 그대로 반환]; } ``` ### `Final Mission` : 위의 코드들을 합쳐 메모리를 할당하고, 입력받은 후 반환하는 코드를 작성해보자.(HINT: 위의 코드를 모두 종합한다.) ```rust #![no_main] #![no_std] extern [동적 메모리 생성]; #[전역할당자 선언] [전역] ALLOC: wee_alloc::WeeAlloc = [메모리 할당자 초기화]; use [가변배열 할당]; use [사용자 지정 entrypoint 지정]; #[entrypoint] fn user_main([Vec 입력받기]) -> [결과로 타입 반환] { [성공하면 입력으로 받은 바이트 벡터를 그대로 반환]; } ``` ## 6개의 미션을 모두 끝내면 Quest Clear!