Обчислювальний бюджет

Ліміт обчислювальних одиниць

Кожній інструкції виділяється за замовчуванням 200 000 CU, а кожна транзакція обмежена 1 400 000 CU. Коли явна інструкція 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 = 3000 CU (згідно з SIMD-0170).
• Невбудовані інструкції (розгорнуті користувачем SBF-програми): кожній виділяється DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200 000 CU.
• Вбудовані програми, що мігрують, які завершили міграцію до SBF (керовані feature-flag): розглядаються як невбудовані (по 200 000 CU кожна).

Результат обмежується значенням MAX_COMPUTE_UNIT_LIMIT (1 400 000).

Ви можете перевизначити це значення за замовчуванням, включивши інструкцію SetComputeUnitLimit у вашу транзакцію.

Щоб визначити відповідний ліміт CU:

1. Симулюйте транзакцію для вимірювання споживання CU.
2. Додайте 10% запасу безпеки до симульованого значення.

Інструкції бюджету обчислень

Програма бюджету обчислень (ComputeBudget111111111111111111111111111111) має чотири інструкції.

Джерело: enum ComputeBudgetInstruction

Обмеження та умови помилок

Наступні правила застосовуються під час обробки інструкцій бюджету обчислень:

• Один на тип: дозволено лише один екземпляр кожного варіанту інструкції на транзакцію. Включення дублікатів викликає помилку DuplicateInstruction (вся транзакція не виконується).
• RequestHeapFrame: значення має бути між MIN_HEAP_FRAME_BYTES (32 КіБ) та MAX_HEAP_FRAME_BYTES (256 КіБ), і має бути кратним 1024. Інакше транзакція не виконується з помилкою InvalidInstructionData. Розмір купи застосовується до кожної програми, викликаної в транзакції (включаючи CPI).
• 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.

Модель вартості планувальника

Планувальник валідатора використовує модель вартості для оцінки використання ресурсів транзакції перед виконанням. Ці оцінки вартості перед виконанням визначають, чи вміщується транзакція в межах залишкової ємності блоку. Вони є окремими від вимірювання обчислювальних одиниць (CU), що відбувається під час виконання.

Загальна вартість планувальника є сумою п'яти компонентів (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Компоненти вартості

Усі значення вказані в обчислювальних одиницях.

Константи вартості планувальника

Вартість транзакції голосування

Транзакції голосування використовують статичну вартість 3 428 CU незалежно від їхнього фактичного вмісту.

Обмеження блоку

Планувальник застосовує обмеження на кожен блок. Якщо додавання транзакції перевищить будь-яке обмеження, вона не включається до блоку.

Константи бюджету виконання

Наступні константи з execution_budget.rs визначають обмеження під час виконання транзакції: