Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 3 additions & 3 deletions operator/launch-operator-service.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -100,15 +100,15 @@ The Operator Service can be installed as a binary, via Docker, or built from sou
Pull Official Image

```bash
docker pull europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0
docker pull europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0
```

Alternatively, build the Docker image locally:

```bash
git clone https://github.com/stakewise/v3-operator.git
cd v3-operator
docker build --pull -t europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 .
docker build --pull -t europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 .
```

Run commands using this format:
Expand All @@ -117,7 +117,7 @@ The Operator Service can be installed as a binary, via Docker, or built from sou
docker run --rm -ti \
-u $(id -u):$(id -g) \
-v ~/.stakewise/:/data \
europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 \
europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 \
src/main.py COMMAND \
--flagA=123 \
--flagB=xyz
Expand Down
27 changes: 14 additions & 13 deletions operator/staking-nodes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,15 @@ Your execution node must be fully synced and running. Any client that supports t
- **[Reth ↗](https://github.com/paradigmxyz/reth)** — (Ethereum)

:::custom-warning[Configure execution client]
Preserve event logs to ensure the Operator Service functions correctly.
Some clients require specific configuration to sync event logs and prevent event log pruning:
The Operator Service needs event logs from a network checkpoint onward. If your execution client prunes history, retain receipts and logs from at least the following blocks:

| Network | Required from block | Recommended setting |
| --- | --- | --- |
| Ethereum | 25,933,938 | 25,900,000 |
| Hoodi | 3,583,807 | 3,580,000 |
| Gnosis | 48,127,042 | 48,100,000 |

The recommended value rounds down to leave a safety margin; any block at or below it works.

<Tabs groupId="special-config" defaultValue="erigon">
<TabItem value="nethermind" label="Nethermind">
Expand All @@ -39,28 +46,22 @@ Some clients require specific configuration to sync event logs and prevent event
<TabItem value="erigon" label="Erigon">
```bash
# Ethereum Mainnet
erigon --prune=receipts --prune.to=18470089

# For other networks, adjust the block number to the Keeper contract creation block
erigon --prune=receipts --prune.to=25900000
```

These flags prevent pruning of event logs as required by the Operator Service.
</TabItem>
<TabItem value="reth" label="Reth">
Add the following option to Reth command:

```bash
# Ethereum Mainnet
--prune.receiptslogfilter=0x6b5815467da09daa7dc83db21c9239d98bb487b5:before:18470089

# For other networks, adjust the block number to the Keeper contract creation block
--prune.receipts.before=25900000
```

The [Keeper contract ↗](https://etherscan.io/address/0x6B5815467da09DaA7DC83Db21c9239D98Bb487b5#code) on Ethereum Mainnet is located at
`0x6b5815467da09daa7dc83db21c9239d98bb487b5` (must be provided in lowercase).
</TabItem>
</Tabs>

For other networks, use the recommended setting from the table above.

Operator Service versions before v5.1.0 still require the full event log history since the Keeper contract deployment. Upgrade the Operator Service before pruning.
:::

## Consensus Client
Expand Down
2 changes: 1 addition & 1 deletion operator/start-operator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Choose the format matching your installation method:
<CommandSnippet template={`docker run --restart on-failure:10 \\
-u $(id -u):$(id -g) \\
-v ~/.stakewise/:/data \\
europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 \\
europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 \\
src/main.py start \\
--vault={{0x834F27bC8670491b75af512d943f01D5383F87Cf}} \\
--data-dir=/data \\
Expand Down
Loading