Skip to content
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

Merged
merged 5 commits into from
Dec 10, 2024
Merged

Update README #76

merged 5 commits into from
Dec 10, 2024

Conversation

ines-toupeira
Copy link
Member

  • clarification of the purpose of the validators-api
  • improvement on the overall README and JSON schema

onmax and others added 2 commits November 27, 2024 10:36
- clarification of the purpose of the validators-api
- improvement on the JSON schema specifications
Copy link

cloudflare-workers-and-pages bot commented Dec 5, 2024

Deploying validators-api-mainnet with  Cloudflare Pages  Cloudflare Pages

Latest commit: 45af544
Status: ✅  Deploy successful!
Preview URL: https://3d16fe3c.validators-api-mainnet.pages.dev
Branch Preview URL: https://update-guidelines.validators-api-mainnet.pages.dev

View logs

Copy link

cloudflare-workers-and-pages bot commented Dec 5, 2024

Deploying validators-api-testnet with  Cloudflare Pages  Cloudflare Pages

Latest commit: 45af544
Status: ✅  Deploy successful!
Preview URL: https://5a694e7e.validators-api-testnet.pages.dev
Branch Preview URL: https://update-guidelines.validators-api-testnet.pages.dev

View logs

@onmax onmax changed the base branch from main to dev December 5, 2024 22:12
Copy link
Member

@onmax onmax left a 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 Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
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.
Copy link
Member

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?
  1. We need to verify the website contents
  2. 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

Copy link
Member Author

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 Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
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).
Copy link
Member

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.

README.md Outdated Show resolved Hide resolved
Copy link
Member

@onmax onmax left a 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

Copy link

pkg-pr-new bot commented Dec 6, 2024

Open in Stackblitz

npm i https://pkg.pr.new/nimiq/validators-api/nimiq-albatross-policy@76
npm i https://pkg.pr.new/nimiq/validators-api/nimiq-rewards-calculator@76
npm i https://pkg.pr.new/nimiq/validators-api/nimiq-validators-trustscore@76
npm i https://pkg.pr.new/nimiq/validators-api/nimiq-supply-calculator@76

commit: 45af544

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@Albermonte
Copy link
Member

@onmax I don't think we should include other file changes except the readme and the example.json

@onmax
Copy link
Member

onmax commented Dec 6, 2024

@onmax I don't think we should include other file changes except the readme and the example.json

I know. I was looking how we can detach the commits I made from this PR but not sure how I can do it...

@ines-toupeira ines-toupeira requested a review from onmax December 10, 2024 16:58
@onmax onmax merged commit 2762a3f into dev Dec 10, 2024
4 checks passed
@onmax onmax deleted the update-guidelines branch December 10, 2024 19:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants