Reformat tables and add borders (#3377)

## Proposed Changes

This PR reformats Markdown tables and ensures all tables have borders.
This commit is contained in:
Justin Traglia 2022-07-27 00:51:07 +00:00
parent 0f62d900fe
commit e29765e118
4 changed files with 98 additions and 98 deletions

View File

@ -23,11 +23,11 @@ states to slow down dramatically. A lower _slots per restore point_ value (SPRP)
frequent restore points, while a higher SPRP corresponds to less frequent. The table below shows frequent restore points, while a higher SPRP corresponds to less frequent. The table below shows
some example values. some example values.
| Use Case | SPRP | Yearly Disk Usage | Load Historical State | | Use Case | SPRP | Yearly Disk Usage | Load Historical State |
| ---------------------- | -------------- | ----------------- | --------------------- | |--------------------------|------|-------------------|-----------------------|
| Block explorer/analysis | 32 | 1.4 TB | 155 ms | | Block explorer/analysis | 32 | 1.4 TB | 155 ms |
| Hobbyist (prev. default) | 2048 | 23.1 GB | 10.2 s | | Hobbyist (prev. default) | 2048 | 23.1 GB | 10.2 s |
| Validator only (default) | 8192 | 5.7 GB | 41 s | | Validator only (default) | 8192 | 5.7 GB | 41 s |
As you can see, it's a high-stakes trade-off! The relationships to disk usage and historical state As you can see, it's a high-stakes trade-off! The relationships to disk usage and historical state
load time are both linear doubling SPRP halves disk usage and doubles load time. The minimum SPRP load time are both linear doubling SPRP halves disk usage and doubles load time. The minimum SPRP

View File

@ -24,12 +24,12 @@ Returns the software version and `git` commit hash for the Lighthouse binary.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/version` | Path | `/lighthouse/version` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Response Body ### Example Response Body
@ -47,12 +47,12 @@ Returns information regarding the health of the host machine.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/health` | Path | `/lighthouse/health` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
*Note: this endpoint is presently only available on Linux.* *Note: this endpoint is presently only available on Linux.*
@ -83,12 +83,12 @@ Returns the Ethereum proof-of-stake consensus specification loaded for this vali
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/spec` | Path | `/lighthouse/spec` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Response Body ### Example Response Body
@ -168,12 +168,12 @@ file may be read by a local user with access rights.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------|
Path | `/lighthouse/auth` | Path | `/lighthouse/auth` |
Method | GET | Method | GET |
Required Headers | - | Required Headers | - |
Typical Responses | 200 | Typical Responses | 200 |
### Example Path ### Example Path
@ -195,12 +195,12 @@ Lists all validators managed by this validator client.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators` | Path | `/lighthouse/validators` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Response Body ### Example Response Body
@ -232,12 +232,12 @@ Get a validator by their `voting_pubkey`.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators/:voting_pubkey` | Path | `/lighthouse/validators/:voting_pubkey` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200, 400 | Typical Responses | 200, 400 |
### Example Path ### Example Path
@ -262,12 +262,12 @@ Update some values for the validator with `voting_pubkey`.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators/:voting_pubkey` | Path | `/lighthouse/validators/:voting_pubkey` |
Method | PATCH | Method | PATCH |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200, 400 | Typical Responses | 200, 400 |
### Example Path ### Example Path
@ -301,12 +301,12 @@ Validators are generated from the mnemonic according to
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators` | Path | `/lighthouse/validators` |
Method | POST | Method | POST |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Request Body ### Example Request Body
@ -359,12 +359,12 @@ Import a keystore into the validator client.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators/keystore` | Path | `/lighthouse/validators/keystore` |
Method | POST | Method | POST |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Request Body ### Example Request Body
@ -433,12 +433,12 @@ generated with the path `m/12381/3600/i/42`.
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators/mnemonic` | Path | `/lighthouse/validators/mnemonic` |
Method | POST | Method | POST |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200 | Typical Responses | 200 |
### Example Request Body ### Example Request Body
@ -479,12 +479,12 @@ Create any number of new validators, all of which will refer to a
### HTTP Specification ### HTTP Specification
| Property | Specification | | Property | Specification |
| --- |--- | |-------------------|--------------------------------------------|
Path | `/lighthouse/validators/web3signer` | Path | `/lighthouse/validators/web3signer` |
Method | POST | Method | POST |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200, 400 | Typical Responses | 200, 400 |
### Example Request Body ### Example Request Body

View File

@ -4,10 +4,10 @@ When publishing releases, Lighthouse will include an "Update Priority" section i
The "Update Priority" section will include a table which may appear like so: The "Update Priority" section will include a table which may appear like so:
|User Class |Beacon Node | Validator Client| | User Class | Beacon Node | Validator Client |
--- | --- | --- |-------------------|-----------------|------------------|
|Staking Users| Medium Priority | Low Priority | | Staking Users | Medium Priority | Low Priority |
|Non-Staking Users| Low Priority|---| | Non-Staking Users | Low Priority | --- |
To understand this table, the following terms are important: To understand this table, the following terms are important:

View File

@ -79,12 +79,12 @@ for setting the fee recipient dynamically for a given public key. When used, the
will be saved in `validator_definitions.yml` so that it persists across restarts of the validator will be saved in `validator_definitions.yml` so that it persists across restarts of the validator
client. client.
| Property | Specification | | Property | Specification |
| --- | --- | |-------------------|--------------------------------------------|
Path | `/eth/v1/validator/{pubkey}/feerecipient` | Path | `/eth/v1/validator/{pubkey}/feerecipient` |
Method | POST | Method | POST |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 202, 404 | Typical Responses | 202, 404 |
#### Example Request Body #### Example Request Body
```json ```json
@ -114,12 +114,12 @@ null
The same path with a `GET` request can be used to query the fee recipient for a given public key at any time. The same path with a `GET` request can be used to query the fee recipient for a given public key at any time.
| Property | Specification | | Property | Specification |
| --- | --- | |-------------------|--------------------------------------------|
Path | `/eth/v1/validator/{pubkey}/feerecipient` | Path | `/eth/v1/validator/{pubkey}/feerecipient` |
Method | GET | Method | GET |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 200, 404 | Typical Responses | 200, 404 |
```bash ```bash
DATADIR=$HOME/.lighthouse/mainnet DATADIR=$HOME/.lighthouse/mainnet
@ -146,12 +146,12 @@ curl -X GET \
The same path with a `DELETE` request can be used to remove the fee recipient for a given public key at any time. The same path with a `DELETE` request can be used to remove the fee recipient for a given public key at any time.
This is useful if you want the fee recipient to fall back to the validator client (or beacon node) default. This is useful if you want the fee recipient to fall back to the validator client (or beacon node) default.
| Property | Specification | | Property | Specification |
| --- | --- | |-------------------|--------------------------------------------|
Path | `/eth/v1/validator/{pubkey}/feerecipient` | Path | `/eth/v1/validator/{pubkey}/feerecipient` |
Method | DELETE | Method | DELETE |
Required Headers | [`Authorization`](./api-vc-auth-header.md) | Required Headers | [`Authorization`](./api-vc-auth-header.md) |
Typical Responses | 204, 404 | Typical Responses | 204, 404 |
```bash ```bash
DATADIR=$HOME/.lighthouse/mainnet DATADIR=$HOME/.lighthouse/mainnet