Welcome to the our first attempt to have a couple of testnets running in parallel!
Here we have an alpha
network, where we want to verify changes before we do a full release that would be compatible with the existing BasicEconomyTweaks
network.
This is not expected to be a wildly long testnet. But participation here will help iron out any potential issues as/when we release new code compatible with BasicEconomyTweaks
.
Right now, this alpha network is not compatible. We cannot cross the streams, any attempt to access it using BasicEconomyTweaks
âs network-contacts
eg, will result in errors (or it should).
Other info:
- Max chunk size: 500kb
- Max chunk count: 2048
- Storecost algo: Bases price off of relevant close chunks not total chunk count. (This should allow prices to shift as capacity shrinks/grows).
Network Details
Node version: 0.105.6-alpha.4
Client version: 0.90.4-alpha.5
Faucet url: 159.65.29.172:8000
We have 50 droplets running a total of 2000 nodes. One droplet has 2vcpu and 4GB of memory.
If you are a regular user, see the âquickstartâ section for getting up and running.
If you are a first-time user, or would like more information, see the âfurther informationâ section.
Quickstart
If you already have safeup
, you can obtain the client and node binaries:
safeup client --version 0.90.4-alpha.5
safeup node --version 0.105.6-alpha.4
Run a Node
Linux/macOS:
safenode --peer /ip4/209.97.139.230/udp/59695/quic-v1/p2p/12D3KooWPTyqVdNzqcaeNGzjHA4nNnqJWkxU81gW7uBPYewu3jop
Windows:
safenode --peer /ip4/209.97.139.230/udp/59695/quic-v1/p2p/12D3KooWPTyqVdNzqcaeNGzjHA4nNnqJWkxU81gW7uBPYewu3jop
Check local nodeâs reward balance
Your local nodeâs peer id will be printed to the terminal on startup with an example command). (You can also retrieve this from the node directory.)
safe wallet balance --peer-id="<local-node-peer-id>"
Connect to the Network as a Client
Linux/macOS:
safe wallet get-faucet 159.65.29.172:8000
safe files upload <directory-path>
Windows:
safe wallet get-faucet 159.65.29.172:8000
safe files upload <directory-path>
To do this with non-default batch-size
s (along with SAFE_PEERS
set as above):
safe files upload --batch-size 40 <directory-path>
40
being the integer value you want to set
Further Information
You can participate in the testnet either by connecting as a client or running your own node.
Connecting as a client requires the safe
client binary; running a node requires the safenode
binary.
Obtaining Binaries
We have a tool named safeup
which is intended to make it easy to obtain the client, node, and other utility binaries.
Installing Safeup
On Linux/macOS, run the following command in your terminal:
curl -sSL https://raw.githubusercontent.com/maidsafe/safeup/main/install.sh | bash
On Windows, run the following command in a Powershell session (be careful to use Powershell, not cmd.exe):
iex (Invoke-RestMethod -Uri "https://raw.githubusercontent.com/maidsafe/safeup/main/install.ps1")
On either platform, you may need to restart your shell session for safeup
to become available.
Installing Binaries
After obtaining safeup
, you can install binaries like so:
safeup client # get the latest version of the client
safeup client --version 0.90.4-alpha.5 # get a specific version
safeup node # get the latest version of the node
safeup node --version 0.105.6-alpha.4 # get a specific version
safeup update # update all installed components to latest versions
When participating in our testnets, it is recommended to use a specific version. In our project we release a new version of the binaries every time we merge new code. This happens frequently, so over the lifetime of a testnet, many new releases will probably occur. So for participating in this particular testnet, you may not want the latest version.
The binaries are installed to ~/.local/bin
on Linux and macOS, and on Windows they go to C:\Users\<username>\safe
. Windows doesnât really have a standard location for binaries that doesnât require elevated privileges.
The safeup
tool will modify the PATH
variable on Linux/macOS, or the user Path
variable on Windows. The effect of this is that the installed binaries will then become available in your shell without having to refer to them with their full paths. However, if youâre installing for the first time, you may need to start a new shell session for this change to be picked up.
Running a Node
You can participate in the testnet by running your own node. At the moment, you may not be successful if youâre running the node from your home machine. This is a situation we are working on. If you run from a cloud provider like Digital Ocean or AWS, you should be able to participate.
You can run the node process like so:
# Linux/macOS
safenode --peer /ip4/209.97.139.230/udp/59695/quic-v1/p2p/12D3KooWPTyqVdNzqcaeNGzjHA4nNnqJWkxU81gW7uBPYewu3jop
# Windows
safenode --peer /ip4/209.97.139.230/udp/59695/quic-v1/p2p/12D3KooWPTyqVdNzqcaeNGzjHA4nNnqJWkxU81gW7uBPYewu3jop
This will output all the logs to the filesystem, with the location of logs being platform specific:
# Linux
~/.local/share/safe/node/<peer id>/logs
# macOS
/Users/<username>/Library/Application Support/safe/node/<peer id>/logs
# Windows
C:\Users\<username>\AppData\Roaming\safe\node\<peer-id>\logs
If you wish, you can also provide your own path:
# Linux/macOS
SN_LOG=all safenode --log-output-dest <path>
# Windows
$env:SN_LOG = "all"; safenode --log-output-dest <path>
The advantage of using the predefined data-dir
location is you can run multiple nodes on one machine without having to specify your own unique path for each node and manage that overhead yourself.
Connecting as a Client
You can use the safe
client binary to connect as a client and upload or download files to/from the network.
Using the Client
Youâll first need to get some Safe Network Tokens:
safe wallet get-faucet 159.65.29.172:8000
You can now proceed to use the client, by, e.g., uploading files:
safe files upload <directory-path>
To download that same content:
safe files download
This will download the files to the default location, which is platform specific:
# Linux
~/.local/share/safe/client/downloaded_files
# macOS
/Users/<username>/Library/Application Support/safe/client/downloaded_files
# Windows
C:\Users\<username>\AppData\Roaming\safe\client\downloaded_files
To download to a particular file or directory:
safe file download [directory/filename] [NetworkAddress]
Troubleshooting
Cleanup
If youâve used previous versions of the network before and you find problems when running commands, you may want to consider clearing out previous data (worthless DBCs from previous runs, old logs, old keys, etc.).
# Linux
rm -rf ~/.local/share/safe
# macOS
rm -rf ~/Library/Application\ Support/safe
# Windows
rmdir /s C:\Users\<username>\AppData\Roaming\safe
If you encounter a problem running any of our binaries on Windows, itâs possible you need the Visual C++ Redistributable installed.