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 and achow101's DNS seed and 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://testnet.achownodes.xyz/seeds.txt.gz | gzip -dc > seeds_test.txt
curl https://raw.githubusercontent.com/fjahr/asmap-data/main/latest_asmap.dat > asmap-filled.dat
python3 makeseeds.py -a asmap-filled.dat -s seeds_main.txt > nodes_main.txt
cat nodes_main_manual.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-15 23:14:30 -04: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-29 22:17:56 -05: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 14:21:21 -03: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 17:32:33 -04: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: Also pull from achow101 seeder 2024-04-30 14:18:27 -04:00			`The seeds compiled into the release are created from sipa's and achow101's DNS seed and AS map`
contrib: Use asmap for ASN lookup in makeseeds Add an argument `-a` to provide a asmap file to do the IP to ASN lookups. This speeds up the script greatly, and makes the output deterministic. Also removes the dependency on `dns.lookup`. I've annotated the output with ASxxxx comments to provide a way to verify the functionality. For now I've added instructions in README.md to download and use the `demo.map` from the asmap repository. When we have some other mechanism for distributing asmap files we could switch to that. This continues #24824. I've removed all the fallbacks and extra complexity, as everyone will be using the same instructions anyway. Co-authored-by: Pieter Wuille <pieter.wuille@gmail.com> Co-authored-by: James O'Beirne <james.obeirne@pm.me> Co-authored-by: russeree <reese.russell@ymail.com> 2022-04-15 17:14:40 +02:00			data. Run the following commands 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 09:39:11 -07:00			```
			`curl https://bitcoin.sipa.be/seeds.txt.gz \| gzip -dc > seeds_main.txt`
seeds: Also pull from achow101 seeder 2024-04-30 14:18:27 -04:00			`curl https://mainnet.achownodes.xyz/seeds.txt.gz \| gzip -dc >> seeds_main.txt`
seeds: Add testnet instructions 2024-04-30 14:44:53 -04:00			`curl https://testnet.achownodes.xyz/seeds.txt.gz \| gzip -dc > seeds_test.txt`
seeds: Use fjahr's more up to date asmap 2024-08-16 12:53:21 -04:00			`curl https://raw.githubusercontent.com/fjahr/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 09:39:11 -07:00			`python3 makeseeds.py -a asmap-filled.dat -s seeds_main.txt > nodes_main.txt`
			`cat nodes_main_manual.txt >> nodes_main.txt`
seeds: Add testnet instructions 2024-04-30 14:44:53 -04: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 09:39:11 -07:00			`python3 generate-seeds.py . > ../../src/chainparamsseeds.h`
			```