{"id":13584962,"url":"https://github.com/bitcoin-dev-project/warnet","last_synced_at":"2026-04-09T03:34:07.927Z","repository":{"id":188927643,"uuid":"678920523","full_name":"bitcoin-dev-project/warnet","owner":"bitcoin-dev-project","description":"Monitor and analyze the emergent behaviors of Bitcoin networks","archived":false,"fork":false,"pushed_at":"2024-04-30T12:03:59.000Z","size":2215,"stargazers_count":56,"open_issues_count":51,"forks_count":27,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-05-02T05:19:39.569Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://warnet.dev","language":"Python","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/bitcoin-dev-project.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}},"created_at":"2023-08-15T17:32:56.000Z","updated_at":"2024-08-16T00:12:41.486Z","dependencies_parsed_at":"2023-10-04T05:29:46.681Z","dependency_job_id":"0f684655-14d8-4cd8-8a2f-f160f5c45c3e","html_url":"https://github.com/bitcoin-dev-project/warnet","commit_stats":null,"previous_names":["bitcoin-dev-project/warnet"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoin-dev-project%2Fwarnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoin-dev-project%2Fwarnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoin-dev-project%2Fwarnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitcoin-dev-project%2Fwarnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitcoin-dev-project","download_url":"https://codeload.github.com/bitcoin-dev-project/warnet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247607160,"owners_count":20965925,"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":"2024-08-01T15:04:37.779Z","updated_at":"2025-12-14T03:03:05.197Z","avatar_url":"https://github.com/bitcoin-dev-project.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https://raw.githubusercontent.com/bitcoin-dev-project/warnet/main/pyproject.toml)\n# Warnet\n\nMonitor and analyze the emergent behaviors of Bitcoin networks.\n\n## Major Features\n\n* Launch a bitcoin network with a specified number of nodes connected to each other according to a network topology.\n* Run scenarios of network behavior across the network which can be programmed using the Bitcoin Core functional [test_framework language](https://github.com/bitcoin/bitcoin/tree/master/test/functional).\n* Collect and search data from nodes including log files and p2p messages.\n* Monitor and visualize performance data from Bitcoin nodes.\n* Connect to a large network running in a remote cluster, or a smaller network running locally.\n* Add a Lightning Network with its own channel topology and payment activity.\n\n## Documentation\n\n- [Design](/DESIGN.md)\n- [Installation](/docs/install.md)\n- [CLI Commands](/docs/warnet.md)\n- [Network configuration with yaml files](/docs/config.md)\n- [Plugins](/docs/plugins.md)\n- [Scenarios](/docs/scenarios.md)\n- [Monitoring](/docs/logging_monitoring.md)\n- [Snapshots](/docs/snapshots.md)\n- [Connecting to local nodes outside the cluster](/docs/connecting-local-nodes.md)\n- [Scaling](/docs/scaling.md)\n- [Contributing](/docs/developer-notes.md)\n\n\n## Quick Start\n\n### 1. Create a python virtual environment\n\n```sh\npython3 -m venv .venv\nsource .venv/bin/activate\n```\n\n### 2. Install Warnet\n\n```sh\npip install warnet\n```\n\n### 3. Set up dependencies\n\nWarnet will ask which back end you want to use, check that it is working,\nand install additional client tools into the virtual environment.\n\n```sh\nwarnet setup\n```\n\n### 4. Create a project and network\n\nWarnet will create a new folder structure containing standard scenario and plugin\nfiles, and prompt for details about a network topology to create. Topology details\ninclude number of Bitcoin nodes, which release versions or custom images to deploy\nand how many random graph connections to start each node with.\n\n```sh\nwarnet new /my/work/stuff/projectname\n```\n\n### 5. Deploy the network\n\n```sh\nwarnet deploy /my/work/stuff/projectname/networks/networkname\n```\n\n### 6. Run experiments\n\nFor example, you can start mining blocks...\n\n```sh\nwarnet run /my/work/stuff/projectname/scenarios/miner_std.py\n```\n\n... and then observe network connectivity and statistics in your browser:\n\n```sh\nwarnet dashboard\n```\n\n### 7. Shut down the network\n\n```sh\nwarnet down\n```\n\n### 8. Customize\n\nRead the docs and learn how to write your own [scenarios](docs/scenarios.md)\nor add [plugins](docs/plugins.md) to your network. [Configure](docs/config.md) individual nodes\nin the network by editing the `network.yaml` file or configure\ndefaults for all nodes in the network by editing `node-defaults.yaml`. Once\nyour network is running use Warnet [CLI](docs/warnet.md) commands to interact with it.\n\n\n![warnet-art](https://raw.githubusercontent.com/bitcoin-dev-project/warnet/main/docs/machines.webp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitcoin-dev-project%2Fwarnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitcoin-dev-project%2Fwarnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitcoin-dev-project%2Fwarnet/lists"}