Chain Info

This page is the canonical quick reference for Lighter EVM chain-level configuration.

Chain metadata

  • The EVM chain ID is chainId = 19_529 = 0x4C49 = "LI".
  • The Core chain ID is 300 on the devnet. Use it for signing Core transactions and deriving EVM-to-Core transaction hashes, not the EVM chain ID.
  • The EVM block time is 1 second.

Differences from L1 EVM

See Differences from L1 EVM for the full list of differences.

Precompiles

Protocol-specific precompiles available to contracts on Lighter EVM.

NameAddressPurpose
READ_CORE0x6600000000000000000000000000000000000000Synchronous reads of Core state

Predeploys

Protocol-owned contracts deployed at fixed addresses in the Lighter EVM (L2) genesis state. Unlike preinstalls, which are third-party contracts included for developer convenience, predeploys are first-party protocol components with privileged roles in the system.

Most predeploys hold an upgradeable proxy as code, upgradeable only via a system transaction. The fee vaults, LighterWrappedERC20V1, and WETH9 are deployed as bare contracts, immutably.

NameAddressPurpose
EvmInteropManager0x6600000000000000000000000000000000000001User-facing entrypoint for EVM and Core token ops
SequencerFeeVault0x6600000000000000000000000000000000000002Fee vault; COINBASE resolves to this address and it receives the priority fees
EvmToCoreMessenger0x6600000000000000000000000000000000000003Low-level EVM -> Core write messenger
EvmToL1Messenger0x6600000000000000000000000000000000000004Low-level EVM -> L1 withdrawal messenger
EvmReplayableMessenger0x6600000000000000000000000000000000000005L1 -> EVM replayable message relay
EvmEscrowGateway0x6600000000000000000000000000000000000006Gateway for bridging EVM-native tokens
LighterWrappedERC20V10x6600000000000000000000000000000000000007Initial wrapped token implementation
EvmMintGateway0x6600000000000000000000000000000000000008Gateway for bridging L1-native tokens
EvmToCoreEntrypoint0x6600000000000000000000000000000000000009User-facing entrypoint for account and order writes to Core
BaseFeeVault0x660000000000000000000000000000000000000aFee vault; receives the EVM base-fee
PubdataFeeVault0x660000000000000000000000000000000000000bFee vault; receives the L1 data fee
WETH90x660000000000000000000000000000000000000cCanonical wrapped ETH (WETH); standard WETH9 interface
GasPriceOracle0x660000000000000000000000000000000000000dExposes the current blobBaseFee for the L1 data fee
EvmL1RefundClaimer0x660000000000000000000000000000000000000eHolds deposit refunds owed to L1-controlled Core accounts

Preinstalls

Preinstalls are third-party contracts included in genesis for developer convenience.

NameAddress
Safe0x69f4D1788e39c87893C980c06EdF4b7f686e2938
SafeL20xfb1bffC9d739B8D520DaF37dF666da4C687191EA
MultiSend0x998739BFdAAdde7C933B942a68053933098f9EDa
MultiSendCallOnly0xA1dabEF33b3B82c7814B6D82A79e50F4AC44102B
SafeSingletonFactory0x914d7Fec6aaC8cd542e72Bca78B30650d45643d7
Multicall30xcA11bde05977b3631167028862bE2a173976CA11
CreateX0xba5Ed099633D3B313e4D5F7bdc1305d3c28ba5Ed
Arachnid's Deterministic Deployment Proxy0x4e59b44847b379578588920cA78FbF26c0B4956C
Permit20x000000000022D473030F116dDEE9F6B43aC78BA3
ERC-4337 v0.6.0 EntryPoint0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
ERC-4337 v0.6.0 SenderCreator0x7fc98430eaedbb6070b35b39d798725049088348
ERC-4337 v0.7.0 EntryPoint0x0000000071727De22E5E9d8BAf0edAc6f37da032
ERC-4337 v0.7.0 SenderCreator0xEFC2c1444eBCC4Db75e7613d20C6a62fF67A167C
ERC-4337 v0.8.0 EntryPoint0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108
ERC-4337 v0.8.0 SenderCreator0x449ed7c3e6fee6a97311d4b55475df59c44add33
ERC-4337 v0.9.0 EntryPoint0x433709009B8330FDa32311DF1C2AFA402eD8D009
ERC-4337 v0.9.0 SenderCreator0x0a630a99df908a81115a3022927be82f9299987e

System addresses

Addresses that are not contracts but appear as transaction senders in the Lighter EVM.

NameAddressPurpose
Core system address0x7fFFfFfFFFfFFFFfFffFfFfFfffFFfFfFffFFFFfSender of every Core-originated EVM transaction

EVM execution parameters

  • TARGET_GAS_LIMIT: 4,250,000
  • ELASTICITY_MULTIPLIER: 4 (MAX_GAS_LIMIT = 17,000,000)
  • BASE_FEE_MAX_CHANGE_DENOMINATOR: 334
  • INITIAL_BASE_FEE: 1 gwei
  • MAX_PRIORITY_GAS_LIMIT: 10,000,000
  • BASE_FEE_OVERHEAD: 120,000
  • BASE_FEE_SCALAR: 9,700,000,000,000
  • PUBDATA_GAS_PER_BYTE: 70 (see L1 Data Fee)

Protocol smart contracts

The following smart contracts are deployed on the private L1.

NameAddressPurpose
ZkLighter0xd560b13C677E99499f496067a44ED355c69Aa51EL1 bridge
L1ReplayableMessenger0xD49203aFef6ED23b198371339E5055b79D74A95fL1 replayable message relay
L1InteropManager0x8709B4047608BE3083dA13f703757A10f5B83A7cUser-facing L1 entry point for sending tokens into Lighter
L1EscrowGateway0xf59c7a46614c343E51d95948E8686769eC8e9696Gateway for bridging L1-native tokens
L1MintGateway0xc99AF9C0e19C8984c36b4CaFc7963B500542DF7cGateway for bridging EVM-native tokens
L1CoreMessaging0x1eaeA4982372d591228D2a5465d55d3b26e809f9Messaging relay between Core and L1
Governance0xAc2499795E7b45F21634C221496a5085017d141cProtocol governance

Did this page help you?