{"id":19067097,"url":"https://github.com/x-cash-official/delegates-explorer","last_synced_at":"2025-10-13T00:11:58.282Z","repository":{"id":39011226,"uuid":"193383299","full_name":"X-CASH-official/delegates-explorer","owner":"X-CASH-official","description":"🔍 Delegates Explorer - Delegates, votes, reserve proofs information","archived":false,"fork":false,"pushed_at":"2023-03-05T17:32:58.000Z","size":3442,"stargazers_count":11,"open_issues_count":22,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-28T12:54:10.458Z","etag":null,"topics":["delegates","dpos","website","xcash"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/X-CASH-official.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2019-06-23T18:40:35.000Z","updated_at":"2024-11-15T04:24:41.000Z","dependencies_parsed_at":"2025-04-18T04:47:00.048Z","dependency_job_id":"4493bfb0-1bb6-4c9f-8b59-c34e90db14c8","html_url":"https://github.com/X-CASH-official/delegates-explorer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/X-CASH-official/delegates-explorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-CASH-official%2Fdelegates-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-CASH-official%2Fdelegates-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-CASH-official%2Fdelegates-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-CASH-official%2Fdelegates-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/X-CASH-official","download_url":"https://codeload.github.com/X-CASH-official/delegates-explorer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-CASH-official%2Fdelegates-explorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013621,"owners_count":26085298,"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","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["delegates","dpos","website","xcash"],"created_at":"2024-11-09T00:59:11.450Z","updated_at":"2025-10-13T00:11:58.256Z","avatar_url":"https://github.com/X-CASH-official.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=middle\u003e\n\n\u003ca align=\"center\" href=\"https://x-network.io/xcash\"\u003e\u003cimg src=\"header.png\" alt=\"X-Cash Core\"\u003e\u003c/a\u003e\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat)](https://opensource.org/licenses/MIT)\n[![Discord](https://img.shields.io/discord/470575102203920395?logo=discord)](https://discordapp.com/invite/4CAahnd)\n\n\u003c/div\u003e\n\n# X-Cash Delegates Explorer\n\n**🔍 Check delegates, vote statistics and latest block created.**  \n\n*Admin-panel-styled dashboard forked from [cdk-admin](https://github.com/codetok/cdk-admin), an Angular 6 admin panel using angular material.*\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [Features](#features)\n- [License](#license)\n- [Contributing](#contributing)\n- [Documentation](#documentation)\n- [Security](#security)\n- [System Requirements](#system-requirements)\n- [Installation Process](#installation-process)\n  - [Dependencies](#dependencies)\n  - [Requirements](#requirements)\n  - [Install](#install)\n  - [Testing](#testing)\n\n## Features\n\n**One-stop Dashboard**  \nScroll through all the delegates, their statistics, votes and reserve proofs received.\n\n**Vote Instructions**  \nYou want to become a delegate ? You will find all the information here to register. Want to help a delegate get elected ? Then see how to vote for him/her.\n\n**Blocks Information**  \nThe delegate explorer also acts as the X-Cash blockchain explorer. Verify the content of the blocks at any given time.\n\n## License\n\n**The X-Cash Delegate Explorer is an open-source project managed by the X-Cash Foundation**.  \nWe are operating under the [MIT License](LICENSE).\n\n## Contributing\n\n**Thank you for thinking of contributing! 😃**   \nIf you want to help out, check [CONTRIBUTING](https://github.com/X-CASH-official/.github/blob/master/CONTRIBUTING.md) for a set of guidelines and check our [opened issues](https://github.com/X-CASH-official/delegates-explorer/issues).\n\n## Documentation\n\nWe are hosting our documentation on **GitBook** 👉 [**docs.xcash.foundation**](https://docs.xcash.foundation/)\n\n\u003e You can contribute directly on our [`gitbook-docs`](https://github.com/X-CASH-official/gitbook-docs) repository.\n\n## Security\n\nIf you discover a **security** vulnerability, please send an e-mail to [security@xcash.foundation](mailto:security@xcash.foundation).  \nAll security vulnerabilities concerning the X-Cash blockchain will be promply addressed.\n\n## System Requirements\n\n*The explorer is optional for delegates to run, as the network nodes will run it already.*\n\nTo run the delegates explorer, it needs to be on the same server as an X-Cash node. The system requirements for running a node are in the [`xcash-dpops`](https://github.com/X-CASH-official/xcash-dpops/tree/master#system-requirements) repository.\n\n\u003e At the moment, [`xcash-dpops`](https://github.com/X-CASH-official/xcash-dpops/) is only available for Linux/Unix distributions.\n\n## Installation Process\n\n### Dependencies\n\n\u003e The following table summarizes the tools and libraries required to run the delegates explorer.\n\n| Dependencies | Min. version   | Ubuntu package                                                      |\n| ------------ | -------------- | ------------------------------------------------------------------- |\n| `Node.js`      | 8              | install from binaries                                               |\n| `Angular`      | 6              | install from `npm`                                                    |\n| `xcash-dpops`  | latest version | [build from source](https://github.com/X-CASH-official/xcash-dpops) |\n\n\n**If you want to run the website using SSL then you will need to install a webserver like nginx  \nThe readme shows you how to setup the website using HTTP, since there is no sensitive data in the website**\n\n### Requirements\n\n#### Intalling Node.js from binaries\n\n\u003e It is recommended to install the nodejs folder in the home directory `/home/$USER/` or root directory (`/root/`) in a new folder\n\nTo download, go to the Node.js official [release page](https://nodejs.org/en/download/current/) and download the **Linux Binaries**. Copy it to your deisgnated folder and run these commands:\n\n```bash\ntar -xf node*.tar.xz\nrm node*.tar.xz\n```\n\nThen add Node.js to your path:\n\n```bash\necho -e '\\nexport PATH=path_to_nodejs/bin:$PATH' \u003e\u003e ~/.profile \u0026\u0026 source ~/.profile\n```\n\u003e Replace `path_to_nodejs/bin` with the location of the `bin` folder where you installed Node.js\n\n#### npm\n\n\u003e Note if your installing on a `root` session, you need to run these additional commands before upgrading\n\u003e ```bash\n\u003e npm config set user 0\n\u003e npm config set unsafe-perm true\n\u003e ```\n\nUpdate `npm` globally:\n```bash\nnpm install -g npm\n```\n\n#### angular\n\nInstall the latest version of Angular globally:\n```shell\nnpm install -g @angular/cli@latest\n```\n\nThen install the compressor `UglifyJS` globally :\n```shell\nnpm install -g uglify-js\n```\n\n### Install\n\n#### Clone repository\n\nIn your desired folder, clone the repository:\n```shell\ngit clone https://github.com/X-CASH-official/delegates-explorer.git\n```\n\n#### Install dependencies\n\n```shell\ncd delegates-explorer\nnpm install\n```\n\n#### Configure application\n\nEdit the `delegates-explorer/src/environments/environment.prod.ts` , set your Base-URL (Domain URL) and if needed an external API Endpoint:\n\n```\nexport const environment = {\n    baseURL: \"\",\n    apiEndPoint: '',\n    explorerApiEndPoint: 'https://explorer.xcash.foundation',\n    announcementJSON: 'https://raw.githubusercontent.com/X-CASH-official/delegates-explorer/master/announcement.json',\n    shortTitle: 'Delegates Explorer',\n    seedNodes: [\n                'us1_xcash_foundation',\n                'europe1_xcash_foundation',\n                'europe2_xcash_foundation',\n                'europe3_xcash_foundation',\n                'oceania1_xcash_foundation'\n              ]\n};\n```\n\n#### Install the firewall with parameters for shared delegates.\n\nRun `bash -c \"$(curl -sSL https://raw.githubusercontent.com/X-CASH-official/xcash-dpops/master/scripts/autoinstaller/autoinstaller.sh)\"` and choose `12 = Shared Delegates Firewall`.\n\n#### Manual Installation of the firewall\n\nDownload the [`firewall_script.sh`](https://github.com/X-CASH-official/xcash-dpops/tree/master/scripts/firewall) .\n\nUncomment these lines in `firewall_script.sh` to enable port 80 and redirect port 80 to 18283:\n```\n# iptables -t filter -I INPUT -p tcp --syn --dport 80 -m connlimit --connlimit-above 100 --connlimit-mask 32 -j DROP\n# iptables -t filter -I INPUT -p tcp --syn --dport 18283 -m connlimit --connlimit-above 100 --connlimit-mask 32 -j DROP\n```\n```\n# iptables -A INPUT -p tcp --dport 80 -j ACCEPT\n```\n\nRun the firewall script\n`./firewall_script.sh`\n\n#### Build\n\nTo build the delegate explorer for the production (mainnet) environment, go to the `delegates-explorer` folder and run:\n```shell\nnpm run build\n```\n\nOptionally, you can build the delegate explorer for the testnet with the command:\n```shell\nng build --aot=true --build--optimizer=true -c testnet\n```\n\nIt will build in the `dist`folder.\n\nCompress the `.js` files with `Uglify-JS` and move all of the contents of this folder to your `xcash-dpops/` folder\n\n```shell\ncd dist\nfor f in *.js; do echo \"Processing $f file..\"; uglifyjs $f --compress --mangle --output \"{$f}min\"; rm $f; mv \"{$f}min\" $f; done\nrm -r ~/xcash-dpops/delegates-explorer\nmkdir ~/xcash-dpops/delegates-explorer\ncd ../\ncp -a dist/* ~/xcash-dpops/delegates-explorer/\n```\n\n### Testing\n\n```shell\nnpm test\n```\n\nTo test that you have properly configured the delegates explorer, run `xcash-dpops` with the `--test_data_add` flag. *This will add test datas to the MongoDB.*\n\nNow run the website server again using the normal options.\n\nNext, navigate to your servers IP address or website domain. You should now see the website and some test data. You can navigate through the website using the test data.\n\nWhen you have verified that the website works correctly, remove the test data by shutting down the `xcash-dpops` and then running it again with the `--test_data_remove` flag.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cash-official%2Fdelegates-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx-cash-official%2Fdelegates-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cash-official%2Fdelegates-explorer/lists"}