환경 구성
Setting Up the Development Environment
💡 핵심 용어 미리보기
- Sui CLI: Move 패키지 빌드, 테스트, 배포를 담당하는 기본 명령줄 도구
- VS Code Extension: GUI 기반 Move 개발 및 PTB 실행 도구
- Workspace: VS Code Extension에서 관리하는 프로젝트 단위
- Explorer 뷰: VS Code에서 프로젝트 탐색 및 생성 메뉴 제공
1. Sui CLI 설치
macOS / Linux / WSL
bash
brew install suiWindows
powershell
choco install sui설치 확인:
bash
sui --version⚠️ Sui CLI는 Move 코드의 빌드와 실행에 반드시 필요합니다. CLI를 먼저 설치해야 이후 단계가 정상적으로 동작합니다.
2. VS Code - Sui Extension 설치
Sui Extension은 VS Code에서 Move 스마트 컨트랙트를 컴파일, 배포, 테스트하고, Programmable Transaction Blocks를 시각적으로 구성하고 실행할 수 있는 확장 도구입니다.
주요 기능
- 컴파일 및 배포
- 업그레이드 지원 (
upgrade.toml) - 오브젝트 탐색기 / 패키지 탐색기
- PTB Builder 내장 (드래그 앤 드롭 지원)
설치 방법
- VS Code 열기 → Extensions (⇧⌘X / Ctrl+Shift+X)
Sui Extension검색 후 설치
- 설치 후 VS Code 재시작
⚠️ 필수 조건: Sui CLI가 먼저 설치되어 있어야 합니다.
3. Login - zkLogin
네트워크를 선택한 뒤, Google Login (zkLogin) 을 통해 지갑에 로그인할 수 있습니다.
💡 PKCE (Proof Key for Code Exchange) 방식을 사용하여
외부 웹사이트로부터 JWT를 안전하게 중계받습니다.

4. Sui Extension 인터페이스
VS Code 왼쪽의 Activity Bar에서 Sui Extension 아이콘을 클릭하면, 기존 탐색기 영역(Primary Side Bar)이 Sui Extension 전용 인터페이스로 전환됩니다.
- Workspace: 새 Move 프로젝트 생성, 빌드, 테스트, 배포
- Owned Objects Explorer: 특정 Account가 소유한 오브젝트의 상태 확인
- Object Explorer: 특정 오브젝트의 상태 조회
- Package Explorer: 배포된 패키지를 로드해, 모듈별 실행 가능한 함수 목록을 표시하고 직접 실행 가능

5. Sui Extension의 Workspace 개념
Sui Extension은 각 Move 프로젝트를 Workspace로 관리합니다. Workspace는 Move 패키지, 설정 파일(Move.toml), 빌드 결과를 하나의 단위로 묶습니다.
| 구성 요소 | 설명 |
|---|---|
Move.toml | 패키지 이름, 의존성, 주소 정의 |
sources/ | Move 모듈(.move) 파일 폴더 |
build/ | 컴파일된 결과물 저장 경로 |
💡 한 Workspace 안에 여러 패키지를 구성할 수 있으며, Extension에서 손쉽게 전환 가능합니다.
💡 다음 장에서는 Sui CLI와 Extension을 함께 사용해 Move 프로젝트를 직접 빌드하고 테스트하는 방법을 배웁니다.