Budget di calcolo

Limite delle unità di calcolo

A ogni istruzione viene allocato un valore predefinito di 200.000 CU, e ogni transazione ha un limite massimo di 1.400.000 CU. Quando non è presente un'istruzione esplicita SetComputeUnitLimit, il valore predefinito viene calcolato in base al tipo di istruzione:

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)

• Istruzioni builtin (System Program, Stake, Vote, ecc. che non sono state migrate a SBF): a ciascuna vengono allocate MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3.000 CU (secondo SIMD-0170).
• Istruzioni non builtin (programmi SBF distribuiti dall'utente): a ciascuna vengono allocate DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200.000 CU.
• Builtin in migrazione che hanno completato la migrazione a SBF (controllati da feature flag): trattati come non builtin (200.000 CU ciascuno).

Il risultato viene limitato a MAX_COMPUTE_UNIT_LIMIT (1.400.000).

Puoi sovrascrivere questo valore predefinito includendo un'istruzione SetComputeUnitLimit nella tua transazione.

Per determinare il limite di CU appropriato:

1. Simula la transazione per misurare il consumo di CU.
2. Aggiungi un margine di sicurezza del 10% al valore simulato.

Istruzioni del budget di calcolo

Il Compute Budget Program (ComputeBudget111111111111111111111111111111) ha quattro istruzioni.

Fonte: enum ComputeBudgetInstruction

Vincoli e condizioni di errore

Le seguenti regole si applicano durante l'elaborazione delle istruzioni del budget di calcolo:

• Una per tipo: è consentita solo una di ciascuna variante di istruzione per transazione. L'inclusione di duplicati causa un errore DuplicateInstruction (l'intera transazione fallisce).
• RequestHeapFrame: il valore deve essere compreso tra MIN_HEAP_FRAME_BYTES (32 KiB) e MAX_HEAP_FRAME_BYTES (256 KiB), e deve essere un multiplo di 1.024. Altrimenti la transazione fallisce con InvalidInstructionData. La dimensione heap si applica a ogni programma invocato nella transazione (inclusi i CPI).
• SetComputeUnitLimit: qualsiasi valore u32 è accettato. Il limite effettivo è limitato a MAX_COMPUTE_UNIT_LIMIT (1.400.000).
• SetComputeUnitPrice: qualsiasi valore u64 è accettato (da 0 a u64::MAX).
• SetLoadedAccountsDataSizeLimit: il valore deve essere maggiore di 0 (NonZeroU32). Un valore di 0 causa InvalidLoadedAccountsDataSizeLimit. Il limite effettivo è limitato a MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 MiB).
• Dati non riconosciuti: qualsiasi istruzione inviata al Compute Budget Program che non viene deserializzata in una variante nota fallisce con InvalidInstructionData.

Modello di costo dello scheduler

Lo scheduler del validator utilizza un modello di costo per stimare l'utilizzo delle risorse della transazione prima dell'esecuzione. Queste stime dei costi pre-esecuzione determinano se una transazione rientra nella capacità rimanente del blocco. Sono separate dalla misurazione delle CU che avviene durante l'esecuzione.

Il costo totale dello scheduler è la somma di cinque componenti (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Componenti del costo

Tutti i valori sono espressi in unità di calcolo.

Costanti del costo dello scheduler

Costo della transazione di voto

Le transazioni di voto utilizzano un costo statico di 3.428 CU indipendentemente dal loro contenuto effettivo.

Limiti del blocco

Lo scheduler applica limiti per blocco. Se l'aggiunta di una transazione supera qualsiasi limite, essa non viene inclusa nel blocco.

Costanti del budget di esecuzione

Le seguenti costanti da execution_budget.rs definiscono i limiti di runtime durante l'esecuzione delle transazioni: