To get familiar with myst cli usage follow the below guide which explains initial set up and available commands for node operators. Mysterium CLI allows you to create, unlock & register node identity, claim your node into mystnodes.com, set bounty payout address, view NAT Traversal status & NAT type, check healthcheak, manually start/stop WireGuard service and more.

How to use the CLI

To start open your terminal and execute:

Once started your terminal window should change to the myst cli interface. To get help and see a full list of possible commands execute:

Each command has an output, if the output does not start with [ERROR] or [WARNING] consider that command a success.

Commands can be autocompleted using the tab key on your keyboard.

Initial setup

If you have already installed a Mysterium node but have no access to the NodeUI to complete the onboarding process, you'll have to unlock and register your identity with Mysterium CLI. Go ahead and fire up the cli application and follow the steps below.

Check your identity

In order to identify yourself in the network you must have an identity which was created during the installation process. Use the command below to print your node identity address to your terminal.

Unlock the new identity

In order to use the created identity it has to be unlocked first.

Unlocking has to be done every time we launch the myst cli and want to use the created identity.

For the sake of simplicity let's say we've received an identity: 0x4570fe47a49af9ae9bd76f029818413ea18620000, which we'll use in all later steps.

To unlock it we'd have to execute:

Register your identity

After creating and unlocking the identity it must be registered so that Mysterium services are aware about it and it's balance, to do that execute the identities register command.

Optional field [beneficiary] can be provided. If provided withdrawal will be automatic and will be sent to provided beneficiary wallet on each settlement.

Claim your node into mystnodes.com

Note: You can find and copy your API key in your Mystnodes profile.

Set payout wallet address

Note: Not required if beneficiary is set as withdrawals will be automatic.

There are two types of wallets that you can use:

Exchange wallets (HitBTC and Bittrex deposit addresses are supported on Ethereum network only!!);

Direct Blockchain wallets (Metamask, Trust wallet, Atomic, MEW, MyCrypto, Trezor, Ledger ...).

MYST is a standard ERC20 token, if wallet supports ERC-20 tokens (has possibility to add any custom ERC-20 token), then MYST can be added there.

‍

MYST token details on Polygon:

Token Contract Address on PolygonScan : 0x1379e8886a944d2d9d440b3d88df536aea08d9f3

Symbol: MYST

Decimals: 18

To learn more about token and how to properly set it up, visit our MYST and Payout guide.

‍

Get payout wallet address

Ensure that beneficiary wallet address has been successfully changed:

Withdraw earned MYST

Note: Not required if beneficiary is set as withdrawals will be automatic.

You can use the CLI to withdraw MYST you've earned. Make sure your identity is unlocked and check your balance and earnings:

(Optional) The amount which you can withdraw will be displayed as your balance. Your earnings are periodically settled in to your balance. If you want to settle earnings in to balance yourself (it will cost you a certain amount MYST in fees), you can do so by running:

After that's done you can now withdraw your funds using the withdraw command:

You can withdraw funds to:

• 137 (Matic mainnet)

Set beneficiary for automatic withdrawals

Automatic withdrawals can be enabled by setting your beneficiary address not to be equal to your channel address. Doing so requires you to have unsettled balance as a transaction to change the address is also a settlement.

To change your beneficiary execute:

To view the status of your beneficiary transaction and your current set beneficiary execute:

Managing node service

To start WireGuard service we'd have to execute (note that WireGuard service is started automatically upon installation, therefore you don't need to start it manually):

To stop WireGuard service:

To get ID and status of your currently active service:

If you are seeing the similar output to the one below - your service is up and running!

[Running] ID: 7b4652a8-2021-4b9d-aeea-da7a60709678 ProviderID: 0x00f735d4ad380b56b92cd6c9f078763bbfeab3e8 Type: wireguard

To get a list of sessions:

To get NAT Traversal status and NAT type:

To view your current node version and uptime execute:

‍