計算予算

計算ユニット制限

各instructionには デフォルトで200,000 CUが割り当てられ、各トランザクションは 1,400,000 CUに制限されています。明示的なSetComputeUnitLimit instructionが存在しない場合、instructionタイプに基づいて デフォルトが計算されます:

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)

• ビルトインinstructions(System Program、Stake、Voteなど、SBFに移行されていないもの):それぞれ MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3,000 CUが割り当てられます(SIMD-0170による)。
• 非ビルトインinstructions(ユーザーがデプロイしたSBFプログラム):それぞれ DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200,000 CUが割り当てられます。
• 移行中のビルトインでSBFへの移行が完了したもの(機能ゲート付き): 非ビルトインとして扱われます(それぞれ200,000 CU)。

結果はMAX_COMPUTE_UNIT_LIMIT(1,400,000)にクランプされます。

トランザクションに SetComputeUnitLimit instructionを含めることで、このデフォルトを上書きできます。

適切なCU制限を決定するには:

1. トランザクションをシミュレートしてCU消費量を測定します。
2. シミュレート値に10%の安全マージンを追加します。

コンピュートバジェットinstructions

コンピュートバジェットプログラム (ComputeBudget111111111111111111111111111111)には4つのinstructionsがあります。

ソース: ComputeBudgetInstruction enum

制約とエラー条件

コンピュートバジェットinstructionsの処理時には、以下のルールが適用されます:

• タイプごとに1つ: 各instructionバリアントは、トランザクションごとに1つのみ許可されます。重複を含めると、*rsDuplicateInstruction*エラーが発生します(トランザクション全体が失敗します)。
• RequestHeapFrame: 値はMIN_HEAP_FRAME_BYTES(32 KiB)からMAX_HEAP_FRAME_BYTES(256 KiB)の間で、かつ1,024の倍数である必要があります。それ以外の場合、トランザクションは*rsInvalidInstructionData*で失敗します。ヒープサイズは、トランザクション内で呼び出されるすべてのプログラム(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)にクランプされます。
• 認識されないデータ: コンピュートバジェットプログラムに送信されたinstructionで、既知のバリアントにデシリアライズできないものは、*rsInvalidInstructionData*で失敗します。

スケジューラーコストモデル

validatorのスケジューラーは、コストモデルを使用して、実行前にトランザクションのリソース使用量を推定します。これらの実行前コスト推定は、トランザクションがブロックの残容量に収まるかどうかを判断します。これらは実行中に発生するCU計測とは別のものです。

スケジューラーの総コストは、5つのコンポーネントの合計です(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の以下の定数は、トランザクション実行中のランタイム制限を定義します: