mvc-cli

Description

This is a simple CLI tool to operate MVC cli wallet.

Installation

Prerequisite

You should install Node at your system first. Open your terminal run command node -v, if it console log v18.14, (18.14 is your node version, it will change depends what version you have installed), this means you have node installed.

If nothing shows, that means you haven't installed Node. For that, we recommand you use nvm to finish this set up.

Install

With node environment successfully set, you can install our cli tool as follows:

npm install -g @mvc-org/mvc-cli

Usage

Config your account

Open terminal, at your current working directory, run mvc-cli init and answer the next series of questions, this will generate account.json file at your current working directory.

// account.json file
MEMONIC="abc edf"
ACCOUNTPATH="m/44'/10001'/0'/0/0"
NETWORK=mainnet

Usage

mvc-cli [command] [options]

Options:

• -h, --help display help for command
• -tk, --tokens <tokens...> You can choose what tokens you want to check(Note1:token name should tranform to lowercase, Note2: this option is for get-ft-balance and get-nft-balance command, Note3, for ft token is symbol, for nft token is genesis id)

Commands | command | description | | :----- | :----- | | send <address> <amount>| for space transferring | | get-balance | for getting space amount of current account | | get-ft-balance -tk, --tokens <tokens...> | for getting fungible token balance of your account | | get-nft-collection -tk, --tokens <tokens...> | for getting non-fungible token collection of your account | | ft-transfer <token> <address> <amount> | for transferring your fungible token to target address| | ft-register | for registering a fungible token, just answer the following series of questions. |

Example

get help text for a specific command

mvc-cli send --help

transfer 0.01 space to target address

mvc-cli send 12ecgYPjeZh3mv6izoVuBSaa1Dxxwv2J1G 0.01

transfer 0.88 MSP ft token to target address

mvc-cli ft-transfer msp 12ecgYPjeZh3mv6izoVuBSaa1Dxxwv2J1G 0.88
// or
mvc-cli ft-transfer b2d75931958114e48c9927160f80363eae78e2dc 12ecgYPjeZh3mv6izoVuBSaa1Dxxwv2J1G 0.88
// b2d.... is token MSP's genesis code

register new fungible tokens

Open terminal, At your current working directory, run mvc-cli ft-register and answer the next series of questions, this will generate tokenRegister.json file at your current working directory.

// tokenRegister.json
[
  {
    "name": "msp",
    "genesis": "b2d75931958114e48c9927160f80363eae78e2dc",
    "decimal": "1e8",
    "codehash": "a2421f1e90c6048c36745edd44fad682e8644693"
  },
]

get balance

get mvc space

mvc-cli get-balance

get ft balance

mvc-cli get-ft-balance  // this will get all ft's balance
mvc-cli get-ft-balance --tokens msp mc // get specific tokens' balance, msp mc is tokens's symbol(!!remember transfer to lowercase!!)

get nft collection

mvc-cli get-nft-collection  // this will get all nft collection
mvc-cli get-nft-collection --tokens b2d75xxxxxxx  efd75xxxxxxx/ / get specific nfts' information, b2d75xxxxxxx is token's genesis id

Dependencies

• NestJS
• NestJS Commander