Quick Start

Install User Cli From Pip

User's python environment needs to be >= 3.5

Run the following command to install the program

pip install v-cloud-market-cli-user

Run user cli client in mainnet

vcloud

Run user cli client in testnet

vcloud -t

Install User Cli From Source

Clone code from repository

git clone git@github.com:virtualeconomy/v-cloud-market-cli-user.git

Enter directory of market-place-cli to start virtual environment
```
 source ./venv/bin/activate
```
Run user cli client (mainnet)
```
python use_main_interface.py
```
Run user cli client (testnet)
```
python use_main_interface.py -t
```

Prepare for V account

1. Import V account with your account seed

Enter 1 to select [1]Recover Wallet From Seed.
Follow the prompt Please enter the number of addresses in the wallet (1-10):, enter the number of accounts to be generated (up to 10).
Follow the prompt Please enter a password to encrypt your wallet (press ENTER for no encryption), set the wallet password, or enter empty to set no password.
Follow the prompt Please enter your wallet seed, enter your V account seed.

For example:

==================================================================================
||    __          __   _ _      _     _____       _ _   _       _ _             ||
||    \ \        / /  | | |    | |   |_   _|     (_) | (_)     | (_)            ||
||     \ \  /\  / /_ _| | | ___| |_    | |  _ __  _| |_ _  __ _| |_ _______     ||
||      \ \/  \/ / _` | | |/ _ \ __|   | | | '_ \| | __| |/ _` | | |_  / _ \    ||
||       \  /\  / (_| | | |  __/ |_   _| |_| | | | | |_| | (_| | | |/ /  __/    ||
||        \/  \/ \__,_|_|_|\___|\__| |_____|_| |_|_|\__|_|\__,_|_|_/___\___|    ||
||                                                                              ||
||                                                                              ||
==================================================================================
[1]    Recover Wallet From Seed
[2]    Generate New Wallet

Please Select Your Choice: 1
Please enter the number of addresses in the wallet (1-10): 1
Please enter a password to encrypt your wallet (press ENTER for no encryption): :
Please enter your wallet seed:
                                                                             Wallet Address Information

                Address                                 Account Seed                                   Private Key                                     Public Key
 ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  AU*********************************   3J******************************************   13******************************************   9y******************************************

                                                                      Wallet Address Balance Information-vsys

                           Address                                       Regular Balance             Minting Average              Available Balance              Effective Balance
 ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
             AU*********************************                                       0                           0                              0                              0

Press ENTER to continue...

2. Generate new V account

You can create V account in testnet (opens new window) or mainnet (opens new window)（warning: please keep the wallet seed with caution). Top up the accounts in the wallet for future payment when using the user cli.
Or you can use cli to create a new V wallet seed by select [2] Generate New Wallet. Cli tool will guide you to create new accounts(warning: please keep the wallet seed with caution). Top up the accounts in the wallet for future payment when using the user cli.

Account Topup

Login your account in testnet (opens new window) or mainnet (opens new window) to get account address for digital currency exchange.
Go to VSwap (opens new window) and get balance.

Version Check

By default, cli will check the client version at startup

If there is a new version, the version update screen will be displayed.
If the current version is already the latest, this screen will be skipped.
If the client version is higher than the minimal supported version, you can choose not to update and continue using.

=========================================================================================
||     _    _           _       _                           _ _       _     _          ||
||    | |  | |         | |     | |           /\            (_) |     | |   | |         ||
||    | |  | |_ __   __| | __ _| |_ ___     /  \__   ____ _ _| | __ _| |__ | | ___     ||
||    | |  | | '_ \ / _` |/ _` | __/ _ \   / /\ \ \ / / _` | | |/ _` | '_ \| |/ _ \    ||
||    | |__| | |_) | (_| | (_| | ||  __/  / ____ \ V / (_| | | | (_| | |_) | |  __/    ||
||     \____/| .__/ \__,_|\__,_|\__\___| /_/    \_\_/ \__,_|_|_|\__,_|_.__/|_|\___|    ||
||           | |                                                                       ||
||           |_|                                                                       ||
=========================================================================================
Your current version:  0.0.7
The latest version:    0.1.0
Latest Change Log:
Basic functionality

Use the following command to upgrade:
pip install -U v-cloud-market-cli-user

Press ENTER to continue

If the client version is lower than the minimum supported version, you must exit and update the client to continue to use.

=====================================================================================
||     _   _       _      _____                              _   _           _     ||
||    | \ | |     | |    / ____|                            | | | |         | |    ||
||    |  \| | ___ | |_  | (___  _   _ _ __  _ __   ___  _ __| |_| |_ ___  __| |    ||
||    | . ` |/ _ \| __|  \___ \| | | | '_ \| '_ \ / _ \| '__| __| __/ _ \/ _` |    ||
||    | |\  | (_) | |_   ____) | |_| | |_) | |_) | (_) | |  | |_| ||  __/ (_| |    ||
||    |_| \_|\___/ \__| |_____/ \__,_| .__/| .__/ \___/|_|   \__|\__\___|\__,_|    ||
||                                   | |   | |                                     ||
||                                   |_|   |_|                                     ||
=====================================================================================
Your current version:             0.0.1
The latest version:               0.1.0
The minimal supported version:    0.0.5

The current version is not supported.
Use the following command to upgrade:
pip install -U v-cloud-market-cli-user

Press ENTER to exit

Go to About Vcloud in main screen to check the client version

For example:

Please Select Your Choice: 6
================================================================================
||              _                 _    __      __           _                 ||
||        /\   | |               | |   \ \    / /          (_)                ||
||       /  \  | |__   ___  _   _| |_   \ \  / /__ _ __ ___ _  ___  _ __      ||
||      / /\ \ | '_ \ / _ \| | | | __|   \ \/ / _ \ '__/ __| |/ _ \| '_ \     ||
||     / ____ \| |_) | (_) | |_| | |_     \  /  __/ |  \__ \ | (_) | | | |    ||
||    /_/    \_\_.__/ \___/ \__,_|\__|     \/ \___|_|  |___/_|\___/|_| |_|    ||
||                                                                            ||
||                                                                            ||
================================================================================
Your current version:  0.0.7
The latest version:    0.1.0
Latest Change Log:
Basic functionality

Use the following command to upgrade:
pip install -U v-cloud-market-cli-user

Press ENTER to continue...

Use the following command to update cli client

pip install -U v-cloud-market-cli-user

Unlock Wallet

If a password is already set, you will enter Unlock Wallet screen.

Enter 1 to select [1]Input Password
Follow the prompt Please enter your password for decrypting the wallet, enter your password to unlock the wallet.
If the password is correct, you will get the Wallet decrypted successfully prompt.
Follow the prompt Please enter the index of address that you want to use, enter the number of the address you want to use.

If there you set empty password, the unlock step will be skipped.

For example:

===========================================================================
||     _    _       _            _     __          __   _ _      _       ||
||    | |  | |     | |          | |    \ \        / /  | | |    | |      ||
||    | |  | |_ __ | | ___   ___| | __  \ \  /\  / /_ _| | | ___| |_     ||
||    | |  | | '_ \| |/ _ \ / __| |/ /   \ \/  \/ / _` | | |/ _ \ __|    ||
||    | |__| | | | | | (_) | (__|   <     \  /\  / (_| | | |  __/ |_     ||
||     \____/|_| |_|_|\___/ \___|_|\_\     \/  \/ \__,_|_|_|\___|\__|    ||
||                                                                       ||
||                                                                       ||
===========================================================================
[1]    Input Password
[2]    Restore Wallet with Seed

Please Select Your Choice: 1
Please enter your password for decrypting the wallet:
Wallet decrypted successfully.
Please enter the index of address that you want to use (1-3): 1
Success. Address index is set to 1. Press ENTER to continue...
===========================================================================
||     __  __       _          _____                 _                   ||
||    |  \/  |     (_)        / ____|               (_)                  ||
||    | \  / | __ _ _ _ __   | (___   ___ _ ____   ___  ___ ___  ___     ||
||    | |\/| |/ _` | | '_ \   \___ \ / _ \ '__\ \ / / |/ __/ _ \/ __|    ||
||    | |  | | (_| | | | | |  ____) |  __/ |   \ V /| | (_|  __/\__ \    ||
||    |_|  |_|\__,_|_|_| |_| |_____/ \___|_|    \_/ |_|\___\___||___/    ||
||                                                                       ||
||                                                                       ||
===========================================================================
[1]    Market Service
[2]    Order Service
[3]    Wallet Service
[4]    User Service
[5]    Cart Service
[6]    About Vcloud

Please Select Your Choice:

← Introduction Purchase Procedure →