-
-
Notifications
You must be signed in to change notification settings - Fork 289
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore: fix prover README typos #6426
Conversation
Codecov Report
Additional details and impacted files@@ Coverage Diff @@
## unstable #6426 +/- ##
============================================
- Coverage 61.72% 61.70% -0.03%
============================================
Files 553 553
Lines 57862 57858 -4
Branches 1829 1828 -1
============================================
- Hits 35717 35701 -16
- Misses 22108 22120 +12
Partials 37 37 |
Performance Report✔️ no performance regression detected Full benchmark results
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The Prover docs definitely need some love, but this needs to be done more thoroughly.
@@ -53,15 +53,15 @@ export const startOptions: CliCommandOptions<StartArgs> = { | |||
}, | |||
|
|||
beaconUrls: { | |||
description: "The beacon node PRC urls for 'rest' mode.", | |||
description: "The beacon node RPC urls for 'rest' mode.", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The beacon node exposes a REST API and does not implement RPC, this is different from execution clients.
The description also reference the mode 'rest' which doesn't even exist?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
RPC is a pretty generic term (unlike JSON-RPC
), so I took it in this way. Can probably be just removed.
Mention of mode
looks like a left-over from previous refactoring.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It even says that for the bootnodes for p2p which we don't even implement? Looks like it was just copy-pasted around without much thought
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
RPC is not generic term, it refers to a certain standard which obviously is not what beacon node APIs complies with. So better to remove that term here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would suggest to remove the beaconBootnodes
option for now in a following PR, as it's not supported (even so it shows a proper error message when used). Would help to clarify for users the available options.
@@ -37,13 +37,12 @@ console.log({balance, address}); | |||
You can also invoke the package as binary. | |||
|
|||
```bash | |||
npm -i g @lodestar/prover | |||
npm i -g @lodestar/prover |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nice catch
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
grrr github. was trying to remove the request changes but didnt work. approving as just agreed with @nflaig so fixing his will also fix mine
beaconBootnodes: { | ||
description: "The beacon node PRC urls for 'p2p' mode.", | ||
description: "Urls of beacon bootnodes to connect to.", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am a bit confused what is meant by beaconBootnodes
, on the one hand in the tests is passes a URL
lodestar/packages/prover/test/e2e/cli/cmds/start.test.ts
Lines 33 to 34 in 42e8835
"--beaconBootnodes", | |
"http://localhost:0000", |
But if those are bootnodes, you would not pass a URL here but an ENR and not connect to them but use them for peer discovery.
This option also give users a false assumption that you can run the light client in p2p mode but this is not even implemented.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Right, I agree it's confusing.
My preference would be:
- do not touch the
beaconBootnodes
as part of this PR - remove the
beaconBootnodes
CLI option in a follow up PR
It's pretty easy to restore this option once it's actually supporte. It also reduces potential user confusion that might see this option exist but not clearly understand that it's not supported because not yet implemented.
I let @nazarhussain shim in if he feels like it should be kept.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd agree, let's remove any changes to beaconBootnodes from this PR and remove it separately to have more visibility on it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
🎉 This PR is included in v1.16.0 🎉 |
Fix prover README typos