Smart Contracts

Mantle LSP is split between multiple smart contracts. This page will give a brief overview of the responsibilities of each of them. The contracts themselves are fully documented and we suggest referring to the source code (GitHub) directly to learn more.

Contract Addresses

Mainnet

Ethereum L1 Addresses:

mETH Token L1 0xd5F7838F5C461fefF7FE49ea5ebaF7728bB0ADfa

Staking 0xe3cBd06D7dadB3F4e6557bAb7EdD924CD1489E8f

UnstakeRequestsManager 0x38fDF7b489316e03eD8754ad339cb5c4483FDcf9

Oracle 0x8735049F496727f824Cc0f2B174d826f5c408192

OracleQuorumManager 0x92e56d2146D54d5AEcB25CA36c89D027a6ea0D90

ReturnsAggregator 0x1766be66fBb0a1883d41B4cfB0a533c5249D3b82

ConsensusLayerReceiver 0xD4e11C28E04c0c2bf370b7a9989498B7eA02493f

ExecutionLayerReceiver 0xD6E4aA932147A3FE5311dA1b67D9e73da06F9cEf

Pauser 0x29Ab878aEd032e2e2c86FF4A9a9B05e3276cf1f8

ProxyAdmin (Timelock) 0xc26016f1166bE7b6c5611AAB104122E0f6c2aCE2

Mantle L2 Addresses:

mETH Token L2 0xcDA86A272531e8640cD7F1a92c01839911B90bb0

Sepolia Testnet

Updated: 2024-03-21

Ethereum L1 Addresses:

mETH Token L1 0x072d71b257ECa6B60b5333626F6a55ea1B0c451c

Staking 0xCAfD88816f07d4FFF671D0aAc5E4c1E29875AB2D

UnstakeRequestsManager 0x1696ADC8e1324EA8DC041dc8E18cD6d13b842143

Oracle 0x869B2C99012cDe2a2AfbA6e76179CBc275165f3e

OracleQuorumManager 0x72ADA2712f00e94F08EB485C1eaff094b52DB005

ReturnsAggregator 0x9f4fc6cAcD66E6414956b379600eB0A4da853316

ConsensusLayerReceiver 0x9E7336f249b4Ca7b82649Be42338e6687daa36Ef

ExecutionLayerReceiver 0xC4d7437Ea5eD73EB4C13998C61c166A81b2f685A

Pauser 0xa1d2AF8B000Ea221a8511C4f8817aB94f51c36B2

ProxyAdmin (Timelock) 0x850996631304697db7440e484C596bC6B6787A42

Mantle L2 Addresses:

mETH Token L2 0x9EF6f9160Ba00B6621e5CB3217BB8b54a92B2828

Holesky Testnet

Updated: 2024-03-25

Ethereum L1 Addresses:

mETH Token L1 0xe3C063B1BEe9de02eb28352b55D49D85514C67FF

Staking 0xbe16244EAe9837219147384c8A7560BA14946262

UnstakeRequestsManager 0x0618720e23B854D79aC0b540C9a85105614c498B

Oracle 0x823750C3C8410cAc68b58BD22569E2baAcb73BD1

OracleQuorumManager 0xa7b722646C9A6567EaAd60dCE9C3e2C0CFe724CC

ReturnsAggregator 0xDc766d235567C0065Ce74C9667891F130Ea6EB78

ConsensusLayerReceiver 0xF23242BD4B4D112C7389A356dCA3F0Fb30Ab10d4

ExecutionLayerReceiver 0x6ED7550149B8A0285bb79C9512eBb9e60eA50C86

Pauser 0x5fc6fe32871642Ea04E0651F54BE80546cF2173b

ProxyAdmin (Timelock) 0xaEd4ebB1d70AA5EE738CA297e21a474E5a386FFE

Goerli Testnet

Updated: 2024-01-15

Ethereum L1 Addresses:

mETH Token L1 0x20d7E093B3fa5eBfA7a0fa414FaD547743a2400F

Staking 0x307770388c483BF225DCbe55EE5BA8b9d0bC5C1d

UnstakeRequestsManager 0x5c500C4364750f5905B920DC15b6b115361C4cC0

Oracle 0x4870BFEDE0d313629169750C125F9658E6EdfdB2

OracleQuorumManager 0x6D8852571FA959582840B000cA963AcFc97F18aC

ReturnsAggregator 0x94c0a0C3C22951BD40CA2490DbD5aebE910e7B95

ConsensusLayerReceiver 0x9A0E047688e0Fd4Aa3252F9a9AfDD00BbB22601f

ExecutionLayerReceiver 0x108CBca9e25DEb154249DFe5749239ED8e3A0448

Pauser 0xF1331e8aaEC8e7E9060530A1cd95377B2f02a11e

ProxyAdmin (Timelock) 0x368A55FB706d53C8DAa4db6a9916dD525CB30eFf

Mantle L2 Addresses:

mETH Token L2 0x5fc6fe32871642Ea04E0651F54BE80546cF2173b

Contract Descriptions

Staking

• Considered the public interface for the protocol, and is the only contract that users should ever need to interact with.

• Handles staking and unstaking operations.

• Performs accounting for the protocol (i.e. how much ETH is controlled).

UnstakeRequestsManager

• Tracks unstake requests.

• Places each request into a first-in-first-out queue, and determines when requests are eligible for claiming.

• Considered an "internal" contract, and users must transact with the Staking contract to unstake.

Oracle

• Receives and validates Oracle "records" that are reported by the off-chain Oracle systems.

• Responsible for ensuring that Oracle records are valid and complete.

• Contains extensive "sanity checks" to confirm that the provided data is within realistic expected bounds. If the report falls outside of the bounds of the checks, then the protocol is paused.

OracleQuorumManager

• Interface for off-chain Oracles to send Oracle records to the system.

• Contains has configurable properties that can be used to ensure that multiple, independent off-chain Oracles agree on the data within a record before it is considered to be eligible to be written to the Oracle contract for verification and storage.

ReturnsAggregator

• Processing all incoming "returns" (ETH rewards and principals) from the protocol.

• Uses validated Oracle records to understand the source of the amounts that has been received, takes protocol fees where appropriate, and sends the remaining amount to the Staking contract to be compounded or to fill unstake requests.

ConsensusLayerReceiver

• A simple contract at which all Consensus Layer withdrawals arrive at.

• Amounts can be pulled from here into the protocol by the ReturnsAggregator.

ExecutionLayerReceiver

• A simple contract at which all Execution Layer rewards arrive. These are gas tips from execution and MEV rewards.

• Amounts can be pulled from here into the protocol by the ReturnsAggregator.

Pauser

• A pausing system that other contracts call to ensure that operations within the protocol are currently active and allowed.

• The Pauser may be invoked by other contracts (e.g. the Oracle may pause the protocol if an unexpected report is detected), or by off-chain guardians.