Nodes/canton/localhost/installation

canton

Canton LocalNet / Canton 설치 가이드

4분 읽기 · localhost/installation

list목차(13)

Canton LocalNet / Canton 설치 가이드

LocalNet(cn-quickstart)과 Canton Participant/Domain 설치 방법입니다.
출처: Canton Network Quickstart Installation, Canton Installation (Daml).

전제 조건

  • Docker Desktop (권장 메모리 8GB 이상). docker info로 동작 확인.
  • Nix 2.20+ (예: nix --version).
    • macOS: sh <(curl -L https://nixos.org/nix/install)
    • Linux: sh <(curl -L https://nixos.org/nix/install) --daemon
    • Windows: WSL 2에서 동일하게 설치.
  • Curl, Direnv, Git.
  • Docker Hub 로그인: docker login (cn-quickstart 이미지 pull용).
  • (선택) cn-quickstart 아티팩트 접근이 제한될 수 있음. 필요 시 Digital Asset 접근 문의.

LocalNet (cn-quickstart)

로컬에서 Validator + Synchronizer를 띄워 개발·테스트합니다.

1. 클론 및 진입

git clone https://github.com/digital-asset/cn-quickstart.git
cd cn-quickstart
direnv allow   # direnv 사용 시

2. quickstart 하위 디렉터리

이후 모든 make 명령은 quickstart/ 디렉터리에서 실행합니다.

cd quickstart

3. Daml SDK 설치

make install-daml-sdk

(시간이 다소 걸릴 수 있음.)

4. 환경 설정

make setup

프롬프트 예시:

  • Enable Observability? — 메모리 8GB 미만이면 n 권장.
  • Enable OAuth2? — y 권장.
  • Party hint — 기본값 쓰려면 공백.
  • Enable TEST_MODE? — n 권장.

변경이 필요하면 make setup을 다시 실행하면 됩니다.

5. 빌드

make build

6. 실행

  • 터미널 1 (quickstart/): make capture-logs
  • 터미널 2 (quickstart/): make start
  • (선택) 터미널 3: make canton-console
  • (선택) 터미널 4: make shell (Daml Shell)

7. 종료

  • Canton Console: exit
  • Daml Shell: quit
  • quickstart/에서: make stop && make clean-all

개발 세션 끝날 때마다 make clean-all을 해 두면 다음 빌드 시 충돌을 줄일 수 있습니다.

다음 단계

Canton Participant / Domain (공식 설치)

Participant만 또는 Embedded Sync Domain만 실행할 때는 공식 Canton 바이너리와 설정을 사용합니다.

  • Participant: ./bin/canton -c config/participant.conf
  • Embedded Sync Domain: ./bin/canton -c config/domain.conf

바이너리 다운로드·설정 파일 형식: Canton Installation (Daml).

Multi-node 예제(Participant/Domain 분리): canton-multinode-example.

Validator (DevNet/TestNet/MainNet)

  • LocalNet은 로컬 Validator + 로컬 Synchronizer만 구성합니다.
  • DevNet/TestNet/MainNet에 연결하려면 Super Validator(SV) 스폰서가 필요합니다.
  • Validator onboarding
  • GSF list of SV Nodes — 스폰서 문의
  • VPN·고정 IP 등 요구사항은 공식 문서를 확인하세요.

Production·Enterprise

canton 다른 챕터