{"id":28095934,"url":"https://github.com/evmos/validator-status","last_synced_at":"2025-07-14T10:34:01.642Z","repository":{"id":230092082,"uuid":"778311908","full_name":"evmos/validator-status","owner":"evmos","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-28T14:34:55.000Z","size":168,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T19:50:42.052Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evmos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-27T13:41:32.000Z","updated_at":"2024-03-27T18:11:33.000Z","dependencies_parsed_at":"2024-03-27T20:27:18.070Z","dependency_job_id":"0e4b1093-ffa1-4d0c-befd-89c00f1ed83a","html_url":"https://github.com/evmos/validator-status","commit_stats":null,"previous_names":["evmos/validator-status"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/evmos/validator-status","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmos%2Fvalidator-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmos%2Fvalidator-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmos%2Fvalidator-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmos%2Fvalidator-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evmos","download_url":"https://codeload.github.com/evmos/validator-status/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evmos%2Fvalidator-status/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265280977,"owners_count":23739859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-13T16:17:12.368Z","updated_at":"2025-07-14T10:34:01.631Z","avatar_url":"https://github.com/evmos.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Validator status\n\n## Config\n\nThe program requieres a `config.json` file to be executed, by default it will look at the path `./config.json` but it can be modified by the flag `--config`\n\nConfig Example:\n\n```json\n{\n  \"logfile\": \"\",\n  \"dbfile\": \"status.db\",\n  \"httpserver\": {\n    \"address\": \"0.0.0.0\",\n    \"port\": \"42069\"\n  },\n  \"cosmosapi\": \"localhost:1317\",\n  \"cosmosrpc\": \"localhost:26656\",\n  \"pruneoffset\": 100,\n  \"refreshduration\": \"5s\",\n  \"apimaxlimit\": 100\n}\n```\n\n- `Pruneoffset` is the value of your node pruned settings. The program will use the information from the latest height - pruneoffset to index the chain\n- `Refreshduration` is the time the program will wait until pulling new blocks values\n- `APIMaxLimit` is the max range allowed by the api, if the range if bigger than the one set, the query will overwrite the `end` value\n\n## Run\n\n- Clone the repo\n- Create the `config.json` file in the root of the repo\n- Run `make run`\n\n## Database\n\n- Schema: `sql/schema.sql`\n- Queries: `sql/queries.sql`\n\nGenerate the go files to interact with the database:\n\n```sh\nmake generate\n```\n\n_NOTE: you need `sqlc` to generate the files, run `make install-deps` if you need it_\n\n## Queries:\n\n### Request all the validators info by block height\n\n- Request\n\n```sh\ncurl \"http://localhost:42069/api?start=7313145\"\n```\n\n_NOTE: optional parameter `end` to set a rangeof blocks_\n\n- Response\n\n```json\n{\n  \"values\": [\n    {\n      \"ID\": 3337,\n      \"Height\": 7313145,\n      \"ValidatorID\": 20,\n      \"Missed\": 0,\n      \"ID_2\": 20,\n      \"OperatorAddress\": \"ethmvaloper1kdtjxywfvwq94jsst2uyshwkel6dwdv5vlf4l2\",\n      \"Pubkey\": \"TP8Ncm5KUUT3bQgN5SsQADVtPEwaW7O0MY5yX+ztJuE=\",\n      \"ValidatorAddress\": \"ethmvalcons1qwcmnlr2kwuunpmh0s4pshrgz5zqd9m7ljs8lu\",\n      \"Moniker\": \"evmOS\",\n      \"Indentity\": \"\"\n    },\n    {\n      \"ID\": 3338,\n      \"Height\": 7313145,\n      \"ValidatorID\": 13,\n      \"Missed\": 2,\n      \"ID_2\": 13,\n      \"OperatorAddress\": \"ethmvaloper1weh6nan3p8cpg7hsfke8teksjnf5pdl8ve97ny\",\n      \"Pubkey\": \"LxQKOI9n5enbjflu802ZL77lyYLHuejIu9o3FXQ3EOc=\",\n      \"ValidatorAddress\": \"ethmvalcons1qkxa6u5tdr820pv9kjc5rlf8p0r7qqr25fenyw\",\n      \"Moniker\": \"peersyst-node-3\",\n      \"Indentity\": \"14329789E9E20C43\"\n    },\n    ...\n  ]\n}\n```\n\n### Request all one validators info by block height\n\n- Request\n\n```sh\ncurl \"http://localhost:42069/api?start=7313145\u0026validator=ethmvaloper1weh6nan3p8cpg7hsfke8teksjnf5pdl8ve97ny\"\n```\n\n_NOTE: optional parameter `end` to set a rangeof blocks_\n\n- Response\n\n```json\n{\n  \"values\": [\n    {\n      \"ID\": 3338,\n      \"Height\": 7313145,\n      \"ValidatorID\": 13,\n      \"Missed\": 2,\n      \"ID_2\": 13,\n      \"OperatorAddress\": \"ethmvaloper1weh6nan3p8cpg7hsfke8teksjnf5pdl8ve97ny\",\n      \"Pubkey\": \"LxQKOI9n5enbjflu802ZL77lyYLHuejIu9o3FXQ3EOc=\",\n      \"ValidatorAddress\": \"ethmvalcons1qkxa6u5tdr820pv9kjc5rlf8p0r7qqr25fenyw\",\n      \"Moniker\": \"peersyst-node-3\",\n      \"Indentity\": \"14329789E9E20C43\"\n    }\n  ]\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevmos%2Fvalidator-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevmos%2Fvalidator-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevmos%2Fvalidator-status/lists"}