هاكاثون رسمي معتمد من Canton FoundationالرعاةTempleDigital AssetWalletAlpendCashen
اطّلع على الجدول
HackTrail
مركز المطوّرين

كل ما تحتاجه للبناء على Canton

إن كنت تبدأ من الصفر فاتبع الخطوات بالترتيب؛ وإن كانت لديك خبرة فانتقل مباشرة إلى ما تحتاجه. كل الروابط تؤدي إلى موارد Canton الرسمية. وإن واجهت صعوبة فاسأل مساعد HackTrail.

البداية

ثلاثة مصادر رسمية

كل ما تحتاجه موجود في هذه العناوين الرسمية الثلاثة. وتأخذك الأقسام الأخرى مباشرة إلى الصفحة المناسبة.

الوثائق

docs.canton.network: المفاهيم والأدلة وQuickstart ومرجع الواجهات البرمجية.

افتح

Developer Hub

dev-hub.canton.foundation: الأدوات وحزم SDK والواجهات البرمجية، ومساعد ذكاء اصطناعي يجيب استنادًا إلى الوثائق.

افتح

Forum

forum.canton.network: أسئلة ونقاشات. ربما أُجيب عن سؤالك من قبل.

افتح

مشروع Canton يعمل في خمس خطوات

  1. تعرّف على Canton

    نموذج الخصوصية، والأطراف (parties)، ومن يرى ماذا. هذا ما يميّز Canton عن سلاسل الكتل الأخرى.

  2. اختر مسار التعلّم

    جديد على سلاسل الكتل أم قادم من إيثيريوم؟ توصي الوثائق الرسمية بالمسار المناسب لك.

  3. ثبّت dpm

    ثبّت Daml SDK بأمر واحد، ثم أنشئ مشروعك الأول واختبره.

  4. شغّل LocalNet باستخدام Quickstart

    شغّل على جهازك تطبيقًا كاملًا يضم نموذج Daml وواجهة خلفية وواجهة أمامية.

  5. استعدّ للتسليم

    استخدم قائمة التحقق قبل التسليم: ملف README، فيديو العرض، وشرح «من يرى ماذا».

أسبوعك الأول المقترح

عندما تواجه صعوبة

Canton Forum

قناة الدعم الرسمية: أسئلة تقنية وإجابات وإعلانات.

افتح

HackTrail Telegram

أسئلة الهاكاثون والإعلانات والبحث عن زملاء فريق.

افتح
التثبيت

التثبيت في أربع خطوات

اتبعها بالترتيب. لكتابة Daml فقط تكفي الخطوتان الأوليان؛ ولبناء تطبيق كامل ثبّت Quickstart أيضًا.

1. هل جهازك جاهز؟

لكتابة Daml واختباره فقط يكفي جهاز عادي. ولتشغيل LocalNet كاملة باستخدام Quickstart ننصح بالمواصفات التالية.

Daml فقط (dpm)Quickstart وLocalNet
الذاكرة (RAM)8 GB16 GB أو أكثر
المعالجنواتان4 أنوية
مساحة القرص المتاحة5 GB50 GB
نظام التشغيلmacOS, Linux, WindowsmacOS وLinux وWSL 2 على Windows
برامج أخرىلا شيءDocker Desktop (‏Compose 2.27 أو أحدث)، direnv، ‏Nix، ‏curl

اضبط ذاكرة Docker Desktop على 8 GB على الأقل، ويفضَّل 16 GB. نقص الذاكرة هو أكثر مشكلات التثبيت شيوعًا.

لا تريد التعامل مع التثبيت؟ مع Seaport يمكنك كتابة عقود Daml وبناؤها في المتصفح ونشرها على DevNet. ولتجربة سريعة دون Docker يكفي dpm sandbox؛ ولبيئة محلية كاملة دون Docker على Windows وLinux استخدم Raposza Tools.

2. أول مشروع Daml باستخدام dpm

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    # يفتح Daml Studio في VS Code

3. LocalNet باستخدام Quickstart

يشغّل CN Quickstart على Docker تطبيقًا تجريبيًا كاملًا يضم نموذج Daml وواجهة خلفية بلغة Java وواجهة أمامية بـ React ومدفوعات Canton Coin. افتح 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   # للإيقاف

قد يستغرق التثبيت الأول من 30 إلى 90 دقيقة بسبب تنزيل SDK. الواجهات المحلية: app-provider.localhost:3000 و wallet.localhost:2000 و scan.localhost:4000.

4. اختيار الشبكة: LocalNet تكفي

يمكنك البناء والتسليم على LocalNet في جهازك، وهذا كافٍ للتحكيم. DevNet اختيارية.

أدوات الرعاة

أدوات الرعاة

منتجات الرعاة الرئيسيين ووثائقهم ومقاطع التدريب في هذا القسم.

Five North

Loop Wallet وLoop SDK

يربط Loop SDK تطبيقك اللامركزي بمحفظة Loop. يوقّع المستخدمون المعاملات في Loop Wallet على الهاتف أو المتصفح، وتتم كل التفاعلات داخل تطبيقك.

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

الأدوات

أدوات المنظومة

اخترنا من دليل أدوات Developer Hub التابع لـ Canton Foundation أكثر الأدوات فائدة للهاكاثون. الأوصاف ملخّصات قصيرة؛ والتفاصيل في صفحة كل أداة. راجع بنفسك أدوات المجتمع والشركاء قبل استخدامها.

فيديوهات تدريبية من Canton Foundation

تُحمَّل الفيديوهات من YouTube عند النقر عليها. وهي باللغة الإنجليزية.

قوالب وعقود جاهزة

OpenZeppelin Canton Contracts

مكوّنات Daml قابلة لإعادة الاستخدام: صلاحيات مؤقتة وقابلة للإلغاء وعقود قابلة للإيقاف المؤقت.

افتح

Five North ID SDK

التحقق من الهوية وإدارة الشهادات بالعقود الذكية.

افتح

التطوير المحلي

Canton Builder Tool

أداة من Canton Foundation لتشغيل مشروعك على LocalNet ببضعة أوامر.

افتح

Canton DevKit

سطر أوامر وواجهة ويب محلية لإدارة LocalNet: إدارة حزم DAR، وفحص الدفتر، واللقطات.

افتح

dpm

Daml Package Manager: أداة سطر الأوامر الرسمية لتثبيت Daml SDK وإدارة الإصدارات وبناء المشاريع واختبارها.

افتح

Canton dAppBooster

حزمة بداية تضم بيئة Canton محلية، وخطافات React، ومكوّنات واجهة جاهزة، ودعم المحافظ، وتطبيقًا تجريبيًا.

افتح

Raposza Tools

Canton محليًا على Windows وLinux دون Docker: بيئة تجريبية وLocalNet ومنصة عمل تعرض عقودك.

افتح

canton-deploy

أداة سطر أوامر لرفع حزم Daml إلى عقدة تدقيق، وإنشاء الأطراف، وتشغيل السكربتات.

افتح

ربط المحفظة

dApp SDK وWallet SDK

حزمة SDK للمتصفح خاصة بالتطبيقات اللامركزية، وحزمة SDK للتكامل خاصة بمزوّدي المحافظ.

افتح

WalletConnect

شبكة تربط المحافظ المتوافقة مع Canton بالتطبيقات اللامركزية.

افتح

PartyLayer

تربط كل محافظ CIP-0103 بتطبيقك عبر طبقة ربط واحدة؛ مع حزم لـ React وVue وReact Native.

افتح

البيانات والمستكشفات

Loop Data

مستكشف Canton وبيانات الشبكة، مجانًا وللعامة.

افتح

CCView Explorer

مستكشف يعرض نشاط شبكة Canton مباشرة.

افتح

Noves

واجهة بيانات برمجية للمعاملات والأرصدة ومؤشرات الشبكة لتطبيقات Canton.

افتح

الأمان والاختبار وتصحيح الأخطاء

daml-lint

أداة تحليل ثابت تفحص عقود Daml بحثًا عن أنماط غير آمنة.

افتح على GitHub

Canton Security 101

دليل يركّز على Canton لأمان تطوير Daml وتطبيقات الويب والتشغيل.

افتح

dpm trace

إضافة لـ dpm تعرض المعاملات بصريًا وتوضّح سبب فشل التسليم.

افتح على GitHub

اكتب Daml بالذكاء الاصطناعي

خادم MCP لوثائق Canton

يربط وثائق Canton الرسمية بمساعدك الذكي. العنوان: docs.canton.network/mcp. لا يحتاج إلى مصادقة.

التثبيت

Canton Developer Hub

دليل أدوات Canton Foundation ومساعد ذكاء اصطناعي يجيب استنادًا إلى الوثائق.

افتح

Claude Code Daml Skill

Claude Skill الرسمي من Canton Foundation: يمنح مساعدك معرفة حديثة ودقيقة بعقود Daml على Canton.

افتح على GitHub

CCPedia

قاعدة معرفة عن Canton مهيّأة للذكاء الاصطناعي تغطي CIPs والمنتدى وGitHub والوثائق والفيديوهات؛ ولها خادم MCP أيضًا.

افتح

Build-on-Canton MCP

تكامل MCP مجتمعي يزوّد مساعدك بمعرفة البناء على Canton.

افتح على GitHub

اختبر دائمًا الشيفرة التي يولّدها الذكاء الاصطناعي. وإن استخدمته فاذكر ذلك في نموذج التسليم.

قبل التسليم

ما الذي سينظر إليه المحكّمون في مشروعك؟

راجع هذه القائمة قبل التسليم. لا يثبّت المحكّمون مشروعك بأنفسهم؛ بل يشاهدون الفيديو ويطّلعون على المستودع وملف 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. قد يستغرق التنزيل الأول بضع دقائق.

خطأ SSL في Nix.

يحدث هذا غالبًا على شبكات الشركات أو خلف وسيط (proxy). جرّب على شبكة شخصية إن أمكن.

العناوين المحلية لا تُفتح في المتصفح.

قد يواجه 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

يدعم صندوق تطوير البروتوكول (Protocol Development Fund) التابع لـ Canton Foundation الأعمال التي تضيف قيمة طويلة الأمد للشبكة كلها. ويمكن لمشاريع HackTrail القوية التقدّم إلى هذا البرنامج.

هل تحتاج إلى مساعدة؟
يجيب مساعد HackTrail عن أسئلتك حول التسجيل والجدول وDaml.