Canton 노드 가이드
Canton은 Digital Asset의 Canton Network(Daml 기반 프라이버시 블록체인 프로토콜) 노드를 의미합니다.
퍼미션드 네트워크이며, 일반 블록체인 Full Node와 역할이 다릅니다.
개발/테스트용 LocalNet 또는 스폰서 초대제 Validator Node를 설치할 수 있습니다.
참고: Cosmos 기반 Canto Network를 찾으신다면 Canto 등 별도 자료를 참고하세요. 본 가이드는 Digital Asset Canton만 다룹니다.
공식 문서: Digital Asset Docs · Canton Network Quickstart Installation · Canton Installation (Daml).
노드 종류
| 종류 | 대상 | 용도 |
|---|---|---|
| LocalNet | 개발자 | 로컬 개발/테스트. cn-quickstart로 로컬 Validator + Synchronizer 실행. Docker·Nix 기반. |
| Validator Node | 스폰서 초대 | DevNet/TestNet/MainNet 접속. Super Validator(SV) 스폰서 필요. VPN·고정 IP 등 요구. |
| Participant / Domain | 구성 요소 | Canton 구성요소. participant.conf·domain.conf(Embedded Sync Domain) 등으로 실행. |
일반 개발자는 LocalNet(cn-quickstart)부터 시작하세요. Validator는 GSF SV 노드 목록에서 스폰서를 문의해야 합니다.
전제 조건 (LocalNet)
- Docker Desktop (권장 메모리 8GB 이상)
- Nix 2.20+ (2.25 등)
- Curl, Direnv, Git
- Windows: WSL 2 (관리자 권한 설치 권장)
설치 방법
LocalNet (개발용, 권장)
cn-quickstart 저장소로 로컬 Canton 네트워크를 띄웁니다.
git clone https://github.com/digital-asset/cn-quickstart.git && cd cn-quickstartcd quickstart→make install-daml-sdk→make setup(Observability/OAuth2/party hint/TEST MODE 선택)make build→ (별도 터미널)make capture-logs→make start- (선택)
make canton-console,make shell(Daml Shell)
시작하기: localhost/README.md
Canton 설치 (Participant/Domain)
공식 Canton 바이너리·설정으로 Participant 또는 Embedded Sync Domain 실행.
Canton Installation: ./bin/canton -c config/participant.conf / ./bin/canton -c config/domain.conf.
Validator (스폰서 필요)
DevNet/TestNet/MainNet에 연결하려면 Super Validator(SV) 스폰서가 필요합니다.
Validator onboarding, GSF SV Nodes. VPN·고정 IP 등 요구사항은 공식 문서를 확인하세요.
폴더 구조
canton/
├── README.md # 이 파일
├── localhost/ # LocalNet·Canton 설치 가이드
│ ├── README.md
│ ├── installation.md # cn-quickstart·Participant/Domain·Validator 참고
│ ├── configuration.md # setup·config 참고
│ ├── troubleshooting.md
│ └── updates/
│ └── README.md
└── docker/ # Docker·배포 참고
└── README.md
주의사항
- Daml 스마트 컨트랙트와 연동. Canton은 Daml 기반입니다.
- Community Edition: Embedded Domain만 지원(HA 미지원). Production·HA는 Enterprise 라이선스 문의.
- cn-quickstart 아티팩트 접근: Digital Asset/jFrog 접근이 필요할 수 있습니다.
- Production: TLS 인증서·Postgres·고사양 클러스터(Kubernetes 권장). Install tutorials.