Canton Foundation onaylı resmi hackathonSponsorlarTempleDigital AssetWalletAlpendCashen
Takvimi inceleyin
HackTrail
Geliştirici Merkezi

Canton'da geliştirmek için ihtiyacınız olan her şey

Sıfırdan başlıyorsanız adımları sırayla izleyin; deneyimliyseniz doğrudan ilgili bölüme geçin. Tüm bağlantılar resmi Canton kaynaklarına gider. Takıldığınız yerde HackTrail Asistanı'na sorun.

Başlangıç

Üç resmi kaynak

Aradığınız her şey bu üç resmi adreste. Diğer bölümler sizi doğrudan doğru sayfaya götürür.

Dokümantasyon

docs.canton.network: kavramlar, rehberler, Quickstart ve API referansları.

Aç

Developer Hub

dev-hub.canton.foundation: araçlar, SDK'lar ve API'ler; dokümanlardan cevap veren yapay zekâ asistanı.

Aç

Forum

forum.canton.network: sorular ve tartışmalar. Sorunuz daha önce cevaplanmış olabilir.

Aç

Beş adımda çalışan bir Canton projesi

  1. Canton'u tanıyın

    Gizlilik modeli, taraflar (party) ve kimin neyi gördüğü. Canton'u diğer zincirlerden ayıran şey bu.

  2. Öğrenme yolunuzu seçin

    Blokzincire yeni misiniz, Ethereum'dan mı geliyorsunuz? Resmi dokümanlar size göre bir yol önerir.

  3. dpm'i kurun

    Tek komutla Daml SDK'sını kurun, ilk projenizi oluşturup test edin.

  4. Quickstart ile LocalNet'i çalıştırın

    Daml modeli, arka uç ve arayüzden oluşan tam bir uygulamayı kendi bilgisayarınızda ayağa kaldırın.

  5. Teslime hazırlanın

    Teslim öncesi kontrol listesini uygulayın: README, demo videosu ve "kim neyi görür" açıklaması.

Önerilen ilk hafta

Takıldığınızda

Canton Forum

Resmi destek kanalı: teknik sorular, cevaplar ve duyurular.

Aç

HackTrail Telegram

Hackathonla ilgili sorular, duyurular ve takım arkadaşı bulma.

Aç
Kurulum

Dört adımda kurulum

Sırayla ilerleyin. Sadece Daml yazmak için ilk iki adım yeterli; tam bir uygulama için Quickstart'ı da kurun.

1. Bilgisayarınız hazır mı?

Sadece Daml yazıp test etmek için sıradan bir bilgisayar yeterli. Quickstart ile tam LocalNet çalıştıracaksanız aşağıdaki değerleri öneriyoruz.

Sadece Daml (dpm)Quickstart ve LocalNet
Bellek (RAM)8 GB16 GB ve üzeri
İşlemci2 çekirdek4 çekirdek
Boş disk5 GB50 GB
İşletim sistemimacOS, Linux, WindowsmacOS, Linux, Windows'ta WSL 2
Ek yazılımYokDocker Desktop (Compose 2.27 ve üzeri), direnv, Nix, curl

Docker Desktop'ta belleği en az 8 GB'a, mümkünse 16 GB'a ayarlayın. Kurulumda en sık sorun yetersiz bellektir.

Kurulumla uğraşmak istemiyor musunuz? Seaport ile Daml sözleşmelerini tarayıcıda yazıp derleyebilir ve DevNet'e yükleyebilirsiniz. Docker'sız hızlı deneme için dpm sandbox yeterlidir; Windows ve Linux'ta Docker'sız tam yerel ortam için Raposza Tools'u kullanabilirsiniz.

2. dpm ile ilk Daml projeniz

dpm, Canton geliştirme için resmi komut satırı aracıdır: SDK kurulumu, proje oluşturma, derleme, test ve yerel ortam. Eski daml komutlarının yerini alır.

macOS ve Linux
$ curl https://get.digitalasset.com/install/install.sh | sh
$ export PATH="$HOME/.dpm/bin:$PATH"   # kalıcı olması için kabuk ayarınıza ekleyin
$ dpm install latest
$ dpm version --all

Windows için resmi kurulum dosyasını kullanın. SDK sürümü olarak DevNet'te çalışan sürümü seçin; uyumluluk tablosu aşağıdaki bağlantıda.

ilk proje
$ dpm new my-project --template daml-intro-contracts
$ cd my-project
$ dpm build     # DAR paketini oluşturur
$ dpm test      # Daml Script testlerini çalıştırır
$ dpm sandbox   # tek katılımcılı yerel ledger
$ dpm studio    # VS Code'da Daml Studio

