Releases: Layr-Labs/eigenlayer-contracts
v1.5.0-rc.0
v1.5.0 Redistribution
Release Manager
Highlights
🚀 New features
- Redistribution is a feature that gives Service Builders a means to not just burn, but repurpose slashed funds.
- We introduce a new operatorSet creation mechanism:
AllocationManager.createRedistributingOperatorSets
, which allows slashed funds to be redistributed to aRedistributionRecipient
. Note: The redistribution recipient can be set only once and is immutable. - All slashed funds will now be routed to individual
SlashEscrow
contracts. The release of funds from escrow is gated by theSlashEscrowFactory
. TheSlashEscrowFactory
deploys individualSlashEscrow
contracts per slash, enforces a global delay for all escrowed funds, and handles pausing/unpausing of escrowed funds. - The original
createOperatorSets
function still exists. This function creates operatorSets whose slashed funds will eventually be burned. There is no mechanism to convert an operatorSet to be redistributing. - See ELIP-006 for a full description.
⛔ Breaking changes
- Funds marked for burning now go through a 4-day escrow period via
SlashEscrow
contracts. These funds are burned by callingSlashEscrowFactory.releaseSlashEscrow
.
📌 Future Deprecations
- The pre-redistribution burn pathway
StrategyManager.decreaseBurnableShares
will be deprecated in an upgrade after the redistribution release. This function can still be used to burn shares that have been slashed at any point prior to the redistribution upgrade.
🛠️ Security Updates
- The slashing of burned funds is no longer instantaneous. All slashed funds (burned or redistributed) now go through a 4-day escrow delay. The eventual burning or redistribution of slashed funds can be paused by the
PauserMultisig
. - The upgradability of the
SlashEscrowFactory
is controlled by theCommunityMultisig
. The contract will have a separateProxyAdmin
from the rest of the EigenLayer core protocol. Each individualSlashEscrow
contract is an immutable clone.
🔧 Improvements
- The
AllocationManager.slashOperator
function now returns aslashId
and array ofshares
to be burned/redistributed. The function selector remains the same. - OperatorSets now have a
slashCount
field, which returns the number of slashes completed by the operatorSet. This value only reflects the number of slashes after the redistribution upgrade. StrategyBase
returns anamountOut
upon withdrawal to comply with standard ERC-4626 vaults.- The
AllocationManager
andDelegationManager
no longer use ownable. Thus, they now inherit theDeprecated_OwnableUpgradeable
mixin in its place to reduce codesize.
🐛 Bug Fixes
SemVerMixin
is updated to only return the first character ofmajorVersion
. We currently return1.
and will return1
after this upgrade.
What's Changed
- docs: add StrategyBase accounting doc by @nadir-akhtar in #1233
- feat: v1.4.0 upgrade script by @ypatil12 in #1244
- chore: add release label by @bowenli86 in #1253
- feat: support all characters after colon by @0xClandestine in #1255
- docs: Clarify AVS Meaning for AllocationManager and Effect of invoking updateAVSMetadataURI by @wesfloyd in #1259
- chore: add missing fn to interface by @0xClandestine in #1271
- chore: address ep/epm informational by @ypatil12 in #1272
- docs: post-cantina doc updates by @ypatil12 in #1266
- fix(cantina): deposit share cast bug by @8sunyuan in #1265
- chore: add event to dsf reset on full withdrawal by @eigenmikem in #1270
- feat: cantina preprod/testnet upgrade scripts by @ypatil12 in #1286
- fix: v1.4.1 execute script name by @ypatil12 in #1297
- docs: add sepolia by @ypatil12 in #1309
- docs: complete MAINTENANCE.md and clarify maintainers responsibility by @bowenli86 in #1314
- docs: simplify readme and consolidate with CONTRIBUTING.md by @bowenli86 in #1317
- docs: improve readability and searchbility with tabs for deployment contracts by @bowenli86 in #1318
- ci: change certora prover to run on main by @bowenli86 in #1319
- ci: add path filter for intense test by @bowenli86 in #1320
- docs: callout consequences of not follow contribution guidelines by @bowenli86 in #1326
- fix: update sepolia wETH strategy contract link with correct address by @pschork in #1336
- ci: enable auto delete branch upon eigengit launch by @bowenli86 in #1339
- docs: enrich MAINTENANCE.md re: release branches by @bowenli86 in #1340
- docs: update addresses for mainnet by @ypatil12 in #1341
- chore: Update README for Holesky v1.4.2 release by @solimander in #1351
- ci: add cron to auto remove stale branches by @bowenli86 in #1348
- chore: update readme for v1.4.1 by @ypatil12 in #1361
- ci: add CI to auto validate deployment scripts by @bowenli86 in #1360
- docs: bump deployment matrix to top of README by @bowenli86 in #1376
- docs: updating readme for dead links, readability, new language, and more by @non-fungible-nelson in #1377
- ci: add testnet envs sepolia and hoodi to validate-deployment-scripts by @bowenli86 in #1378
- docs: add doc for steps to write deploy scripts by @bowenli86 in #1380
- ci: add explicit permissions to workflows to mitigate security concerns by @bowenli86 in #1392
- chore: update .gitattributes with Certora .spec/.conf formatting by @nadir-akhtar in #1379
- chore: add instruction of generating changelog from last release by @bowenli86 in #1405
- docs: add hoodi by @ypatil12 in #1419
- feat(release): redistribution by @0xClandestine in #1355
New Contributors
- @pschork made their first contribution in #1336
- @non-fungible-nelson made their first contribution in #1377
Full Changelog: v1.4.0-testnet-holesky...v1.5.0-rc.0
v1.4.1
Overview
This release brings Pectra Compatability to EigenPods. There are no breaking changes as part of this release. v1.3.0
of the proof generation CLI is forwards compatible with this release.
As part of the upgrade process, EigenPods will be paused for ~12 hours on mainnet. For a full list of updates, see our guide.
What's Changed
- feat: proofra upgrade script by @ypatil12 in (#1067)
- feat: pectra compatibility by @ypatil12 in (#1053)
Full Changelog: v1.3.0...v1.4.1
v1.4.2
Overview
This release reduces the following delay parameters on the Holesky testnet to enable faster iteration and testing:
ALLOCATION_CONFIGURATION_DELAY
: reduced from 75 blocks (~15 minutes) to 30 blocks (~6 minutes)DEALLOCATION_DELAY
: reduced from 50 blocks (~10 minutes) to 25 blocks (~5 minutes)MIN_WITHDRAWAL_DELAY_BLOCKS
: reduced from 50 blocks (~10 minutes) to 25 blocks (~5 minutes)
What's Changed from v1.4.1
- release: Reduce allocation configuration delay & min withdrawal delay on Holesky by @solimander #1343
Full Changelog: v1.4.1...v1.4.2
v1.3.0
Overview
This is the release for the upcoming EigenLayer mainnet slashing upgrade. It encompasses all functionality, testing, and audit changes.
For a full breakdown of breaking changes, please see our release notes for Operators/LRTs and AVSs.
What's Changed from the release candidate
- feat: cantina audit changes on mainnet release by @ypatil12 in #1288
- feat: mainnet upgrade scripts by @ypatil12 in #1257
What's Changed from v0.5.4
- docs: rewards v2 audit report by @0xrajath in #1021
- chore: merge
dev
totestnet-holesky
by @0xrajath in #1032 - feat: slashing release by @8sunyuan in #679
- feat: rewards v2.1 by @0xClandestine in #1011
- feat: storage-diff.sh by @0xClandestine in #1054
- docs: Rewards v2.1 by @nadir-akhtar in #1055
- refactor: quality of life improvements by @0xClandestine in #1006
- fix: enforce no compile warnings by @0xClandestine in #1057
- chore: rewards v2.1 zeus script by @0xrajath in #1058
- docs: updated rewards v2.1 docs by @0xrajath in #1061
- test: improve coverage by @0xClandestine in #1059
- feat: ci storage check required by @0xClandestine in #1062
- docs: fix broken link by @dabit3 in #907
- docs: rm -rf docs/storage-report by @0xClandestine in #1063
- feat: add size diff workflow by @0xClandestine in #1065
- chore: remove old release scripts by @0xClandestine in #1066
- fix: zeus upgrade name by @0xrajath in #1068
- chore: vscode settings json by @0xrajath in #1071
- fix(ci): intense test errors by @0xClandestine in #1072
- chore: update to open source zeus repo by @jbrower95 in #1084
- fix: remove deprecated hardhat configs by @bowenli86 in #1090
- perf: parallelize foundry workflows by @bowenli86 in #1094
- refactor: limit continuous fuzzing to dev branch by @bowenli86 in #1101
- refactor: registrar interfaces by @8sunyuan in #1102
- feat: alm upgrade script by @8sunyuan in #1103
- perf: use x64 16core machine for CI by @bowenli86 in #1099
- fix: remove tsconfig by @bowenli86 in #1114
- perf: run Foundry CI tests only for relevant code changes by @bowenli86 in #1112
- perf: speed up test coverage job in CI by @bowenli86 in #1115
- docs: fix all misspellings by @0xClandestine in #1119
- perf: install lcov via prebuilt binary, instead of via apt by @bowenli86 in #1123
- perf: add cache for forge build by @bowenli86 in #1125
- feat: add typos-cli ci check by @0xClandestine in #1126
- feat: slashing audit fixes by @wadealexc in #1046
- fix: disable foundry ci suite path check by @0xClandestine in #1159
- chore: re-enable foundry ci suite path check by @bowenli86 in #1160
- docs: add warning in PR template by @0xClandestine in #1174
- feat: add pull request labeler to ci pipeline by @0xClandestine in #1177
- chore: improve labeler config by @0xClandestine in #1185
- chore: improve labeler config by @0xClandestine in #1186
- chore(ci): lint pr titles by @0xClandestine in #1193
- fix: DSF increase on checkpointed nonzero shares by @ypatil12 in #1176
- chore: disable ci path filtering by @0xClandestine in #1202
- docs(avs-directory): mark AVSDirectory as deprecated by @nadir-akhtar in #1199
- chore: consolidate/update deploy from scratch scripts by @ypatil12 in #1209
- test: slashing integration testing by @ypatil12 in #1211
- chore: forge fmt tests by @0xClandestine in #1212
- docs: updates for slashing release by @8sunyuan in #1213
- fix: zero duration by @0xrajath in #1216
- fix: compile warnings + ignore non-relevant errors by @0xClandestine in #1220
- test: Certora prover specs and CI by @aehyvari in #1218
- docs: update
effectBlock
on allocation delay; add undelegate dual slash edge case by @ypatil12 in #1221 - test: refactoring dsf assertions by @eigenmikem in #1217
- chore: update doc version by @ypatil12 in #1224
- feat: cantina audit changes on mainnet release by @ypatil12 in #1288
- feat: mainnet upgrade scripts by @ypatil12 in #1257
New Contributors
Full Changelog: v0.5.4...v1.3.0
v1.4.1-testnet-holesky
Overview
This release includes changes from our Cantina Competition Audit. There are no breaking changes from v1.4.0
.
The audit-related changes include the below PRs:
Full Changelog
- docs: add StrategyBase accounting doc by @nadir-akhtar in #1233
- feat: v1.4.0 upgrade script by @ypatil12 in #1244
- chore: add release label by @bowenli86 in #1253
- feat: support all characters after colon by @0xClandestine in #1255
- docs: Clarify AVS Meaning for AllocationManager and Effect of invoking updateAVSMetadataURI by @wesfloyd in #1259
- chore: add missing fn to interface by @0xClandestine in #1271
- chore: address ep/epm informational by @ypatil12 in #1272
- docs: post-cantina doc updates by @ypatil12 in #1266
- fix(cantina): deposit share cast bug by @8sunyuan in #1265
- chore: add event to dsf reset on full withdrawal by @eigenmikem in #1270
- feat: cantina preprod/testnet upgrade scripts by @ypatil12 in #1286
- fix: v1.4.1 execute script name by @ypatil12 in #1297
Full Changelog: v1.4.0-testnet-holesky...v1.4.1-testnet-holeksy
v1.3.0-rc.0
Overview
This is the release candidate for the upcoming EigenLayer mainnet slashing release. It encompasses changes from two external audits along with several testing upgrades.
Note: This release is the similar to our v1.4.0.tesnet-holesky
release, except it does not include any Pectra compatibility changes. We anticipate slashing to be deployed on mainnet prior to the mainnet Pectra hard fork.
Breaking Changes
- Require AVS Metadata Registration prior to Opset Creation #1025
- Rename
getQueuedWithdrawal
->queuedWithdrawals
: #1133.getQueuedWithdrawal
still exists, but changes the behavior ofgetQueuedWithdrawals
. - Behavior of
getMinimumSlashableStake
: #1037 encumberedMagnitude
getter: #1038ISignatureUtils
->ISignatureUtilsMixin
andISignatureUtilsMixinTypes
: #1015
What's Changed
- docs: rewards v2 audit report by @0xrajath in #1021
- chore: merge
dev
totestnet-holesky
by @0xrajath in #1032 - feat: slashing release by @8sunyuan in #679
- feat: rewards v2.1 by @0xClandestine in #1011
- feat: storage-diff.sh by @0xClandestine in #1054
- docs: Rewards v2.1 by @nadir-akhtar in #1055
- refactor: quality of life improvements by @0xClandestine in #1006
- fix: enforce no compile warnings by @0xClandestine in #1057
- chore: rewards v2.1 zeus script by @0xrajath in #1058
- docs: updated rewards v2.1 docs by @0xrajath in #1061
- test: improve coverage by @0xClandestine in #1059
- feat: ci storage check required by @0xClandestine in #1062
- docs: fix broken link by @dabit3 in #907
- docs: rm -rf docs/storage-report by @0xClandestine in #1063
- feat: add size diff workflow by @0xClandestine in #1065
- chore: remove old release scripts by @0xClandestine in #1066
- fix: zeus upgrade name by @0xrajath in #1068
- chore: vscode settings json by @0xrajath in #1071
- fix(ci): intense test errors by @0xClandestine in #1072
- chore: update to open source zeus repo by @jbrower95 in #1084
- fix: remove deprecated hardhat configs by @bowenli86 in #1090
- perf: parallelize foundry workflows by @bowenli86 in #1094
- refactor: limit continuous fuzzing to dev branch by @bowenli86 in #1101
- refactor: registrar interfaces by @8sunyuan in #1102
- feat: alm upgrade script by @8sunyuan in #1103
- perf: use x64 16core machine for CI by @bowenli86 in #1099
- fix: remove tsconfig by @bowenli86 in #1114
- perf: run Foundry CI tests only for relevant code changes by @bowenli86 in #1112
- perf: speed up test coverage job in CI by @bowenli86 in #1115
- docs: fix all misspellings by @0xClandestine in #1119
- perf: install lcov via prebuilt binary, instead of via apt by @bowenli86 in #1123
- perf: add cache for forge build by @bowenli86 in #1125
- feat: add typos-cli ci check by @0xClandestine in #1126
- feat: slashing audit fixes by @wadealexc in #1046
- fix: disable foundry ci suite path check by @0xClandestine in #1159
- chore: re-enable foundry ci suite path check by @bowenli86 in #1160
- docs: add warning in PR template by @0xClandestine in #1174
- feat: add pull request labeler to ci pipeline by @0xClandestine in #1177
- chore: improve labeler config by @0xClandestine in #1185
- chore: improve labeler config by @0xClandestine in #1186
- chore(ci): lint pr titles by @0xClandestine in #1193
- fix: DSF increase on checkpointed nonzero shares by @ypatil12 in #1176
- chore: disable ci path filtering by @0xClandestine in #1202
- docs(avs-directory): mark AVSDirectory as deprecated by @nadir-akhtar in #1199
- chore: consolidate/update deploy from scratch scripts by @ypatil12 in #1209
- test: slashing integration testing by @ypatil12 in #1211
- chore: forge fmt tests by @0xClandestine in #1212
- docs: updates for slashing release by @8sunyuan in #1213
- fix: zero duration by @0xrajath in #1216
- fix: compile warnings + ignore non-relevant errors by @0xClandestine in #1220
- test: Certora prover specs and CI by @aehyvari in #1218
- docs: update
effectBlock
on allocation delay; add undelegate dual slash edge case by @ypatil12 in #1221 - test: refactoring dsf assertions by @eigenmikem in #1217
- chore: update doc version by @ypatil12 in #1224
New Contributors
Full Changelog: v0.5.4...v1.3.0
v1.4.0
Overview
This is the release candidate for the upcoming EigenLayer mainnet slashing release. It encompasses changes from two external audits along with several testing upgrades. Full release notes here.
Note: This release is the similar to our v1.3.0.rc-1
release, except it DOES include Pectra compatibility changes. We anticipate slashing to be deployed on mainnet prior to the mainnet Pectra hard fork. The minor version 1.3
is skipped on testnet to align delivery order with mainnet.
Breaking Changes
- Require AVS Metadata Registration prior to Opset Creation #1025
- Rename
getQueuedWithdrawal
->queuedWithdrawals
: #1133.getQueuedWithdrawal
still exists but now matches the behavior ofgetQueuedWithdrawals
, except it returns shares for a single root. - Behavior of
getMinimumSlashableStake
: #1037 encumberedMagnitude
getter: #1038ISignatureUtils
->ISignatureUtilsMixin
andISignatureUtilsMixinTypes
: #1015
What's Changed
- chore: update addresses for slashing by @ypatil12 in #974
- fix: default split frontrun patch upgrade by @0xrajath in #991
- docs: rewards v2 audit report by @0xrajath in #1021
- chore: merge
dev
totestnet-holesky
by @0xrajath in #1032 - feat: slashing release by @8sunyuan in #679
- feat: rewards v2.1 by @0xClandestine in #1011
- feat: storage-diff.sh by @0xClandestine in #1054
- docs: Rewards v2.1 by @nadir-akhtar in #1055
- refactor: quality of life improvements by @0xClandestine in #1006
- fix: enforce no compile warnings by @0xClandestine in #1057
- chore: rewards v2.1 zeus script by @0xrajath in #1058
- docs: updated rewards v2.1 docs by @0xrajath in #1061
- test: improve coverage by @0xClandestine in #1059
- feat: ci storage check required by @0xClandestine in #1062
- docs: fix broken link by @dabit3 in #907
- docs: rm -rf docs/storage-report by @0xClandestine in #1063
- feat: add size diff workflow by @0xClandestine in #1065
- chore: remove old release scripts by @0xClandestine in #1066
- fix: zeus upgrade name by @0xrajath in #1068
- chore: vscode settings json by @0xrajath in #1071
- fix(ci): intense test errors by @0xClandestine in #1072
- chore: update to open source zeus repo by @jbrower95 in #1084
- fix: remove deprecated hardhat configs by @bowenli86 in #1090
- perf: parallelize foundry workflows by @bowenli86 in #1094
- refactor: limit continuous fuzzing to dev branch by @bowenli86 in #1101
- refactor: registrar interfaces by @8sunyuan in #1102
- feat: alm upgrade script by @8sunyuan in #1103
- perf: use x64 16core machine for CI by @bowenli86 in #1099
- fix: remove tsconfig by @bowenli86 in #1114
- perf: run Foundry CI tests only for relevant code changes by @bowenli86 in #1112
- perf: speed up test coverage job in CI by @bowenli86 in #1115
- docs: fix all misspellings by @0xClandestine in #1119
- perf: install lcov via prebuilt binary, instead of via apt by @bowenli86 in #1123
- perf: add cache for forge build by @bowenli86 in #1125
- feat: add typos-cli ci check by @0xClandestine in #1126
- feat: slashing audit fixes by @wadealexc in #1046
- fix: disable foundry ci suite path check by @0xClandestine in #1159
- chore: re-enable foundry ci suite path check by @bowenli86 in #1160
- docs: add warning in PR template by @0xClandestine in #1174
- feat: add pull request labeler to ci pipeline by @0xClandestine in #1177
- chore: improve labeler config by @0xClandestine in #1185
- chore: improve labeler config by @0xClandestine in #1186
- chore(ci): lint pr titles by @0xClandestine in #1193
- fix: DSF increase on checkpointed nonzero shares by @ypatil12 in #1176
- chore: disable ci path filtering by @0xClandestine in #1202
- docs(avs-directory): mark AVSDirectory as deprecated by @nadir-akhtar in #1199
- chore: consolidate/update deploy from scratch scripts by @ypatil12 in #1209
- test: slashing integration testing by @ypatil12 in #1211
- chore: forge fmt tests by @0xClandestine in #1212
- docs: updates for slashing release by @8sunyuan in #1213
- fix: zero duration by @0xrajath in #1216
- fix: compile warnings + ignore non-relevant errors by @0xClandestine in #1220
- test: Certora prover specs and CI by @aehyvari in #1218
- docs: update
effectBlock
on allocation delay; add undelegate dual slash edge case by @ypatil12 in #1221 - test: refactoring dsf assertions by @eigenmikem in #1217
- chore: update doc version by @ypatil12 in #1224
- docs: Explaining Minimum Slashable Stake in Better Detail by @wesfloyd in #1225
- chore: certora workflow update by @8sunyuan in #1222
- docs: update rewards calculation link by @0xrajath in #1229
- docs: non-standard erc20 note by @0xrajath in #1236
- feat: pectra compatibility by @ypatil12 in #1155
New Contributors
Full Changelog: v1.2.0-testnet-holesky...v1.4.0-testnet-holesky
v1.2.0-testnet-holesky
Overview
This is the release to make EigenPods Pectra-Comptiable. There are no breaking changes. As part of this release, we also add support for compounding withdrawal credentials (0x02 validators). For more information on off-chain implications, see our Pectra guide
Summary of Changes
Full Changelog: v1.1.1...v1.2.0
v.1.1.1-testnet.holesky
Overview
This release is a hotfix upgrade to preprod
/testnet
with the purpose of unblocking AVSs and their integration with Slashing. It addresses some edge cases uncovered during audit and integration testing from AVS partners.
The changes in this upgrade are being prioritized to go live prior to a larger patch with the majority of the audit fix changes. This is scheduled for early March, and it progress can be viewed here #1046 or in the slashing-magnitude-fixes branch.
We are splitting these releases due to the interface changes we note below. As they may necessitate small reworks from AVSs, we are releasing them in advance of a larger patch with the remaining audit fixes.
Note: The rewards v2.1 changes in v1.1.1 are part of this release.
What's Changed
-
Added
address avs
field in calldata ofIAVSRegistry.registerOperator
,IAVSRegistry.deregisterOperator
- The interface
IAVSreigsitry
can be found here.
- The interface
-
Added
IAVSRegistry.supportsAVS(avs)
interface which is checked upon setting an AVS registry.
There are now additional checks on the AVS registry being set to prevent registries being used without consent for multiple AVSs. Theaddress avs
field should also be verified by AVSs upon callbacks. -
Removed the try/catch on
AllocationManager.deregisterFromOperatorSets
Operator deregistration will be a atomic interaction between the core and AVS contracts with the try/catch being removed. AVSs won’t have to account for how previously an operator could be still seen as registered in AVS contracts but have deregistered on the AllocationManager. -
OperatorSets require
avs metadata
being set before they are created.
Full Changelog: v1.0.3...yash/merge-rewardsv2.1-in-v1.1.1
v1.1.0-testnet.holesky
What's Changed
- chore: update addresses for slashing by @ypatil12 in #974
- fix: default split frontrun patch upgrade by @0xrajath in #991
- docs: rewards v2 audit report by @0xrajath in #1021
- chore: merge
dev
totestnet-holesky
by @0xrajath in #1032 - feat: slashing release by @8sunyuan in #679
- feat: rewards v2.1 by @0xClandestine in #1011
- feat: storage-diff.sh by @0xClandestine in #1054
- docs: Rewards v2.1 by @nadir-akhtar in #1055
- refactor: quality of life improvements by @0xClandestine in #1006
- fix: enforce no compile warnings by @0xClandestine in #1057
- chore: rewards v2.1 zeus script by @0xrajath in #1058
- docs: updated rewards v2.1 docs by @0xrajath in #1061
- test: improve coverage by @0xClandestine in #1059
- feat: ci storage check required by @0xClandestine in #1062
- docs: fix broken link by @dabit3 in #907
- docs: rm -rf docs/storage-report by @0xClandestine in #1063
- feat: add size diff workflow by @0xClandestine in #1065
- chore: remove old release scripts by @0xClandestine in #1066
- fix: zeus upgrade name by @0xrajath in #1068
Full Changelog: v1.0.3...v1.1.0-testnet