ميزانية الحوسبة

حد وحدات الحوسبة

يتم تخصيص افتراضي 200,000 وحدة حوسبة لكل تعليمة، ويتم تحديد كل معاملة بحد أقصى 1,400,000 وحدة حوسبة. عندما لا تكون هناك تعليمة SetComputeUnitLimit صريحة، يتم حساب الافتراضي بناءً على نوع التعليمة:

default_cu_limit = (num_non_migratable_builtin_instructions * 3,000)
                 + (num_not_migrated_builtin_instructions * 3,000)
                 + (num_non_builtin_instructions * 200,000)
                 + (num_migrated_builtin_instructions * 200,000)

• التعليمات المدمجة (System Program، Stake، Vote، إلخ. التي لم يتم ترحيلها إلى SBF): يتم تخصيص MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3,000 وحدة حوسبة لكل منها (وفقًا لـ SIMD-0170).
• التعليمات غير المدمجة (برامج SBF المنشورة من قبل المستخدم): يتم تخصيص DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200,000 وحدة حوسبة لكل منها.
• البرامج المدمجة قيد الترحيل التي أكملت الترحيل إلى SBF (محكومة بميزة): تُعامل كبرامج غير مدمجة (200,000 وحدة حوسبة لكل منها).

يتم تقييد النتيجة إلى MAX_COMPUTE_UNIT_LIMIT (1,400,000).

يمكنك تجاوز هذا الافتراضي من خلال تضمين تعليمة SetComputeUnitLimit في معاملتك.

لتحديد حد وحدات الحوسبة المناسب:

1. محاكاة المعاملة لقياس استهلاك وحدات الحوسبة.
2. إضافة هامش أمان بنسبة 10% إلى القيمة المحاكاة.

تعليمات ميزانية الحوسبة

يحتوي برنامج ميزانية الحوسبة (ComputeBudget111111111111111111111111111111) على أربع تعليمات.

المصدر: ComputeBudgetInstruction enum

القيود وشروط الخطأ

تنطبق القواعد التالية عند معالجة تعليمات ميزانية الحوسبة:

• واحد لكل نوع: يُسمح بمتغير واحد فقط من كل تعليمة لكل معاملة. يؤدي تضمين نسخ مكررة إلى خطأ DuplicateInstruction (تفشل المعاملة بأكملها).
• RequestHeapFrame: يجب أن تكون القيمة بين MIN_HEAP_FRAME_BYTES (32 كيلوبايت) و MAX_HEAP_FRAME_BYTES (256 كيلوبايت)، ويجب أن تكون مضاعفاً للعدد 1,024. وإلا تفشل المعاملة مع InvalidInstructionData. ينطبق حجم الذاكرة على كل برنامج يتم استدعاؤه في المعاملة (بما في ذلك CPIs).
• SetComputeUnitLimit: يتم قبول أي قيمة u32. يتم تقييد الحد الفعلي إلى MAX_COMPUTE_UNIT_LIMIT (1,400,000).
• SetComputeUnitPrice: يتم قبول أي قيمة u64 (من 0 إلى u64::MAX).
• SetLoadedAccountsDataSizeLimit: يجب أن تكون القيمة أكبر من 0 (NonZeroU32). تتسبب القيمة 0 في InvalidLoadedAccountsDataSizeLimit. يتم تقييد الحد الفعلي إلى MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 ميجابايت).
• بيانات غير معروفة: أي تعليمة يتم إرسالها إلى برنامج ميزانية الحوسبة ولا يمكن إلغاء تسلسلها إلى متغير معروف تفشل مع InvalidInstructionData.

نموذج تكلفة المجدول

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

إجمالي تكلفة المجدول هو مجموع خمسة مكونات (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

مكونات التكلفة

جميع القيم بوحدات الحوسبة.

ثوابت تكلفة المجدول

تكلفة معاملة التصويت

تستخدم معاملات التصويت تكلفة ثابتة قدرها 3,428 وحدة حوسبة بغض النظر عن محتواها الفعلي.

حدود الكتلة

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

ثوابت ميزانية التنفيذ

الثوابت التالية من execution_budget.rs تحدد حدود وقت التشغيل أثناء تنفيذ المعاملة: