@aztec/constants 0.0.1-commit.a072138 → 0.0.1-commit.a4600f49

package/dest/constants.js

@@ -2,17 +2,40 @@ import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
 import { Fr } from '@aztec/foundation/curves/bn254';
 // Re-export L2 block number constants with proper BlockNumber type
 // Note: The generated constants are plain numbers, but we provide typed versions here
-import { GENESIS_BLOCK_HEADER_HASH as GENESIS_BLOCK_HEADER_HASH_BIGINT, INITIAL_CHECKPOINT_NUMBER as INITIAL_CHECKPOINT_NUM_RAW, INITIAL_L2_BLOCK_NUM as INITIAL_L2_BLOCK_NUM_RAW } from './constants.gen.js';
+import { DA_GAS_PER_FIELD, GENESIS_BLOCK_HEADER_HASH as GENESIS_BLOCK_HEADER_HASH_BIGINT, INITIAL_CHECKPOINT_NUMBER as INITIAL_CHECKPOINT_NUM_RAW, INITIAL_L2_BLOCK_NUM as INITIAL_L2_BLOCK_NUM_RAW, MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT as MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT_RAW, MAX_TX_BLOB_DATA_SIZE_IN_FIELDS } from './constants.gen.js';
 // Typescript-land-only constants
 export const SPONSORED_FPC_SALT = BigInt(0);
+/**
+ * Network-minimum per-block budget multiplier for L2 gas / tx count. Operators may configure a higher value,
+ * but never lower: a node admitting txs under a smaller multiplier would accept work it can never pack.
+ */ export const MIN_PER_BLOCK_ALLOCATION_MULTIPLIER = 1.2;
+/**
+ * Network-minimum per-block budget multiplier for DA gas / blob fields. See
+ * {@link MIN_PER_BLOCK_ALLOCATION_MULTIPLIER}. The DA-specific operator knob and its runtime enforcement land
+ * with the network tx admission limits (#23947); until then this constant is documentation of the network
+ * minimum only.
+ */ export const MIN_PER_BLOCK_DA_ALLOCATION_MULTIPLIER = 1.5;
+/**
+ * The most DA gas a single tx can consume. A tx's effects cannot encode more than
+ * MAX_TX_BLOB_DATA_SIZE_IN_FIELDS fields in a blob, each costing DA_GAS_PER_FIELD, so this is the maximum
+ * DA gas a tx could ever use; declaring a higher limit is rejected by inbound validation.
+ */ export const MAX_TX_DA_GAS = MAX_TX_BLOB_DATA_SIZE_IN_FIELDS * DA_GAS_PER_FIELD;
 // Autogenerated constants loaded from noir-land
 // eslint-disable-next-line import-x/export
 export * from './constants.gen.js';
-/** The initial L2 block number (typed as BlockNumber). This is the first block number in the Aztec L2 chain. */ // Shadow the export from constants.gen above
-// eslint-disable-next-line import-x/export
+/** The initial L2 block number (typed as BlockNumber). This is the first block number in the Aztec L2 chain. */ // eslint-disable-next-line import-x/export
 export const INITIAL_L2_BLOCK_NUM = BlockNumber(INITIAL_L2_BLOCK_NUM_RAW);
-/** The initial L2 checkpoint number (typed as CheckpointNumber). This is the first checkpoint number in the Aztec L2 chain. */ // Shadow the export from constants.gen above
-export const INITIAL_L2_CHECKPOINT_NUM = CheckpointNumber(INITIAL_CHECKPOINT_NUM_RAW);
-/** The block header hash for the genesis block 0. */ // Shadow the export from constants.gen above
-// eslint-disable-next-line import-x/export
+/** The initial L2 checkpoint number (typed as CheckpointNumber). This is the first checkpoint number in the Aztec L2 chain. */ // eslint-disable-next-line import-x/export
+export const INITIAL_CHECKPOINT_NUMBER = CheckpointNumber(INITIAL_CHECKPOINT_NUM_RAW);
+/** The block header hash for the genesis block 0. */ // eslint-disable-next-line import-x/export
 export const GENESIS_BLOCK_HEADER_HASH = new Fr(GENESIS_BLOCK_HEADER_HASH_BIGINT);
+/**
+ * The RAW DA capacity of a checkpoint's blobs: `BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB * DA_GAS_PER_FIELD`.
+ * This value is NOT attainable by transactions. The blob encoding reserves overhead fields that no tx pays
+ * DA gas for: a checkpoint-end marker field plus per-block block-end fields (7 for the first block in a
+ * checkpoint, 6 for each subsequent block — see `@aztec/blob-lib` encoding). The true tx-usable DA budget
+ * is lower and block-count-dependent; consumers budgeting tx data should subtract the encoding overhead (as
+ * `CheckpointBuilder` and the network tx gas limits in `@aztec/stdlib/gas` do) rather than use this value
+ * directly.
+ */ // eslint-disable-next-line import-x/export
+export const MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT_RAW;

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "@aztec/constants",
-  "version": "0.0.1-commit.a072138",
+  "version": "0.0.1-commit.a4600f49",
   "type": "module",
   "inherits": [
     "../package.common.json"
   ],
+  "typedocOptions": {
+    "entryPoints": [
+      "./src/constants.gen.ts"
+    ],
+    "name": "Constants",
+    "tsconfig": "./tsconfig.json"
+  },
   "exports": {
     ".": "./dest/constants.js"
   },
@@ -12,11 +19,11 @@
     "build": "yarn clean && ../scripts/tsc.sh",
     "build:dev": "../scripts/tsc.sh --watch",
     "clean": "rm -rf ./dest .tsbuildinfo",
