Бюджет вычислений

Лимит вычислительных единиц

Каждой инструкции выделяется по умолчанию 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

Ограничения и условия ошибок

Следующие правила применяются при обработке инструкций вычислительного бюджета:

• Одна на тип: допускается только одна инструкция каждого варианта в одной транзакции. Включение дубликатов вызывает ошибку DuplicateInstruction (вся транзакция отклоняется).
• RequestHeapFrame: значение должно быть между MIN_HEAP_FRAME_BYTES (32 КиБ) и MAX_HEAP_FRAME_BYTES (256 КиБ) и должно быть кратным 1 024. В противном случае транзакция завершится ошибкой 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.

Модель стоимости планировщика

Планировщик validator (scheduler) использует модель стоимости для оценки использования ресурсов транзакцией до выполнения. Эти предварительные оценки стоимости определяют, помещается ли транзакция в оставшуюся ёмкость блока. Они отделены от учёта compute units (CU), который происходит во время выполнения.

Общая стоимость по модели планировщика — это сумма пяти компонентов (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Компоненты стоимости

Все значения указаны в compute units.

Константы стоимости планировщика

Стоимость транзакции голосования

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

Лимиты блока

Планировщик применяет лимиты на блок. Если добавление транзакции превышает какой-либо лимит, она не включается в блок.

Константы бюджета исполнения

Следующие константы из execution_budget.rs определяют лимиты времени выполнения при исполнении транзакций: