After a successful
DialNet we’re looking to test our reworked payment process. Now instead of badly guesstimating costs on the network, we ask each and every node how much they’d like and pay that. (This can be tweaked to avoid bad actors easily enough). As such, every node will receive rewards for PUTs directly!
(Note: you won’t get a reward for every chunk you’re expected to hold, they are only paid at PUT time, not replication, to keep things simple… but you can expect to be rewarded on an ongoing basis as you accept new chunks and the network grows.)
As well as this, we’ve a bit more logging around putting data, together with a new
--concurrency option on the CLI which allows users to decide how much work to do concurrently when they upload data. The default
-c value is
5, more will upload more chunks and payments at the same time. The same can be set for downloads. High values here will require more client resources.
safe files -c 10 upload <dir> will set a concurrency value of 10 for the client.
- Verify the stability of pay-each-holder approach
- Verify Node Rewards are being received and can be queried
- Shake out any bugs in this process
Node version: 0.89.16
Client version: 0.81.16
Faucet url: 126.96.36.199:8000
"/ip4/188.8.131.52/tcp/35367/p2p/12D3KooWL7A4j2PoZyXaiwhPxZaHcPvjNfejNgQL1BBeqV3S6bZW" "/ip4/184.108.40.206/tcp/37491/p2p/12D3KooWJWvSH6cmg1HfskNB4PPkdfpnpqn9Z1MTtZ9ZvEEfx9pf" "/ip4/220.127.116.11/tcp/35307/p2p/12D3KooWBWHFijhdKD2BmCqm3bn5oChXGJM1Xm2n8qw9GK6tvsD7" "/ip4/18.104.22.168/tcp/41255/p2p/12D3KooWA1KDD7cyVzcwuPkCG4PjH4y9FzUf1qbd2mFeFK2BGJFU" "/ip4/22.214.171.124/tcp/39401/p2p/12D3KooWMTDY3NdCB6TeQT3ZE3MHTjU9i9gJz552r7UUawi1wa96" "/ip4/126.96.36.199/tcp/33447/p2p/12D3KooWJvW634Lfd7b5N4vRievDEXaxtnSR5msLm9WiHAKsVa34" "/ip4/188.8.131.52/tcp/36513/p2p/12D3KooWCtPdWgn82hSVTqW7kYGhVx6SED75uEcziiWtTZtS9CiJ" "/ip4/184.108.40.206/tcp/34181/p2p/12D3KooWMzWbX6oZtNidygRYwDwD2ykaosQsDk6m7GebrjWhDac3" "/ip4/220.127.116.11/tcp/39861/p2p/12D3KooWGpXcWh7mhcKHXiSZRQE1cAkqpHMEB82SvqsJKF8VGdqP"
We have 101 droplets running a total of 2001 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.
If you already have
safeup, you can obtain the client and node binaries:
safeup client --version 0.81.16 safeup node --version 0.89.16
export SAFE_PEERS="/ip4/18.104.22.168/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" SN_LOG=all safenode
$env:SAFE_PEERS="/ip4/22.214.171.124/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" $env:SN_LOG = "all"; safenode
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>"
export SAFE_PEERS="/ip4/126.96.36.199/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" safe wallet get-faucet http://188.8.131.52:8000 safe files upload <directory-path>
$env:SAFE_PEERS = "/ip4/184.108.40.206/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" safe wallet get-faucet http://220.127.116.11:8000 safe files upload <directory-path>
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
We have a tool named
safeup which is intended to make it easy to obtain the client, node, and other utility binaries.
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.
safeup, you can install binaries like so:
safeup client # get the latest version of the client safeup client --version 0.81.16 # get a specific version safeup node # get the latest version of the node safeup node --version 0.89.16 # 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.
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.
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 SN_LOG=all safenode # Windows $env:SN_LOG = "all"; safenode
This will output all the logs in the terminal.
Sometimes it will be preferable to output the logs to file. You can do this by running the node like so:
# Linux/macOS SN_LOG=all safenode --log-output-dest data-dir # Windows $env:SN_LOG = "all"; safenode --log-output-dest data-dir
The location of
data-dir is 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.
You can use the
safe client binary to connect as a client and upload or download files to/from the network.
To connect, you must provide another peer, in the form of a multi address. You can find one in the ‘Network Details’ section at the top.
It is recommended to set the peer using the environment variable
SAFE_PEERS. You can set this variable once and it will apply for the duration of your shell session:
# Linux/macOS export SAFE_PEERS="/ip4/18.104.22.168/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" # Windows $env:SAFE_PEERS = "/ip4/22.214.171.124/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib"
NOTE: If you close and/or start a new shell session, you will be required to redefine this environment variable in the new session.
As an alternative to the environment variable, it’s also possible to use the
safe --peer="/ip4/126.96.36.199/tcp/37569/p2p/12D3KooWPHE8qcKL4CB2n8QvPpE25TRsP9nmkfeM6Qa61aAsokib" ...
However, this requires specifying the peer with each command.
You’ll first need to get some Safe Network Tokens:
safe wallet get-faucet http://188.8.131.52: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] [XORURL]
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.