Budżet obliczeniowy

Limit jednostek obliczeniowych

Każda instrukcja otrzymuje domyślnie 200 000 CU, a każda transakcja jest ograniczona do 1 400 000 CU. Gdy nie ma jawnej instrukcji SetComputeUnitLimit, domyślna wartość jest wyliczana w zależności od typu instrukcji:

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)

• Instrukcje wbudowane (System Program, Stake, Vote itd., które nie zostały zmigrowane do SBF): każda otrzymuje MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3 000 CU (zgodnie z SIMD-0170).
• Instrukcje niewbudowane (programy SBF wdrożone przez użytkowników): każda otrzymuje DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200 000 CU.
• Wbudowane w trakcie migracji, które zakończyły migrację do SBF (feature-gated): traktowane jak niewbudowane (200 000 CU każda).

Wynik jest ograniczany do MAX_COMPUTE_UNIT_LIMIT (1 400 000).

Możesz nadpisać tę wartość domyślną, dodając instrukcję SetComputeUnitLimit do swojej transakcji.

Aby określić odpowiedni limit CU:

1. Zasymuluj transakcję, aby zmierzyć zużycie CU.
2. Dodaj 10% marginesu bezpieczeństwa do uzyskanej wartości.

Instrukcje budżetu obliczeniowego

Compute Budget Program (ComputeBudget111111111111111111111111111111) zawiera cztery instrukcje.

Źródło: enum ComputeBudgetInstruction

Ograniczenia i warunki błędów

Poniższe zasady obowiązują podczas przetwarzania instrukcji budżetu obliczeniowego:

• Jedna na typ: dozwolona jest tylko jedna instrukcja danego wariantu na transakcję. Dodanie duplikatów powoduje błąd DuplicateInstruction (cała transakcja zostaje odrzucona).
• RequestHeapFrame: wartość musi mieścić się w zakresie od MIN_HEAP_FRAME_BYTES (32 KiB) do MAX_HEAP_FRAME_BYTES (256 KiB) i być wielokrotnością 1 024. W przeciwnym razie transakcja zostanie odrzucona z błędem InvalidInstructionData. Rozmiar sterty dotyczy każdego programu wywoływanego w transakcji (w tym CPI).
• SetComputeUnitLimit: akceptowana jest dowolna wartość u32. Efektywny limit jest ograniczony do MAX_COMPUTE_UNIT_LIMIT (1 400 000).
• SetComputeUnitPrice: akceptowana jest dowolna wartość u64 (od 0 do u64::MAX).
• SetLoadedAccountsDataSizeLimit: wartość musi być większa niż 0 (NonZeroU32). Wartość 0 powoduje InvalidLoadedAccountsDataSizeLimit. Efektywny limit jest ograniczony do MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 MiB).
• Nierozpoznane dane: każda instrukcja wysłana do Compute Budget Program, która nie deserializuje się do znanego wariantu, kończy się błędem InvalidInstructionData.

Model kosztów scheduler'a

Validator używa scheduler'a oraz modelu kosztów do szacowania zużycia zasobów przez transakcję przed jej wykonaniem. Te przedwykonawcze estymacje kosztów określają, czy transakcja mieści się w pozostałej pojemności bloku. Są one niezależne od mierzenia CU, które odbywa się podczas wykonania.

Całkowity koszt scheduler'a to suma pięciu składników (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Składniki kosztów

Wszystkie wartości podawane są w jednostkach obliczeniowych (compute units).

Stałe kosztów scheduler'a

Koszt transakcji głosujących

Transakcje głosujące używają stałego kosztu 3 428 CU niezależnie od ich faktycznej zawartości.

Limity bloku

Scheduler wymusza limity na blok. Jeśli dodanie transakcji przekroczyłoby którykolwiek z limitów, nie zostanie ona uwzględniona w bloku.

Stałe budżetu wykonania

Następujące stałe z pliku execution_budget.rs definiują limity środowiska wykonawczego podczas realizacji transakcji: