aboutsummaryrefslogtreecommitdiff
path: root/doc/cjdns.md
diff options
context:
space:
mode:
authorJon Atack <jon@atack.com>2022-03-29 20:06:39 +0200
committerJon Atack <jon@atack.com>2022-04-01 16:11:03 +0200
commit19538dd41ecd9f593ad56f1f5f3a2cb45ad2b4ef (patch)
tree8b2b0482a53b136727ac1505ef324ee9007c1f49 /doc/cjdns.md
parent9e32adbb5c543885b2c01a984bf1e4b80e8cec16 (diff)
downloadbitcoin-19538dd41ecd9f593ad56f1f5f3a2cb45ad2b4ef.tar.xz
Add concrete steps in doc/cjdns.md to easily find a friend
Diffstat (limited to 'doc/cjdns.md')
-rw-r--r--doc/cjdns.md30
1 files changed, 25 insertions, 5 deletions
diff --git a/doc/cjdns.md b/doc/cjdns.md
index 5b2bcaf874..197495e890 100644
--- a/doc/cjdns.md
+++ b/doc/cjdns.md
@@ -23,17 +23,37 @@ somewhat centralized. I2P connections have a source address and I2P is slow.
CJDNS is fast but does not hide the sender and the recipient from intermediate
routers.
-## Installing CJDNS and connecting to the network
+## Installing CJDNS and finding a peer to connect to the network
To install and set up CJDNS, follow the instructions at
https://github.com/cjdelisle/cjdns#cjdns.
-Don't skip steps
+You need to initiate an outbound connection to a peer on the CJDNS network
+before it will work with your Bitcoin Core node. This is described in steps
["2. Find a friend"](https://github.com/cjdelisle/cjdns#2-find-a-friend) and
["3. Connect your node to your friend's
-node"](https://github.com/cjdelisle/cjdns#3-connect-your-node-to-your-friends-node).
-You need to be connected to the CJDNS network before it will work with your
-Bitcoin Core node.
+node"](https://github.com/cjdelisle/cjdns#3-connect-your-node-to-your-friends-node)
+in the CJDNS documentation.
+
+One quick way to accomplish these two steps is to query for available public
+peers on [Hyperboria](https://github.com/hyperboria) by running the following:
+
+```
+git clone https://github.com/hyperboria/peers hyperboria-peers
+cd hyperboria-peers
+./testAvailable.py
+```
+
+For each peer, the `./testAvailable.py` script prints the filename of the peer's
+credentials followed by the ping result.
+
+Choose one or several peers, copy their credentials from their respective files,
+paste them into the relevant IPv4 or IPv6 "connectTo" JSON object in the
+`cjdroute.conf` file you created in step ["1. Generate a new configuration
+file"](https://github.com/cjdelisle/cjdns#1-generate-a-new-configuration-file),
+and save the file.
+
+## Launching CJDNS
Typically, CJDNS might be launched from its directory with
`sudo ./cjdroute < cjdroute.conf` and it sheds permissions after setting up the