Skip to content

Commit

Permalink
Add --validators-builder-registration-default-gas-limit (#631)
Browse files Browse the repository at this point in the history
* Add `--validators-builder-registration-default-gas-limit`

* try to fix lint

* fix one linting error

* edits

---------

Co-authored-by: Alexandra Tran <alexandratran@protonmail.com>
StefanBratanov and alexandratran authored Jan 15, 2025
1 parent 5271895 commit 0c24450
Showing 2 changed files with 47 additions and 5 deletions.
16 changes: 11 additions & 5 deletions docs/how-to/configure/use-proposer-config-file.md
Original file line number Diff line number Diff line change
@@ -6,7 +6,8 @@ sidebar_position: 2

# Use a proposer configuration file

You can define complex fee recipient and [builder network](builder-network.md) configurations for multiple validators using a proposer configuration file. Specify the proposer configuration file using the [`--validators-proposer-config`](../../reference/cli/index.md#validators-proposer-config) command line option.
You can define complex fee recipient and [builder network](builder-network.md) configurations for multiple validators using a proposer configuration file.
Specify the proposer configuration file using the [`--validators-proposer-config`](../../reference/cli/index.md#validators-proposer-config) command line option.

:::note

@@ -25,9 +26,12 @@ Attributes for each proposer configuration are:

- `fee_recipient` - (optional in `proposer_config` but required in `default_config`) The fee recipient to use when proposing blocks.
- `builder` - (optional) The [builder network configuration](builder-network.md), which includes the following attributes:
- `enabled` - (optional in `proposer_config` but required in `default_config`) Indicates whether to use the [builder endpoint](../../reference/cli/index.md#builder-endpoint) when proposing blocks. The default is `false`.
- `gas_limit` - (optional) Gas limit for the builder. The default is `30000000`.
- `registration_overrides` - (optional) Dedicated overrides to use during the registration process. Useful for distributed validator technology (DVT) and secret shared validator (SSV) technology. The override is specified using the following attributes:
- `enabled` - (optional in `proposer_config` but required in `default_config`) Indicates whether to use the [builder endpoint](../../reference/cli/index.md#builder-endpoint) when proposing blocks.
The default is `false`.
- `gas_limit` - (optional) Gas limit for the builder. The default is `36000000`.
- `registration_overrides` - (optional) Dedicated overrides to use during the registration process.
Useful for distributed validator technology (DVT) and secret shared validator (SSV) technology.
The override is specified using the following attributes:
- `timestamp` - (optional) Timestamp to be used (instead of the current time) in the validator registration message.
- `public_key` - (optional in `proposer_config` but forbidden in `default_config`) Public key to be used (instead of the validator's public key) in the validator registration message.

@@ -217,4 +221,6 @@ The following is a proposer configuration example using distributed validator te
}
```

In this example, the builder is enabled by default, with `timestamp` registration override. Each validator has its own `public_key` override. All validators use the same `0x6e35733c5af9B61374A128e6F85f553aF09ff89A` as `fee_recipient`.
In this example, the builder is enabled by default, with `timestamp` registration override.
Each validator has its own `public_key` override.
All validators use the same `0x6e35733c5af9B61374A128e6F85f553aF09ff89A` as `fee_recipient`.
36 changes: 36 additions & 0 deletions docs/reference/cli/index.md
Original file line number Diff line number Diff line change
@@ -3308,6 +3308,42 @@ validators-builder-registration-default-enabled: true
Enables or disables registering all validators managed by the validator client to the
[builder endpoint](../../how-to/configure/builder-network.md) when proposing a block.

### `validators-builder-registration-default-gas-limit`

<Tabs>
<TabItem value="Syntax" label="Syntax" default>

```bash
--validators-builder-registration-default-gas-limit=<NUMBER>
```

</TabItem>
<TabItem value="Example" label="Example" >

```bash
--validators-builder-registration-default-gas-limit=40000000
```

</TabItem>
<TabItem value="Environment variable" label="Environment variable" >

```bash
TEKU_VALIDATORS_BUILDER_REGISTRATION_DEFAULT_GAS_LIMIT=40000000
```

</TabItem>
<TabItem value="Configuration file" label="Configuration file" >

```bash
validators-builder-registration-default-gas-limit: 40000000
```

</TabItem>
</Tabs>

The gas limit used for [registering validators to the builder endpoint](../../how-to/configure/builder-network.md#3-register-the-validator).
The default is `36000000`.

### `validators-early-attestations-enabled`

<Tabs>

0 comments on commit 0c24450

Please sign in to comment.