الوثائق
docs.canton.network: المفاهيم والأدلة وQuickstart ومرجع الواجهات البرمجية.
افتحإن كنت تبدأ من الصفر فاتبع الخطوات بالترتيب؛ وإن كانت لديك خبرة فانتقل مباشرة إلى ما تحتاجه. كل الروابط تؤدي إلى موارد Canton الرسمية. وإن واجهت صعوبة فاسأل مساعد HackTrail.
كل ما تحتاجه موجود في هذه العناوين الرسمية الثلاثة. وتأخذك الأقسام الأخرى مباشرة إلى الصفحة المناسبة.
docs.canton.network: المفاهيم والأدلة وQuickstart ومرجع الواجهات البرمجية.
افتحdev-hub.canton.foundation: الأدوات وحزم SDK والواجهات البرمجية، ومساعد ذكاء اصطناعي يجيب استنادًا إلى الوثائق.
افتحforum.canton.network: أسئلة ونقاشات. ربما أُجيب عن سؤالك من قبل.
افتحنموذج الخصوصية، والأطراف (parties)، ومن يرى ماذا. هذا ما يميّز Canton عن سلاسل الكتل الأخرى.
جديد على سلاسل الكتل أم قادم من إيثيريوم؟ توصي الوثائق الرسمية بالمسار المناسب لك.
ثبّت Daml SDK بأمر واحد، ثم أنشئ مشروعك الأول واختبره.
شغّل على جهازك تطبيقًا كاملًا يضم نموذج Daml وواجهة خلفية وواجهة أمامية.
استخدم قائمة التحقق قبل التسليم: ملف README، فيديو العرض، وشرح «من يرى ماذا».
اتبعها بالترتيب. لكتابة Daml فقط تكفي الخطوتان الأوليان؛ ولبناء تطبيق كامل ثبّت Quickstart أيضًا.
لكتابة Daml واختباره فقط يكفي جهاز عادي. ولتشغيل LocalNet كاملة باستخدام Quickstart ننصح بالمواصفات التالية.
| Daml فقط (dpm) | Quickstart وLocalNet | |
|---|---|---|
| الذاكرة (RAM) | 8 GB | 16 GB أو أكثر |
| المعالج | نواتان | 4 أنوية |
| مساحة القرص المتاحة | 5 GB | 50 GB |
| نظام التشغيل | macOS, Linux, Windows | macOS و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.
dpm هي أداة سطر الأوامر الرسمية لتطوير Canton: تثبيت SDK، وإنشاء المشاريع، والبناء، والاختبار، والبيئة المحلية. وهي تحلّ محل أوامر daml القديمة.
$ 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
يشغّل CN Quickstart على Docker تطبيقًا تجريبيًا كاملًا يضم نموذج Daml وواجهة خلفية بلغة Java وواجهة أمامية بـ React ومدفوعات Canton Coin. افتح Docker Desktop أولًا ثم شغّل docker login.
$ 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.
يمكنك البناء والتسليم على LocalNet في جهازك، وهذا كافٍ للتحكيم. DevNet اختيارية.
منتجات الرعاة الرئيسيين ووثائقهم ومقاطع التدريب في هذا القسم.
يربط Loop SDK تطبيقك اللامركزي بمحفظة Loop. يوقّع المستخدمون المعاملات في Loop Wallet على الهاتف أو المتصفح، وتتم كل التفاعلات داخل تطبيقك.
// 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
Seaport منصة سحابية لكتابة عقود Daml وبنائها ونشرها وإدارتها. تعمل من المتصفح دون تثبيت أي شيء؛ وهي بديل مستضاف لإعداد LocalNet.
اخترنا من دليل أدوات Developer Hub التابع لـ Canton Foundation أكثر الأدوات فائدة للهاكاثون. الأوصاف ملخّصات قصيرة؛ والتفاصيل في صفحة كل أداة. راجع بنفسك أدوات المجتمع والشركاء قبل استخدامها.
تُحمَّل الفيديوهات من YouTube عند النقر عليها. وهي باللغة الإنجليزية.
مكوّنات Daml قابلة لإعادة الاستخدام: صلاحيات مؤقتة وقابلة للإلغاء وعقود قابلة للإيقاف المؤقت.
افتحالتحقق من الهوية وإدارة الشهادات بالعقود الذكية.
افتحأداة من Canton Foundation لتشغيل مشروعك على LocalNet ببضعة أوامر.
افتحسطر أوامر وواجهة ويب محلية لإدارة LocalNet: إدارة حزم DAR، وفحص الدفتر، واللقطات.
افتحDaml Package Manager: أداة سطر الأوامر الرسمية لتثبيت Daml SDK وإدارة الإصدارات وبناء المشاريع واختبارها.
افتححزمة بداية تضم بيئة Canton محلية، وخطافات React، ومكوّنات واجهة جاهزة، ودعم المحافظ، وتطبيقًا تجريبيًا.
افتحCanton محليًا على Windows وLinux دون Docker: بيئة تجريبية وLocalNet ومنصة عمل تعرض عقودك.
افتحأداة سطر أوامر لرفع حزم Daml إلى عقدة تدقيق، وإنشاء الأطراف، وتشغيل السكربتات.
افتححزمة SDK للمتصفح خاصة بالتطبيقات اللامركزية، وحزمة SDK للتكامل خاصة بمزوّدي المحافظ.
افتحشبكة تربط المحافظ المتوافقة مع Canton بالتطبيقات اللامركزية.
افتحتربط كل محافظ CIP-0103 بتطبيقك عبر طبقة ربط واحدة؛ مع حزم لـ React وVue وReact Native.
افتحمستكشف Canton وبيانات الشبكة، مجانًا وللعامة.
افتحمستكشف يعرض نشاط شبكة Canton مباشرة.
افتحواجهة بيانات برمجية للمعاملات والأرصدة ومؤشرات الشبكة لتطبيقات Canton.
افتحأداة تحليل ثابت تفحص عقود Daml بحثًا عن أنماط غير آمنة.
افتح على GitHubدليل يركّز على Canton لأمان تطوير Daml وتطبيقات الويب والتشغيل.
افتحإضافة لـ dpm تعرض المعاملات بصريًا وتوضّح سبب فشل التسليم.
افتح على GitHubيربط وثائق Canton الرسمية بمساعدك الذكي. العنوان: docs.canton.network/mcp. لا يحتاج إلى مصادقة.
التثبيتدليل أدوات Canton Foundation ومساعد ذكاء اصطناعي يجيب استنادًا إلى الوثائق.
افتحClaude Skill الرسمي من Canton Foundation: يمنح مساعدك معرفة حديثة ودقيقة بعقود Daml على Canton.
افتح على GitHubقاعدة معرفة عن Canton مهيّأة للذكاء الاصطناعي تغطي CIPs والمنتدى وGitHub والوثائق والفيديوهات؛ ولها خادم MCP أيضًا.
افتحتكامل MCP مجتمعي يزوّد مساعدك بمعرفة البناء على Canton.
افتح على GitHubاختبر دائمًا الشيفرة التي يولّدها الذكاء الاصطناعي. وإن استخدمته فاذكر ذلك في نموذج التسليم.
راجع هذه القائمة قبل التسليم. لا يثبّت المحكّمون مشروعك بأنفسهم؛ بل يشاهدون الفيديو ويطّلعون على المستودع وملف README. ويتحقّق المنظّم في الفحص الأولي من أن المشروع يعمل.
daml.yaml وقوالب Daml حقيقية: الموقّعون والمراقبون والخيارات مضبوطة بشكل صحيح.dpm build يبني الحزمة، و dpm test تنجح فيه الاختبارات.معاملات Daml الخاصة لا تظهر في المستكشف؛ وهذا ليس خطأً بل نموذج الخصوصية في Canton. يعرض المستكشف فقط معاملات Canton Coin والشبكة.
السبب في الغالب نقص الذاكرة. ارفع ذاكرة Docker Desktop إلى 16 GB، وشغّل make clean-all، وفي make setupعطّل Observability.
تأكّد من أنك تشغّل الأوامر داخل مجلد cn-quickstart/quickstart.
توجد مشكلة معروفة في Docker Desktop 4.38.0. حدّث Docker Desktop إلى أحدث إصدار.
make install-daml-sdk يعيد تنزيل SDK. قد يستغرق التنزيل الأول بضع دقائق.
يحدث هذا غالبًا على شبكات الشركات أو خلف وسيط (proxy). جرّب على شبكة شخصية إن أمكن.
قد يواجه Safari مشكلات مع هذه العناوين المحلية؛ استخدم Chrome أو Firefox.
الإصدار المستخدم على DevNet. استخدم dpm version --all لرؤية الإصدارات المثبّتة، وتحقّق من إصدار DevNet في جدول التوافق.
هذا طبيعي. معاملات التطبيقات على Canton خاصة ولا يراها إلا الأطراف المعنية. يعرض المستكشف فقط معاملات Canton Coin والشبكة.
لا. يغطي docs.daml.com الإصدار القديم 2.x. استخدم لـ Canton Network الوثائق الحالية على docs.canton.network.
DevNet اختيارية؛ ويمكنك التسليم على LocalNet أيضًا. ولـ DevNet اتبع خطوات الدليل الرسمي؛ وإن واجهت مشكلات فراسلنا عبر «الإبلاغ عن مشكلة» في لوحتك.
يدعم صندوق تطوير البروتوكول (Protocol Development Fund) التابع لـ Canton Foundation الأعمال التي تضيف قيمة طويلة الأمد للشبكة كلها. ويمكن لمشاريع HackTrail القوية التقدّم إلى هذا البرنامج.