{"id":15448630,"url":"https://github.com/soramitsu/fearless-polkadot","last_synced_at":"2025-10-11T12:31:46.844Z","repository":{"id":38342624,"uuid":"394681658","full_name":"soramitsu/fearless-polkadot","owner":"soramitsu","description":"Polkadot Node Implementation","archived":false,"fork":true,"pushed_at":"2023-04-24T11:37:12.000Z","size":145248,"stargazers_count":1,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-27T22:05:57.376Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"paritytech/polkadot","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soramitsu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null}},"created_at":"2021-08-10T14:19:56.000Z","updated_at":"2022-05-04T17:26:11.000Z","dependencies_parsed_at":"2023-02-12T06:46:07.163Z","dependency_job_id":null,"html_url":"https://github.com/soramitsu/fearless-polkadot","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"purl":"pkg:github/soramitsu/fearless-polkadot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soramitsu%2Ffearless-polkadot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soramitsu%2Ffearless-polkadot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soramitsu%2Ffearless-polkadot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soramitsu%2Ffearless-polkadot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soramitsu","download_url":"https://codeload.github.com/soramitsu/fearless-polkadot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soramitsu%2Ffearless-polkadot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279007167,"owners_count":26084247,"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-11T02:00:06.511Z","response_time":55,"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":[],"created_at":"2024-10-01T20:29:12.246Z","updated_at":"2025-10-11T12:31:45.027Z","avatar_url":"https://github.com/soramitsu.png","language":"Rust","funding_links":[],"categories":["Ecosystem Tools"],"sub_categories":[],"readme":"# Polkadot\n\nImplementation of a \u003chttps://polkadot.network\u003e node in Rust based on the Substrate framework.\n\n\u003e **NOTE:** In 2018, we split our implementation of \"Polkadot\" from its development framework\n\u003e \"Substrate\". See the [Substrate][substrate-repo] repo for git history prior to 2018.\n\n[substrate-repo]: https://github.com/paritytech/substrate\n\nThis repo contains runtimes for the Polkadot, Kusama, and Westend networks. The README provides\ninformation about installing the `polkadot` binary and developing on the codebase. For more\nspecific guides, like how to be a validator, see the\n[Polkadot Wiki](https://wiki.polkadot.network/docs/getting-started).\n\n## Installation\n\nIf you just wish to run a Polkadot node without compiling it yourself, you may\neither run the latest binary from our\n[releases](https://github.com/paritytech/polkadot/releases) page, or install\nPolkadot from one of our package repositories.\n\nInstallation from the Debian repository will create a `systemd`\nservice that can be used to run a Polkadot node. This is disabled by default,\nand can be started by running `systemctl start polkadot` on demand (use\n`systemctl enable polkadot` to make it auto-start after reboot). By default, it\nwill run as the `polkadot` user.  Command-line flags passed to the binary can\nbe customized by editing `/etc/default/polkadot`. This file will not be\noverwritten on updating polkadot. You may also just run the node directly from\nthe command-line.\n\n### Debian-based (Debian, Ubuntu)\n\nCurrently supports Debian 10 (Buster) and Ubuntu 20.04 (Focal), and\nderivatives. Run the following commands as the `root` user.\n\n```bash\n# Import the security@parity.io GPG key\ngpg --recv-keys --keyserver hkps://keys.mailvelope.com 9D4B2B6EB8F97156D19669A9FF0812D491B96798\ngpg --export 9D4B2B6EB8F97156D19669A9FF0812D491B96798 \u003e /usr/share/keyrings/parity.gpg\n# Add the Parity repository and update the package index\necho 'deb [signed-by=/usr/share/keyrings/parity.gpg] https://releases.parity.io/deb release main' \u003e /etc/apt/sources.list.d/parity.list\napt update\n# Install the `parity-keyring` package - This will ensure the GPG key\n# used by APT remains up-to-date\napt install parity-keyring\n# Install polkadot\napt install polkadot\n\n```\n\n## Building\n\n### Install via Cargo\n\nMake sure you have the support software installed from the **Build from Source** section\nbelow this section.\n\nIf you want to install Polkadot in your PATH, you can do so with:\n\n```bash\ncargo install --git https://github.com/paritytech/polkadot --tag \u003cversion\u003e polkadot --locked\n```\n\n### Build from Source\n\nIf you'd like to build from source, first install Rust. You may need to add Cargo's bin directory\nto your PATH environment variable. Restarting your computer will do this for you automatically.\n\n```bash\ncurl https://sh.rustup.rs -sSf | sh\n```\n\nIf you already have Rust installed, make sure you're using the latest version by running:\n\n```bash\nrustup update\n```\n\nOnce done, finish installing the support software:\n\n```bash\nsudo apt install build-essential git clang libclang-dev pkg-config libssl-dev\n```\n\nBuild the client by cloning this repository and running the following commands from the root\ndirectory of the repo:\n\n```bash\ngit checkout \u003clatest tagged release\u003e\n./scripts/init.sh\ncargo build --release\n```\n\nNote that compilation is a memory intensive process. We recommend having 4 GiB of physical RAM or swap available (keep in mind that if a build hits swap it tends to be very slow).\n\n#### Build from Source with Docker\n\nYou can also build from source using \n[Parity CI docker image](https://github.com/paritytech/scripts/tree/master/dockerfiles/ci-linux):\n\n```bash\ngit checkout \u003clatest tagged release\u003e\ndocker run --rm -it -w /shellhere/polkadot \\\n                    -v $(pwd):/shellhere/polkadot \\\n                    paritytech/ci-linux:production cargo build --release\nsudo chown -R $(id -u):$(id -g) target/\n```\n\nIf you want to reproduce other steps of CI process you can use the following \n[guide](https://github.com/paritytech/scripts#gitlab-ci-for-building-docker-images).\n\n## Networks\n\nThis repo supports runtimes for Polkadot, Kusama, and Westend.\n\n### Connect to Polkadot Mainnet\n\nConnect to the global Polkadot Mainnet network by running:\n\n```bash\n./target/release/polkadot --chain=polkadot\n```\n\nYou can see your node on [telemetry] (set a custom name with `--name \"my custom name\"`).\n\n[telemetry]: https://telemetry.polkadot.io/#list/Polkadot\n\n### Connect to the \"Kusama\" Canary Network\n\nConnect to the global Kusama canary network by running:\n\n```bash\n./target/release/polkadot --chain=kusama\n```\n\nYou can see your node on [telemetry] (set a custom name with `--name \"my custom name\"`).\n\n[telemetry]: https://telemetry.polkadot.io/#list/Kusama\n\n### Connect to the Westend Testnet\n\nConnect to the global Westend testnet by running:\n\n```bash\n./target/release/polkadot --chain=westend\n```\n\nYou can see your node on [telemetry] (set a custom name with `--name \"my custom name\"`).\n\n[telemetry]: https://telemetry.polkadot.io/#list/Westend\n\n### Obtaining DOTs\n\nIf you want to do anything on Polkadot, Kusama, or Westend, then you'll need to get an account and\nsome DOT, KSM, or WND tokens, respectively. See the\n[claims instructions](https://claims.polkadot.network/) for Polkadot if you have DOTs to claim. For\nWestend's WND tokens, see the faucet\n[instructions](https://wiki.polkadot.network/docs/learn-DOT#getting-westies) on the Wiki.\n\n## Hacking on Polkadot\n\nIf you'd actually like to hack on Polkadot, you can grab the source code and build it. Ensure you have\nRust and the support software installed. This script will install or update Rust and install the\nrequired dependencies (this may take up to 30 minutes on Mac machines):\n\n```bash\ncurl https://getsubstrate.io -sSf | bash -s -- --fast\n```\n\nThen, grab the Polkadot source code:\n\n```bash\ngit clone https://github.com/paritytech/polkadot.git\ncd polkadot\n```\n\nThen build the code. You will need to build in release mode (`--release`) to start a network. Only\nuse debug mode for development (faster compile times for development and testing).\n\n```bash\n./scripts/init.sh   # Install WebAssembly. Update Rust\ncargo build # Builds all native code\n```\n\nYou can run the tests if you like:\n\n```bash\ncargo test --workspace --release\n```\n\nYou can start a development chain with:\n\n```bash\ncargo run -- --dev\n```\n\nDetailed logs may be shown by running the node with the following environment variables set:\n\n```bash\nRUST_LOG=debug RUST_BACKTRACE=1 cargo run -- --dev\n```\n\n### Development\n\nYou can run a simple single-node development \"network\" on your machine by running:\n\n```bash\npolkadot --dev\n```\n\nYou can muck around by heading to \u003chttps://polkadot.js.org/apps\u003e and choose \"Local Node\" from the\nSettings menu.\n\n### Local Two-node Testnet\n\nIf you want to see the multi-node consensus algorithm in action locally, then you can create a\nlocal testnet. You'll need two terminals open. In one, run:\n\n```bash\npolkadot --chain=polkadot-local --alice -d /tmp/alice\n```\n\nAnd in the other, run:\n\n```bash\npolkadot --chain=polkadot-local --bob -d /tmp/bob --port 30334 --bootnodes '/ip4/127.0.0.1/tcp/30333/p2p/ALICE_BOOTNODE_ID_HERE'\n```\n\nEnsure you replace `ALICE_BOOTNODE_ID_HERE` with the node ID from the output of the first terminal.\n\n### Monitoring\n\n[Setup Prometheus and Grafana](https://wiki.polkadot.network/docs/maintain-guides-how-to-monitor-your-node).\n\nOnce you set this up you can take a look at the [Polkadot Grafana dashboards](grafana/README.md) that we currently maintain. \n\n### Using Docker\n\n[Using Docker](doc/docker.md)\n\n### Shell Completion\n\n[Shell Completion](doc/shell-completion.md)\n\n## Contributing\n\n### Contributing Guidelines\n\n[Contribution Guidelines](CONTRIBUTING.md)\n\n### Contributor Code of Conduct\n\n[Code of Conduct](CODE_OF_CONDUCT.md)\n\n## License\n\nPolkadot is [GPL 3.0 licensed](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoramitsu%2Ffearless-polkadot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoramitsu%2Ffearless-polkadot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoramitsu%2Ffearless-polkadot/lists"}