Canton Foundation 공식 승인 해커톤스폰서TempleDigital AssetWalletAlpendCashen
일정 보기
HackTrail
개발자 허브

Canton 개발에 필요한 모든 것

처음이라면 각 단계를 순서대로 따라가고, 경험이 있다면 필요한 부분으로 바로 이동하세요. 모든 링크는 Canton 공식 리소스로 연결됩니다. 막히면 HackTrail 어시스턴트에게 물어보세요.

시작하기

세 가지 공식 소스

필요한 모든 것은 이 세 공식 주소에 있습니다. 다른 섹션에서는 해당 페이지로 바로 안내합니다.

문서

docs.canton.network: 개념, 가이드, Quickstart, API 레퍼런스.

열기

Developer Hub

dev-hub.canton.foundation: 도구, SDK, API, 그리고 문서를 바탕으로 답하는 AI 어시스턴트.

열기

Forum

forum.canton.network: 질문과 토론. 내 질문에 이미 답이 있을 수도 있습니다.

열기

다섯 단계로 동작하는 Canton 프로젝트 만들기

  1. Canton 이해하기

    프라이버시 모델, 당사자(party), 누가 무엇을 보는지. 이것이 Canton이 다른 블록체인과 다른 점입니다.

  2. 학습 경로 고르기

    블록체인이 처음인가요, 이더리움에서 오셨나요? 공식 문서가 알맞은 경로를 추천합니다.

  3. dpm 설치

    명령어 하나로 Daml SDK를 설치한 뒤 첫 프로젝트를 만들고 테스트하세요.

  4. Quickstart로 LocalNet 실행

    Daml 모델, 백엔드, 프론트엔드를 갖춘 전체 애플리케이션을 내 컴퓨터에서 실행하세요.

  5. 제출 준비

    제출 전 체크리스트로 README, 데모 영상, ‘누가 무엇을 보는지’ 설명을 준비하세요.

추천 첫 주

막혔을 때

Canton Forum

공식 지원 채널: 기술 질문, 답변, 공지.

열기

HackTrail Telegram

해커톤 관련 질문, 공지, 팀원 찾기.

열기
설치

네 단계로 설치

순서대로 진행하세요. Daml만 작성한다면 처음 두 단계로 충분하고, 전체 애플리케이션을 만들려면 Quickstart도 설치하세요.

1. 컴퓨터가 준비되었나요?

Daml을 작성하고 테스트하는 것만이라면 일반 컴퓨터로 충분합니다. Quickstart로 전체 LocalNet을 실행하려면 아래 사양을 권장합니다.

Daml만 (dpm)Quickstart와 LocalNet
메모리(RAM)8 GB16 GB 이상
프로세서2코어4코어
여유 디스크5 GB50 GB
운영체제macOS, Linux, WindowsmacOS, Linux, Windows의 WSL 2
기타 소프트웨어없음Docker Desktop(Compose 2.27 이상), direnv, Nix, curl

Docker Desktop의 메모리를 최소 8 GB, 가능하면 16 GB로 설정하세요. 메모리 부족은 가장 흔한 설치 문제입니다.

설치가 번거로우신가요? Seaport에서는 브라우저로 Daml 컨트랙트를 작성하고 빌드해 DevNet에 배포할 수 있습니다. Docker 없이 빠르게 시험해 보려면 dpm sandbox만으로 충분하고, Windows와 Linux에서 Docker 없이 전체 로컬 환경이 필요하다면 Raposza Tools를 사용하세요.

2. dpm으로 첫 Daml 프로젝트 만들기

dpm은 Canton 개발을 위한 공식 명령줄 도구입니다. SDK 설치, 프로젝트 생성, 빌드, 테스트, 로컬 환경을 모두 다룹니다. 이전의 daml 명령어를 대체합니다.

macOS와 Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # 영구 적용하려면 셸 설정에 추가하세요
$ dpm install latest
$ dpm version --all

Windows에서는 공식 설치 프로그램을 사용하세요. SDK 버전은 DevNet에서 실행 중인 버전을 선택하세요. 호환성 표는 아래 링크에 있습니다.

첫 프로젝트
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # DAR 패키지 생성
$ dpm test      # Daml Script 테스트 실행
$ dpm sandbox   # 단일 참여자 로컬 원장
$ dpm studio    # VS Code에서 Daml Studio 열기

3. Quickstart로 LocalNet 실행

CN Quickstart는 Daml 모델, Java 백엔드, React 프론트엔드, Canton Coin 결제를 갖춘 전체 예제 앱을 Docker에서 실행합니다. 먼저 Docker Desktop을 열고 다음을 실행하세요: docker login.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # make 명령어는 이 디렉터리에서 실행합니다
$ make setup             # OAuth2는 켜고 Observability는 끄세요
$ make build
$ make start
$ make capture-logs      # 선택 사항, 다른 터미널에서
$ make stop && make clean-all   # 종료

첫 설치는 SDK 다운로드 때문에 30–90분이 걸릴 수 있습니다. 로컬 화면: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. 네트워크 선택: LocalNet이면 충분합니다

내 컴퓨터의 LocalNet에서 개발하고 제출해도 심사에는 충분합니다. DevNet은 선택 사항입니다.

스폰서 도구

스폰서 도구

주요 스폰서의 제품, 문서, 교육 영상은 이 섹션에 있습니다.

Five North

Loop Wallet과 Loop SDK

Loop SDK로 dApp을 Loop 지갑에 연결할 수 있습니다. 사용자는 휴대폰이나 브라우저의 Loop Wallet에서 거래에 서명하고, 모든 상호작용은 dApp 안에서 이루어집니다.

app.js
// npm install @fivenorth/loop-sdk
import { loop } from '@fivenorth/loop-sdk';

loop.init({
  appName: 'HackTrail dApp',
  network: 'devnet',            // 'local' | 'devnet' | 'mainnet'
  onAccept: (provider) => console.log(provider.party_id),
  onReject: () => console.log('rejected'),
});

loop.connect();                     // QR 코드 연결 창 열기
Five North

Seaport

Seaport는 Daml 컨트랙트를 작성, 빌드, 배포, 관리하는 클라우드 플랫폼입니다. 아무것도 설치하지 않고 브라우저에서 작업하며, LocalNet 설치를 대신하는 호스팅 방식입니다.

Canton Coin

도구

생태계 도구

Canton Foundation의 Developer Hub 카탈로그에서 해커톤에 가장 유용한 도구를 골랐습니다. 설명은 짧은 요약이니 자세한 내용은 각 도구의 페이지를 확인하세요. 커뮤니티와 파트너 도구는 사용 전에 직접 검토하세요.

Canton Foundation 교육 영상

영상은 클릭할 때 YouTube에서 불러옵니다. 영어로 진행됩니다.

기성 템플릿과 컨트랙트

OpenZeppelin Canton Contracts

재사용 가능한 Daml 컴포넌트: 기간 제한 및 취소 가능한 권한, 일시 중지 가능한 계약.

열기

Five North ID SDK

스마트 컨트랙트로 신원 확인과 자격 증명을 관리합니다.

열기

로컬 개발

Canton Builder Tool

명령어 몇 개로 프로젝트를 LocalNet에서 실행하는 Canton Foundation 도구.

열기

Canton DevKit

LocalNet 관리를 위한 명령줄과 로컬 웹 UI: DAR 관리, 원장 조회, 스냅샷.

열기

dpm

Daml Package Manager: Daml SDK 설치, 버전 관리, 프로젝트 빌드와 테스트를 위한 공식 명령줄 도구입니다.

열기

Canton dAppBooster

로컬 Canton 환경, React 훅, 기성 UI 컴포넌트, 지갑 지원, 데모 dApp을 담은 스타터 키트.

열기

Raposza Tools

Windows와 Linux에서 Docker 없이 쓰는 로컬 Canton: 샌드박스, LocalNet, 컨트랙트를 보여 주는 작업 화면.

열기

canton-deploy

Daml 패키지를 검증자에 업로드하고, 당사자를 만들고, 스크립트를 실행하는 명령줄 도구.

열기

지갑 연결

dApp SDK와 Wallet SDK

dApp을 위한 브라우저 SDK와 지갑 제공자를 위한 연동 SDK.

열기

WalletConnect

Canton 호환 지갑을 dApp에 연결하는 네트워크.

열기

PartyLayer

하나의 연결 계층으로 모든 CIP-0103 지갑을 dApp에 연결합니다. React, Vue, React Native 패키지 제공.

열기

데이터와 익스플로러

Loop Data

무료로 공개된 Canton 익스플로러와 네트워크 데이터.

열기

CCView Explorer

Canton 네트워크 활동을 실시간으로 보여 주는 익스플로러.

열기

Noves

Canton 앱을 위한 거래, 잔액, 네트워크 지표 데이터 API.

열기

보안, 테스트, 디버깅

daml-lint

Daml 컨트랙트에서 보안상 위험한 패턴을 찾아내는 정적 분석 도구.

GitHub에서 열기

Canton Security 101

Daml 개발, 웹 앱, 운영 보안을 다루는 Canton 중심 가이드.

열기

dpm trace

거래를 시각화하고 제출이 실패한 이유를 보여 주는 dpm 플러그인.

GitHub에서 열기

AI로 Daml 작성하기

Canton 문서 MCP 서버

Canton 공식 문서를 AI 어시스턴트에 연결합니다. 주소: docs.canton.network/mcp. 인증이 필요 없습니다.

설치

Canton Developer Hub

Canton Foundation의 도구 디렉터리와 문서를 바탕으로 답하는 AI 어시스턴트.

열기

Claude Code Daml Skill

Canton Foundation의 공식 Claude Skill: 어시스턴트에게 Canton의 Daml 컨트랙트에 대한 최신의 정확한 지식을 제공합니다.

GitHub에서 열기

CCPedia

CIP, 포럼, GitHub, 문서, 영상을 아우르는 AI용 Canton 지식 베이스. MCP 서버도 있습니다.

열기

Build-on-Canton MCP

어시스턴트에 Canton 개발 지식을 더해 주는 커뮤니티 MCP 통합.

GitHub에서 열기

AI가 생성한 코드는 반드시 테스트하세요. AI를 사용했다면 제출 양식에 적어 주세요.

제출 전

심사위원은 프로젝트의 무엇을 볼까요?

제출 전에 이 목록을 확인하세요. 심사위원은 프로젝트를 직접 설치하지 않고 영상, 레포지토리, README를 봅니다. 프로젝트가 실행되는지는 주최 측이 사전 검토에서 확인합니다.

비공개 Daml 거래는 익스플로러에 나타나지 않습니다. 오류가 아니라 Canton의 프라이버시 모델입니다. 익스플로러에는 Canton Coin과 네트워크 거래만 표시됩니다.

문제 해결

자주 발생하는 문제

설치

컨테이너가 계속 ‘unhealthy’ 상태입니다.

대부분 메모리 부족 때문입니다. Docker Desktop의 메모리를 16 GB로 올리고, make clean-all 명령어를 실행한 뒤, make setup단계에서 Observability를 끄세요.

make 명령어가 동작하지 않습니다.

명령어를 cn-quickstart/quickstart 폴더 안에서 실행하고 있는지 확인하세요.

Docker Desktop 업데이트 후 오류가 납니다.

Docker Desktop 4.38.0에 알려진 문제가 있습니다. Docker Desktop을 최신 버전으로 업데이트하세요.

SDK 다운로드가 중단되었거나 파일이 손상되었습니다.

make install-daml-sdk 명령어로 SDK를 다시 다운로드합니다. 첫 다운로드는 몇 분 걸릴 수 있습니다.

Nix에서 SSL 오류가 납니다.

회사 네트워크나 프록시 뒤에서 자주 발생합니다. 가능하다면 개인 네트워크에서 다시 시도하세요.

로컬 주소가 브라우저에서 열리지 않습니다.

Safari는 이런 로컬 주소에서 문제가 생길 수 있습니다. Chrome이나 Firefox를 사용하세요.

개발

어떤 SDK 버전을 써야 하나요?

DevNet에서 실행 중인 버전입니다. dpm version --all 로 설치된 버전을 확인하고, 호환성 표에서 DevNet 버전과 비교하세요.

내 거래가 익스플로러에 보이지 않습니다.

정상입니다. Canton에서 애플리케이션 거래는 비공개이며 관련 당사자만 볼 수 있습니다. 익스플로러에는 Canton Coin과 네트워크 거래만 표시됩니다.

예전 Daml 2.x 문서를 써도 되나요?

아니요. docs.daml.com은 예전 2.x 버전을 다룹니다. Canton Network에는 docs.canton.network의 최신 문서를 사용하세요.

DevNet에 접속할 수 없습니다.

DevNet은 선택 사항이며 LocalNet으로도 제출할 수 있습니다. DevNet을 쓰려면 공식 가이드의 단계를 따르고, 문제가 생기면 대시보드의 ‘문제 신고’로 알려 주세요.

Grant

HackTrail 이후: Canton Foundation 그랜트

Canton Foundation의 Protocol Development Fund는 네트워크 전체에 장기적인 가치를 더하는 작업을 지원합니다. 우수한 HackTrail 프로젝트는 이 프로그램에 지원할 수 있습니다.

도움이 필요하신가요?
HackTrail 어시스턴트가 신청, 일정, Daml에 관한 질문에 답해 드립니다.