-    "remake-constants": "node --loader @swc-node/register/esm src/scripts/constants.in.ts && cd ../../l1-contracts && forge fmt",
+    "generate": "./scripts/remake-constants.sh",
     "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
   },
   "dependencies": {
-    "@aztec/foundation": "0.0.1-commit.a072138",
+    "@aztec/foundation": "0.0.1-commit.a4600f49",
     "tslib": "^2.4.0"
   },
   "devDependencies": {

package/src/constants.gen.ts

@@ -1,4 +1,4 @@
-// GENERATED FILE - DO NOT EDIT, RUN yarn remake-constants
+// GENERATED FILE - DO NOT EDIT
 export const MAX_FIELD_VALUE = 21888242871839275222246405745257275088548364400416034343698204186575808495616n;
 export const MAX_ETH_ADDRESS_BIT_SIZE = 160;
 export const MAX_ETH_ADDRESS_VALUE = 1461501637330902918203684832716283019655932542975n;
@@ -12,7 +12,7 @@ export const NOTE_HASH_TREE_HEIGHT = 42;
 export const PUBLIC_DATA_TREE_HEIGHT = 40;
 export const NULLIFIER_TREE_HEIGHT = 42;
 export const L1_TO_L2_MSG_TREE_HEIGHT = 36;
-export const OUT_HASH_TREE_HEIGHT = 6;
+export const OUT_HASH_TREE_HEIGHT = 5;
 export const ARTIFACT_FUNCTION_TREE_MAX_HEIGHT = 7;
 export const NULLIFIER_TREE_ID = 0;
 export const NOTE_HASH_TREE_ID = 1;
@@ -21,7 +21,7 @@ export const L1_TO_L2_MESSAGE_TREE_ID = 3;
 export const ARCHIVE_TREE_ID = 4;
 export const NOTE_HASH_TREE_LEAF_COUNT = 4398046511104;
 export const L1_TO_L2_MSG_TREE_LEAF_COUNT = 68719476736;
-export const OUT_HASH_TREE_LEAF_COUNT = 64;
+export const OUT_HASH_TREE_LEAF_COUNT = 32;
 export const NOTE_HASH_SUBTREE_HEIGHT = 6;
 export const NULLIFIER_SUBTREE_HEIGHT = 6;
 export const PUBLIC_DATA_SUBTREE_HEIGHT = 6;
@@ -57,8 +57,6 @@ export const MAX_KEY_VALIDATION_REQUESTS_PER_CALL = 16;
 export const NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP = 1024;
 export const PRIVATE_KERNEL_INIT_VK_INDEX = 0;
 export const PRIVATE_KERNEL_INNER_VK_INDEX = 1;
-export const PRIVATE_KERNEL_TAIL_VK_INDEX = 2;
-export const PRIVATE_KERNEL_TAIL_TO_PUBLIC_VK_INDEX = 3;
 export const HIDING_KERNEL_TO_ROLLUP_VK_INDEX = 4;
 export const HIDING_KERNEL_TO_PUBLIC_VK_INDEX = 5;
 export const PUBLIC_CHONK_VERIFIER_VK_INDEX = 6;
@@ -79,6 +77,18 @@ export const ROOT_ROLLUP_VK_INDEX = 20;
 export const PARITY_BASE_VK_INDEX = 21;
 export const PARITY_ROOT_VK_INDEX = 22;
 export const PRIVATE_KERNEL_RESET_VK_INDEX = 23;
+export const PRIVATE_KERNEL_RESET_TAIL_VK_INDEX = 31;
+export const PRIVATE_KERNEL_RESET_TAIL_TO_PUBLIC_VK_INDEX = 37;
+export const PRIVATE_KERNEL_RESET_BLOCK_END = 43;
+export const PRIVATE_KERNEL_INIT_2_VK_INDEX = 65;
+export const PRIVATE_KERNEL_INIT_3_VK_INDEX = 66;
+export const PRIVATE_KERNEL_INIT_4_VK_INDEX = 67;
+export const PRIVATE_KERNEL_INIT_5_VK_INDEX = 68;
+export const PRIVATE_KERNEL_INNER_2_VK_INDEX = 69;
+export const PRIVATE_KERNEL_INNER_3_VK_INDEX = 70;
+export const PRIVATE_KERNEL_INNER_4_VK_INDEX = 71;
+export const PRIVATE_KERNEL_INNER_5_VK_INDEX = 72;
+export const MAX_APPS_PER_KERNEL = 5;
 export const GLOBAL_INDEX_NOTE_HASH_READ_REQUEST_OFFSET = 0;
 export const GLOBAL_INDEX_NULLIFIER_READ_REQUEST_OFFSET = 16;
 export const GLOBAL_INDEX_NOTE_HASH_OFFSET = 32;
@@ -96,31 +106,28 @@ export const INITIAL_CHECKPOINT_NUMBER = 1;
 export const INITIAL_L2_BLOCK_NUM = 1;
 export const FIELDS_PER_BLOB = 4096;
 export const BLOBS_PER_CHECKPOINT = 6;
-export const AZTEC_MAX_EPOCH_DURATION = 48;
-export const MAX_INCLUDE_BY_TIMESTAMP_DURATION = 86400;
-export const GENESIS_BLOCK_HEADER_HASH = 14710079915322740317808687122062173337464078712794912405124797936019536947264n;
-export const GENESIS_ARCHIVE_ROOT = 19669888813533984740577615922349869995342895739385283929087009026587729644092n;
-export const EMPTY_EPOCH_OUT_HASH = 425901435741743301163237390758864716627999612705062243139499504804273333597n;
+export const MAX_CHECKPOINTS_PER_EPOCH = 32;
+export const MAX_TX_LIFETIME = 86400;
+export const GENESIS_BLOCK_HEADER_HASH = 6551417544883665873456328017782433997345264442591862482015827744892259451090n;
+export const GENESIS_ARCHIVE_ROOT = 10619256997260439436842531499967995403253967496480475679746178797053672406517n;
+export const EMPTY_EPOCH_OUT_HASH = 355785372471781095838790036702437931769306153278986832745847530947941691539n;
 export const MAX_PACKED_PUBLIC_BYTECODE_SIZE_IN_FIELDS = 3000;
 export const MAX_PACKED_BYTECODE_SIZE_PER_PRIVATE_FUNCTION_IN_FIELDS = 3000;
 export const MAX_PACKED_BYTECODE_SIZE_PER_UTILITY_FUNCTION_IN_FIELDS = 3000;
 export const CLASS_REGISTRY_PRIVATE_FUNCTION_BROADCASTED_ADDITIONAL_FIELDS = 23;
 export const CLASS_REGISTRY_UTILITY_FUNCTION_BROADCASTED_ADDITIONAL_FIELDS = 14;
-export const CONTRACT_CLASS_PUBLISHED_MAGIC_VALUE = 14149211982683198966415397187677099530590983261208050372085833907509n;
-export const CONTRACT_CLASS_REGISTRY_PRIVATE_FUNCTION_BROADCASTED_MAGIC_VALUE = 2889881020989534926461066592611988634597302675057895885580456197069n;
-export const CONTRACT_CLASS_REGISTRY_UTILITY_FUNCTION_BROADCASTED_MAGIC_VALUE = 24399338136397901754495080759185489776044879232766421623673792970137n;
-export const CONTRACT_INSTANCE_PUBLISHED_MAGIC_VALUE = 19558544958816189742429223939242700295084178455458336806004020892999n;
-export const CONTRACT_INSTANCE_UPDATED_MAGIC_VALUE = 1534834688047131268740281708431107902615560100979874281215533519862n;
+export const CONTRACT_CLASS_PUBLISHED_MAGIC_VALUE = 14907836659448373306373608164128296596488873008270905914742877230397948162628n;
+export const CONTRACT_CLASS_REGISTRY_PRIVATE_FUNCTION_BROADCASTED_MAGIC_VALUE = 6632427679359753950122686582223287785801228472790519808071945107172278003224n;
+export const CONTRACT_CLASS_REGISTRY_UTILITY_FUNCTION_BROADCASTED_MAGIC_VALUE = 2863388930963370662477859081312917957786876946407365497018765359301074232169n;
+export const CONTRACT_INSTANCE_PUBLISHED_MAGIC_VALUE = 10538216027419913765597387738085647348651103543680388181336823392401502757423n;
+export const CONTRACT_INSTANCE_UPDATED_MAGIC_VALUE = 20721543224513346060908370400407150739273836456436647488068002302723900469047n;
 export const MAX_PROTOCOL_CONTRACTS = 11;
-export const CANONICAL_AUTH_REGISTRY_ADDRESS = 1;
+export const CONTRACT_CLASS_REGISTRY_CONTRACT_ADDRESS = 1;
 export const CONTRACT_INSTANCE_REGISTRY_CONTRACT_ADDRESS = 2;
-export const CONTRACT_CLASS_REGISTRY_CONTRACT_ADDRESS = 3;
-export const MULTI_CALL_ENTRYPOINT_ADDRESS = 4;
-export const FEE_JUICE_ADDRESS = 5;
-export const PUBLIC_CHECKS_ADDRESS = 6;
-export const SIDE_EFFECT_MASKING_ADDRESS = 12;
+export const FEE_JUICE_ADDRESS = 3;
+export const SIDE_EFFECT_MASKING_ADDRESS = 19523154334483583633304358390644137470227519736821975910774528428729027989987n;
 export const NULL_MSG_SENDER_CONTRACT_ADDRESS = 21888242871839275222246405745257275088548364400416034343698204186575808495616n;
-export const CONTRACT_CLASS_REGISTRY_BYTECODE_CAPSULE_SLOT = 79025834455612;
+export const CONTRACT_CLASS_REGISTRY_BYTECODE_CAPSULE_SLOT = 14193106819744442689484501689686180698286338820089744102289275815863062044599n;
 export const FEE_JUICE_BALANCES_SLOT = 1;
 export const UPDATED_CLASS_IDS_SLOT = 1;
 export const DEFAULT_NPK_M_X = 582240093077765400562621227108555700500271598878376310175765873770292988861n;
@@ -131,12 +138,21 @@ export const DEFAULT_OVPK_M_X = 122127877196173055705879288602884754543280089552
 export const DEFAULT_OVPK_M_Y = 3646747884782549389807830220601404629716007431341772952958971658285958854707n;
 export const DEFAULT_TPK_M_X = 728059161893070741164607238299536939695876538801885465230641192969135857403n;
 export const DEFAULT_TPK_M_Y = 14575718736702206050102425029229426215631664471161015518982549597389390371695n;
+export const DEFAULT_MSPK_M_X = 376604625977751683916174973150925911104291823095102990065366659597425722296n;
+export const DEFAULT_MSPK_M_Y = 6401736487141786437369922081657103422778081213225821992340733703460199150021n;
+export const DEFAULT_FBPK_M_X = 11572348468544340050763207926758553848489417025671995953147359609999720016266n;
+export const DEFAULT_FBPK_M_Y = 11774107091164614768010125692190151838649080987589360468021169521798921524563n;
+export const DEFAULT_NPK_M_HASH = 9490941203163884203266873379528043162885952552009707050511473783876867365414n;
+export const DEFAULT_OVPK_M_HASH = 6503635668323258394266152634006889881423098283582185344306514598322956522059n;
+export const DEFAULT_TPK_M_HASH = 3696996950890211715833095099359687729113787313245035143274671977290400579312n;
+export const DEFAULT_MSPK_M_HASH = 9339255027081995322829531434846677508514443987752207871815765570767379563350n;
+export const DEFAULT_FBPK_M_HASH = 6817041416194035981444514907304573239615033139388669881213007796289638159510n;
 export const AZTEC_ADDRESS_LENGTH = 1;
 export const GAS_FEES_LENGTH = 2;
 export const GAS_LENGTH = 2;
 export const GAS_SETTINGS_LENGTH = 8;
 export const CALL_CONTEXT_LENGTH = 4;
-export const CONTRACT_INSTANCE_LENGTH = 16;
+export const CONTRACT_INSTANCE_LENGTH = 12;
 export const CONTRACT_STORAGE_READ_LENGTH = 3;
 export const CONTRACT_STORAGE_UPDATE_REQUEST_LENGTH = 3;
 export const ETH_ADDRESS_LENGTH = 1;
@@ -158,16 +174,16 @@ export const L2_TO_L1_MESSAGE_LENGTH = 2;
 export const COUNTED_L2_TO_L1_MESSAGE_LENGTH = 3;
 export const SCOPED_L2_TO_L1_MESSAGE_LENGTH = 3;
 export const SCOPED_COUNTED_L2_TO_L1_MESSAGE_LENGTH = 4;
-export const KEY_VALIDATION_REQUEST_LENGTH = 4;
-export const KEY_VALIDATION_REQUEST_AND_GENERATOR_LENGTH = 5;
-export const SCOPED_KEY_VALIDATION_REQUEST_AND_GENERATOR_LENGTH = 6;
+export const KEY_VALIDATION_REQUEST_LENGTH = 2;
+export const KEY_VALIDATION_REQUEST_AND_GENERATOR_LENGTH = 3;
+export const SCOPED_KEY_VALIDATION_REQUEST_AND_GENERATOR_LENGTH = 4;
 export const PARTIAL_STATE_REFERENCE_LENGTH = 6;
 export const TREE_LEAF_READ_REQUEST_LENGTH = 2;
-export const PRIVATE_LOG_SIZE_IN_FIELDS = 18;
-export const PRIVATE_LOG_LENGTH = 19;
-export const PRIVATE_LOG_DATA_LENGTH = 21;
-export const PRIVATE_LOG_CIPHERTEXT_LEN = 17;
-export const SCOPED_PRIVATE_LOG_DATA_LENGTH = 22;
+export const PRIVATE_LOG_SIZE_IN_FIELDS = 16;
+export const PRIVATE_LOG_LENGTH = 17;
+export const PRIVATE_LOG_DATA_LENGTH = 19;
+export const PRIVATE_LOG_CIPHERTEXT_LEN = 15;
+export const SCOPED_PRIVATE_LOG_DATA_LENGTH = 20;
 export const FLAT_PUBLIC_LOGS_HEADER_LENGTH = 1;
 export const FLAT_PUBLIC_LOGS_PAYLOAD_LENGTH = 4096;
 export const PUBLIC_LOGS_LENGTH = 4097;
@@ -196,50 +212,57 @@ export const TX_REQUEST_LENGTH = 15;
 export const TOTAL_FEES_LENGTH = 1;
 export const TOTAL_MANA_USED_LENGTH = 1;
 export const BLOCK_HEADER_LENGTH = 22;
-export const CHECKPOINT_HEADER_LENGTH = 12;
-export const CHECKPOINT_HEADER_SIZE_IN_BYTES = 316;
+export const CHECKPOINT_HEADER_LENGTH = 13;
+export const CHECKPOINT_HEADER_SIZE_IN_BYTES = 348;
 export const SCOPED_READ_REQUEST_LEN = 3;
-export const PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 902;
-export const PRIVATE_CONTEXT_INPUTS_LENGTH = 37;
+export const PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 839;
+export const PRIVATE_CONTEXT_INPUTS_LENGTH = 38;
 export const FEE_RECIPIENT_LENGTH = 2;
-export const HIDING_KERNEL_IO_PUBLIC_INPUTS_SIZE = 56;
-export const PAIRING_POINTS_SIZE = 16;
-export const IPA_CLAIM_SIZE = 10;
+export const HIDING_KERNEL_IO_PUBLIC_INPUTS_SIZE = 28;
+export const PAIRING_POINTS_SIZE = 8;
+export const IPA_CLAIM_SIZE = 6;
 export const PUBLIC_DATA_READ_LENGTH = 3;
-export const PRIVATE_VALIDATION_REQUESTS_LENGTH = 771;
-export const PRIVATE_TO_ROLLUP_ACCUMULATED_DATA_LENGTH = 1371;
+export const PRIVATE_VALIDATION_REQUESTS_LENGTH = 643;
+export const PRIVATE_TO_ROLLUP_ACCUMULATED_DATA_LENGTH = 1243;
 export const TX_CONSTANT_DATA_LENGTH = 34;
 export const COMBINED_CONSTANT_DATA_LENGTH = 43;
-export const PRIVATE_ACCUMULATED_DATA_LENGTH = 2187;
-export const PRIVATE_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 3001;
-export const PRIVATE_TO_PUBLIC_ACCUMULATED_DATA_LENGTH = 1499;
+export const PRIVATE_ACCUMULATED_DATA_LENGTH = 2059;
+export const PRIVATE_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 2745;
+export const PRIVATE_TO_PUBLIC_ACCUMULATED_DATA_LENGTH = 1371;
 export const PRIVATE_TO_AVM_ACCUMULATED_DATA_LENGTH = 152;
 export const NUM_PRIVATE_TO_AVM_ACCUMULATED_DATA_ARRAYS = 3;
 export const NUM_AVM_ACCUMULATED_DATA_ARRAYS = 4;
 export const NUM_PUBLIC_CALL_REQUEST_ARRAYS = 3;
 export const AVM_ACCUMULATED_DATA_LENGTH = 4377;
-export const PRIVATE_TO_PUBLIC_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 3040;
-export const PRIVATE_TO_ROLLUP_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 1409;
+export const PRIVATE_TO_PUBLIC_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 2784;
+export const PRIVATE_TO_ROLLUP_KERNEL_CIRCUIT_PUBLIC_INPUTS_LENGTH = 1281;
 export const AVM_CIRCUIT_PUBLIC_INPUTS_LENGTH = 5008;
 export const BLOCK_CONSTANT_DATA_LENGTH = 16;
 export const CHECKPOINT_CONSTANT_DATA_LENGTH = 10;
 export const EPOCH_CONSTANT_DATA_LENGTH = 5;
 export const TX_ROLLUP_PUBLIC_INPUTS_LENGTH = 52;
 export const BLOCK_ROLLUP_PUBLIC_INPUTS_LENGTH = 56;
-export const CHECKPOINT_ROLLUP_PUBLIC_INPUTS_LENGTH = 197;
-export const ROOT_ROLLUP_PUBLIC_INPUTS_LENGTH = 159;
+export const CHECKPOINT_ROLLUP_PUBLIC_INPUTS_LENGTH = 149;
+export const ROOT_ROLLUP_PUBLIC_INPUTS_LENGTH = 111;
 export const NUM_MSGS_PER_BASE_PARITY = 256;
 export const NUM_BASE_PARITY_PER_ROOT_PARITY = 4;
-export const RECURSIVE_PROOF_LENGTH = 457;
-export const NESTED_RECURSIVE_PROOF_LENGTH = 457;
+export const RECURSIVE_PROOF_LENGTH = 410;
+export const NESTED_RECURSIVE_PROOF_LENGTH = 410;
 export const IPA_PROOF_LENGTH = 64;
-export const ULTRA_KECCAK_PROOF_LENGTH = 339;
-export const RECURSIVE_ROLLUP_HONK_PROOF_LENGTH = 531;
-export const NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH = 531;
-export const CHONK_PROOF_LENGTH = 1963;
+export const ULTRA_KECCAK_PROOF_LENGTH = 331;
+export const RECURSIVE_ROLLUP_HONK_PROOF_LENGTH = 480;
+export const NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH = 480;
+export const CHONK_HIDING_OINK_LENGTH = 48;
+export const CHONK_MERGE_PROOF_SIZE = 41;
+export const CHONK_ECCVM_PROOF_LENGTH = 556;
+export const CHONK_TRIPLE_IPA_PROOF_LENGTH = 70;
+export const CHONK_JOINT_PROOF_LENGTH = 478;
+export const CHONK_PROOF_LENGTH = 1221;
 export const ULTRA_VK_LENGTH_IN_FIELDS = 115;
-export const MEGA_VK_LENGTH_IN_FIELDS = 127;
-export const CHONK_VK_LENGTH_IN_FIELDS = 127;
+export const MEGA_APP_VK_LENGTH_IN_FIELDS = 151;
+export const MEGA_KERNEL_VK_LENGTH_IN_FIELDS = 151;
+export const MEGA_ZK_VK_LENGTH_IN_FIELDS = 119;
+export const CHONK_VK_LENGTH_IN_FIELDS = 119;
 export const AVM_VERIFICATION_KEY_LENGTH_IN_FIELDS = 86;
 export const MAX_PUBLIC_BYTECODE_SIZE_IN_BYTES = 96000;
 export const MAX_PUBLIC_CALLS_TO_UNIQUE_CONTRACT_CLASS_IDS = 21;
@@ -253,9 +276,9 @@ export const MEM_TAG_U128 = 6;
 export const AVM_HIGHEST_MEM_ADDRESS = 4294967295;
 export const AVM_MEMORY_NUM_BITS = 32;
 export const AVM_MEMORY_SIZE = 4294967296;
-export const AVM_BITWISE_AND_OP_ID = 0;
-export const AVM_BITWISE_OR_OP_ID = 1;
-export const AVM_BITWISE_XOR_OP_ID = 2;
+export const AVM_BITWISE_AND_OP_ID = 1;
+export const AVM_BITWISE_OR_OP_ID = 2;
+export const AVM_BITWISE_XOR_OP_ID = 4;
 export const AVM_KECCAKF1600_NUM_ROUNDS = 24;
 export const AVM_KECCAKF1600_STATE_SIZE = 25;
 export const AVM_TX_PHASE_VALUE_START = 0;
@@ -269,7 +292,7 @@ export const AVM_SUBTRACE_ID_CALLDATA_COPY = 16;
 export const AVM_SUBTRACE_ID_RETURNDATA_COPY = 32;
 export const AVM_SUBTRACE_ID_SET = 64;
 export const AVM_SUBTRACE_ID_GETCONTRACTINSTANCE = 128;
-export const AVM_SUBTRACE_ID_EMITUNENCRYPTEDLOG = 256;
+export const AVM_SUBTRACE_ID_EMITPUBLICLOG = 256;
 export const AVM_SUBTRACE_ID_POSEIDON2_PERM = 512;
 export const AVM_SUBTRACE_ID_SHA256_COMPRESSION = 1024;
 export const AVM_SUBTRACE_ID_KECCAKF1600 = 2048;
@@ -278,9 +301,8 @@ export const AVM_SUBTRACE_ID_TO_RADIX = 8192;
 export const AVM_DYN_GAS_ID_CALLDATACOPY = 1;
 export const AVM_DYN_GAS_ID_RETURNDATACOPY = 2;
 export const AVM_DYN_GAS_ID_TORADIX = 4;
-export const AVM_DYN_GAS_ID_BITWISE = 8;
-export const AVM_DYN_GAS_ID_EMITUNENCRYPTEDLOG = 16;
-export const AVM_DYN_GAS_ID_SSTORE = 32;
+export const AVM_DYN_GAS_ID_EMITPUBLICLOG = 8;
+export const AVM_DYN_GAS_ID_SSTORE = 16;
 export const AVM_EXEC_OP_ID_GETENVVAR = 1;
 export const AVM_EXEC_OP_ID_MOV = 2;
 export const AVM_EXEC_OP_ID_JUMP = 4;
@@ -382,36 +404,34 @@ export const AVM_PUBLIC_INPUTS_TRANSACTION_FEE_ROW_IDX = 4683;
 export const AVM_PUBLIC_INPUTS_REVERTED_ROW_IDX = 4684;
 export const AVM_PUBLIC_INPUTS_COLUMNS_MAX_LENGTH = 4685;
 export const AVM_NUM_PUBLIC_INPUT_COLUMNS = 4;
-export const AVM_PUBLIC_INPUTS_COLUMNS_COMBINED_LENGTH = 18740;
-export const AVM_V2_PROOF_LENGTH_IN_FIELDS_PADDED = 16200;
-export const AVM_V2_VERIFICATION_KEY_LENGTH_IN_FIELDS_PADDED = 1000;
-export const AVM_MAX_PROCESSABLE_L2_GAS = 6000000;
+export const AVM_PUBLIC_INPUTS_COLUMN_0_LENGTH = 4685;
+export const AVM_PUBLIC_INPUTS_COLUMN_1_LENGTH = 4683;
+export const AVM_PUBLIC_INPUTS_COLUMN_2_LENGTH = 522;
+export const AVM_PUBLIC_INPUTS_COLUMN_3_LENGTH = 99;
+export const AVM_PUBLIC_INPUTS_COLUMNS_COMBINED_LENGTH = 9989;
+export const AVM_V2_PROOF_LENGTH_IN_FIELDS = 14532;
 export const DA_BYTES_PER_FIELD = 32;
-export const DA_GAS_PER_BYTE = 16;
-export const FIXED_DA_GAS = 512;
-export const FIXED_L2_GAS = 512;
+export const DA_GAS_PER_BYTE = 1;
+export const DA_GAS_PER_FIELD = 32;
+export const TX_DA_GAS_OVERHEAD = 96;
+export const PUBLIC_TX_L2_GAS_OVERHEAD = 540000;
+export const PRIVATE_TX_L2_GAS_OVERHEAD = 440000;
 export const FIXED_AVM_STARTUP_L2_GAS = 20000;
-export const MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT = 12582912;
-export const GAS_ESTIMATION_TEARDOWN_L2_GAS_LIMIT = 6000000;
-export const GAS_ESTIMATION_L2_GAS_LIMIT = 12000000;
-export const GAS_ESTIMATION_TEARDOWN_DA_GAS_LIMIT = 12582912;
-export const GAS_ESTIMATION_DA_GAS_LIMIT = 25165824;
-export const DEFAULT_TEARDOWN_L2_GAS_LIMIT = 1000000;
-export const DEFAULT_L2_GAS_LIMIT = 6000000;
-export const DEFAULT_TEARDOWN_DA_GAS_LIMIT = 1000000;
-export const DEFAULT_DA_GAS_LIMIT = 12582912;
+export const AVM_MAX_PROCESSABLE_L2_GAS = 6000000;
+export const MAX_PROCESSABLE_L2_GAS = 6540000;
+export const MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT = 786432;
 export const L2_GAS_DISTRIBUTED_STORAGE_PREMIUM = 1024;
 export const AVM_PC_SIZE_IN_BITS = 32;
-export const AVM_MAX_OPERANDS = 7;
-export const AVM_MAX_REGISTERS = 6;
+export const AVM_MAX_OPERANDS = 5;
+export const AVM_MAX_REGISTERS = 4;
 export const AVM_ADDRESSING_BASE_RESOLUTION_L2_GAS = 3;
 export const AVM_ADDRESSING_INDIRECT_L2_GAS = 3;
 export const AVM_ADDRESSING_RELATIVE_L2_GAS = 3;
-export const L2_GAS_PER_NOTE_HASH = 0;
-export const L2_GAS_PER_NULLIFIER = 0;
-export const L2_GAS_PER_L2_TO_L1_MSG = 200;
-export const L2_GAS_PER_PRIVATE_LOG = 0;
-export const L2_GAS_PER_CONTRACT_CLASS_LOG = 0;
+export const L2_GAS_PER_NOTE_HASH = 9200;
+export const L2_GAS_PER_NULLIFIER = 16000;
+export const L2_GAS_PER_L2_TO_L1_MSG = 5200;
+export const L2_GAS_PER_PRIVATE_LOG = 2500;
+export const L2_GAS_PER_CONTRACT_CLASS_LOG = 73000;
 export const AVM_ADD_BASE_L2_GAS = 12;
 export const AVM_SUB_BASE_L2_GAS = 12;
 export const AVM_MUL_BASE_L2_GAS = 27;
@@ -446,8 +466,8 @@ export const AVM_NULLIFIEREXISTS_BASE_L2_GAS = 903;
 export const AVM_EMITNULLIFIER_BASE_L2_GAS = 30800;
 export const AVM_L1TOL2MSGEXISTS_BASE_L2_GAS = 540;
 export const AVM_GETCONTRACTINSTANCE_BASE_L2_GAS = 6108;
-export const AVM_EMITUNENCRYPTEDLOG_BASE_L2_GAS = 15;
-export const AVM_SENDL2TOL1MSG_BASE_L2_GAS = 478;
+export const AVM_EMITPUBLICLOG_BASE_L2_GAS = 15;
+export const AVM_SENDL2TOL1MSG_BASE_L2_GAS = 5239;
 export const AVM_CALL_BASE_L2_GAS = 9936;
 export const AVM_STATICCALL_BASE_L2_GAS = 9936;
 export const AVM_RETURN_BASE_L2_GAS = 9;
@@ -456,23 +476,21 @@ export const AVM_DEBUGLOG_BASE_L2_GAS = 9;
 export const AVM_POSEIDON2_BASE_L2_GAS = 360;
 export const AVM_SHA256COMPRESSION_BASE_L2_GAS = 12288;
 export const AVM_KECCAKF1600_BASE_L2_GAS = 58176;
-export const AVM_ECADD_BASE_L2_GAS = 270;
+export const AVM_ECADD_BASE_L2_GAS = 180;
 export const AVM_TORADIXBE_BASE_L2_GAS = 24;
-export const AVM_CALLDATACOPY_DYN_L2_GAS = 3;
-export const AVM_RETURNDATACOPY_DYN_L2_GAS = 3;
+export const AVM_CALLDATACOPY_DYN_L2_GAS = 6;
+export const AVM_RETURNDATACOPY_DYN_L2_GAS = 6;
 export const AVM_TORADIXBE_DYN_L2_GAS = 3;
-export const AVM_BITWISE_DYN_L2_GAS = 3;
-export const AVM_EMITUNENCRYPTEDLOG_DYN_L2_GAS = 3;
-export const AVM_EMITNOTEHASH_BASE_DA_GAS = 512;
-export const AVM_EMITNULLIFIER_BASE_DA_GAS = 512;
-export const AVM_SENDL2TOL1MSG_BASE_DA_GAS = 512;
-export const AVM_EMITUNENCRYPTEDLOG_BASE_DA_GAS = 1024;
-export const AVM_EMITUNENCRYPTEDLOG_DYN_DA_GAS = 512;
-export const AVM_SSTORE_DYN_DA_GAS = 1024;
-export const TX_START_PREFIX = 8392562855083340404n;
-export const TX_START_PREFIX_BIT_SIZE = 64;
-export const BLOCK_END_PREFIX = 1815594492414860291684n;
-export const CHECKPOINT_END_PREFIX = 2016229657840014237853300314959460n;
+export const AVM_EMITPUBLICLOG_DYN_L2_GAS = 3;
+export const AVM_EMITNOTEHASH_BASE_DA_GAS = 32;
+export const AVM_EMITNULLIFIER_BASE_DA_GAS = 32;
+export const AVM_SENDL2TOL1MSG_BASE_DA_GAS = 32;
+export const AVM_EMITPUBLICLOG_BASE_DA_GAS = 64;
+export const AVM_EMITPUBLICLOG_DYN_DA_GAS = 32;
+export const AVM_SSTORE_DYN_DA_GAS = 64;
+export const TX_START_PREFIX = 2624615704;
+export const BLOCK_END_PREFIX = 3951939007;
+export const CHECKPOINT_END_PREFIX = 2355328067;
 export const PROOF_TYPE_HONK = 0;
 export const PROOF_TYPE_OINK = 1;
 export const PROOF_TYPE_HN = 2;
@@ -480,14 +498,13 @@ export const PROOF_TYPE_AVM = 3;
 export const PROOF_TYPE_ROLLUP_HONK = 4;
 export const PROOF_TYPE_ROOT_ROLLUP_HONK = 5;
 export const PROOF_TYPE_HN_FINAL = 7;
-export const PROOF_TYPE_HN_TAIL = 8;
-export const PROOF_TYPE_CHONK = 9;
+export const PROOF_TYPE_CHONK = 8;
 export const TWO_POW_64 = 18446744073709551616n;
 export const AVM_WRITTEN_PUBLIC_DATA_SLOTS_TREE_HEIGHT = 6;
-export const AVM_WRITTEN_PUBLIC_DATA_SLOTS_TREE_INITIAL_ROOT = 18291678969210913367302010540259942201271604198321103848479209155223586227821n;
+export const AVM_WRITTEN_PUBLIC_DATA_SLOTS_TREE_INITIAL_ROOT = 8857725174171741160013581538021104168730942281584695363072221389187184558934n;
 export const AVM_WRITTEN_PUBLIC_DATA_SLOTS_TREE_INITIAL_SIZE = 1;
 export const AVM_RETRIEVED_BYTECODES_TREE_HEIGHT = 5;
-export const AVM_RETRIEVED_BYTECODES_TREE_INITIAL_ROOT = 7257575663883662864904159007845791361042428565864275462740313586853981161757n;
+export const AVM_RETRIEVED_BYTECODES_TREE_INITIAL_ROOT = 7219963955978612430652135562469971022121082503142071142433583613738272177170n;
 export const AVM_RETRIEVED_BYTECODES_TREE_INITIAL_SIZE = 1;
 export const TIMESTAMP_OF_CHANGE_BIT_SIZE = 32;
 export const DEFAULT_UPDATE_DELAY = 86400;
@@ -501,44 +518,73 @@ export const UPDATES_DELAYED_PUBLIC_MUTABLE_METADATA_BIT_SIZE = 144;
 export const GRUMPKIN_ONE_X = 1;
 export const GRUMPKIN_ONE_Y = 17631683881184975370165255887551781615748388533673675138860n;
 export const DEFAULT_MAX_DEBUG_LOG_MEMORY_READS = 125000;
-export enum GeneratorIndex {
-  NOTE_HASH = 570261536,
-  NOTE_HASH_NONCE = 4040695053,
-  UNIQUE_NOTE_HASH = 1615905817,
-  SILOED_NOTE_HASH = 3552985968,
-  NOTE_NULLIFIER = 2273326939,
-  MESSAGE_NULLIFIER = 4179235419,
-  SILOED_NULLIFIER = 1843769845,
-  PRIVATE_LOG_FIRST_FIELD = 3381826258,
-  PUBLIC_LEAF_SLOT = 2853865602,
-  PUBLIC_STORAGE_MAP_SLOT = 1106049611,
-  PRIVATE_FUNCTION_LEAF = 3274445394,
-  PUBLIC_BYTECODE = 4245021897,
-  CONTRACT_CLASS_ID = 1134959961,
-  INITIALIZER = 3165476885,
-  NHK_M = 3431122223,
-  IVSK_M = 3641144584,
-  OVSK_M = 449371170,
-  TSK_M = 4031170476,
-  PUBLIC_KEYS_HASH = 349301051,
-  PARTIAL_ADDRESS = 1453969891,
-  CONTRACT_ADDRESS_V1 = 2091531360,
-  BLOCK_HEADER_HASH = 2064783670,
-  TX_REQUEST = 1076396939,
-  PUBLIC_TX_HASH = 419169672,
-  PRIVATE_TX_HASH = 4261301885,
-  PUBLIC_CALLDATA = 388853507,
-  FUNCTION_ARGS = 587126185,
-  PROTOCOL_CONTRACTS = 3581307760,
-  EVENT_COMMITMENT = 469373807,
-  AUTHWIT_INNER = 829479065,
-  AUTHWIT_OUTER = 1502324539,
-  AUTHWIT_NULLIFIER = 1450992171,
-  SYMMETRIC_KEY = 690840336,
-  SYMMETRIC_KEY_2 = 3484314061,
-  PARTIAL_NOTE_VALIDITY_COMMITMENT = 1665410974,
-  INITIALIZATION_NULLIFIER = 2762319966,
-  SECRET_HASH = 15484084,
-  TX_NULLIFIER = 1039603495,
-  SIGNATURE_PAYLOAD = 2407104296,
+export const MAX_TX_BLOB_DATA_SIZE_IN_FIELDS = 8475;
+export enum DomainSeparator {
+  NOTE_HASH = 116501019,
+  PARTIAL_NOTE_COMMITMENT = 568912195,
+  SILOED_NOTE_HASH = 3361878420,
+  UNIQUE_NOTE_HASH = 226850429,
+  NOTE_HASH_NONCE = 1721808740,
+  SINGLE_USE_CLAIM_NULLIFIER = 1465998995,
+  NOTE_NULLIFIER = 50789342,
+  SILOED_NULLIFIER = 57496191,
+  MESSAGE_NULLIFIER = 3754509616,
+  EVENT_LOG_TAG = 926040838,
+  NOTE_COMPLETION_LOG_TAG = 3372669888,
+  UNCONSTRAINED_MSG_LOG_TAG = 1485357192,
+  CONSTRAINED_MSG_LOG_TAG = 3715244738,
+  CONSTRAINED_MSG_NULLIFIER = 3723577546,
+  CONSTRAINED_MSG_SENDER_SECRET = 1182889476,
+  NON_INTERACTIVE_HANDSHAKE_LOG_TAG = 4046403018,
+  INTERACTIVE_HANDSHAKE_SIGNATURE = 3098455647,
+  PRIVATE_LOG_FIRST_FIELD = 2769976252,
+  PUBLIC_LEAF_SLOT = 1247650290,
+  PUBLIC_STORAGE_MAP_SLOT = 4015149901,
+  MERKLE_HASH = 2982624097,
+  NULLIFIER_MERKLE = 1157584160,
+  PUBLIC_DATA_MERKLE = 3756303423,
+  WRITTEN_SLOTS_MERKLE = 2292766212,
+  RETRIEVED_BYTECODES_MERKLE = 2789215184,
+  PRIVATE_FUNCTION_LEAF = 1389398688,
+  PUBLIC_BYTECODE = 260313585,
+  CONTRACT_CLASS_ID = 3923495515,
+  SALTED_INITIALIZATION_HASH = 2763052992,
+  INITIALIZER = 385396519,
+  NHK_M = 242137788,
+  IVSK_M = 2747825907,
+  OVSK_M = 4272201051,
+  TSK_M = 1546190975,
+  MSSK_M = 617962565,
+  FBSK_M = 787738027,
+  PUBLIC_KEYS_HASH = 777457226,
+  SINGLE_PUBLIC_KEY_HASH = 3452068255,
+  PARTIAL_ADDRESS = 2103633018,
+  CONTRACT_ADDRESS_V2 = 4099338721,
+  BLOCK_HEADER_HASH = 4195546849,
+  TX_REQUEST = 3763737512,
+  PUBLIC_TX_HASH = 1630108851,
+  PRIVATE_TX_HASH = 1971680439,
+  PUBLIC_CALLDATA = 2760353947,
+  FUNCTION_ARGS = 3576554347,
+  PROTOCOL_CONTRACTS = 3904434327,
+  EVENT_COMMITMENT = 2517418573,
+  AUTHWIT_INNER = 221354163,
+  AUTHWIT_OUTER = 3283595782,
+  AUTHWIT_NULLIFIER = 1239150694,
+  APP_SILOED_ECDH_SHARED_SECRET = 1707851664,
+  ECDH_SUBKEY = 4277646631,
+  ECDH_FIELD_MASK = 190532684,
+  PARTIAL_NOTE_VALIDITY_COMMITMENT = 623934423,
+  INITIALIZATION_NULLIFIER = 1653084894,
+  PUBLIC_INITIALIZATION_NULLIFIER = 3342006647,
+  PRIVATE_INITIALIZATION_NULLIFIER = 3990889078,
+  SECRET_HASH = 4199652938,
+  TX_NULLIFIER = 1025801951,
+  SIGNATURE_PAYLOAD = 463525807,
+  BLOCK_HEADERS_HASH = 515582467,
+  BLOB_HASHED_Y_LIMBS = 2949331415,
+  BLOB_CHALLENGE_Z = 60345710,
+  BLOB_Z_ACC = 1003392952,
+  BLOB_GAMMA_ACC = 855632775,
+  BLOB_GAMMA_FINAL = 1755883835,
 }

package/src/constants.ts

@@ -4,29 +4,62 @@ import { Fr } from '@aztec/foundation/curves/bn254';
 // Re-export L2 block number constants with proper BlockNumber type
 // Note: The generated constants are plain numbers, but we provide typed versions here
 import {
+  DA_GAS_PER_FIELD,
   GENESIS_BLOCK_HEADER_HASH as GENESIS_BLOCK_HEADER_HASH_BIGINT,
   INITIAL_CHECKPOINT_NUMBER as INITIAL_CHECKPOINT_NUM_RAW,
   INITIAL_L2_BLOCK_NUM as INITIAL_L2_BLOCK_NUM_RAW,
+  MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT as MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT_RAW,
+  MAX_TX_BLOB_DATA_SIZE_IN_FIELDS,
 } from './constants.gen.js';
 
 // Typescript-land-only constants
 export const SPONSORED_FPC_SALT = BigInt(0);
 
+/**
+ * Network-minimum per-block budget multiplier for L2 gas / tx count. Operators may configure a higher value,
+ * but never lower: a node admitting txs under a smaller multiplier would accept work it can never pack.
+ */
+export const MIN_PER_BLOCK_ALLOCATION_MULTIPLIER = 1.2;
+
+/**
+ * Network-minimum per-block budget multiplier for DA gas / blob fields. See
+ * {@link MIN_PER_BLOCK_ALLOCATION_MULTIPLIER}. The DA-specific operator knob and its runtime enforcement land
+ * with the network tx admission limits (#23947); until then this constant is documentation of the network
+ * minimum only.
+ */
+export const MIN_PER_BLOCK_DA_ALLOCATION_MULTIPLIER = 1.5;
+
+/**
+ * The most DA gas a single tx can consume. A tx's effects cannot encode more than
+ * MAX_TX_BLOB_DATA_SIZE_IN_FIELDS fields in a blob, each costing DA_GAS_PER_FIELD, so this is the maximum
+ * DA gas a tx could ever use; declaring a higher limit is rejected by inbound validation.
+ */
+export const MAX_TX_DA_GAS = MAX_TX_BLOB_DATA_SIZE_IN_FIELDS * DA_GAS_PER_FIELD;
+
 // Autogenerated constants loaded from noir-land
 // eslint-disable-next-line import-x/export
 export * from './constants.gen.js';
 
 /** The initial L2 block number (typed as BlockNumber). This is the first block number in the Aztec L2 chain. */
-// Shadow the export from constants.gen above
 // eslint-disable-next-line import-x/export
 export const INITIAL_L2_BLOCK_NUM: BlockNumber = BlockNumber(INITIAL_L2_BLOCK_NUM_RAW);
 
 /** The initial L2 checkpoint number (typed as CheckpointNumber). This is the first checkpoint number in the Aztec L2 chain. */
-// Shadow the export from constants.gen above
-
-export const INITIAL_L2_CHECKPOINT_NUM: CheckpointNumber = CheckpointNumber(INITIAL_CHECKPOINT_NUM_RAW);
+// eslint-disable-next-line import-x/export
+export const INITIAL_CHECKPOINT_NUMBER: CheckpointNumber = CheckpointNumber(INITIAL_CHECKPOINT_NUM_RAW);
 
 /** The block header hash for the genesis block 0. */
-// Shadow the export from constants.gen above
 // eslint-disable-next-line import-x/export
 export const GENESIS_BLOCK_HEADER_HASH = new Fr(GENESIS_BLOCK_HEADER_HASH_BIGINT);
+
+/**
+ * The RAW DA capacity of a checkpoint's blobs: `BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB * DA_GAS_PER_FIELD`.
+ * This value is NOT attainable by transactions. The blob encoding reserves overhead fields that no tx pays
+ * DA gas for: a checkpoint-end marker field plus per-block block-end fields (7 for the first block in a
+ * checkpoint, 6 for each subsequent block — see `@aztec/blob-lib` encoding). The true tx-usable DA budget
+ * is lower and block-count-dependent; consumers budgeting tx data should subtract the encoding overhead (as
+ * `CheckpointBuilder` and the network tx gas limits in `@aztec/stdlib/gas` do) rather than use this value
+ * directly.
+ */
+// eslint-disable-next-line import-x/export
+export const MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT = MAX_PROCESSABLE_DA_GAS_PER_CHECKPOINT_RAW;