Anggaran komputasi

Batas unit komputasi

Setiap instruksi dialokasikan default 200.000 CU, dan setiap transaksi dibatasi pada 1.400.000 CU. Ketika tidak ada instruksi SetComputeUnitLimit eksplisit, maka default dihitung berdasarkan jenis instruksi:

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)

• Instruksi builtin (System Program, Stake, Vote, dll. yang belum dimigrasikan ke SBF): masing-masing dialokasikan MAX_BUILTIN_ALLOCATION_COMPUTE_UNIT_LIMIT = 3.000 CU (sesuai SIMD-0170).
• Instruksi non-builtin (program SBF yang di-deploy pengguna): masing-masing dialokasikan DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT = 200.000 CU.
• Builtin yang sedang migrasi yang telah menyelesaikan migrasi ke SBF (feature-gated): diperlakukan sebagai non-builtin (200.000 CU masing-masing).

Hasilnya dibatasi pada MAX_COMPUTE_UNIT_LIMIT (1.400.000).

Anda dapat mengganti default ini dengan menyertakan instruksi SetComputeUnitLimit dalam transaksi Anda.

Untuk menentukan batas CU yang sesuai:

1. Simulasikan transaksi untuk mengukur konsumsi CU.
2. Tambahkan margin keamanan 10% pada nilai hasil simulasi.

Instruksi compute budget

Compute Budget Program (ComputeBudget111111111111111111111111111111) memiliki empat instruksi.

Sumber: enum ComputeBudgetInstruction

Batasan dan kondisi error

Aturan berikut berlaku saat memproses instruksi compute budget:

• Satu per tipe: hanya satu dari setiap varian instruksi yang diizinkan per transaksi. Menyertakan duplikat menyebabkan error DuplicateInstruction (seluruh transaksi gagal).
• RequestHeapFrame: nilai harus antara MIN_HEAP_FRAME_BYTES (32 KiB) dan MAX_HEAP_FRAME_BYTES (256 KiB), dan harus merupakan kelipatan 1.024. Jika tidak, transaksi gagal dengan InvalidInstructionData. Ukuran heap berlaku untuk setiap program yang dipanggil dalam transaksi (termasuk CPI).
• SetComputeUnitLimit: nilai u32 apa pun diterima. Batas efektif dibatasi hingga MAX_COMPUTE_UNIT_LIMIT (1.400.000).
• SetComputeUnitPrice: nilai u64 apa pun diterima (0 hingga u64::MAX).
• SetLoadedAccountsDataSizeLimit: nilai harus lebih besar dari 0 (NonZeroU32). Nilai 0 menyebabkan InvalidLoadedAccountsDataSizeLimit. Batas efektif dibatasi hingga MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES (64 MiB).
• Data tidak dikenali: instruksi apa pun yang dikirim ke Compute Budget Program yang tidak dapat di-deserialisasi menjadi varian yang dikenal gagal dengan InvalidInstructionData.

Model biaya scheduler

Scheduler validator menggunakan model biaya untuk memperkirakan penggunaan sumber daya transaksi sebelum eksekusi. Estimasi biaya pra-eksekusi ini menentukan apakah suatu transaksi sesuai dengan kapasitas blok yang tersisa. Ini terpisah dari pengukuran CU yang terjadi selama eksekusi.

Total biaya scheduler adalah jumlah dari lima komponen (UsageCostDetails::sum):

total_cost = signature_cost
           + write_lock_cost
           + data_bytes_cost
           + programs_execution_cost
           + loaded_accounts_data_size_cost

Komponen biaya

Semua nilai dalam compute unit.

Konstanta biaya scheduler

Biaya transaksi vote

Transaksi vote menggunakan biaya statis sebesar 3.428 CU terlepas dari konten aktualnya.

Batas blok

Scheduler memberlakukan batas per blok. Jika menambahkan transaksi akan melebihi batas apa pun, transaksi tersebut tidak akan disertakan dalam blok.

Konstanta budget eksekusi

Konstanta berikut dari execution_budget.rs mendefinisikan batas runtime selama eksekusi transaksi: