Skip to content

Commit 7c32f61

Browse files
JuArceglpecile
andauthored
docs: add operator FAQ and troubleshooting guide (#920)
Co-authored-by: Gian <[email protected]>
1 parent e282e12 commit 7c32f61

File tree

3 files changed

+113
-0
lines changed

3 files changed

+113
-0
lines changed

docs/SUMMARY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@
3737
## Operators
3838

3939
* [Running an operator](operator_guides/0_running_an_operator.md)
40+
* [Operator FAQ](operator_guides/1_operator_FAQ.md)
41+
* [Troubleshooting](operator_guides/2_troubleshooting.md)
4042

4143
## Useful links
4244

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Operator FAQ
2+
3+
The EigenLayer Operator FAQ is available [here](https://docs.eigenlayer.xyz/eigenlayer/operator-guides/operator-faq).
4+
5+
### How do I get whitelisted to run an operator?
6+
7+
To get whitelisted,
8+
you need to fill out the form available [here](https://docs.google.com/forms/d/e/1FAIpQLSdH9sgfTz4v33lAvwj6BvYJGAeIshQia3FXz36PFfF-WQAWEQ/viewform)
9+
and wait for the Aligned team to approve your request.
10+
11+
### What RPC should I use?
12+
13+
We suggest you use your own nodes for better performance and reliability. Note that the node must support HTTP and WebSockets.
14+
15+
We also recommend the following RPC providers:
16+
17+
- [Infura](https://infura.io/)
18+
- [Blast](https://blastapi.io/)
19+
20+
The default configuration uses the public nodes RPC.
21+
22+
Since `v0.5.2`, there is a fallback mechanism to have two RPCs, so you need to add a second RPC for redundancy.
23+
24+
### How can I check if the version I'm using is the latest one?
25+
26+
You can check the latest version available on the [releases' page](https://github.com/yetanotherco/aligned_layer/releases).
27+
28+
### How do I check the operator version registered on the Aligned version tracking system?
29+
30+
You can get the registered version of your operator by running the following command:
31+
32+
```bash
33+
curl https://holesky.tracker.alignedlayer.com/versions/<operator_address>
34+
```
35+
36+
Replace `<operator_address>` with your operator address.
37+
38+
In future releases, the explorer will show the operator version and the latest available version.
39+
40+
### How do I check the operator version locally?
41+
42+
To see the operator version, run:
43+
44+
```bash
45+
./operator/build/aligned-operator --version
46+
```
47+
48+
You have to be in the root `aligned-layer` directory to run this command.
49+
50+
This will show the version of the operator you have built in your filesystem.
51+
52+
### How do I get the ID of the operator?
53+
54+
You can get the ID of the operator by running the following command:
55+
56+
```bash
57+
cast call \
58+
--rpc-url https://ethereum-holesky-rpc.publicnode.com \
59+
0xD0A725d82649f9e4155D7A60B638Fe33b3F25e3b \
60+
"getOperatorId(address operator)(bytes32)" <operator_address>
61+
```
62+
63+
> Note: You need to have installed [Foundry](https://book.getfoundry.sh/)
64+
65+
This will return the operator ID if the operator is registered, otherwise it will return `0x`.
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Troubleshooting
2+
3+
### How to resolve the error "Error in new task subscription"
4+
5+
This error is caused by the operator not being able to subscribe to the task.
6+
7+
Make sure you have configured the RPC correctly and verify that the node is running.
8+
9+
The following RPC providers are known to have issues:
10+
11+
- [dRPC](https://drpc.org/)
12+
13+
### My operator is not showing up on the Aligned Explorer
14+
15+
The [explorer](https://explorer.alignedlayer.com/) does not update the operator status in real time.
16+
The explorer updates the operators' list every 1 hour.
17+
18+
If your operator is not showing up after 1 hour, please check the following:
19+
20+
- The operator is **whitelisted** on the Aligned AVS, you can run the following command:
21+
22+
```bash
23+
cast call \
24+
--rpc-url https://ethereum-holesky-rpc.publicnode.com \
25+
0x3aD77134c986193c9ef98e55e800B71e72835b62 \
26+
"isWhitelisted(address _address)(bool)" <operator_address>
27+
```
28+
29+
If the operator is whitelisted, it will return `true`.
30+
31+
- The operator is **registered** on the Aligned AVS:
32+
33+
```bash
34+
cast call \
35+
--rpc-url https://ethereum-holesky-rpc.publicnode.com \
36+
0xD0A725d82649f9e4155D7A60B638Fe33b3F25e3b \
37+
"getOperatorId(address operator)(bytes32)" <operator_address>
38+
```
39+
40+
If the operator is not registered, it will return `0x0` otherwise it will return the operator ID.
41+
42+
### How to resolve the error "Eth ws url or fallback is empty" or "Eth rpc url or fallback is empty"
43+
44+
This error is caused by the operator not being able to get the RPC urls.
45+
46+
Make sure you have configured the RPC correctly in the [config file](0_running_an_operator.md#step-3---update-the-configuration-for-your-specific-operator).

0 commit comments

Comments
 (0)