feat: Interop fees (#1911)

# What ❔

This is a sister PR to
matter-labs/zksync-era#4612

[WIP], to be filled
<!-- What are the changes this PR brings about? -->
<!-- Example: This PR adds a PR template to the repo. -->
<!-- (For bigger PRs adding more context is appreciated) -->

## Why ❔

<!-- Why are these changes done? What goal do they contribute to? What
are the principles behind them? -->
<!-- Example: PR templates ensure PR reviewers, observers, and future
iterators are in context about the evolution of repos. -->

## Checklist

<!-- Check your PR fulfills the following items. -->
<!-- For draft PRs check the boxes as you complete them. -->

- [ ] PR title corresponds to the body of PR (we generate changelog
entries from PRs).
- [ ] Tests for the changes have been added / updated.
- [ ] Documentation comments have been added / updated.

---------

Signed-off-by: Danil <deniallugo@gmail.com>
Co-authored-by: zkzoomer <sergio@zkzoomer.io>
Co-authored-by: Danil <deniallugo@gmail.com>
Co-authored-by: Marcin M <128217157+mm-zk@users.noreply.github.com>
Co-authored-by: Raid Ateir <ateirraid@gmail.com>
Co-authored-by: Raid5594 <52794079+Raid5594@users.noreply.github.com>
Co-authored-by: Vladislav Volosnikov <vladyan18@gmail.com>
Co-authored-by: EmilLuta <evl@matterlabs.dev>
Co-authored-by: EmilLuta <EmilLuta@users.noreply.github.com>
Co-authored-by: AntonD3 <74021421+AntonD3@users.noreply.github.com>
Co-authored-by: Stanislav Bezkorovainyi <stanislavbezkor@gmail.com>
Co-authored-by: kelemeno <kl@matterlabs.dev>
Co-authored-by: kelemeno <34402761+kelemeno@users.noreply.github.com>
Co-authored-by: mm <mm@matterlabs.dev>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Alexander Melnikov <sanekmelnikov@gmail.com>
Co-authored-by: nikitastupin-matterlabs <178824211+nikitastupin-matterlabs@users.noreply.github.com>
Co-authored-by: Anton Baliasnikov <aba@matterlabs.dev>
Co-authored-by: zksync[bot] <zksync[bot]@users.noreply.github.com>

Author: 15 people

.markdownlintignore

@@ -1,10 +1,10 @@
 # root
 node_modules
+CLAUDE.md
+AGENTS.md
 
 # l1-contracts
 l1-contracts/node_modules
-l1-contracts/CLAUDE.md
-l1-contracts/AGENTS.md
 
 # l1-contracts-foundry
 l1-contracts-foundry/lib

l1-contracts/AGENTS.md AGENTS.mdl1-contracts/AGENTS.md renamed to AGENTS.md

@@ -46,6 +46,56 @@ address result = _tryAddress(target, "someFunction()");
 - If you want to add an immutable for L1, always double check whether it is possible to deterministically obtain from other contracts.
 - If there is variable that can be an immutable on L1, but we need a similar field on L2, a common pattern is to create a method in the base contract that can be inherited by both. On L2 it can be either a constant (esp if it is an L2 built-in contract address) or a storage variable that must be initialized within during the genesis. For example, look how `initL2` functions are used.
 
+## Updating test_infra Git Dependencies (Bootloader Tests)
+
+### Problem
+
+The bootloader test infrastructure at `system-contracts/bootloader/test_infra/` uses `nightly-2025-05-23` and has git
+dependencies on `zksync-era`. When the git rev in `Cargo.toml` is updated, **do NOT run `cargo update` or regenerate
+the entire `Cargo.lock`**. A full re-resolve will pull in latest crates.io versions of transitive dependencies (e.g.,
+`crc-fast`, `zerocopy`) that use `stdarch_x86_avx512` intrinsics, which are not stabilized on this nightly toolchain.
+This causes CI build failures on x86_64 runners.
+
+### Correct Approach: Selective Lockfile Update
+
+When updating the zksync-era git rev in `Cargo.toml`, update the lockfile by targeting only the git dependencies:
+
+```bash
+cd system-contracts/bootloader/test_infra
+
+# Update only the git dependencies, keeping all crates.io deps pinned
+cargo update -p zksync_multivm -p zksync_types -p zksync_contracts \
+  -p zksync_utils -p zksync_state -p zksync_vlog
+```
+
+This swaps the git rev for the zksync-era crates while preserving all other dependency versions at their current
+(known-working) state.
+
+### If the Lockfile Is Already Broken
+
+If a full `cargo update` was already run and the lockfile has incompatible versions, restore from the last known-good
+commit and selectively update:
+
+```bash
+cd system-contracts/bootloader/test_infra
+
+# Restore the old working lockfile (find the last commit before the breakage)
+git show <last-good-commit>:system-contracts/bootloader/test_infra/Cargo.lock > Cargo.lock
+
+# Then selectively update only git deps
+cargo update -p zksync_multivm -p zksync_types -p zksync_contracts \
+  -p zksync_utils -p zksync_state -p zksync_vlog
+```
+
+### Known Incompatible Crate Versions (on nightly-2025-05-23)
+
+These versions require `stdarch_x86_avx512` (stabilized in Rust 1.89) and fail on `nightly-2025-05-23`:
+
+- `crc-fast >= 1.4` (all versions use AVX-512 intrinsics on x86_64)
+- `zerocopy >= 0.8.39`
+
+Known-good versions: `crc-fast 1.3.0`, `zerocopy 0.8.27`
+
 ## Debugging Strategies
 
 When debugging Solidity compilation or script failures:

AllContractsHashes.json

@@ -4,11 +4,11 @@
     "minor": 31,
     "patch": 0
   },
