Skip to content

Latest commit

 

History

History
161 lines (106 loc) · 4.51 KB

devnet.md

File metadata and controls

161 lines (106 loc) · 4.51 KB
Raw

TweedleDev - Spacemesh 0.2 Devnet

Latest release: v0.2.4-beta.0 (Network Id 208)

Release date: October 21st, 2021

Explore TweedleDev

TweedleDev is an early Spacemesh 0.2 technical preview release intended for users who are comfortable with using the command line and with terminal applications.

Follow these instructions to join the Spacemesh 0.2 devnet.

Minimum System Requirements

  • A computer with a modern Intel or AMD x86-64 CPU with at least 2 cores / 4 native threads or an Apple M1 CPU.
  • Windows 10 Home or Pro, macOS or Ubuntu 20.04. Other modern Linux distributions should also work.
  • 4 GB RAM.
  • 100 GiB free disk space (HDD or SSD).
  • An always-on, unmetered Internet connection with at least 10 mbps download and 1 mbps upload speed.

Recommended System Requirements

  • 8 GB RAM.
  • An Nvidia GPU and driver with CUDA support (minimum compute compatibility 5.0, maximum compute compatibility 8.6) such as Nvidia driver version R450 or newer.
  • A GPU with Vulkan 1.2 support such as a modern AMD GPU, Apple M1 CPU/GPU, or Intel GPU.

Installing and Running

  1. Download the devnet release zip file for your platform

  1. Extract the zip file to a directory and navigate to it in terminal

  2. Configure downloaded binaries

Linux and macOS

Set go-spacemesh execution permissions.

chmod u+x go-spacemesh

macOS

Enable downloaded binaries execution.

sudo xattr -rd com.apple.quarantine go-spacemesh
sudo xattr -rd com.apple.quarantine lib*
sudo xattr -rd com.apple.quarantine smrepl
  1. Start a Spacemesh full node

macOS and Linux

./go-spacemesh -c config.json > log.txt

Windows (PowerShell)

.\go-spacemesh.exe -c config.json > log.txt
  1. Start Smrepl

Open another terminal window or tab.

macOS and Linux

./smrepl

Windows (PowerShell)

.\smrepl.exe

Proceed to create a wallet and setup smeshing in smrepl.

Viewing node logs

Use this command from another terminal tab or window to view your full node logs.

macOS or Linux

tail -f logs.txt

Windows (PowerShell)

Get-Content logs.txt –Wait

Using the gpu-post test app

Navigate to your directory you extract the zip release to and enter from a terminal:

macOS

export DYLD_LIBRARY_PATH=.:$DYLD_LIBRARY_PATH
chmod +x gpu-setup-test
sudo xattr -rd com.apple.quarantine gpu-setup-test
./gpu-setup-test

Linux

export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH
chmod +x gpu-setup-test
./gpu-setup-test

Windows (PowerShell)

.\gpu-setup-test.exe

Building from Source Code

You can join the devnet by building this release binaries from source code from our public github repos instead of using our provided binaries.

  1. Clone and build go-spacemesh from this tag

  2. Clone and build smrepl from this tag

  3. Clone and build gpu-post from this tag

  4. Copy the gpu-post artifacts for your platform to your go-spacemesh directory.

  5. Run the full node with this devnet config file

Devnet 0.2 Mini Technical FAQ

Q: My node stopped syncing. I waited a long time but the current layer doesn't advance. What should I do?

A: Stop the node process by pressing ctrl-c in the terminal window you started the node at. Delete local node data folder ~/spacemesh/<devnet_id>/ and proof of spacetime data from your post directory if you created any, and start it again.

Q: I've setup smeshing via smrepl and I later restarted the node and now it is not smeshing. How can I keep smeshing after a node restart?

A: After setting post in smrepl, you need to modify your node's config file with the smeshing parameters so your node can continue smeshing using these parameters after you restart it.

Q: I'm getting an error when starting the node on Windows about missing C++ runtime. A: Install the latest Visual C++ runtime from Microsoft and try again.