-
Notifications
You must be signed in to change notification settings - Fork 17
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
Update README #76
Update README #76
Conversation
ines-toupeira
commented
Dec 5, 2024
- clarification of the purpose of the validators-api
- improvement on the overall README and JSON schema
- clarification of the purpose of the validators-api - improvement on the JSON schema specifications
Deploying validators-api-mainnet with Cloudflare Pages
|
Deploying validators-api-testnet with Cloudflare Pages
|
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 job!
Most of comments are subjetive, so feel free to reject them.
The main blocker now is to make sure that the links to the example are ok
README.md
Outdated
- Use the provided example template in the directory to structure your data. | ||
3. Review the [Description Guidelines](#recommendations-for-your-validator-information). | ||
4. Learn about the [JSON Schema](#validator-json-schema). | ||
5. Submit a PR to this repository. A Nimiq team member will review your submission. |
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.
At the moment this process is quite opaque and slow (up to 3 days).
Can we add something about this? We need to be more transparent:
- Why it takes so much?
- What are we verifying exactly?
- We need to verify the website contents
- We need to verify that the fee stated by the validator is what actually is doing (not sure how this is being tested, ask Micha)...
Not sure if this is the place
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 talked to Micha and Richy. The PR will be reviewed in up to 3 days; fee verification is an ongoing process. In this README, I will only mention it in the PR verification. The fee verification time will be updated in the pool guidelines
README.md
Outdated
- `name`: The name of your validator. If you don’t provide a name, your validator address will be used by default. | ||
- `description`: A short description of your validator. Use this to highlight what makes your validator unique or appealing to stakers. | ||
- `address`: The address of the validator in this format `NQXX XXXX XXXX XXXX XXXX XXXX XXXX XXXX XXXX`. | ||
- `fee`: A percentage fee between 0 and 1 (0.05 represents a 5% fee). |
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.
Not sure if this is clear enough 🙈 .
Maybe overthinking, but something like this might be clearer?
- Fee information. You need to add ONE of the following:
- For static fees, use `fee`. A percentage fee between 0 and 1 (0.05 represents a 5% fee).
- For dynamic fees, you need to add three keys:
- `feeLowest`: The minimum possible fee.
- `feeHighest`: The maximum possible fee.
- `feeDescription`: Outline the conditions for various fees.
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 job!
Most of comments are subjetive, so feel free to reject them.
The main blocker now is to make sure that the links to the example are ok
commit: |
@onmax I don't think we should include other file changes except the readme and the |
I know. I was looking how we can detach the commits I made from this PR but not sure how I can do it... |
5dd77a3
to
5f2bbea
Compare