bitcoin/contrib/seeds/README.md

# Seeds

Utility to generate the seeds.txt list that is compiled into the client
(see [src/chainparamsseeds.h](/src/chainparamsseeds.h) and other utilities in [contrib/seeds](/contrib/seeds)).

Be sure to update `PATTERN_AGENT` in `makeseeds.py` to include the current version,
and remove old versions as necessary (at a minimum when SeedsServiceFlags()
changes its default return value, as those are the services which seeds are added
to addrman with).

The seeds compiled into the release are created from sipa's, achow101's and luke-jr's
DNS seed, virtu's crawler, and asmap community AS map data. Run the following commands
from the `/contrib/seeds` directory:

```
curl https://bitcoin.sipa.be/seeds.txt.gz | gzip -dc > seeds_main.txt
curl https://mainnet.achownodes.xyz/seeds.txt.gz | gzip -dc >> seeds_main.txt
curl https://21.ninja/seeds.txt.gz | gzip -dc >> seeds_main.txt
curl https://luke.dashjr.org/programs/bitcoin/files/charts/seeds.txt >> seeds_main.txt
curl https://testnet.achownodes.xyz/seeds.txt.gz | gzip -dc > seeds_test.txt
curl https://raw.githubusercontent.com/asmap/asmap-data/main/latest_asmap.dat > asmap-filled.dat
python3 makeseeds.py -a asmap-filled.dat -s seeds_main.txt > nodes_main.txt
python3 makeseeds.py -a asmap-filled.dat -s seeds_test.txt > nodes_test.txt
# TODO: Uncomment when a seeder publishes seeds.txt.gz for testnet4
# python3 makeseeds.py -a asmap-filled.dat -s seeds_testnet4.txt -m 30000 > nodes_testnet4.txt
python3 generate-seeds.py . > ../../src/chainparamsseeds.h
```
Update seeds tooling to Python 3 All the other tooling scripts require Python 3, it makes sense to do so here too. Also document the dependency on python3-dnspython. 2017-02-10 10:16:14 +01:00			`# Seeds`
Finished /Contrib Index. Standardized READMEs. File and Link Fix. 2013-10-16 05:14:30 +02:00
Update seed IPs, based on bitcoin.sipa.be crawler data 2014-12-23 17:43:32 +01:00			`Utility to generate the seeds.txt list that is compiled into the client`
contrib: Improvements to hardcoded seeds scripts - Moved all seed related scripts to contrib/seeds for consistency - Updated `makeseeds.py` to handle IPv6 and onions, fix regular expression for recent Bitcoin Core versions - Fixed a bug in `generate-seeds.py` with regard to IPv6 parsing 2015-06-23 21:31:47 +02:00			`(see [src/chainparamsseeds.h](/src/chainparamsseeds.h) and other utilities in [contrib/seeds](/contrib/seeds)).`
Utility to create pnSeed array 2013-01-30 04:17:56 +01:00
contrib/seeds: Update PATTERN_AGENT gmaxwell: Adds the newest versions, drops everything multiple softforks ago. 2017-02-10 10:58:17 +01:00			Be sure to update `PATTERN_AGENT` in `makeseeds.py` to include the current version,
net: decouple state independent service flags from desirable ones This former one will be moved to the peer manager class in the following-up commit. 2023-07-26 19:21:21 +02:00			`and remove old versions as necessary (at a minimum when SeedsServiceFlags()`
Use GetDesireableServiceFlags in static seeds, document this. 44407100f broke inserting entries into addrman from static seeds (as well as dnsseeds which did not support service bits). Static seeds were already being filtered by UA for 0.13.1+ (ie NODE_WITNESS), so simply changing the default service bits to include NODE_WITNESS (and updating docs appropriately) is sufficient. For DNS Seeds, we will later fix by falling back to oneshot if a seed does not support filtering. 2017-10-19 23:32:33 +02:00			`changes its default return value, as those are the services which seeds are added`
			`to addrman with).`
contrib/seeds: Update PATTERN_AGENT gmaxwell: Adds the newest versions, drops everything multiple softforks ago. 2017-02-10 10:58:17 +01:00
seeds: Pull nodes from Luke's seeder Pull additional nodes from Luke's seeder to further decentralize the generation of seed nodes. 2024-08-27 06:15:58 +02:00			`The seeds compiled into the release are created from sipa's, achow101's and luke-jr's`
contrib: Update asmap link in seeds readme 2024-09-26 15:54:01 +02:00			`DNS seed, virtu's crawler, and asmap community AS map data. Run the following commands`
seeds: Pull nodes from Luke's seeder Pull additional nodes from Luke's seeder to further decentralize the generation of seed nodes. 2024-08-27 06:15:58 +02:00			from the `/contrib/seeds` directory:
net: Hardcoded seeds update January 2016 2016-01-25 16:14:14 +01:00
contrib: make-seeds updates for 25.x and make the steps in /contrib/seeds/README.md easier to copy-paste 2023-04-18 18:39:11 +02:00			```
			`curl https://bitcoin.sipa.be/seeds.txt.gz \| gzip -dc > seeds_main.txt`
seeds: Also pull from achow101 seeder 2024-04-30 20:18:27 +02:00			`curl https://mainnet.achownodes.xyz/seeds.txt.gz \| gzip -dc >> seeds_main.txt`
seeds: Pull nodes from virtu's crawler Pull additional nodes from virtu's crawler. Data includes sufficient Onion and I2P nodes to align the uptime requirements for these networks to that of clearnet nodes (i.e., 50%). Data also includes more than three times the number of CJDNS nodes currently hardcoded into nodes_main_manual.txt, so hardcoded nodes becomes obsolete. 2024-08-22 11:50:15 +02:00			`curl https://21.ninja/seeds.txt.gz \| gzip -dc >> seeds_main.txt`
seeds: Pull nodes from Luke's seeder Pull additional nodes from Luke's seeder to further decentralize the generation of seed nodes. 2024-08-27 06:15:58 +02:00			`curl https://luke.dashjr.org/programs/bitcoin/files/charts/seeds.txt >> seeds_main.txt`
			`curl https://testnet.achownodes.xyz/seeds.txt.gz \| gzip -dc > seeds_test.txt`
contrib: Update asmap link in seeds readme 2024-09-26 15:54:01 +02:00			`curl https://raw.githubusercontent.com/asmap/asmap-data/main/latest_asmap.dat > asmap-filled.dat`
contrib: make-seeds updates for 25.x and make the steps in /contrib/seeds/README.md easier to copy-paste 2023-04-18 18:39:11 +02:00			`python3 makeseeds.py -a asmap-filled.dat -s seeds_main.txt > nodes_main.txt`
seeds: Add testnet instructions 2024-04-30 20:44:53 +02:00			`python3 makeseeds.py -a asmap-filled.dat -s seeds_test.txt > nodes_test.txt`
			`# TODO: Uncomment when a seeder publishes seeds.txt.gz for testnet4`
			`# python3 makeseeds.py -a asmap-filled.dat -s seeds_testnet4.txt -m 30000 > nodes_testnet4.txt`
contrib: make-seeds updates for 25.x and make the steps in /contrib/seeds/README.md easier to copy-paste 2023-04-18 18:39:11 +02:00			`python3 generate-seeds.py . > ../../src/chainparamsseeds.h`
			```