Skip to main content
Version: v1

Toolchain 설치

이 가이드에서는 Midnight DApp 개발에 필요한 핵심 의존성을 설치합니다.

Prerequisites​

시작하기 전에 다음을 준비하세요:

note

Lace Midnight Wallet은 현재 베타입니다. Midnight wallet을 사용하려면 먼저 Cardano wallet을 생성하고, 설정에서 베타 기능을 활성화한 뒤 새 wallet을 추가하면서 Midnight 네트워크를 선택하세요.

개발은 Linux와 Mac에서 지원되며, 현재 Windows는 지원되지 않습니다.

Install Compact​

Compact는 애플리케이션의 데이터 보호 수준을 개발자가 직접 제어하도록 설계된 Midnight 전용 smart contract 언어입니다.

사전 빌드된 바이너리를 설치하세요:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh

Update your shell PATH​

설치 스크립트가 Compact를 셸 PATH에 자동으로 추가합니다. 단, 변경 사항을 적용하려면 터미널을 재시작하거나 셸 설정을 다시 로드해야 합니다.

터미널을 재시작하지 않고 셸 설정을 다시 로드하려면 다음을 실행하세요:

source ~/.zshrc # zsh의 경우
# 또는
source ~/.bashrc # bash의 경우

수동 PATH 구성 (필요한 경우에만): 재시작 후에도 Compact를 찾을 수 없으면 수동으로 PATH에 추가하세요:

export PATH="$HOME/.compact/bin:$PATH"

그런 다음 위와 같이 셸 설정을 다시 로드하세요.

Update the compiler version​

최신 컴파일러로 업데이트하세요:

compact update

최신 버전의 Compact 컴파일러를 다운로드하고 기본 버전으로 설정합니다.

Verify the Compact installation​

설치가 정상적으로 되었는지 확인하세요:

compact --version # Compact 버전 출력
compact compile --version # 컴파일러 버전 출력
which compact     # 설치 경로 출력

확인: 각 명령어가 Compact 버전 번호, 컴파일러 버전 번호, 설치 경로를 출력하면 정상입니다.

Set up the proof server​

Proof server는 transaction에 대한 zero-knowledge proof를 로컬에서 생성합니다. 아래 절차에 따라 proof server를 실행하세요.

Docker Desktop​

Proof server는 Docker 기반 백그라운드 서비스로 실행됩니다. 다음 단계를 진행하기 전에 Docker 엔진이 실행 중인지 확인하세요.

Run the proof server​

터미널에서 proof server를 시작하세요:

docker run -p 6300:6300 midnightntwrk/proof-server:latest midnight-proof-server -v

이 명령어는 실행 중인 동안 터미널을 점유합니다.

확인: http://localhost:6300에서 수신 대기 중이라는 로그가 터미널에 표시되면 정상입니다.

note

로컬 proof server를 Lace Midnight wallet과 함께 사용하려면, Settings » Midnight으로 이동하여 Local (http://localhost:6300)을 선택하세요.

Install the Compact VS Code extension​

Compact VS Code 확장 프로그램은 구문 강조와 코드 스니펫 자동 완성을 지원합니다. 다음 단계에 따라 설치하세요:

1
VSIX 패키지를 다운로드하세요.
2
VS Code에서 Extensions로 이동한 다음 Install from VSIX를 선택하고 확장 프로그램 파일을 선택하세요.

확인: VS Code의 설치된 확장 프로그램 목록에 Compact Language Support가 나타나면 정상입니다.

Install Complete​

개발 환경 구성이 완료되었습니다. 이제 Midnight에서 프라이버시 기반 애플리케이션을 빌드할 준비가 되었습니다.

Midnight DApp을 배포하고 사용하려면 Midnight Node와 Indexer가 모두 필요합니다. 이들은 RPC endpoint로 제공되며 최신 안정 릴리스에서 확인할 수 있습니다. 이후 튜토리얼에서 사용법을 다루며, 예제 섹션에서 전체 DApp 데모를 확인할 수 있습니다.

Troubleshoot​

설치 중 발생할 수 있는 일반적인 문제와 해결 방법입니다.

Compact binary not found​

다음 오류가 표시되는 경우:

compact: command not found

Compact 바이너리가 PATH에 등록되지 않은 것입니다. Update your shell PATH 안내에 따라 PATH에 추가하세요.

Docker Desktop not running​

Proof server 시작 시 연결 오류가 발생하면 Docker Desktop이 실행 중인지 확인하세요:

  1. Docker Desktop 애플리케이션을 여세요.
  2. Docker 엔진이 완전히 시작될 때까지 기다리세요 (시스템 트레이의 Docker 아이콘이 안정 상태여야 합니다).
  3. Proof server 명령어를 다시 실행하세요.

Port already in use​

포트 6300이 이미 사용 중이라는 오류가 나타나면:

Error: bind: address already in use

포트 6300을 사용 중인 프로세스를 중지하거나, 다른 포트에서 proof server를 실행하세요:

docker run -p 6301:6300 midnightntwrk/proof-server:latest midnight-proof-server -v

애플리케이션 설정에서 새 포트로 변경하는 것도 잊지 마세요.

Next steps​

개발 환경 설정이 완료되었습니다. 다음 단계로 진행하세요: