Flow CLI (Dapper Labs)

ما Flow CLI؟

Flow CLI هي واجهة سطر الأوامر الرسمية لتطوير التطبيقات والتفاعل مع بلوكشين Flow.

يرمز CLI إلى واجهة سطر الأوامر، أي أن المطورين يتحكمون في الأداة بإدخال أوامر نصية في الطرفية بدلاً من النقر على الأزرار في تطبيق رسومي.

يمكن لـ Flow CLI تهيئة مشاريع البلوكشين، وتشغيل شبكة Flow محلية، واختبار شيفرة Cadence، ونشر العقود الذكية، وإرسال المعاملات، وتنفيذ السكربتات، وإدارة الحسابات، وإنشاء المفاتيح، وتثبيت تبعيات العقود، واسترجاع بيانات البلوكشين.

توفر الأداة سير عمل تطوير موحداً عبر Flow Emulator المحلي وFlow Testnet وFlow Mainnet.

صُممت الأداة أساساً لمطوري العقود الذكية وفرق التطبيقات اللامركزية ومهندسي البنية التحتية والمختبرين وغيرهم من المستخدمين التقنيين الذين يبنون على Flow.

Flow CLI ليست عملة مشفرة أو محفظة عملات مشفرة أو عقدة بلوكشين أو تطبيقاً استهلاكياً أو منتج تداول.

إنها برنامج للمطورين يتواصل مع عقد الوصول إلى Flow وخدمات التطوير المحلية.

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

ما العلاقة بين Flow CLI وDapper Labs؟

صُممت Flow وطورتها Dapper Labs في الأصل، ولذلك يبحث بعض المستخدمين عن Flow CLI بعبارة «Flow CLI Dapper Labs».

أنشأت Dapper Labs شبكة Flow لدعم تطبيقات بلوكشين قادرة على خدمة جماهير واسعة من المستهلكين من دون أن تضطر كل التطبيقات إلى التنافس على موارد المعالجة المحدودة نفسها.

ويذكر التاريخ الرسمي لـ Flow وCadence أن Dapper Labs هي المصمم والمطور الأصلي للبلوكشين.

تُوزع Flow CLI الآن كبرنامج مفتوح المصدر عبر منظمة Onflow، وهي جزء من منظومة المطورين الأوسع لشبكة Flow.

مستودع الشيفرة المصدرية الرسمي للأداة متاح للعامة بموجب ترخيص Apache 2.0.

لذلك ينبغي فهم Flow CLI على أنها أدوات رسمية لشبكة Flow، لا تطبيق استهلاكي خاص تديره Dapper Labs وحدها.

ما أحدث إصدار من Flow CLI؟

حتى 14 يوليو 2026، أحدث إصدار منشور من Flow CLI هو الإصدار 2.17.4.

صدر الإصدار 2.17.4 في 4 يونيو 2026، وحدّث الأداة إلى إصدار Cadence 1.10.3.

كما حدّث الإصدار مكونات عقود Flow الأساسية المرفقة إلى إصدارات متوافقة مع Cadence 1.10.3.

يمكن للمطورين التحقق من الإصدار الحالي عبر صفحة إصدارات Flow CLI الرسمية.

قد تتغير معلومات الإصدار بوتيرة متكررة، إذ يجب أن تظل واجهة CLI متوافقة مع إصدارات Cadence الجديدة وتحديثات المحاكي والعقود الأساسية وميزات الشبكة والإصلاحات الأمنية.

يمكن للمطور التحقق من الإصدار المثبت محلياً بتشغيل

في الطرفية.

ينبغي لفرق الإنتاج استخدام إصدار مختبَر ومحدد من CLI في أنظمة البناء الآلية، بدلاً من تغيير الإصدارات تلقائياً مع كل عملية نشر.

لماذا تُعد Flow CLI مهمة؟

يتطلب تطوير البلوكشين أكثر من كتابة ملف عقد ذكي.

إذ يجب على المطور أيضاً إنشاء الحسابات وإدارة المفاتيح وحل عناوين العقود وإرسال المعاملات الموقعة وفحص النتائج واختبار حالات الإخفاق ونشر الشيفرة على الشبكة الصحيحة.

تجمع Flow CLI هذه المهام ضمن أداة واحدة متسقة.

وتقلل الحاجة إلى إنشاء طلبات خام يدوياً إلى عقد الوصول إلى Flow لتنفيذ العمليات التطويرية المعتادة.

كما تتيح CLI تكرار الأوامر، ما يفيد الاختبار وسكربتات النشر والتكامل المستمر والتعاون بين أعضاء الفريق.

يمكن مراجعة أمر محفوظ في سكربت نشر وتنفيذه باتساق في عدة بيئات تطوير.

وهذا أكثر أماناً من الاعتماد كلياً على خطوات يدوية غير موثقة تُنفذ عبر واجهة رسومية.

كيفية تثبيت Flow CLI

يمكن تثبيت Flow CLI على macOS وWindows ومعظم أنظمة Linux.

ينبغي للمطورين اتباع تعليمات التثبيت الرسمية لـ Flow CLI، لأن الملفات التنفيذية المتاحة وإصدارات أنظمة التشغيل المدعومة قد تتغير.

من أوامر التثبيت الشائعة على macOS:

.

يمكن عادةً تحديث التثبيت باستخدام Homebrew عبر الأمر

.

تتوفر أيضاً سكربتات التثبيت الرسمية لبيئات Linux وmacOS وWindows المدعومة.

ينبغي للمطور مراجعة سكربت التثبيت قبل تشغيله بصلاحيات مرتفعة على النظام.

قد يؤدي تثبيت برنامج مباشرةً من موقع غير موثّق أو رسالة منسوخة من وسائل التواصل الاجتماعي إلى تعريض الكمبيوتر والمفاتيح الخاصة وملفات المشروع لشيفرات ضارة.

بعد التثبيت، ينبغي للمطور تشغيل

و للتأكد من عمل الملف التنفيذي وإتاحته عبر مسار النظام.

كيفية بدء مشروع Flow

الأمر الرئيسي لإنشاء مشروع Flow هو

.

ينشئ هذا الأمر بنية المشروع وينشئ ملف إعدادات مركزيّاً باسم

.

قد تعرض الإصدارات الحالية من Flow CLI قوالب جاهزة لأنواع مختلفة من التطبيقات، ومنها مشاريع Cadence الأساسية وسير عمل بلوكشين أكثر تخصصاً.

قد يتضمن القالب مجلدات للعقود الذكية والمعاملات والسكربتات والاختبارات وإعدادات المشروع.

يوضح دليل تهيئة المشروع الرسمي كيفية إنشاء الملفات اللازمة لبيئة تطوير جديدة باستخدام

.

ينبغي للمطورين فحص المشروع الذي أُنشئ بدلاً من افتراض ملاءمة كل إعداد افتراضي للإنتاج.

يجب التحقق من عناوين الشبكات وأسماء الحسابات المستعارة والتبعيات وإعدادات الموقّعين وأهداف النشر قبل إرسال المعاملات المباشرة.

ما flow.json؟

هو ملف الإعداد المركزي الذي تستخدمه Flow CLI.

يحدد الشبكات والحسابات والعقود والتبعيات وأهداف النشر ومسارات المشروع التي ينبغي لـ CLI استخدامها.

يوضح المرجع الرسمي لإعدادات flow.json الأقسام والتنسيقات المتاحة.

يحدد قسم

الاتصالات ببيئات مثل المحاكي وشبكة الاختبار والشبكة الرئيسية.

يربط قسم

أسماء الحسابات المقروءة بعناوين Flow وإعدادات مفاتيح التوقيع.

يربط قسم

أسماء عقود Cadence بملفات المصدر والعناوين الخاصة بكل شبكة.

يحدد قسم

العقود المطلوب نشرها على الحسابات ضمن كل شبكة.

يتيح ملف الإعدادات المحفوظ جيداً ربط استيراد Cadence نفسه بعناوين مختلفة على المحاكي وشبكة الاختبار والشبكة الرئيسية.

ويمنع ذلك المطورين من تثبيت عنوان عقد إحدى الشبكات في كل ملف مصدر.

ينبغي للفرق مراجعة التغييرات على

عبر نظام التحكم بالإصدارات، لأن تعديل هدف النشر أو اسم الحساب المستعار قد يرسل المعاملة إلى بيئة غير مقصودة.

هل يخزن flow.json المفاتيح الخاصة؟

تدعم Flow CLI إعدادات تتضمن معلومات المفاتيح الخاصة، لكن وضع مفتاح إنتاج غير مشفر مباشرةً في ملف

مشترك أمر خطير.

يتيح المفتاح الخاص لحامله تفويض معاملات البلوكشين لحساب Flow المرتبط به، وفق وزن المفتاح وإعدادات الحساب.

إذا رُفع ملف الإعدادات إلى مستودع عام، فقد يتمكن المهاجم من السيطرة على العقود والتوكنات والصلاحيات الإدارية.

تشمل خيارات إعداد Flow CLI الحالية المفاتيح السداسية المباشرة وملفات المفاتيح الخارجية والاشتقاق المستند إلى العبارة الأولية والتكامل مع Google Cloud KMS.

قد يقلل استخدام نظام خارجي لإدارة المفاتيح الحاجة إلى كشف مواد التوقيع الخام في ملفات المشروع المحلية.

ينبغي استبعاد ملفات المفاتيح والإعدادات الخاصة بكل بيئة وغيرها من الأسرار من أنظمة التحكم بالإصدارات العامة.

كما ينبغي للمطورين فصل مفاتيح المحاكي عن مفاتيح شبكة الاختبار والشبكة الرئيسية.

مفتاح خدمة المحاكي الافتراضي معروف للعامة، ولا يكون استخدامه آمناً إلا لأن المحاكي شبكة تطوير محلية لا تحتوي على أصول حقيقية.

ما الشبكات التي يمكن لـ Flow CLI استخدامها؟

يمكن لـ Flow CLI التفاعل مع Flow Emulator المحلي وFlow Testnet وFlow Mainnet ونقاط النهاية المخصصة لعقد الوصول إلى Flow.

المحاكي مخصص للتطوير المحلي الخاص.

شبكة الاختبار بيئة عامة تُستخدم لاختبار التطبيقات من دون استخدام أصول Flow الإنتاجية.

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

تقبل أوامر كثيرة الخيار

لتحديد البيئة المستهدفة.

فعلى سبيل المثال، قد يستخدم المطور

أو أو .

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

ينبغي لسكربتات الإنتاج تحديد الشبكة بوضوح، وفرض عمليات تحقق إضافية قبل استخدام موقّعي الشبكة الرئيسية.

ما Flow Emulator؟

Flow Emulator شبكة محلية خفيفة تحاكي جوانب مهمة من سلوك بلوكشين Flow لأغراض التطوير والاختبار.

وهو مرفق مع Flow CLI ويمكن تشغيله باستخدام

.

تصف وثائق Flow Emulator الرسمية المحاكي بأنه بيئة محلية لتنفيذ المعاملات ونشر العقود واختبار التطبيقات قبل استخدام شبكة عامة.

وبما أن المحاكي يعمل محلياً، يستطيع المطورون إعادة ضبط حالته وفحص السجلات التفصيلية واختبار حالات الإخفاق من دون إنفاق عملات مشفرة حقيقية.

يتضمن المحاكي حساب خدمة يمكنه إنشاء الحسابات وتوقيع المعاملات ونشر العقود ضمن البيئة المحلية.

ولا يصلح مفتاحه الخاص للشبكة الرئيسية، لأنه معلن ومتاح للجميع عمداً ويمكن توقعه.

يوفر المحاكي تكافؤاً شبه كامل للميزات مع Flow Access API، لكن ينبغي للمطورين ألا يفترضوا إمكانية محاكاة كل ظروف الإنتاج بدقة على كمبيوتر واحد.

قد يؤدي زمن الاستجابة على الشبكات العامة وسلوك المدققين وازدحام الشبكة والخدمات الخارجية وإعدادات حسابات الإنتاج إلى نتائج مختلفة.

كيف يعمل سير عمل التطوير المحلي؟

يبدأ سير العمل المعتاد باستخدام Flow CLI بإنشاء مشروع عبر

.

ثم يشغّل المطور بلوكشين محلياً باستخدام

.

تُضاف عقود Cadence إلى المشروع وتُربط في

.

ينشر المطور العقود على حسابات المحاكي وينفذ معاملات أو سكربتات اختبارية.

يمكن تشغيل الاختبارات الآلية باستخدام

.

بعد اجتياز الاختبارات المحلية، يمكن نشر المشروع على شبكة الاختبار لتجربته على شبكة عامة مشتركة.

ينبغي ألا يتم النشر على الشبكة الرئيسية إلا بعد مراجعة الشيفرة وإعداد الحسابات وصلاحيات الموقّعين والتبعيات وخطة النشر.

كيف تنشر Flow CLI العقود الذكية؟

يمكن لـ Flow CLI نشر عقود Cadence الذكية على الحسابات المحددة في إعدادات المشروع.

أمر النشر على مستوى المشروع هو

.

توضح وثائق النشر الرسمية أن هذا الأمر يقرأ العقود وأهداف النشر من

.

يمكن للمطور تحديد الشبكة المقصودة عند النشر.

فعلى سبيل المثال، ينشر

عقود المشروع المحددة على البيئة المحلية.

يؤدي تغيير الشبكة إلى testnet أو mainnet إلى استخدام CLI الحسابات والأسماء المستعارة وإعدادات عقد الوصول الخاصة بالشبكة المقابلة.

نشر العقد الذكي معاملة على البلوكشين، ولذلك يتطلب تفويضاً من حساب يملك صلاحيات المفاتيح المناسبة.

قد يفشل النشر بسبب شيفرة Cadence غير صالحة أو تعذر حل عمليات الاستيراد أو عدم كفاية صلاحيات الحساب أو استخدام مفتاح توقيع غير صحيح أو مشكلة في الاتصال بالشبكة.

قد تترتب على النشر على الشبكة الرئيسية عواقب دائمة، لذا ينبغي للمطورين التحقق من مصدر العقد وعنوان الحساب قبل التوقيع.

هل تستطيع Flow CLI تحديث عقد قائم؟

يمكن لـ Flow CLI إرسال معاملات لتحديث العقود المخزنة بالفعل في حساب Flow.

ويجب أن يصرح بالتحديث مفتاح يملك وزناً كافياً في الحساب الذي يملك العقد.

تخضع تحديثات عقود Cadence لقواعد اللغة والشبكة التي تحمي الموارد المخزنة وحالة التطبيق القائمة.

ومع ذلك، قد يؤدي التحديث إلى أخطاء أو تعطيل التطبيقات المعتمدة على العقد أو تغيير السلوك المتوقع، حتى إذا كانت المعاملة صحيحة من الناحية التقنية.

ينبغي للمطورين إجراء اختبارات الترحيل والتحقق من التوافق مع بيانات الحساب القائمة قبل تحديث عقد إنتاج.

تشرح إرشادات Flow الرسمية لنشر العقود إعداد الحساب والنشر والاعتبارات المتعلقة بتحديث العقود.

ما Cadence؟

Cadence لغة برمجة للعقود الذكية صُممت لبلوكشين Flow.

وتستخدم مفاهيم البرمجة القائمة على الموارد لتمثيل الأصول المشفرة والقيم الأخرى التي ينبغي ألا تُنسخ أو تُفقد عن طريق الخطأ.

تتضمن Flow CLI الأدوات اللازمة لتنفيذ شيفرة Cadence واختبارها وفحصها ونشرها والتفاعل معها.

يجب الحفاظ على التوافق بين إصداري CLI وCadence، لأن تغييرات اللغة قد تؤثر في التحليل وفحص الأنواع والتنفيذ وسلوك العقود.

اعتباراً من الإصدار 2.17.4 من Flow CLI، إصدار Cadence المرفق هو 1.10.3.

يمكن للمطورين التعرف على سلوك اللغة الحالي عبر وثائق Cadence الرسمية.

ما الفرق بين سكربت Cadence ومعاملته؟

يقرأ سكربت Cadence حالة البلوكشين من دون تغييرها بصورة دائمة.

يمكن للسكربت استرجاع رصيد حساب أو قراءة حقل عام في عقد أو حساب نتيجة أو فحص إمكانات عامة مخزنة.

لا تتطلب السكربتات تفويضاً بالمعاملات لأنها لا تستطيع تعديل حالة البلوكشين.

أما معاملة Cadence فتستطيع تغيير حالة البلوكشين.

وقد تنقل المعاملات أصولاً مشفرة أو تنشئ موارد أو تستدعي وظائف العقود أو تعدّل تخزين الحساب أو تنفذ إجراءات أخرى مصرحاً بها.

يجب توقيع المعاملة من الحسابات التي تؤدي أدوار الدافع أو مقدم المعاملة أو المفوض.

توفر Flow CLI مجموعات أوامر منفصلة لتنفيذ السكربتات وإرسال المعاملات.

هذا الفرق مهم، لأن إرسال المعاملة ينطوي على مخاطر التفويض والرسوم وتغيير الحالة، وهي مخاطر لا تنطبق بالطريقة نفسها على السكربتات المخصصة للقراءة فقط.

كيف ترسل Flow CLI المعاملات؟

يمكن لـ Flow CLI إنشاء معاملات Flow وتوقيعها وإرسالها واسترجاعها.

يحدد أمر المعاملة ملف معاملة Cadence والوسائط وإعدادات الموقّع والشبكة المستهدفة.

تستخدم CLI معلومات الحساب من

أو خيارات سطر الأوامر لإنشاء التوقيعات المطلوبة.

بعد الإرسال، تمر معاملة Flow بعدة حالات قبل وصولها إلى نتيجة نهائية مختومة.

قد تفشل المعاملة بعد إرسالها إذا أدى تنفيذ Cadence إلى خطأ.

ينبغي للمطور فحص نتيجة المعاملة والأحداث الصادرة ورسائل الخطأ، لا اعتبار الإرسال دليلاً على النجاح.

ترد صيغة الأوامر الدقيقة والخيارات المتاحة في الاستعراض الرسمي لأوامر Flow CLI.

كيف تدير Flow CLI الحسابات؟

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

يمكن لـ Flow CLI إنشاء الحسابات واسترجاع تفاصيلها وفحص المفاتيح وإضافة المفاتيح أو إلغاؤها ونشر العقود على الحسابات المصرح بها.

يفصل نموذج الحساب بين عنوان Flow وأي مفتاح عام منفرد.

وقد يضم الحساب عدة مفاتيح بأوزان وخوارزميات توقيع وخوارزميات تجزئة وأرقام تسلسلية مختلفة.

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

تشرح وثائق حسابات Flow الرسمية اختلافها عن نماذج العناوين التي يحدد فيها مفتاح واحد عنواناً واحداً بصورة دائمة.

لا يمكن لإلغاء مفتاح مخترق حماية الحساب إلا إذا كانت هناك مفاتيح صالحة أخرى توفر وزناً كافياً للتفويض.

ينبغي للمطورين اختبار إجراءات إدارة المفاتيح قبل الاعتماد عليها لحسابات إنتاج مرتفعة القيمة.

كيف تتعامل Flow CLI مع مفاتيح التشفير؟

تتضمن Flow CLI أوامر لإنشاء مفاتيح متوافقة مع Flow وفك ترميزها.

كما توفر أوامر لإنشاء التوقيعات الرقمية والتحقق منها.

يجب أن يستخدم إنشاء المفاتيح مصدراً عشوائياً آمناً، إذ يمكن للمهاجم إعادة بناء مفتاح خاص يمكن التنبؤ به.

يجب عدم لصق مفتاح خاص أبداً في بلاغ عام أو تسجيل شاشة لمشاركة الطرفية أو رسالة دردشة أو مستودع للشيفرة المصدرية.

وقد يكشف سجل سطر الأوامر الأسرار أيضاً عند تقديم المفاتيح الخاصة مباشرةً كوسائط للأوامر.

ينبغي لأنظمة الإنتاج استخدام ملفات مفاتيح مخصصة ذات أذونات مقيدة أو تخزين مدعوم بالأجهزة أو خدمة معتمدة لإدارة المفاتيح.

يجب حماية النسخ الاحتياطية للمفاتيح، لأن فقدان جميع المفاتيح الصالحة قد يؤدي إلى فقدان القدرة على التحكم بالحساب نهائياً.

ما مدير التبعيات في Flow CLI؟

يثبت مدير التبعيات في Flow CLI عقود Cadence الخارجية التي يستخدمها المشروع ويتتبعها.

تعتمد العقود الذكية كثيراً على المعايير والواجهات والتنفيذات المنشورة في مواضع أخرى على شبكة Flow.

يمكن لمدير التبعيات استرجاع مصادر العقود وتحديث إعدادات المشروع كي تُحل عمليات الاستيراد بصورة صحيحة.

يعرض الأمر

التبعيات المسجلة حالياً في المشروع.

ويمكن للأمر

تثبيت تبعية من موقع شبكة مدعوم.

تشرح وثائق إدارة التبعيات الرسمية كيفية تثبيت تبعيات العقود وفحصها وإدارتها.

ينبغي للمطورين مراجعة شيفرة التبعيات وعناوينها بدلاً من افتراض سلامة كل عقد على السلسلة.

قد تؤدي تبعية خبيثة أو محددة على نحو خاطئ إلى إدخال سلوك غير مصرح به في تطبيق لامركزي.

وينبغي للفرق أيضاً مراعاة إمكانية تحديث حساب آخر للعقد المستورد بعد نشر التطبيق.

كيف تختبر Flow CLI عقود Cadence الذكية؟

تتضمن Flow CLI إطار اختبار Cadence، وتشغّل ملفات الاختبار باستخدام الأمر

.

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

يستخدم نظام الاختبار Flow Emulator ضمن بيئة اختبار Cadence.

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

يشرح دليل اختبار Cadence الرسمي سير عمل اختبارات الوحدات والتكامل.

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

لا تثبت نسبة تغطية الشيفرة المرتفعة أن العقد آمن، فقد لا تختبر الحالات الافتراضية الأكثر خطورة.

ينبغي أيضاً إخضاع العقود الحساسة أمنياً للمراجعة اليدوية والاختبارات العدائية والتدقيق المستقل عند الاقتضاء.

ما اختبار التفريع في Flow CLI؟

ينشئ اختبار التفريع بيئة تطوير محلية يمكنها قراءة الحالة من Flow Mainnet أو Testnet، مع تنفيذ التغييرات محلياً.

يتيح للمطورين اختبار الشيفرة مقابل العقود المنشورة والعناوين وحالة البلوكشين الفعلية من دون تعديل الشبكة العامة الأصلية.

يمكن للمطور بدء تفريع يستند إلى الشبكة الرئيسية بأمر مثل

.

يوضح الدليل الرسمي لاختبار التفريع في Flow كيفية محاكاة المحاكي المحلي لحالة شبكة Flow أخرى.

يفيد اختبار التفريع عندما يعتمد التطبيق على عقود أو بيانات حساب يصعب إعادة إنشائها يدوياً.

كما قد يساعد على تحديد مشكلات التوافق قبل تحديث عقد إنتاج.

لا تعادل بيئة متفرعة إنشاء تفرع دائم لبلوكتشين Flow.

إنها نسخة اختبار خاصة لا تؤثر معاملاتها المحلية في الشبكة الرئيسية أو شبكة الاختبار.

ومع ذلك، ينبغي للمطورين التحقق من ارتفاع الكتلة والشبكة المحددين، لأن النتائج قد تختلف عند تغير حالة الإنتاج لاحقاً.

ما فحص الشيفرة في Flow CLI؟

يفحص فحص الشيفرة المصدر بحثاً عن أخطاء محتملة وأنماط غير آمنة ومشكلات تنسيق وغيرها من المشكلات، من دون نشر العقد.

توفر Flow CLI الأمر

لمشاريع Cadence.

قد يكشف فحص الشيفرة بعض المشكلات مبكراً أثناء التطوير، ويمكن إضافته إلى عمليات التحقق الآلية.

تدعم الإصدارات الحالية خيار الدليل الأساسي للمشاريع التي تخزن ملفات Cadence خارج الموقع الافتراضي.

لا تثبت نتيجة الفحص الناجحة صحة منطق الأعمال أو التحكم بالوصول أو الحوافز الاقتصادية أو سلوك إدارة الموارد.

ينبغي استخدام فحص الشيفرة إلى جانب الاختبارات ومراجعة الشيفرة ومراقبة الإنتاج.

كيف تستعلم Flow CLI عن بيانات البلوكشين؟

يمكن لـ Flow CLI استرجاع الحسابات والكتل والمجموعات والأحداث والمعاملات ونتائج التنفيذ وغيرها من المعلومات المتاحة عبر Flow Access API.

يمكن للأمر

استرجاع كتلة باستخدام المعرّف أو الارتفاع أو أحدث كتلة متاحة.

ويسترجع الأمر

معلومات عن حساب Flow.

يمكن لأوامر الأحداث استرجاع الأحداث الصادرة عبر نطاق محدد من الكتل.

كما يمكن لأوامر المعاملات فحص حالة المعاملة المرسلة ونتيجتها.

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

لكن CLI ليست مفهرساً تاريخياً كاملاً، إذ قد توفر عقد الوصول وخدمات الفهرسة المتخصصة إمكانات استعلام مختلفة.

يتطلب تطبيق التحليلات واسع النطاق عادةً قاعدة بيانات أو خدمة لمعالجة الأحداث أو بنية تحتية مخصصة أخرى إلى جانب أوامر CLI.

ما قوالب التفاعل في Flow؟

توفر قوالب التفاعل في Flow أوصافاً معيارية لمعاملات Cadence وسكربتاته.

وتُعرف أحياناً باسم قوالب FLIX.

قد يصف القالب شيفرة التفاعل والوسائط والتبعيات والبيانات الوصفية اللازمة للمحافظ أو التطبيقات لفهم العملية.

تتضمن Flow CLI أوامر FLIX لتنفيذ التفاعلات المدعومة وإنشائها وتجميعها.

قد تحسن القوالب الاتساق بين مطوري التطبيقات والمحافظ والعقود الذكية.

ومع ذلك، يجب على المستخدمين التحقق من شيفرة المعاملة ووسائطها قبل التوقيع، لأن القالب لا يلغي مخاطر العقود الذكية أو المحافظ.

ما أوامر المعاملات المجدولة؟

تتضمن الإصدارات الحالية من Flow CLI أوامر للتفاعل مع المعاملات المجدولة في Flow.

تتيح المعاملات المجدولة للعقود الذكية ترتيب تنفيذ آلي مستقبلي وفق قواعد الجدولة في الشبكة.

تشمل الاستخدامات المحتملة في العملات المشفرة التحويلات المتكررة وإجراءات العقود المؤجلة والمنطق المالي الآلي وسلوك التطبيقات المرتبط بوقت محدد.

يمكن للأمر

إنشاء مورد المدير اللازم لإدارة المعاملات المجدولة لحساب.

وتتيح أوامر إضافية عرض المعاملات المجدولة المدعومة وفحصها وإلغاؤها.

تشرح وثائق المعاملات المجدولة الرسمية متطلبات الإعداد والأولويات وسلوك الأوامر.

لا يضمن جدولة معاملة أن تكون نتيجتها الاقتصادية مواتية، إذ قد تتغير أسعار الأصول وأرصدة الحسابات وحالة العقود وظروف الشبكة قبل التنفيذ.

ما Flowser؟

Flowser مستكشف مرئي يمكن استخدامه مع بيئة Flow Emulator المحلية.

تتضمن Flow CLI أمراً لتشغيل Flowser عندما تتوفر المكونات المطلوبة.

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

تكمل Flowser سطر الأوامر، لكنها لا تحل محل الاختبارات الآلية أو مراجعة الشيفرة المصدرية.

تنطبق النتائج المعروضة في المستكشف المحلي على حالة المحاكي الحالية، ولا ينبغي الخلط بينها وبين نشاط الشبكة الرئيسية.

ما Flow Dev Wallet؟

Flow Dev Wallet أداة تطوير تُستخدم لاختبار تفويض المحافظ والتفاعلات مع التطبيقات.

يمكن لـ Flow CLI تشغيل بيئة محفظة التطوير لسير العمل المحلي المدعوم.

يمكن للمطور استخدامها لمحاكاة تسجيل الدخول وتفويض الحسابات والموافقة على المعاملات وغيرها من سلوكيات المحافظ أثناء بناء تطبيق لامركزي.

لم تُصمم Dev Wallet لحماية أصول إنتاجية قيّمة.

يجب أن تتكامل تطبيقات الإنتاج مع محافظ المستخدمين المناسبة، وأن تتبع ممارسات آمنة للمصادقة ومراجعة المعاملات.

هل تدعم Flow CLI بيئة Flow EVM؟

تدعم Flow كلاً من العقود الذكية المكتوبة بلغة Cadence وبيئة آلة Ethereum الافتراضية، لكن Flow CLI هي أساساً أداة سطر الأوامر الرسمية لسير عمل التطوير باستخدام Cadence وFlow Access API.

تستخدم تطبيقات Solidity على Flow EVM عادةً أدوات JSON-RPC المتوافقة مع EVM وبوابة EVM.

وتوضح وثائق Flow EVM Gateway الرسمية أن عملاء EVM يتصلون عبر بوابة تطبق مواصفات Ethereum JSON-RPC.

كما يمكن لتطبيقات Cadence التفاعل مع Flow EVM عبر الحسابات المملوكة لـ Cadence وعقود الشبكة.

ينبغي للمطور اختيار الأدوات وفقاً لما إذا كان التطبيق مكتوباً بلغة Cadence أو Solidity أو يجمع بين بيئتي التنفيذ.

ولا يعني استخدام اسم Flow CLI أن كل عملية خاصة بـ EVM تُنفذ عبر مجموعة الأوامر نفسها.

Flow CLI مقابل Flow SDK

Flow CLI أداة طرفية تفاعلية قابلة للبرمجة النصية.

أما حزمة تطوير البرمجيات (SDK) الخاصة بـ Flow فهي مكتبة برمجية تُستورد في شيفرة التطبيق.

تفيد CLI في التطوير المحلي وإعداد المشروع والتفاعل اليدوي مع الشبكة والاختبار وأتمتة النشر.

وتناسب SDK خدمات الواجهة الخلفية وخوادم التطبيقات والروبوتات والمحافظ والمفهرسات وغيرها من البرامج التي تحتاج إلى التواصل مع Flow أثناء تشغيلها.

قد يستخدم فريق التطوير Flow CLI لنشر عقد، ثم يستخدم SDK لـ JavaScript أو Go أو الأجهزة المحمولة للتفاعل معه من التطبيق.

تكمل فئتا الأدوات إحداهما الأخرى بدلاً من أن تكونا بديلتين مباشرتين.

Flow CLI مقابل بيئة التطوير الرسومية

توفر بيئة التطوير الرسومية قوائم ومحررات وأدوات مرئية للحسابات وغيرها من ميزات النقر والاختيار.

أما Flow CLI فتقدم أوامر يسهل أتمتتها وحفظها في سكربتات وإعادة تنفيذها في التكامل المستمر.

قد تكون الأداة الرسومية أسهل للمبتدئ، بينما توفر CLI تحكماً وشفافية أكبر في سير العمل القابل للتكرار.

يستخدم كثير من المطورين النهجين معاً، فيحررون Cadence في بيئة تطوير متكاملة ويشغلون أوامر Flow CLI في طرفية مضمّنة.

يمكن لإضافة Cadence الرسمية توفير دعم الصياغة ومساعدة التطوير، بينما تتولى Flow CLI التنفيذ والنشر.

هل يمكن استخدام Flow CLI في التكامل المستمر؟

يمكن تضمين أوامر Flow CLI في سير عمل التكامل المستمر والنشر المستمر.

قد يثبت خط التنفيذ إصداراً محدداً من CLI، ويفحص ملفات Cadence، ويشغل الاختبارات، ويهيئ محاكياً، وينشر عقود الاختبار، ويتحقق من المعاملات المتوقعة.

يتطلب النشر الآلي على الشبكة الرئيسية ضوابط أقوى بكثير من الاختبار الآلي.

ينبغي تخزين المفاتيح الخاصة في نظام آمن لإدارة الأسرار، لا في ملف خط التنفيذ نفسه.

وقد يتطلب النشر الإنتاجي موافقة يدوية وعناصر إصدار موقعة وفروعاً محمية ومراجعين متعددين.

ينبغي لخط التنفيذ التوقف عند إخفاق الاختبارات أو فحوصات الشيفرة أو التحقق من النشر أو فحوصات نتائج المعاملات في إصدار النتائج المتوقعة.

كما ينبغي للفرق تسجيل إصداري Flow CLI وCadence المستخدمين في كل إصدار.

هل تجمع Flow CLI بيانات الاستخدام؟

تجمع Flow CLI حالياً أعداداً إجمالية لاستخدام الأوامر عبر Mixpanel افتراضياً.

تذكر الوثائق الرسمية أن قيم وسائط الأوامر وقيم الخيارات لا تُجمع ضمن نظام احتساب الاستخدام هذا.

يمكن للمستخدمين تعطيل جمع المقاييس باستخدام

.

ويمكن تفعيل المقاييس مجدداً باستخدام

.

تشرح صفحة جمع البيانات الرسمية لـ Flow CLI البيانات التي تُجمع وكيفية تغيير الإعداد.

ينبغي للمؤسسات ذات متطلبات الخصوصية أو الامتثال أو البناء المعزول مراجعة سلوك القياس عن بُعد قبل تثبيت CLI في البيئات الخاضعة للضوابط.

أفضل ممارسات الأمان في Flow CLI

ينبغي للمطورين تثبيت Flow CLI من الوثائق الرسمية أو ملفات الإصدارات المعتمدة فقط.

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

يجب عدم تخزين المفاتيح الخاصة بالشبكة الرئيسية كنص عادي في ملفات المشاريع العامة.

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

ينبغي أن تستخدم حسابات الإنتاج أوزان مفاتيح مناسبة وألا تعتمد على حاسوب مطور واحد غير محمي.

يجب التحقق من عمليات استيراد العقود وعناوين التبعيات لكل شبكة.

ينبغي مراجعة المعاملات للتحقق من أدوار الموقّعين والوسائط وحدود الغاز والعقود المستهدفة قبل إرسالها.

ينبغي للمطورين فحص نتيجة المعاملة المختومة بدلاً من افتراض نجاح المعاملة لمجرد إرسالها.

يجب اختبار إصدارات CLI قبل إدخال الترقيات في سير عمل الإنتاج.

ينبغي إلغاء مفاتيح الحساب القديمة أو غير المستخدمة عند وجود مسار تفويض بديل آمن.

يجب عدم إدخال العبارات الأولية أو المفاتيح الخاصة في مواقع تدّعي ضرورة ذلك لتفعيل Flow CLI.

أخطاء Flow CLI الشائعة

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

قد ينتج خطأ التفويض عن مفتاح خاص أو فهرس مفتاح أو رقم تسلسلي أو خوارزمية توقيع أو خوارزمية تجزئة أو عنوان حساب غير صحيح.

قد يحدث خطأ الاستيراد عندما يكون اسم مستعار لعقد Cadence مفقوداً أو يشير إلى عنوان شبكة غير صحيح.

قد ينتج خطأ النشر عن شيفرة Cadence غير صالحة أو إصدار لغة غير متوافق أو تبعيات مفقودة أو عدم كفاية تفويض الحساب.

قد تفشل المعاملة إذا كان وسيط ما من نوع Cadence غير صحيح أو لم يتضمن الحساب المورد أو الإمكانية المطلوبة.

قد يحدث خطأ الرقم التسلسلي عندما تحاول عدة معاملات استخدام مفتاح مقدم المعاملة نفسه في الوقت نفسه تقريباً.

ينبغي للمطورين قراءة مخرجات الخطأ كاملةً والتحقق من الشبكة النشطة واستخدام خيار

للأمر قبل تغيير إعدادات أخرى غير مرتبطة بالمشكلة.

الاستخدامات الشائعة لـ Flow CLI

يمكن استخدام Flow CLI لإنشاء مشروع Cadence جديد وإعداده.

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

كما يمكنها إنشاء الحسابات وإدارة مفاتيحها.

ويمكنها نشر عقود Cadence وتحديثها.

كما يمكنها تنفيذ سكربتات للقراءة فقط ومعاملات موقعة.

ويمكنها تثبيت تبعيات العقود وإدارة الأسماء المستعارة للشبكات.

وتتيح تشغيل اختبارات الوحدات والتكامل وفحوصات الشيفرة واختبارات التفريع استناداً إلى حالة الشبكة الرئيسية.

كما يمكنها استرجاع الكتل والمعاملات والحسابات والمجموعات والأحداث.

وتدعم خطوط البناء والنشر الآلية.

وقد تساعد المطورين أيضاً على إعادة تنفيذ عمليات البلوكشين عند التحقيق في أخطاء التطبيقات.

حدود Flow CLI

لا تجعل Flow CLI العقد الذكي آمناً تلقائياً.

ولا تستطيع منع المطور من توقيع معاملة ضارة أو نشر شيفرة على الحساب الخطأ.

ولا تحل محل التدقيق الاحترافي أو نمذجة التهديدات أو تصميم التحكم بالوصول أو المراقبة التشغيلية.

لا يستطيع المحاكي المحلي إعادة إنتاج كل ظروف الشبكة العامة بدقة تامة.

كما أن CLI ليست واجهة محفظة متكاملة مصممة للمستهلكين العاديين.

ولا توفر قاعدة بيانات تحليلات تاريخية كاملة لكل معاملة على Flow.

لا يزال يتعين على المطورين فهم Cadence وحسابات Flow وأدوار المعاملات والإمكانات وتخزين الموارد والتبعيات وأمان الشبكة.

الأسئلة الشائعة

ما المقصود بـ Flow CLI؟

تعني Flow CLI واجهة سطر الأوامر الخاصة بـ Flow، وهي أداة التطوير الرسمية المعتمدة على الطرفية لبلوكشين Flow.

هل أنشأت Dapper Labs أداة Flow CLI؟

صممت Dapper Labs شبكة Flow وطورتها في الأصل، بينما تُصان Flow CLI الآن بوصفها برنامجاً مفتوح المصدر رسمياً ضمن منظومة Flow عبر منظمة Onflow.

هل Flow CLI محفظة عملات مشفرة؟

لا، Flow CLI أداة للمطورين، رغم قدرتها على استخدام مفاتيح خاصة مهيأة لتوقيع المعاملات وإدارة حسابات Flow.

ما أحدث إصدار من Flow CLI؟

حتى 14 يوليو 2026، أحدث إصدار رسمي هو Flow CLI 2.17.4.

ما إصدار Cadence المرفق مع Flow CLI 2.17.4؟

يتضمن Flow CLI 2.17.4 إصدار Cadence 1.10.3.

كيف أثبت Flow CLI على macOS؟

من الطرق الشائعة تشغيل

باستخدام Homebrew.

كيف أتحقق من إصدار Flow CLI؟

شغّل

في الطرفية.

كيف أنشئ مشروع Flow جديداً؟

شغّل

واختر قالب المشروع المناسب.

ما flow.json؟

ملف إعدادات المشروع الرئيسي، ويحدد الشبكات والحسابات والعقود والتبعيات وأهداف النشر.

كيف أشغّل Flow Emulator؟

شغّل

من الطرفية.

هل يستخدم Flow Emulator عملة FLOW حقيقية؟

لا، يستخدم المحاكي المحلي حالة وأصولاً تطويرية لا قيمة لها على الشبكة الرئيسية.

هل يمكن لـ Flow CLI نشر العقود على الشبكة الرئيسية؟

نعم، يمكنها نشر العقود على Flow Mainnet عند توفير إعدادات الشبكة والحساب والمفتاح والنشر الصحيحة.

ما الأمر الذي ينشر مشروع Flow؟

أمر نشر المشروع المعتاد هو

، ويُستخدم عادةً مع تحديد خيار الشبكة صراحةً.

هل يمكن لـ Flow CLI تحديث العقود الذكية؟

نعم، يمكنها إرسال معاملات مصرح بها لتحديث العقود وفق قواعد Cadence وشبكة Flow.

كيف أشغّل اختبارات Cadence؟

شغّل

من مشروع Flow مهيأ.

ما اختبار التفريع في Flow؟

يشغّل اختبار التفريع بيئة محلية تستند إلى نسخة من حالة الشبكة الرئيسية أو شبكة الاختبار من دون تغيير البلوكشين العام.

هل تدعم Flow CLI إنشاء الحسابات؟

نعم، يمكن لـ Flow CLI إنشاء حسابات Flow واسترجاعها وإدارة مفاتيحها.

هل تستطيع Flow CLI قراءة بيانات البلوكشين؟

نعم، يمكنها استرجاع الكتل والحسابات والمعاملات والأحداث والمجموعات وغيرها من البيانات المتاحة عبر عقد الوصول إلى Flow.

ما الفرق بين سكربت Flow ومعاملته؟

يقرأ السكربت الحالة من دون تغيير البلوكشين، بينما تُوقّع المعاملة ويمكنها تعديل حالته.

هل تستطيع Flow CLI إدارة تبعيات العقود؟

نعم، يمكن لمدير التبعيات تثبيت عقود Cadence الخارجية التي يستخدمها المشروع وعرضها وتتبعها.

هل تجمع Flow CLI بيانات القياس عن بُعد؟

تجمع Flow CLI حالياً أعداد الأوامر الإجمالية افتراضياً، ويمكن للمستخدمين تعطيل هذه الميزة باستخدام

.

هل ينبغي تخزين المفاتيح الخاصة في flow.json؟

ينبغي عدم تخزين مفاتيح الإنتاج الخاصة كنص غير مشفر في ملف

مشترك أو عام.

هل يمكن استخدام Flow CLI في عمليات النشر الآلية؟

نعم، لكن ينبغي أن تستخدم عمليات النشر الإنتاجية إصدارات محددة وأسراراً محمية وضوابط للمراجعة وتحققاً صريحاً من الشبكة.

هل تعمل Flow CLI مع Flow Testnet؟

نعم، شبكة الاختبار إحدى البيئات القياسية المدعومة عبر إعداد الشبكات في Flow CLI.

هل تُستخدم Flow CLI لتطوير Solidity؟

تدعم Flow CLI أساساً سير العمل باستخدام Cadence وFlow Access API، بينما تستخدم تطبيقات Solidity على Flow EVM عادةً أدوات JSON-RPC المتوافقة مع EVM.

هل Flow CLI مفتوحة المصدر؟

نعم، شيفرة Flow CLI المصدرية متاحة للعامة بموجب ترخيص Apache 2.0.

هل يمكن أن يؤدي استخدام Flow CLI إلى خسارة العملات المشفرة؟

نعم، فقد تتسبب المفاتيح أو الشبكات أو العناوين أو شيفرة العقود أو وسائط المعاملات غير الصحيحة في خسائر لا يمكن عكسها على الشبكة الرئيسية.

الخلاصة

Flow CLI أداة التطوير الرسمية لسطر الأوامر لبناء التطبيقات على بلوكشين Flow والتفاعل معها.

تأتي صلتها بـ Dapper Labs من تصميم Dapper Labs الأصلي لشبكة Flow وتطويرها، بينما تعمل CLI الآن كبرنامج مفتوح المصدر ضمن منظومة Flow.

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

يتيح نظام الإعدادات

للمطورين إدارة بيئات متسقة عبر المحاكي وشبكة الاختبار والشبكة الرئيسية وتفريعات الشبكات المحلية.

قد تجعل Flow CLI تطوير البلوكشين أكثر قابلية للتكرار، لكنها لا تزيل مخاطر المفاتيح غير الآمنة أو العقود المعيبة أو أهداف النشر غير الصحيحة أو التبعيات الخبيثة أو المعاملات التي لا يمكن عكسها.

ينبغي للمطورين استخدام الإصدارات الرسمية وحماية بيانات اعتماد التوقيع والاختبار عبر بيئات متعددة وفحص نتائج المعاملات وفرض ضوابط مراجعة صارمة قبل النشر على Flow Mainnet.