v0.5.4-mainnet-rewards-v2

Overview

The Rewards v2 protocol upgrade is the next iteration of EigenLayer rewards. The proposal is outlined in depth in (ELIP-001).

Rewards v2 addresses key challenges identified in the EigenLayer Rewards MVP (v1), particularly the need for Operator-directed rewards via external logic and flexibility for Operators in setting different fee rates to better cover operating costs or attract more stake when running different AVS types. The growing demand from AVSs for more performance-based rewards prompted this upgrade, ensuring EigenLayer's rewards protocol can serve a wider variety of scenarios.

This upgrade to the core contracts has been audited. The results of these audits are public and can be found here.

Breaking changes and upcoming breaking changes

Operators that integrated the first released version of the Rewards code should note the following naming change. globalOperatorCommissionBips has been renamed to defaultOperatorSplitBips.

Improvements

• Performance-based and directed rewards from AVSs to Operators via the createOperatorDirectedAVSRewardsSubmission function.
• Operator-configurable split for AVS Rewards, via the setOperatorAVSSplit function on the RewardsCoordinator to allow per-AVS variable Operator fees.
• Operator-configurable split for Programmatic Incentives with the Eigen Foundation, via the setOperatorPISplit function on the RewardsCoordinator to allow variable operator fees for Programmatic Incentives.
• Batch claiming for both Stakers and Operators via the processClaims function on the RewardsCoordinator
• Permissionless verifiability of the entire Rewards pipeline via the open-source Eigen Sidecar. More details on this can be found in the Sidecar repository.

What's Changed

• Fix: Update coverage workflow job name by @ypatil12 in #834
• Fix: Get Dev to Compile by @ypatil12 in #835
• feat: introduce zeus templates by @nadir-akhtar in #790
• refactor: require "name" to be populated for deployments by @nadir-akhtar in #872
• Update LICENSE by @A2Zrestaking in #887
• chore: update bindings by @0xrajath in #890
• feat: Rewards v2 by @0xrajath in #837
• fix: operator-directed rewards total amount upper bound by @0xrajath in #917
• feat: rewards v2 upgrade script by @jbrower95 in #888
• test: rewards v2 upgrade event assertion in zeus script by @0xrajath in #924
• feat: explicit multisig syntax on zeus scripts by @jbrower95 in #928
• refactor: address informational security review findings by @nadir-akhtar in #909
• fix: patch rewards v2 by @0xrajath in #940
• chore: fix semver constraint on rewardsv2 by @jbrower95 in #941
• chore: fix zeus environment by @jbrower95 in #942
• chore: log rather than comment final coverage output by @nadir-akhtar in #943
• fix: operator split activation delay lock by @0xrajath in #947
• fix: patch operator split lock upgrade by @0xrajath in #948
• docs: rewards v2 by @nadir-akhtar in #952
• fix: rewards v2 audit fixes by @0xrajath in #987
• chore: update addresses for slashing by @ypatil12 in #974
• fix: default split frontrun patch upgrade by @0xrajath in #991

Full Changelog: v0.4.3-mainnet-rewards-foundation-incentives...v0.5.4

v0.5.4-testnet-rewards-v2

What's Changed

• fix: rewards v2 audit fixes by @0xrajath in #987
• chore: update addresses for slashing by @ypatil12 in #974
• fix: default split frontrun patch upgrade by @0xrajath in #991

Full Changelog: v0.5.3...v0.5.4-holesky

v1.0.3-testnet-slashing

What's Changed

• docs: wip slashing docs by @nadir-akhtar in #925
• refactor: scaled shares accounting by @8sunyuan in #975
• refactor: final slashing cleanup by @wadealexc in #982
• chore: remove unused avsd events by @ypatil12 in #984
• fix: SignatureUtils construction by @0xClandestine in #990
• fix: rewards v2 audit fixes by @0xrajath in #987
• fix: readd manual checks by @0xClandestine in #996
• feat: slashing 1.0.3 upgrade script by @ypatil12 in #995

Full Changelog: v1.0.2...v1.0.3

v1.0.2-testnet-slashing

This release marks the testnet slashing release. A full spec change is in documented in ELIP-002

See the following docs for breaking changes:

• Slashing update for operators/LRTs
• Slashing update for AVSs

New Addresses

There are two new core contracts deployed

Name	Proxy	Implementation	Notes
AllocationManager	0x78469728304326CBc65f8f95FA756B0B73164462	0xe03d...4ee2	Proxy: [email protected]
PermissionController	0x598cb226B591155F767dA17AfE7A2241a68C5C10	0x7ab0...a2b9	Proxy: [email protected]

What's Changed

• fix(slashing): fix upgrade script phase 4 by @jbrower95 in #953
• fix: patch by @gpsanant in #956
• feat: bindings by @gpsanant in #960
• fix: remove numtocomplete interface by @8sunyuan in #966
• feat: add share helpers by @gpsanant in #964
• fix: slashable window boundaries by @8sunyuan in #965
• refactor: small cleanup by @0xClandestine in #959
• feat: remove max strategies list by @ypatil12 in #968
• feat: slashing patch upgrade script by @ypatil12 in #967
• chore: bindings by @gpsanant in #969
• fix: try catch out of gas edge case by @8sunyuan in #971
• chore: slashing 1.0.2 direct upgrade script by @jbrower95 in #972

Full Changelog: v0.5.3...v1.0.2

v0.5.3-testnet-rewards-v2

This release marks the Rewards v2 upgrade. Please see EigenLayer Improvement Proposal-001: Rewards v2 for a technical description of this upgrade.

What's Changed

• Fix: Update coverage workflow job name by @ypatil12 in #834
• Fix: Get Dev to Compile by @ypatil12 in #835
• feat: introduce zeus templates by @nadir-akhtar in #790
• refactor: require "name" to be populated for deployments by @nadir-akhtar in #872
• Update LICENSE by @A2Zrestaking in #887
• chore: update bindings by @0xrajath in #890
• feat: Rewards v2 by @0xrajath in #837
• fix: operator-directed rewards total amount upper bound by @0xrajath in #917
• feat: rewards v2 upgrade script by @jbrower95 in #888
• test: rewards v2 upgrade event assertion in zeus script by @0xrajath in #924
• feat: explicit multisig syntax on zeus scripts by @jbrower95 in #928
• refactor: address informational security review findings by @nadir-akhtar in #909
• fix: patch rewards v2 by @0xrajath in #940
• chore: fix semver constraint on rewardsv2 by @jbrower95 in #941
• chore: fix zeus environment by @jbrower95 in #942
• chore: log rather than comment final coverage output by @nadir-akhtar in #943
• fix: operator split activation delay lock by @0xrajath in #947
• fix: patch operator split lock upgrade by @0xrajath in #948
• docs: rewards v2 by @nadir-akhtar in #952

Full Changelog: v0.4.3-mainnet-rewards-foundation-incentives...v0.5.3

v1.0.0-devnet-slashing-alpha

Slashing Public Devnet Alpha Release

NOTE: No guarantees are made on the correctness of this code. It is unaudited and should not be used in production integrations.

This release is a fresh deploy of the EigenLayer protocol on Holesky. A list of contract addresses is below:

Name	Address
DelegationManager	0x3391eBafDD4b2e84Eeecf1711Ff9FC06EF9Ed182
StrategyManager	0x70f8bC2Da145b434de66114ac539c9756eF64fb3
AVSDirectory	0xCa839541648D3e23137457b1Fd4A06bccEADD33a
AllocationManager	0xAbD5Dd30CaEF8598d4EadFE7D45Fd582EDEade15
StrategyFactory	0x09F8f1c1ca1815083a8a05E1b4A0c65EFB509141
RewardsCoordinator	0xa7DB7B0E63B5B75e080924F9C842758711177c07
EigenPodManager	0x8C9781FD55c67CE4DC08e3035ECbdB2B67a07307

See the deployment config for additional configurations and implementation contracts.

Key Changes Include:

• AVSDirectory
• AllocationManager
• Accounting for the DelegationManager and StrategyManager updated to take into account slashing of operator's shares

Native Restaking and Rewards functionally are paused. There is currently a wethStrategy deployed and the StrategyFactory can be used to create additional restaking tokens.

An associated in-progress AVS reference contract implementation can be found here.

Full Changelog: v0.4.3-mainnet-rewards-foundation-incentives...v1.0.0-devnet-slashing-alpha

v0.4.3-mainnet-rewards-programmatic-incentives

What's Changed

• bEIGEN/EIGEN changes by @MinisculeTarantula in #717
• Remove Slither from CI by @ypatil12 in #781
• chore: update token deployment addresses by @MinisculeTarantula in #785
• Feat: Mainnet Incentives Scripts by @ypatil12 in #749
• fix: rewards coordinator gap by @0xClandestine in #789
• feat: inheritdoc by @0xClandestine in #775
• chore: ignore bindings in pull requests by @jbrower95 in #791
• fix: compile warnings by @0xClandestine in #664
• Clarifying depositIntoStrategyWithSignature() purpose by @wesfloyd in #797
• feat: preprod rewards coordinator upgrade by @ypatil12 in #729

Full Changelog: v0.4.3-holesky-rewards-foundation-incentives...v0.4.3-mainnet-rewards-foundation-incentives

v0.4.3-holesky-rewards-programmatic-incentives

What's Changed

• feat: rewardAllEarners by @8sunyuan in #724
• chore: deploy and upgrade longtail on preprod by @wadealexc in #721
• chore: full deploy script by @jbrower95 in #732
• chore: force the scratch buld on every push by @jbrower95 in #735
• docs: rewards for all earners by @ypatil12 in #737
• Testnet Rewards Coordinator Upgrade Script by @ypatil12 in #742
• feat: ci storage reports by @0xClandestine in #750
• feat: storage report by @0xClandestine in #753
• fix: fail on storage diff by @0xClandestine in #759

Full Changelog: v0.4.2-mainnet-pepe...v0.4.3-holesky-rewards-foundation-incentives

v0.4.2-mainnet-pepe

This release marks the PEPE (Protocol: EigenPod Enhancement) upgrade on mainnet. All EigenPods will be upgraded automatically on Sept 4, at noon ET.

Please see EigenPod Redesign: Checkpoint Proofs for a technical description of this upgrade. For most users, no action is required -- however, if you are integrating with an EigenPod via custom smart contracts, your contracts will need to use the updated EigenPod interface. The website and CLI have also been updated to support PEPE.

What's Changed

• feat: strategy factory release by @ypatil12 in #678
• feat: rewards interface views by @8sunyuan in #677
• docs: add certora audit report by @wadealexc in #689
• fix: deploy up-to-date implementation by @8sunyuan in #692
• chore: fastforward testnet-holesky by @8sunyuan in #698
• feat: pepe deploy script and config cleanup by @wadealexc in #697
• chore: add updated certora report by @wadealexc in #708
• docs: update README with pepe commit hashes by @wadealexc in #726

Full Changelog: v0.4.1-holesky-pepe...v0.4.2-mainnet-pepe

v0.3.3-mainnet-rewards

What's Changed

• feat: strategy factory release by @ypatil12 in #678
• feat: rewards interface views by @8sunyuan in #677

Full Changelog: v0.4.1-holesky-pepe...v0.3.3-mainnet-rewards