miden_protocol/constants.rs
1use miden_processor::ExecutionOptions;
2
3/// Depth of the account database tree.
4pub const ACCOUNT_TREE_DEPTH: u8 = 64;
5
6/// The maximum allowed size of an account update is 256 KiB.
7pub const ACCOUNT_UPDATE_MAX_SIZE: u32 = 2u32.pow(18);
8
9/// The maximum number of assets that can be stored in a single note.
10pub const MAX_ASSETS_PER_NOTE: usize = 255;
11
12/// The maximum number of inputs that can accompany a single note.
13///
14/// The value is set to 1024 so that it is evenly divisible by 8.
15pub const MAX_INPUTS_PER_NOTE: usize = 1024;
16
17/// The maximum number of notes that can be consumed by a single transaction.
18pub const MAX_INPUT_NOTES_PER_TX: usize = 1024;
19
20/// The maximum number of new notes created by a single transaction.
21pub const MAX_OUTPUT_NOTES_PER_TX: usize = MAX_INPUT_NOTES_PER_TX;
22
23/// The minimum proof security level used by the Miden prover & verifier.
24pub const MIN_PROOF_SECURITY_LEVEL: u32 = 96;
25
26/// The maximum number of VM cycles a transaction is allowed to take.
27pub const MAX_TX_EXECUTION_CYCLES: u32 = ExecutionOptions::MAX_CYCLES;
28
29/// The minimum number of VM cycles a transaction needs to execute.
30pub const MIN_TX_EXECUTION_CYCLES: u32 = 1 << 12;
31
32/// Maximum number of the foreign accounts that can be loaded.
33pub const MAX_NUM_FOREIGN_ACCOUNTS: u8 = 64;
34
35// TRANSACTION BATCH
36// ================================================================================================
37
38/// The depth of the Sparse Merkle Tree used to store output notes in a single batch.
39pub const BATCH_NOTE_TREE_DEPTH: u8 = 10;
40
41/// The maximum number of notes that can be created in a single batch.
42pub const MAX_OUTPUT_NOTES_PER_BATCH: usize = 1 << BATCH_NOTE_TREE_DEPTH;
43const _: () = assert!(MAX_OUTPUT_NOTES_PER_BATCH >= MAX_OUTPUT_NOTES_PER_TX);
44
45/// The maximum number of input notes that can be consumed in a single batch.
46pub const MAX_INPUT_NOTES_PER_BATCH: usize = MAX_OUTPUT_NOTES_PER_BATCH;
47const _: () = assert!(MAX_INPUT_NOTES_PER_BATCH >= MAX_INPUT_NOTES_PER_TX);
48
49/// The maximum number of accounts that can be updated in a single batch.
50pub const MAX_ACCOUNTS_PER_BATCH: usize = 1024;
51
52// BLOCK
53// ================================================================================================
54
55/// The final depth of the Sparse Merkle Tree used to store all notes created in a block.
56pub const BLOCK_NOTE_TREE_DEPTH: u8 = 16;
57
58/// Maximum number of batches that can be inserted into a single block.
59pub const MAX_BATCHES_PER_BLOCK: usize = 1 << (BLOCK_NOTE_TREE_DEPTH - BATCH_NOTE_TREE_DEPTH);
60
61/// Maximum number of output notes that can be created in a single block.
62pub const MAX_OUTPUT_NOTES_PER_BLOCK: usize = MAX_OUTPUT_NOTES_PER_BATCH * MAX_BATCHES_PER_BLOCK;
63const _: () = assert!(MAX_OUTPUT_NOTES_PER_BLOCK >= MAX_OUTPUT_NOTES_PER_BATCH);
64
65/// Maximum number of input notes that can be consumed in a single block.
66pub const MAX_INPUT_NOTES_PER_BLOCK: usize = MAX_OUTPUT_NOTES_PER_BLOCK;
67
68/// The maximum number of accounts that can be updated in a single block.
69pub const MAX_ACCOUNTS_PER_BLOCK: usize = MAX_ACCOUNTS_PER_BATCH * MAX_BATCHES_PER_BLOCK;
70const _: () = assert!(MAX_ACCOUNTS_PER_BLOCK >= MAX_ACCOUNTS_PER_BATCH);
71const _: () = assert!(MAX_ACCOUNTS_PER_BLOCK >= MAX_BATCHES_PER_BLOCK);