Προϋπολογισμός υπολογισμού

Όριο μονάδων υπολογισμού

Σε κάθε εντολή εκχωρούνται προεπιλεγμένα 200.000 CUs, και κάθε συναλλαγή περιορίζεται σε 1.400.000 CUs. Όταν δεν υπάρχει ρητή εντολή SetComputeUnitLimit, η προεπιλογή υπολογίζεται βάσει του τύπου εντολής:

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)

• Ενσωματωμένες εντολές (System Program, Stake, Vote κ.λπ. που δεν έχουν μεταφερθεί σε SBF): σε καθεμία εκχωρούνται MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3.000 CUs (σύμφωνα με το SIMD-0170).
• Μη ενσωματωμένες εντολές (προγράμματα SBF που έχουν αναπτυχθεί από χρήστες): σε καθεμία εκχωρούνται DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200.000 CUs.
• Ενσωματωμένες υπό μετάβαση που έχουν ολοκληρώσει τη μετάβαση σε SBF (με feature gate): αντιμετωπίζονται ως μη ενσωματωμένες (200.000 CUs η καθεμία).

Το αποτέλεσμα περιορίζεται στο MAX_COMPUTE_UNIT_LIMIT (1.400.000).

Μπορείτε να παρακάμψετε αυτήν την προεπιλογή συμπεριλαμβάνοντας μια εντολή SetComputeUnitLimit στη συναλλαγή σας.

Για να προσδιορίσετε το κατάλληλο όριο CU:

1. Προσομοιώστε τη συναλλαγή για να μετρήσετε την κατανάλωση CU.
2. Προσθέστε ένα περιθώριο ασφαλείας 10% στην προσομοιωμένη τιμή.

Οδηγίες προϋπολογισμού υπολογισμού

Το Compute Budget Program (ComputeBudget111111111111111111111111111111) διαθέτει τέσσερις οδηγίες.

Πηγή: ComputeBudgetInstruction enum

Περιορισμοί και συνθήκες σφάλματος

Οι ακόλουθοι κανόνες ισχύουν κατά την επεξεργασία οδηγιών προϋπολογισμού υπολογισμού:

• Μία ανά τύπο: επιτρέπεται μόνο μία από κάθε παραλλαγή οδηγίας ανά συναλλαγή. Η συμπερίληψη διπλότυπων προκαλεί σφάλμα DuplicateInstruction (ολόκληρη η συναλλαγή αποτυγχάνει).
• RequestHeapFrame: η τιμή πρέπει να είναι μεταξύ MIN_HEAP_FRAME_BYTES (32 KiB) και MAX_HEAP_FRAME_BYTES (256 KiB), και πρέπει να είναι πολλαπλάσιο του 1.024. Διαφορετικά η συναλλαγή αποτυγχάνει με InvalidInstructionData. Το μέγεθος heap ισχύει για κάθε πρόγραμμα που καλείται στη συναλλαγή (συμπεριλαμβανομένων των CPIs).
• 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).
• Μη αναγνωρίσιμα δεδομένα: οποιαδήποτε οδηγία αποστέλλεται στο Compute Budget Program που δεν αποσειριοποιείται σε γνωστή παραλλαγή αποτυγχάνει με InvalidInstructionData.

Μοντέλο κόστους χρονοπρογραμματιστή

Ο χρονοπρογραμματιστής του validator χρησιμοποιεί ένα μοντέλο κόστους για να εκτιμήσει τη χρήση πόρων της συναλλαγής πριν από την εκτέλεση. Αυτές οι εκτιμήσεις κόστους προ-εκτέλεσης καθορίζουν αν μια συναλλαγή χωράει στην υπολειπόμενη χωρητικότητα του block. Είναι ξεχωριστές από τη μέτρηση CU που συμβαίνει κατά την εκτέλεση.

Το συνολικό κόστος του χρονοπρογραμματιστή είναι το άθροισμα πέντε συνιστωσών (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Συνιστώσες κόστους

Όλες οι τιμές είναι σε compute units.

Σταθερές κόστους χρονοπρογραμματιστή

Κόστος συναλλαγής ψήφου

Οι συναλλαγές ψήφου χρησιμοποιούν ένα στατικό κόστος 3.428 CUs ανεξάρτητα από το πραγματικό τους περιεχόμενο.

Όρια block

Ο χρονοπρογραμματιστής επιβάλλει όρια ανά block. Αν η προσθήκη μιας συναλλαγής θα υπερέβαινε οποιοδήποτε όριο, δεν συμπεριλαμβάνεται στο block.

Σταθερές προϋπολογισμού εκτέλεσης

Οι ακόλουθες σταθερές από το execution_budget.rs ορίζουν όρια χρόνου εκτέλεσης κατά την εκτέλεση συναλλαγών: