计算预算

计算单元限制

每条指令分配 默认 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 = 3,000 CU（参见 SIMD-0170）。
• 非内置指令（用户部署的 SBF 程序）：每条分配 DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200,000 CU。
• 正在迁移的内置指令（已完成 SBF 迁移并启用相关功能）：视为非内置指令（每条 200,000 CU）。

结果会被限制在 MAX_COMPUTE_UNIT_LIMIT（1,400,000）以内。

你可以在交易中包含 SetComputeUnitLimit 指令来覆盖默认值。

确定合适的 CU 限制方法：

1. 通过模拟交易测量 CU 消耗。
2. 在模拟值基础上增加 10% 的安全余量。

计算预算指令

Compute Budget Program（ComputeBudget111111111111111111111111111111）包含四种指令。

来源：ComputeBudgetInstruction 枚举

约束与错误条件

在处理计算预算指令时，适用以下规则：

• 每种类型仅允许一个：每笔交易中，每种指令变体只能包含一个。若包含重复项，将导致 DuplicateInstruction 错误（整个交易失败）。
• RequestHeapFrame：该值必须介于 MIN_HEAP_FRAME_BYTES（32 KiB）和 MAX_HEAP_FRAME_BYTES（256 KiB）之间，并且必须为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 MiB）。
• 未识别的数据：任何发送到 Compute Budget Program 且无法反序列化为已知变体的指令，都会以 InvalidInstructionData 失败。

调度器成本模型

validator 的 scheduler 使用 cost model 在执行前估算交易的资源使用情况。这些预执行成本估算用于判断交易是否能适配区块剩余容量。它们与执行期间发生的 CU 计量是分开的。

调度器总成本由五个部分组成 (UsageCostDetails::sum)：

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

成本组成部分

所有数值均以 compute unit（CU）为单位。

调度器成本常量

投票交易成本

投票交易无论实际内容如何，均使用 固定成本 3,428 CU。

区块限制

调度器会强制执行每个区块的限制。如果添加某笔交易会超出任何限制，则该交易不会被包含进区块。

执行预算常量

以下常量来自 execution_budget.rs 定义了交易执行期间的运行时限制：