Laskentabudjetti

Laskentayksikkörajoitus

Jokaiselle ohjeelle allokoidaan oletuksena 200 000 CU:ta, ja jokainen transaktio on rajoitettu 1 400 000 CU:hun. Kun eksplisiittistä SetComputeUnitLimit-ohjetta ei ole läsnä, oletusarvo lasketaan ohjeen tyypin perusteella:

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)

• Sisäänrakennetut ohjeet (System Program, Stake, Vote jne., joita ei ole siirretty SBF:ään): kullekin allokoidaan MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3 000 CU:ta (mukaan lukien SIMD-0170).
• Ei-sisäänrakennetut ohjeet (käyttäjän julkaisemat SBF-ohjelmat): kullekin allokoidaan DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200 000 CU:ta.
• Siirtyvät sisäänrakennetut, jotka on siirretty SBF:ään (feature-gated): käsitellään ei-sisäänrakennettuina (200 000 CU:ta kullekin).

Tulos rajataan arvoon MAX_COMPUTE_UNIT_LIMIT (1 400 000).

Voit ohittaa tämän oletusarvon sisällyttämällä SetComputeUnitLimit-ohjeen transaktioon.

Sopivan CU-rajan määrittämiseksi:

1. Simuloi transaktio CU-kulutuksen mittaamiseksi.
2. Lisää 10 %:n turvamarginaali simuloituun arvoon.

Laskentabudjetin ohjeet

Laskentabudjetin ohjelmassa (ComputeBudget111111111111111111111111111111) on neljä ohjetta.

Lähde: ComputeBudgetInstruction enum

Rajoitukset ja virhetilanteet

Seuraavat säännöt pätevät laskentabudjetin ohjeiden käsittelyssä:

• Yksi per tyyppi: vain yksi kutakin ohjevarianttia sallitaan per transaktio. Duplikaattien sisällyttäminen aiheuttaa DuplicateInstruction-virheen (koko transaktio epäonnistuu).
• RequestHeapFrame: arvon on oltava välillä MIN_HEAP_FRAME_BYTES (32 KiB) ja MAX_HEAP_FRAME_BYTES (256 KiB), ja sen on oltava 1 024:n monikerta. Muussa tapauksessa transaktio epäonnistuu InvalidInstructionData-virheeseen. Heap-koko koskee jokaista transaktiossa kutsuttua ohjelmaa (mukaan lukien CPI:t).
• SetComputeUnitLimit: mikä tahansa u32-arvo hyväksytään. Todellinen raja rajataan arvoon MAX_COMPUTE_UNIT_LIMIT (1 400 000).
• SetComputeUnitPrice: mikä tahansa u64-arvo hyväksytään (0–u64::MAX).
• SetLoadedAccountsDataSizeLimit: arvon on oltava suurempi kuin 0 (NonZeroU32). Arvo 0 aiheuttaa InvalidLoadedAccountsDataSizeLimit-virheen. Todellinen raja rajataan arvoon MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 MiB).
• Tunnistamaton data: mikä tahansa laskentabudjetin ohjelmalle lähetetty ohje, joka ei deserialisoidu tunnetuksi variantiksi, epäonnistuu InvalidInstructionData-virheeseen.

Ajoittimen kustannusmalli

Validatorin ajoitin käyttää kustannusmallia transaktion resurssien käytön arvioimiseen ennen suoritusta. Nämä suoritusta edeltävät kustannusarviot määrittävät, mahtuuko transaktio lohkon jäljellä olevaan kapasiteettiin. Ne ovat erillisiä suorituksen aikana tapahtuvasta CU-mittauksesta.

Ajoittimen kokonaiskustannus on viiden komponentin summa (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Kustannuskomponentit

Kaikki arvot ovat laskentayksiköissä.

Ajoittimen kustannusvakiot

Äänestystransaktion kustannus

Äänestystransaktiot käyttävät staattista kustannusta 3 428 CU riippumatta niiden todellisesta sisällöstä.

Lohkorajat

Ajoitin valvoo lohkokohtaisia rajoja. Jos transaktion lisääminen ylittäisi jonkin rajan, sitä ei sisällytetä lohkoon.

Suoritubudjetin vakiot

Seuraavat vakiot tiedostosta execution_budget.rs määrittelevät ajonaikaiset rajoitukset transaktion suorituksen aikana: