Skip to main content

Connect to Devnet

note

A new version of Mina Docs is coming soon! This page will be rewritten.

In this section, we'll connect to the Devnet network. Devnet is a network dedicated for developers building on top of the Mina protocol. It is designed for testing and experimentation of developers and holds no real value. Users can reach out on Discord if they would like to request a prefunded account.

Only use the Devnet network if you are a developer and building on top of the Mina protocol. If you are interested in running a node, please connect to Mainnet RC instead.

Update your software​

Connecting to Devnet requires a specific build of the Mina client as well as a specific version of a peers list. Using the Devnet build and peers list does not work for Zenith.

Follow the instructions below for your operating system below.

Ubuntu 18.04 / Debian 9​

Follow along below to install the latest Stable Mina Release 1.3.0 or visit the Github Releases Page to discover and install pre-release (Alpha/Beta) builds.

You can set up the new debian stable repository and install the latest version as follows:

echo "deb [trusted=yes] http://packages.o1test.net $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/mina.list
sudo apt-get install --yes apt-transport-https
sudo apt-get update
sudo apt-get install --yes curl unzip mina-devnet=1.3.0-9b0369c

Check that daemon installed correctly by running mina version. The output should read Commit 9b0369c27bb85c8ab2f8725c6e977eb27b53b826 on branch master.

Start up a node​

Run the following commands to start up a Mina node instance and connect to the Devnet network:

mina daemon --peer-list-url https://storage.googleapis.com/seed-lists/devnet_seeds.txt

Docker​

When running your daemon using Docker, first create a directory on the host machine to mount as a volume:

cd ~
mkdir ~/.mina-config

To produce blocks or otherwise customize the configuration for the mina daemon, create a file ~/.mina-env containing the following:

export MINA_PRIVKEY_PASS="My_V3ry_S3cure_Password"
LOG_LEVEL=Info
FILE_LOG_LEVEL=Debug
EXTRA_FLAGS=" --block-producer-key <BLOCK_PRODUCER_KEY_PATH>"
PEER_LIST_URL=https://storage.googleapis.com/seed-lists/devnet_seeds.txt

Ensure to replace <BLOCK_PRODUCER_KEY_PATH> with the full path to your block producer private key, for example, /home/ubuntu/keys/my-wallet.

If you do not intend to produce blocks then you can keep ~/.mina-env empty except for the PEER_LIST_URL.

Now simply run the image with your ~/.mina-config and ~/.mina-env mounted into the container:

docker run --name mina -d \
-p 8302:8302 \
--restart=always \
--mount "type=bind,source=$(pwd)/.mina-env,dst=/entrypoint.d/mina-env,readonly" \
--mount "type=bind,source=$(pwd)/.mina-config,dst=/root/.mina-config" \
minaprotocol/mina-daemon:1.3.0-9b0369c-bullseye-devnet \
daemon \

Run docker logs -f mina to follow the logs, and if it crashes save the log output to a file with docker logs mina > mina-log.txt.

Run docker exec -it mina mina client status to monitor connectivity to the network.