Skip to content
This repository was archived by the owner on Jun 19, 2025. It is now read-only.

[Do not merge] Sepolia testnet updates #446

Closed
wants to merge 26 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
0256e60
Minimal restructure to demo Concept/How To/Reference/Tutorial approach
MadelineAu Feb 5, 2025
f7c9d9a
fixed redirects and urls
wesfloyd Feb 5, 2025
bd627ef
Addressing review comments
MadelineAu Feb 6, 2025
feae197
Merge branch 'devRestruture' of github.com:MadelineAu/eigenlayer-docs…
MadelineAu Feb 6, 2025
96bbf96
Added redirects
MadelineAu Feb 6, 2025
5264329
fixed redirects
MadelineAu Feb 6, 2025
4e5b0bd
more redirect fixing
MadelineAu Feb 6, 2025
8bff2ec
Merge branch 'MadelineAu-devRestruture'
MadelineAu Feb 6, 2025
9f63380
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 9, 2025
af864c0
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 10, 2025
c49b0e8
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 10, 2025
7e430a0
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 17, 2025
0e1a6eb
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 18, 2025
3ed0774
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 19, 2025
8130497
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 21, 2025
37281a6
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 21, 2025
cf76167
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 21, 2025
6126940
Merge remote-tracking branch 'upstream/main'
MadelineAu Feb 23, 2025
34fad65
Merge remote-tracking branch 'upstream/main'
MadelineAu Mar 3, 2025
e8465ae
Merge remote-tracking branch 'upstream/main'
MadelineAu Mar 4, 2025
d5ab33c
Merge remote-tracking branch 'upstream/main'
MadelineAu Mar 5, 2025
18f4927
Merge remote-tracking branch 'upstream/main'
MadelineAu Mar 5, 2025
cbaee98
Merge remote-tracking branch 'upstream/main'
MadelineAu Mar 6, 2025
bbfe304
Updating for Sepolia launch
MadelineAu Mar 6, 2025
ade320d
Restored snapshot data to original state
MadelineAu Mar 6, 2025
93af9d7
Updating from testnet-holesky branch to testnet-sepolia branch
MadelineAu Mar 6, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions docs/developers/Concepts/eigenlayer-contracts/core-contracts.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@ to the core contracts.

The EigenLayer core contracts are documented in the [eigenlayer-contracts](https://github.com/Layr-Labs/eigenlayer-contracts) repository. The core contracts include:

| Core contract | Description |
|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [StrategyManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#strategymanager) | Responsible for handling the accounting for Restakers as they deposit and withdraw ERC20 tokens from their corresponding strategies. The StrategyManager tracks the amount of restaked assets each Restaker has within Eigenlayer. |
| [DelegationManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#delegationmanager) | Responsible for enabling Restakers to delegate assets to Operators, and withdraw assets. The DelegationManager tracks the amount of assets from each Strategy that have been delegated to each Operator, and tracks accounting for slashing. |
| [EigenPodManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#eigenpodmanager) | Enables native ETH restaking |
| [AllocationManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#allocationmanager) | Responsible for creating Operator Sets, and Operator registrations to Operator Sets. The Allocation Manager also tracks allocation of stake to a Operator Set, and enables AVSs to slash that stake.
| [RewardsCoordinator](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#allocationmanager) | Enables AVSs to distribute ERC20 tokens to Operators and Restakers who delegated assets to Operators. The RewardsCoordinator tracks the rewards and enables Operators and Restakers to claim them.
| [PermissionController](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#permissioncontroller) |Enables AVSs and operators to delegate the ability to call certain core contract functions to other addresses.|
| [AVSDirectory](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-holesky/docs#avsdirectory) | Has been replaced by AllocationManager and will be deprecated in a future release. |
| Core contract | Description |
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [StrategyManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#strategymanager) | Responsible for handling the accounting for Restakers as they deposit and withdraw ERC20 tokens from their corresponding strategies. The StrategyManager tracks the amount of restaked assets each Restaker has within Eigenlayer. |
| [DelegationManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#delegationmanager) | Responsible for enabling Restakers to delegate assets to Operators, and withdraw assets. The DelegationManager tracks the amount of assets from each Strategy that have been delegated to each Operator, and tracks accounting for slashing. |
| [EigenPodManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#eigenpodmanager) | Enables native ETH restaking |
| [AllocationManager](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#allocationmanager) | Responsible for creating Operator Sets, and Operator registrations to Operator Sets. The Allocation Manager also tracks allocation of stake to a Operator Set, and enables AVSs to slash that stake.
| [RewardsCoordinator](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#allocationmanager) | Enables AVSs to distribute ERC20 tokens to Operators and Restakers who delegated assets to Operators. The RewardsCoordinator tracks the rewards and enables Operators and Restakers to claim them.
| [PermissionController](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#permissioncontroller) |Enables AVSs and operators to delegate the ability to call certain core contract functions to other addresses.|
| [AVSDirectory](https://github.com/Layr-Labs/eigenlayer-contracts/tree/testnet-sepolia/docs#avsdirectory) | Has been replaced by AllocationManager and will be deprecated in a future release. |

This documentation matches the functionality available on the Holesky testnet. For mainnet
This documentation matches the functionality available on the Sepolia testnet. For mainnet
specific documentation, refer to the `/docs` repository on the `mainnet` branch in the [eigenlayer-contracts](https://github.com/Layr-Labs/eigenlayer-contracts)
repository.

Expand Down
2 changes: 1 addition & 1 deletion docs/developers/HowTo/build/how-to-build-an-avs.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Operator responses to tasks are often signed using the BLS or ECDSA algorithm. T

The following section covers the minimum set of smart contract integrations and deployment scripts that an AVS needs to build in order to:
1. Be considered a fully functional AVS for demo and proof of concept purposes.
2. Prepare your AVS to integrate Slashing functionality. Slashing is [live on Holesky Testnet](https://www.blog.eigenlayer.xyz/introducing-slashing/) and Mainnet deployment is proposed for late Q1 2025.
2. Prepare your AVS to integrate Slashing functionality. Slashing is [live on testnet](../../../eigenlayer/releases.md) and Mainnet deployment is proposed for late Q1 2025.


:::info
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Operator Sets Overview
---

:::note
Operator Sets are currently available on the Holesky testnet. [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
Operator Sets are currently available on [testnet](../../releases.md). [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
introduced Operator Sets.

Currently, Operators register to an AVS to earn rewards in the AVSDirectory. We recommend existing AVSs [migrate to Operator Sets on testnet](../../../developers/HowTo/slashing/migrate-to-operatorsets.md).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Strategies and Magnitudes
---

:::note
Operator Sets are currently available on the Holesky testnet. [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
Operator Sets are currently available on [testnet](../../releases.md). [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
introduced Operator Sets.
:::

Expand Down
2 changes: 1 addition & 1 deletion docs/eigenlayer/concepts/slashing/slashing-concept.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Slashing Overview
---

:::note
Slashing is currently available on the Holesky testnet. The Slashing release implements [ELIP-002: Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md).
Slashing is currently available on [testnet](../../releases.md). The Slashing release implements [ELIP-002: Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md).
:::

Slashing is a type of penalty determined by an AVS as a deterrent for broken commitments by Operators. Broken commitments
Expand Down
2 changes: 1 addition & 1 deletion docs/eigenlayer/concepts/slashing/unique-stake.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Unique Stake
---

:::note
Operator Sets and Slashing are currently available on the Holesky testnet. [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
Operator Sets and Slashing are currently available on [testnet](../../releases.md). [ELIP-002 Slashing via Unique Stake & Operator Sets](https://github.com/eigenfoundation/ELIPs/blob/main/ELIPs/ELIP-002.md)
introduced Operator Sets and Slashing.
:::

Expand Down
38 changes: 23 additions & 15 deletions docs/eigenlayer/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,51 +2,59 @@
sidebar_position: 3
title: Releases
---
# Mainnet
## Mainnet

The [Rewards v2 release](https://www.blog.eigenlayer.xyz/rewards-v2/) is available on mainnet. The [eigenlayer-contracts](https://github.com/Layr-Labs/eigenlayer-contracts)
and [eigenlayer-middleware](https://github.com/Layr-Labs/eigenlayer-middleware) include the Rewards v2 release on the `mainnet` branch
in each repository.

# Testnet
## Testnet

The [Slashing](https://www.blog.eigenlayer.xyz/introducing-slashing/) and Rewards v2.1 releases are available on the Holesky testnet.
The [Slashing](https://www.blog.eigenlayer.xyz/introducing-slashing/) and Rewards v2.1 releases are available on the Sepolia testnet.
The [eigenlayer-contracts](https://github.com/Layr-Labs/eigenlayer-contracts) and [eigenlayer-middleware](https://github.com/Layr-Labs/eigenlayer-middleware)
include the Slashing release on the `testnet-holesky` branch.
include the Slashing release on the `testnet-sepolia` branch.

:::important
Unless specified otherwise, this documentation matches the functionality available on the Holesky testnet. For mainnet
Unless specified otherwise, this documentation matches the functionality available on the Sepolia testnet. For mainnet
specific documentation, refer to the `/docs` repository on the `mainnet` branch in the [eigenlayer-contracts](https://github.com/Layr-Labs/eigenlayer-contracts)
and [eigenlayer-middleware](https://github.com/Layr-Labs/eigenlayer-middleware) repositories.
:::

## What's changed
### What's changed

### Operator Sets
#### Sepolia Testnet

The Slashing release on the Holesky testnet introduced Operator Sets. The AllocationManager core contract manages Operator Sets and replaces
Due to recent instability on Holesky testnet, EigenLayer has launched on Sepolia. AVS developers can use Sepolia for development and testing.

Currently, EigenPods and native ETH restaking are not available on Holesky. EigenLayer will continue to support Holesky as
it stabilizes for end to end protocol testing.

For more information, refer to the [EigenLayer blog](https://www.blog.eigenlayer.xyz/).

#### Operator Sets

The Slashing release on testnet introduced Operator Sets. The AllocationManager core contract manages Operator Sets and replaces
the AVSDirectory for registering Operators to an AVS. [The AVSDirectory will be deprecated in a future upgrade](https://docs.eigenlayer.xyz/developers/HowTo/slashing/migrate-to-operatorsets).

### Rewards v2.1
#### Rewards v2.1

Rewards v2.1 on the Holesky testnet introduced Operator directed rewards for Operator sets. For AVSs using Operator Sets, use `createOperatorDirectedOperatorSetRewardsSubmission`.
Rewards v2.1 on testnet introduced Operator directed rewards for Operator sets. For AVSs using Operator Sets, use `createOperatorDirectedOperatorSetRewardsSubmission`.
`createAVSRewardsSubmission` and `createOperatorDirectedAVSRewardsSubmission` remain available for use by AVSs that have not yet [migrated to Operator Sets](https://docs.eigenlayer.xyz/developers/HowTo/slashing/migrate-to-operatorsets).

### Release notes
#### Release Notes

For complete release notes, refer to the [`eigenlayer-contracts` repository](https://github.com/Layr-Labs/eigenlayer-contracts/releases).

# SDKs
## SDKs

The [EigenLayer Rust SDK](https://github.com/Layr-Labs/eigensdk-rs) supports two bindngs:
* Rewards v2 - Current mainnet release.
* Slashing - Middleware's dev branch latest commit.

The [EigenLayer Go SDK](https://github.com/Layr-Labs/eigensdk-go) supports the Rewards v2.1 release.

# Samples
## Samples

The [Hello World AVS](https://github.com/Layr-Labs/hello-world-avs) and [Incredible Squaring](https://github.com/Layr-Labs/incredible-squaring-avs)
samples are available to for development and testing to get familiar with EigenLayer. We are currently updating these to
include rewards and slashing capabilities.

include rewards and slashing capabilities.
18 changes: 9 additions & 9 deletions docs/eigenlayer/rewards-claiming/claim-rewards/via-cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,10 +41,10 @@ eigenlayer version v<X.X.X>
```

</TabItem>
<TabItem value="holesky" label="Holesky">
<TabItem value="sepolia" label="Sepolia">
```bash
./bin/eigenlayer rewards show \
--network holesky \
--network sepolia \
--earner-address <earner-address> \
--claim-type unclaimed
```
Expand Down Expand Up @@ -98,13 +98,13 @@ Make sure the keys you are using to claim is the claimer you have set.
`comma-separated-list-of-token-addresses` - You can get this from output of [Step 3](#step-3-check-if-rewards-are-available-to-claim)

</TabItem>
<TabItem value="holesky" label="Holesky">
<TabItem value="sepolia" label="Sepolia">
If you are using local keystore file, use the following command to claim rewards

```bash
./bin/eigenlayer rewards claim \
--network holesky \
--eth-rpc-url <holesky-eth-rpc-url> \
--network sepolia \
--eth-rpc-url <sepolia-eth-rpc-url> \
--earner-address <earner-address> \
--recipient-address <address-to-send-rewards-to> \
--path-to-key-store /path/to/key/store-json \
Expand All @@ -128,21 +128,21 @@ If you want to see the rewards parameters before claiming, you can use the follo

```bash
./bin/eigenlayer rewards claim \
--network holesky \
--network mainnet \
--eth-rpc-url <mainnet-eth-rpc-url> \
--earner-address <earner-address> \
--token-addresses <comma-separated-list-of-token-addresses>
```
`comma-separated-list-of-token-addresses` - You can get this from output of [Step 3](#step-3-check-if-rewards-are-available-to-claim)

</TabItem>
<TabItem value="holesky" label="Holesky">
<TabItem value="sepolia" label="Sepolia">
If you are using local keystore file, use the following command to claim rewards

```bash
./bin/eigenlayer rewards claim \
--network holesky \
--eth-rpc-url <holesky-eth-rpc-url> \
--network sepolia \
--eth-rpc-url <sepolia-eth-rpc-url> \
--earner-address <earner-address> \
--token-addresses <comma-separated-list-of-token-addresses>
```
Expand Down
4 changes: 2 additions & 2 deletions docs/operators/howto/operator-rewards-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,10 @@ Operators can set their per-AVS fee rate via the EigenLayer CLI with the followi

```
# Get the current per-AVS fee rate
eigenlayer-cli operator get-rewards-split --operator-address [operator_address] --avs-address [avs_address] --eth-rpc-url [rpc_endpoint] --network holesky
eigenlayer-cli operator get-rewards-split --operator-address [operator_address] --avs-address [avs_address] --eth-rpc-url [rpc_endpoint] --network sepolia

# Set the current per-AVS fee rate
eigenlayer-cli operator set-rewards-split --operator-address [operator_address] --avs-address [avs_address] --eth-rpc-url [rpc_endpoint] --network holesky --path-to-key-store [path_to_local_operator_ecdsa_keystore.ecdsa.key.json] --operator-split [split in bips] --broadcast
eigenlayer-cli operator set-rewards-split --operator-address [operator_address] --avs-address [avs_address] --eth-rpc-url [rpc_endpoint] --network sepolia --path-to-key-store [path_to_local_operator_ecdsa_keystore.ecdsa.key.json] --operator-split [split in bips] --broadcast
```
Please note the Operator split is denoted in units of bips (basis points). E.g. 1000 = 10%.

Expand Down
4 changes: 2 additions & 2 deletions docs/operators/howto/operator-sets.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Set Allocations per Operator Set and Strategy

```
eigenlayer operator allocations update
--network holesky
--network sepolia
--operator-address <operator-address>
--csv-file updates.csv
--caller-address <address-of-caller>
Expand All @@ -46,7 +46,7 @@ View all your allocations with show command as below

```
eigenlayer operator allocations show
--network holesky
--network sepolia
--operator-address <operator-address>
--strategy-addresses <comma-separated-strategy-addresses>

Expand Down