3. Quickstart ile LocalNet

CN Quickstart; Daml modeli, Java arka uç, React arayüz ve Canton Coin ödemeleri içeren tam bir örnek uygulamayı Docker üzerinde çalıştırır. Önce Docker Desktop'ı açın ve docker login yapın.

cn-quickstart
$ git clone https://github.com/digital-asset/cn-quickstart.git
$ cd cn-quickstart
$ direnv allow
$ cd quickstart          # make komutları bu klasörde çalışır
$ make setup             # OAuth2 açık, Observability kapalı seçin
$ make build
$ make start
$ make capture-logs      # isteğe bağlı, ayrı bir terminalde
$ make stop && make clean-all   # kapatmak için

İlk kurulum SDK indirmesi nedeniyle 30-90 dakika sürebilir. Yerel arayüzler: app-provider.localhost:3000, wallet.localhost:2000, scan.localhost:4000.

4. Ağ seçimi: LocalNet yeterli

Projenizi kendi bilgisayarınızdaki LocalNet'te geliştirip teslim edebilirsiniz; jüri değerlendirmesi için bu yeterlidir. DevNet isteğe bağlıdır.

Sponsor araçları

Sponsorlarımızın araçları

Ana sponsorlarımızın ürünleri, dokümanları ve eğitim videoları bu bölümde yer alır.

Five North

Loop Wallet ve Loop SDK

Loop SDK, dApp'inizin bir Loop cüzdanına bağlanmasını sağlar. Kullanıcı işlemleri mobilde ya da tarayıcıdaki Loop Wallet'ta imzalar; tüm etkileşim dApp'iniz içinde kalır.

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 kodlu bağlantı penceresini açar
Five North

Seaport

Seaport, Daml sözleşmelerini yazmak, derlemek, yayınlamak ve yönetmek için bulut platformudur. Bilgisayarınıza hiçbir şey kurmadan tarayıcıdan çalışırsınız; LocalNet kurulumuna barındırılan bir alternatiftir.

Canton Coin

Araçlar

Ekosistem araçları

Canton Foundation'ın Developer Hub kataloğundan hackathon için en işe yarayanları seçtik. Açıklamalar kısa özetlerdir; ayrıntılar her aracın kendi sayfasındadır. "Topluluk" ve iş ortağı araçlarını kullanmadan önce kendiniz inceleyin.

Canton Foundation eğitim videoları

Videolar tıkladığınızda YouTube'dan yüklenir. İngilizcedir.

Hazır şablonlar ve sözleşmeler

OpenZeppelin Canton Contracts

Yeniden kullanılabilir Daml bileşenleri: süreli ve geri alınabilir yetkiler ve durdurulabilir sözleşmeler.

Aç

Five North ID SDK

Akıllı sözleşmelerle kimlik doğrulama ve kimlik bilgisi yönetimi.

Aç

Yerel geliştirme

Canton Builder Tool

Projenizi birkaç komutla LocalNet'te çalıştırmak için Canton Foundation aracı.

Aç

Canton DevKit

LocalNet'i yönetmek için komut satırı ve yerel web arayüzü: DAR yönetimi, ledger inceleme, anlık görüntüler.

Aç

dpm

Daml Package Manager: Daml SDK'sını kurmak, sürümleri yönetmek, projeleri derlemek ve test etmek için resmi komut satırı aracı.

Aç

Canton dAppBooster

Yerel Canton ortamı, React hook'ları, hazır arayüz bileşenleri, cüzdan desteği ve örnek dApp içeren başlangıç paketi.

Aç

Raposza Tools

Windows ve Linux'ta Docker'sız yerel Canton: sandbox, LocalNet ve sözleşmeleri gösteren çalışma ekranı.

Aç

canton-deploy

Daml paketlerini bir validatöre yükleme, taraf oluşturma ve script çalıştırma için komut satırı aracı.

Aç

Cüzdan bağlantısı

dApp SDK ve Wallet SDK

dApp'ler için tarayıcı SDK'sı ve cüzdan sağlayıcıları için entegrasyon SDK'sı.

Aç

WalletConnect

Canton uyumlu cüzdanları dApp'lere bağlayan ağ.

Aç

PartyLayer

CIP-0103 uyumlu tüm cüzdanları tek bağlantı katmanıyla dApp'e bağlar; React, Vue ve React Native paketleri.

Aç

Veri ve explorer'lar

Loop Data

Canton ağı için ücretsiz, herkese açık explorer ve ağ verileri.

Aç

CCView Explorer

Canton ağ aktivitesini gerçek zamanlı gösteren explorer.

Aç

Noves

Canton uygulamaları için işlem, bakiye ve ağ metrikleri sunan veri API'si.

Aç

Güvenlik, test ve hata ayıklama

daml-lint

Daml sözleşmelerinde güvenlik açığı kalıplarını tarayan statik analiz aracı.

GitHub'da aç

Canton Security 101

Daml geliştirme, web uygulaması ve operasyon güvenliği için Canton odaklı rehber.

Aç

dpm trace

İşlemleri görselleştiren ve bir gönderimin neden başarısız olduğunu gösteren dpm eklentisi.

GitHub'da aç

Yapay zekâ ile Daml yazın

Canton dokümanları MCP sunucusu

Resmi Canton dokümanlarını yapay zekâ asistanınıza bağlar. Adres: docs.canton.network/mcp. Kimlik doğrulama gerekmez.

Kurulum

Canton Developer Hub

Canton Foundation'ın araç kataloğu ve dokümanlardan cevap veren yapay zekâ asistanı.

Aç

Claude Code Daml Skill

Canton Foundation'ın resmi Claude Skill'i: asistanınıza Canton'daki Daml sözleşmeleri hakkında güncel ve doğru bilgi verir.

GitHub'da aç

CCPedia

CIP'ler, forum, GitHub, dokümanlar ve videolar üzerinde yapay zekâya açık Canton bilgi tabanı; MCP sunucusu da var.

Aç

Build-on-Canton MCP

Asistanınıza Canton'da geliştirme bilgisi kazandıran topluluk MCP entegrasyonu.

GitHub'da aç

Yapay zekânın ürettiği kodu her zaman test edin. Kullandıysanız teslim formunda belirtin.

Teslim öncesi

Jüri projenizde neye bakacak?

Göndermeden önce bu listeyi kontrol edin. Jüri projenizi kurmak zorunda değildir; video, repo ve README'ye bakar. Organizatör ön kontrolde projenin çalıştığını doğrular.

Gizli Daml işlemleri explorer'larda görünmez; bu bir hata değil, Canton'un gizlilik modelidir. Explorer'larda yalnızca Canton Coin ve ağ işlemleri görünür.

Sorun giderme

Sık karşılaşılan sorunlar

Kurulum

Container'lar "unhealthy" durumunda kalıyor.

Neredeyse her zaman bellek yetersizliğidir. Docker Desktop'ta belleği 16 GB'a çıkarın, make clean-all çalıştırın ve make setup'ta Observability'yi kapalı seçin.

make komutları çalışmıyor.

Komutları cn-quickstart/quickstart klasörünün içinde çalıştırdığınızdan emin olun.

Docker Desktop güncellemesinden sonra hata alıyorum.

Docker Desktop 4.38.0 sürümünde bilinen bir hata var. Docker Desktop'ı en son sürüme güncelleyin.

SDK indirmesi yarıda kaldı ya da bozuk.

make install-daml-sdk ile SDK'yı yeniden indirin. İlk indirme birkaç dakika sürebilir.

Nix SSL hatası veriyor.

Kurumsal ağlarda ve proxy arkasında görülür. Mümkünse kişisel bir ağda deneyin.

Yerel adresler tarayıcıda açılmıyor.

Safari bu yerel adreslerde sorun çıkarabilir; Chrome ya da Firefox kullanın.

Geliştirme

Hangi SDK sürümünü kullanmalıyım?

DevNet'te çalışan sürümü. dpm version --all ile kurulu sürümleri görün, uyumluluk tablosundan DevNet sürümünü kontrol edin.

İşlemim explorer'da görünmüyor.

Normal. Canton'da uygulama işlemleri gizlidir ve yalnızca taraflar görür. Explorer'larda yalnızca Canton Coin ve ağ işlemleri görünür.

Eski Daml 2.x dokümanlarını kullanabilir miyim?

Hayır. docs.daml.com eski 2.x sürümünü anlatır. Canton Network için docs.canton.network'teki güncel dokümanları kullanın.

DevNet'e erişemiyorum.

DevNet isteğe bağlıdır; LocalNet ile de teslim edebilirsiniz. DevNet için resmi rehberdeki adımları izleyin, sorun yaşarsanız panelden "Sorun bildir" ile yazın.

Grant

HackTrail'den sonra: Canton Foundation grant'i

Canton Foundation'ın Protocol Development Fund'ı tüm ağa uzun vadeli değer katan işleri destekler. Güçlü HackTrail projeleri bu programa başvurabilir.

Yardıma ihtiyacınız var mı?
Başvuru, takvim ya da Daml hakkında sorularınızı HackTrail Asistanı yanıtlar.