-  "genesis_root": "0x26ff4c90ceb9b60cc86feb88f416a6214cb9a64a360d686526b1d85067e56519",
+  "genesis_root": "0xd14523fbdf862f8c90ad9c8d4f15633f71685ca0b3a87395051af05a665521e4",
   "genesis_rollup_leaf_index": 104,
-  "genesis_batch_commitment": "0x521dd5afd12900722822f74a13b5d515074bb084bc03bafe0068eceed22a1d25",
-  "bootloader_hash": "0x0100098b957008dda66d37766dc973bac46b3b69405d9cd584aa64548a17f43f",
-  "default_aa_hash": "0x010005f77c5bcc9dfe0869ea74a11c79eee954e100d1f79c3fe19f98307b3689",
+  "genesis_batch_commitment": "0x3bce47b3d7a1c55c8dd067392a1a084f2470265f5a71461bcf28fe927af7195d",
+  "bootloader_hash": "0x01000997783d068e1865ddd522fd4d99fb4385e5f32bd876b953fa1415a28112",
+  "default_aa_hash": "0x010005f9b417b825b2e9faaf9c727b7afd29c5a1b65269ff6f429320b7b87e4b",
   "evm_emulator_hash": "0x01000d8bae37b82f311186426184866498b357f41d7a02ced11f3e3fbfbacd63",
   "prover": {
     "recursion_scheduler_level_vk_hash": "0x1ffc56111a5cfaf5db387f6a31408ad20217e9bc1f31f2f5c1bd38b0d6d7968b",

l1-contracts/CLAUDE.md CLAUDE.mdl1-contracts/CLAUDE.md renamed to CLAUDE.md

@@ -1,9 +1,9 @@
 protocol_semantic_version = 133143986176
-genesis_root = "0x26ff4c90ceb9b60cc86feb88f416a6214cb9a64a360d686526b1d85067e56519"
+genesis_root = "0xd14523fbdf862f8c90ad9c8d4f15633f71685ca0b3a87395051af05a665521e4"
 genesis_rollup_leaf_index = 104
-genesis_batch_commitment = "0x521dd5afd12900722822f74a13b5d515074bb084bc03bafe0068eceed22a1d25"
-bootloader_hash = "0x0100098b957008dda66d37766dc973bac46b3b69405d9cd584aa64548a17f43f"
-default_aa_hash = "0x010005f77c5bcc9dfe0869ea74a11c79eee954e100d1f79c3fe19f98307b3689"
+genesis_batch_commitment = "0x3bce47b3d7a1c55c8dd067392a1a084f2470265f5a71461bcf28fe927af7195d"
+bootloader_hash = "0x01000997783d068e1865ddd522fd4d99fb4385e5f32bd876b953fa1415a28112"
+default_aa_hash = "0x010005f9b417b825b2e9faaf9c727b7afd29c5a1b65269ff6f429320b7b87e4b"
 evm_emulator_hash = "0x01000d8bae37b82f311186426184866498b357f41d7a02ced11f3e3fbfbacd63"
 
 [prover]

configs/genesis/era/latest.json

@@ -15,6 +15,8 @@ error InvalidCanonicalTxHash(bytes32);
 error InvalidChainMigrationNumber(uint256, uint256);
 // 0x24ef4f8a
 error InvalidEmptyMessageRoot(bytes32 expectedMessageRoot, bytes32 providedMessageRoot);
+// 0x768dc598
+error InvalidFeeRecipient();
 // 0x532a43fc
 error InvalidFunctionSignature(bytes4 functionSignature);
 // 0xfbf8ed35
@@ -51,6 +53,8 @@ error OnlyGatewaySettlementLayer();
 error OnlyWhitelistedSettlementLayer(address, address);
 // 0x174996d5
 error RegisterNewTokenNotAllowed();
+// 0xaad86dcd
+error SettlementFeePayerNotAgreed(address payer, uint256 chainId);
 // 0x90ed63bb
 error TokenBalanceNotMigratedToGateway(bytes32, uint256, uint256);
 // 0x03a5ba47