Dokümantasyon
docs.canton.network: kavramlar, rehberler, Quickstart ve API referansları.
Aç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.
Aradığınız her şey bu üç resmi adreste. Diğer bölümler sizi doğrudan doğru sayfaya götürür.
docs.canton.network: kavramlar, rehberler, Quickstart ve API referansları.
Açdev-hub.canton.foundation: araçlar, SDK'lar ve API'ler; dokümanlardan cevap veren yapay zekâ asistanı.
Açforum.canton.network: sorular ve tartışmalar. Sorunuz daha önce cevaplanmış olabilir.
AçGizlilik modeli, taraflar (party) ve kimin neyi gördüğü. Canton'u diğer zincirlerden ayıran şey bu.
Blokzincire yeni misiniz, Ethereum'dan mı geliyorsunuz? Resmi dokümanlar size göre bir yol önerir.
Tek komutla Daml SDK'sını kurun, ilk projenizi oluşturup test edin.
Daml modeli, arka uç ve arayüzden oluşan tam bir uygulamayı kendi bilgisayarınızda ayağa kaldırın.
Teslim öncesi kontrol listesini uygulayın: README, demo videosu ve "kim neyi görür" açıklaması.
Sırayla ilerleyin. Sadece Daml yazmak için ilk iki adım yeterli; tam bir uygulama için Quickstart'ı da kurun.
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 GB | 16 GB ve üzeri |
| İşlemci | 2 çekirdek | 4 çekirdek |
| Boş disk | 5 GB | 50 GB |
| İşletim sistemi | macOS, Linux, Windows | macOS, Linux, Windows'ta WSL 2 |
| Ek yazılım | Yok | Docker 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.
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.
$ 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.
$ 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
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.
$ 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.
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.
Ana sponsorlarımızın ürünleri, dokümanları ve eğitim videoları bu bölümde yer alır.
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.
// 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
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 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.
Videolar tıkladığınızda YouTube'dan yüklenir. İngilizcedir.
Yeniden kullanılabilir Daml bileşenleri: süreli ve geri alınabilir yetkiler ve durdurulabilir sözleşmeler.
AçAkıllı sözleşmelerle kimlik doğrulama ve kimlik bilgisi yönetimi.
AçProjenizi birkaç komutla LocalNet'te çalıştırmak için Canton Foundation aracı.
Aç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ç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ç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çWindows ve Linux'ta Docker'sız yerel Canton: sandbox, LocalNet ve sözleşmeleri gösteren çalışma ekranı.
AçDaml paketlerini bir validatöre yükleme, taraf oluşturma ve script çalıştırma için komut satırı aracı.
AçdApp'ler için tarayıcı SDK'sı ve cüzdan sağlayıcıları için entegrasyon SDK'sı.
AçCanton uyumlu cüzdanları dApp'lere bağlayan ağ.
AçCIP-0103 uyumlu tüm cüzdanları tek bağlantı katmanıyla dApp'e bağlar; React, Vue ve React Native paketleri.
AçCanton ağı için ücretsiz, herkese açık explorer ve ağ verileri.
AçCanton ağ aktivitesini gerçek zamanlı gösteren explorer.
AçCanton uygulamaları için işlem, bakiye ve ağ metrikleri sunan veri API'si.
AçDaml sözleşmelerinde güvenlik açığı kalıplarını tarayan statik analiz aracı.
GitHub'da açDaml geliştirme, web uygulaması ve operasyon güvenliği için Canton odaklı rehber.
Açİşlemleri görselleştiren ve bir gönderimin neden başarısız olduğunu gösteren dpm eklentisi.
GitHub'da açResmi Canton dokümanlarını yapay zekâ asistanınıza bağlar. Adres: docs.canton.network/mcp. Kimlik doğrulama gerekmez.
KurulumCanton Foundation'ın araç kataloğu ve dokümanlardan cevap veren yapay zekâ asistanı.
Aç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çCIP'ler, forum, GitHub, dokümanlar ve videolar üzerinde yapay zekâya açık Canton bilgi tabanı; MCP sunucusu da var.
Aç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.
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.
daml.yaml ve gerçek Daml şablonları var: imzacılar, gözlemciler ve choice'lar doğru kurgulanmış.dpm build paketi oluşturuyor, dpm test testleri geçiyor.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.
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.
Komutları cn-quickstart/quickstart klasörünün içinde çalıştırdığınızdan emin olun.
Docker Desktop 4.38.0 sürümünde bilinen bir hata var. Docker Desktop'ı en son sürüme güncelleyin.
make install-daml-sdk ile SDK'yı yeniden indirin. İlk indirme birkaç dakika sürebilir.
Kurumsal ağlarda ve proxy arkasında görülür. Mümkünse kişisel bir ağda deneyin.
Safari bu yerel adreslerde sorun çıkarabilir; Chrome ya da Firefox kullanın.
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.
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.
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 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.
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.