Rechenbudget

Compute-Unit-Limit

Jede Anweisung erhält standardmäßig 200.000 CUs, und jede Transaktion ist auf 1.400.000 CUs begrenzt. Wenn keine explizite SetComputeUnitLimit Anweisung vorhanden ist, wird der Standardwert berechnet basierend auf dem Anweisungstyp:

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)

• Builtin-Anweisungen (System Program, Stake, Vote usw., die noch nicht zu SBF migriert wurden): jeweils MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3.000 CUs (gemäß SIMD-0170).
• Nicht-Builtin-Anweisungen (vom Benutzer bereitgestellte SBF-Programme): jeweils DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200.000 CUs.
• Migrierende Builtins, die die Migration zu SBF abgeschlossen haben (Feature-gesteuert): werden als Nicht-Builtin behandelt (jeweils 200.000 CUs).

Das Ergebnis wird auf MAX_COMPUTE_UNIT_LIMIT (1.400.000) begrenzt.

Sie können diesen Standardwert überschreiben, indem Sie eine SetComputeUnitLimit Anweisung in Ihre Transaktion einfügen.

Um das geeignete CU-Limit zu bestimmen:

1. Simulieren Sie die Transaktion, um den CU-Verbrauch zu messen.
2. Fügen Sie dem simulierten Wert eine Sicherheitsmarge von 10 % hinzu.

Anweisungen für das Rechenbudget

Das Compute Budget Program (ComputeBudget111111111111111111111111111111) verfügt über vier Anweisungen.

Quelle: ComputeBudgetInstruction enum

Einschränkungen und Fehlerbedingungen

Die folgenden Regeln gelten bei der Verarbeitung von Compute-Budget-Anweisungen:

• Eine pro Typ: nur eine Anweisung jeder Variante ist pro Transaktion zulässig. Das Einbeziehen von Duplikaten verursacht einen DuplicateInstruction-Fehler (die gesamte Transaktion schlägt fehl).
• RequestHeapFrame: der Wert muss zwischen MIN_HEAP_FRAME_BYTES (32 KiB) und MAX_HEAP_FRAME_BYTES (256 KiB) liegen und muss ein Vielfaches von 1.024 sein. Andernfalls schlägt die Transaktion mit InvalidInstructionData fehl. Die Heap-Größe gilt für jedes in der Transaktion aufgerufene Programm (einschließlich CPIs).
• SetComputeUnitLimit: jeder u32-Wert wird akzeptiert. Das effektive Limit wird auf MAX_COMPUTE_UNIT_LIMIT (1.400.000) begrenzt.
• SetComputeUnitPrice: jeder u64-Wert wird akzeptiert (0 bis u64::MAX).
• SetLoadedAccountsDataSizeLimit: der Wert muss größer als 0 sein (NonZeroU32). Ein Wert von 0 verursacht InvalidLoadedAccountsDataSizeLimit. Das effektive Limit wird auf MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 MiB) begrenzt.
• Nicht erkannte Daten: jede Anweisung, die an das Compute Budget Program gesendet wird und nicht in eine bekannte Variante deserialisiert werden kann, schlägt mit InvalidInstructionData fehl.

Scheduler-Kostenmodell

Der Scheduler des Validators verwendet ein Kostenmodell, um die Ressourcennutzung von Transaktionen vor der Ausführung zu schätzen. Diese Kostenschätzungen vor der Ausführung bestimmen, ob eine Transaktion in die verbleibende Kapazität des Blocks passt. Sie sind getrennt von der CU-Messung, die während der Ausführung erfolgt.

Die Gesamtkosten des Schedulers sind die Summe von fünf Komponenten (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Kostenkomponenten

Alle Werte sind in Compute-Units angegeben.

Scheduler-Kostenkonstanten

Vote-Transaktionskosten

Vote-Transaktionen verwenden statische Kosten von 3.428 CUs, unabhängig von ihrem tatsächlichen Inhalt.

Block-Limits

Der Scheduler erzwingt Limits pro Block. Wenn das Hinzufügen einer Transaktion ein Limit überschreiten würde, wird sie nicht in den Block aufgenommen.

Konstanten für das Ausführungsbudget

Die folgenden Konstanten aus execution_budget.rs definieren Laufzeitlimits während der Transaktionsausführung: