Documentation

English
  • English
  • Russian
Mina Overview

Seed Peers

Seed peers are our helpful allies that make it easy for the rest of us to connect to the network.

Most nodes connect to the Mina network using seed peers that are run explicitly at seed nodes.

Running a Seed Node

The two important things about seed nodes:

  1. Their address should be static
  2. They need high uptime and be able to support many connections -- thus they should avoid doing as much as possible other than "seeding"

Enforcing and publishing a static address

First of all, you need a static host where you'll be running your node. Preferably, you can use DNS and host your seed node at, for example: seed.o1test.net. Alternatively, you can also set up a static ipv4 address such as 82.230.217.200.

Secondly, you'll need to select the port that your node is running on. By default, it's on 8302.

Thirdly, you'll want to pregenerate your libp2p keypair -- this is used to identify you on the gossip network. To do so:

mina advanced generate-libp2p-keypair

This will generate a libp2p keypair on your machine. And run your daemon with the --discovery-keypair flag:

Finally you'd publish your DNS address like so:

/dns4/seed.o1test.net/tcp/8302/p2p/12D3KooWGDHtsPUS8dZk3x3FUgsXCWwpnSJ6W7EwkWZKBZXczkwC

Or a static IP one in this manner:

/ip4/82.230.217.200/tcp/8302/p2p/12D3KooWCE97fGwuDCicVNK3ZWF8fVzfNezp3uGjmSc8VrRFem6a

This address string can be used for folks to connect to you.

Tuning your node for uptime and high connections

Firstly, don't run block production or snark working on this node. Full stop. By doing neither of these things, the surface area for logic executing on this node reduces drastically.

It would be preferable to run with a larger --max-connection flag. At least 100. You'll still be able to seed with more than 100 nodes in total, it's just that you'll only be able to maintain connections with 100 at once.

Example daemon command

When we put together all the needed configuration, a basic seed node configuration could look like the following example.

mina daemon \
--seed \
--peer-list-url https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt \
--file-log-level Info -log-level Info \
--log-block-creation false \
--log-snark-work-gossip false \
--log-txn-pool-gossip false \
--metrics-port 9100 \
--discovery-keypair /keys/my-libp2p \
--generate-genesis-proof true \
--max-connection 100

Please note that --discovery-keypair could change in value depending on where you stored your libp2p keypair from the previous steps. Ensure also that you're running on a version later than 1.1.2 to handle Mainnet traffic.

If you're using Docker, then here is a similar example.

docker run --name mina-seed-node -d \
--restart always \
-p 8302:8302 \
-p 9100:9100 \
-v $(pwd)/keys:/root/keys:ro \
-v $(pwd)/.mina-config:/root/.mina-config \
--env CODA_LIBP2P_PASS='PASS' \
minaprotocol/mina-daemon-baked:1.1.2-0975867 daemon \
--discovery-keypair /keys/libp2p-keys \
--peer-list-url https://storage.googleapis.com/mina-seed-lists/mainnet_seeds.txt \
--metrics-port 9100 \
--seed \
--max-connection 100 \
--file-log-level Info \
--log-level Info

Make sure to replace the --env CODA_LIBP2P_PASS='' with your correct password for the libp2p keypair. Also as with the previous example, ensure you set the correct value with --discovery-keypair.

Peers List

There will be a peers list hosted with a handful of O(1) Labs nodes and another much larger handful of addresses from folks unaffiliated with O(1). This list is curated for nodes that should be great seed peers and will try their best to keep the list up-to-date as well.

Alternate Peer Lists

We have a decentralized network after all -- we encourage other members in the community to host seed lists. To create a list, please talk to those you trust and use their addresses as seed peers.

To consume such alternate lists, you can swap the parameter -peer-list-file or -peer-list-url to point to another one.