basic contracts

[kelemeno]

What ❔

Why ❔

Checklist

• 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.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[github-actions]

Coverage after merging kl/l2-l1-interop-pilot into kl/medium-interop will be

77.52%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
contracts/bridge
BridgeHelper.sol	100%	100%	100%	100%
BridgedStandardERC20.sol	96.25%	100%	92.31%	97.01%	231–232
L1ERC20Bridge.sol	97.78%	100%	100%	97.30%	261
L1Nullifier.sol	88.44%	100%	87.10%	88.69%	129–130, 182, 191, 432–433, 436, 462, 647, 649, 698, 710, 713, 715, 731, 745–746, 750–751
UpgradeableBeaconDeployer.sol	0%	100%	0%	0%	15–16, 18, 20–21
contracts/bridge/asset-router
AssetRouterBase.sol	86.08%	100%	70.59%	90.32%	128, 202, 313, 49, 58, 81
L1AssetRouter.sol	91.62%	100%	86.67%	92.70%	104, 320, 331, 413–414, 434, 592, 603, 617, 622
contracts/bridge/asset-tracker
AssetTrackerBase.sol	51.02%	100%	41.18%	56.25%	105–106, 134, 163, 61, 63, 65, 67, 69–70, 79–80, 96–97
GWAssetTracker.sol	31.48%	100%	37.84%	30.47%	111–113, 115–117, 123, 127, 130–131, 134–135, 138–139, 142–143, 150–151, 207, 210–211, 214, 216–220, 222, 224, 226–230, 232–233, 235–236, 238–248, 250, 252, 254, 256–258, 263–264, 266–267, 271, 273–274, 280, 290, 308–312, 318–319, 322–323, 327, 332, 334, 337, 339–340, 342, 344, 346–347, 349–350, 354–355, 358–359, 362, 364–365, 368, 374, 376, 378, 380–381, 384, 389–391, 393–394, 398, 400–406, 413–414, 423, 425, 427, 431, 441, 447–448, 450, 452–454, 456, 464, 470, 472–473, 475–477, 486–487, 489, 495, 499, 503, 509–510, 514, 520–522, 533–536, 623–624, 675, 678, 76–78, 83–85, 90–92
L1AssetTracker.sol	72.37%	100%	70.83%	72.66%	111–113, 116–119, 121–122, 125–126, 132–134, 191, 195–199, 246, 368–371, 424, 45–46, 57–58, 61–62, 72–74
LegacySharedBridgeAddresses.sol	0%	100%	0%	0%	23, 26, 29, 32, 36–41, 43
contracts/bridge/interfaces
AssetHandlerModifiers.sol	75%	100%	100%	66.67%	13
contracts/bridge/ntv
L1NativeTokenVault.sol	73.83%	100%	77.27%	72.94%	101–103, 150, 154–156, 179–185, 187, 256–257, 259, 270, 272, 278, 92–93
NativeTokenVaultBase.sol	79.50%	100%	61.54%	83.85%	101–102, 135–138, 140–141, 143, 218, 309, 442, 444, 45, 47, 49, 51, 512, 549, 559–560, 564–565, 87, 92, 97
contracts/bridgehub
BridgehubBase.sol	73.53%	100%	71.05%	74.10%	125–127, 135, 140, 142–143, 150, 168, 198, 206–207, 213–214, 223, 236–238, 240–241, 243, 245, 277, 280, 299, 315, 346, 39, 41, 43, 478, 482, 486–487, 506, 509, 568, 572, 575, 613–614, 618–619
CTMDeploymentTracker.sol	73.47%	100%	81.82%	71.05%	108, 112, 116, 141, 145–146, 34, 42, 67, 80–81
ChainAssetHandlerBase.sol	42.34%	100%	20.83%	48.28%	113, 120–121, 126–128, 139–141, 147–150, 153–154, 204, 207, 219–220, 277, 294, 321, 325, 327, 329–330, 339–340, 344–345, 349–350, 354–355, 46, 49, 52, 55, 58, 64, 66, 68, 70, 72, 74
ChainRegistrationSender.sol	88.24%	100%	100%	85.19%	41, 85, 89, 95
L1Bridgehub.sol	90%	100%	91.67%	89.77%	206, 281, 285–286, 289, 299, 65–66, 89
L1ChainAssetHandler.sol	86.36%	100%	80%	88.24%	53–54, 69–70
L1MessageRoot.sol	60.98%	100%	85.71%	55.88%	51–52, 56–58, 61–62, 67–68, 74, 76, 80–81, 96–97
L2Bridgehub.sol	47.83%	100%	40%	50%	104–105, 113, 115–116, 125, 130–131, 133–134, 46, 48–51, 77, 90–91
L2ChainAssetHandler.sol	73.53%	100%	66.67%	76%	101, 50–51, 70–71, 77
L2MessageRoot.sol	75.51%	100%	72.73%	76.32%	101, 47–48, 51, 58, 63–64, 88–89
MessageRootBase.sol	78.99%	100%	82.61%	78.26%	131–133, 135, 137–138, 140, 144, 150–152, 160, 177, 187, 192, 197, 199–200, 257, 273, 346, 36, 375, 38, 40
contracts/common
MessageVerification.sol	94.44%	100%	88.89%	96.30%	88
ReentrancyGuard.sol	95%	100%	100%	94.12%	79
contracts/common/l2-helpers
L2ContractHelper.sol	84.91%	100%	100%	82.22%	102, 108, 112, 129, 134, 73, 79, 83
SystemContractsCaller.sol	52.50%	100%	60%	51.43%	44–45, 47, 49, 51, 53, 66, 69, 72, 75, 78, 83, 89, 91, 93, 96, 98
contracts/common/libraries
DataEncoding.sol	80%	100%	75%	81.25%	120–121, 128–129, 174