monero-docs/docs/infrastructure/tor-onion-p2p-seed-nodes.md
2021-01-11 15:26:51 +01:00

2.4 KiB

title
Tor Onion Seed Nodes for Monero P2P Network | Monero Documentation

Tor onion seed nodes for Monero P2P network

When this is necessary?

This is only necessary if:

  • you run a full node and you want to propagate locally-originating transactions over Tor (using tx-proxy option, see monerod reference)

What are P2P seed nodes?

Your monero daemon will discover other p2p nodes but it needs to start somewhere. These starting nodes are known as "seed nodes". For clearnet the seed nodes are hardcoded in the software so no configuration is needed.

For the Tor network there are no hardcoded seed nodes. You must specify them manually by using the add-peer option in monero.conf.

Config snippet

These were tested working as of 2020-01-11. They are ran by volunteers and are not guaranteed to work or be maintained. See below how you can quickly test them.

# monero.conf snippet
# ...
add-peer=moneroxmrxw44lku6qniyarpwgznpcwml4drq7vb24ppatlcg4kmxpqd.onion:18080
add-peer=monerozf6koypqrt.onion:18080
add-peer=zbjkbsxc5munw3qusl7j2hpcmikhqocdf4pqhnhtpzw5nt5jrmofptid.onion:18083        # https://github.com/monero-project/monero/blob/master/src/p2p/net_node.inl
add-peer=rno75kjcw3ein6i446sqby2xkyqjarb75oq36ah6c2mribyklzhurpyd.onion:28083        # it's mainnet despite the weird port
add-peer=sqzrokz36lgkng2i2nlzgzns2ugcxqosflygsxbkybb4xn6gq3ouugqd.onion:18083        # very flaky, works 1 in 3 times
add-peer=blzchctiibfjfvtukctsydhquucz2oajnxnfc5hh4ix35gyqjhdnaqqd.onion:18080        # by author of monerodocs.org
# ...

How to test onion seed nodes?

You need Tor daemon installed and running on your laptop. You will also need torsocks command line tool that often comes with Tor.

To test speficic onion:

torsocks telnet blzchctiibfjfvtukctsydhquucz2oajnxnfc5hh4ix35gyqjhdnaqqd.onion 18080

The correct output will be similar to (domain resolution errors are fine):

1610372702 ERROR torsocks[11332]: Unable to resolve. Status reply: 4 (in socks5_recv_resolve_reply() at socks5.c:677)
Trying 127.42.42.0...
Connected to blzchctiibfjfvtukctsydhquucz2oajnxnfc5hh4ix35gyqjhdnaqqd.onion.
Escape character is '^]'.

Not enough onion seed nodes

The onion seed nodes are a scarce resource. Most nodes are only maintained temporarily by their authors.

You can greatly contribute to Monero P2P network performance and resillience by running onion-enabled monero full node.