API v2 Usage

NOTICE

Strongly recommends referring to <a href=/api_v3/>API v3 to replace api v2.

This documentation provides more detailed information about the API.v2(JSON-RPC 2.0) list and will be particularly helpful for people who want to build BaaS(Blockchain As A Service) appliacations. If you are interested in more basic usage of Metaverse, please refer to the docs instead.

Please note that this documentation is only valid for MVS FULL NODE.
Compatiblity for API v1, please refers to API v1.

API v2 Usage

Supported v0.7.3 and later

API Default Port URI Default URL
API v2 8820 /rpc/v2 http://127.0.0.1:8820/rpc/v2
Websocket 8821 /ws http://127.0.0.1:8821/ws

Refers to How to configure Port.

Build Json, then HTTP POST to URL:

{                                                                        
 "id":number,                                                         
 "method":"xxx",                                                         
 "params":[                                                              
     "param1",  //command arguments from help
     "param2",  
     {
         "option1": value1,  //command options from help
         "option2": value2,  
     }
     ]                                                                   
 }

Example:

$ curl -X POST --data '{"jsonrpc":"2.0","method":"getinfo","params":[],"id":25}' http://127.0.0.1:8820/rpc/v2
$ curl -X POST --data '{"jsonrpc":"2.0","method":"sendmore","params":["account_name","account_auth",{"receivers":"t7r9twiK5gAwhR2gXDqT2zqpzS6ogvaqnJ:100000"}],"id":25}' http://127.0.0.1:8820/rpc/v2

Obviously, Use help to get all commands(methods) list.

$ ./mvs-cli help
$ ./mvs-cli help $command

API v2 Call List

Account

Method Online-required Admin-required Account-required Version
getnewaccount × × × 0.7.3
validateaddress × × × 0.7.3
importaccount × × × 0.7.3
importkeyfile × × × 0.7.3
dumpkeyfile × × √ 0.7.3
getnewaddress × × √ 0.7.3
listaddresses × × √ 0.7.3
changepasswd × × √ 0.7.3
deleteaccount × × √ 0.7.3
getaccount × × √ 0.7.3

Blockchain

Method Online-required Admin-required Account-required Version
shutdown × √ × 0.7.3
getinfo × √ × 0.7.3
getheight × √ × 0.7.3
getpeerinfo × √ × 0.7.3
getmininginfo √ √ × 0.7.3
startmining √ × √ 0.7.3
stopmining √ × √ 0.7.3
getwork √ × √ 0.7.3
addnode × √ × 0.7.3
setminingaccount √ × √ 0.7.3
submitwork √ × √ 0.7.3
getmemorypool × √ × 0.7.3

Block

Method Online-required Admin-required Account-required Version
getblock × √ × 0.7.3
getblockheader × √ × 0.7.3

ETP

Method Online-required Admin-required Account-required Version
getbalance √ × √ 0.7.3
listbalances √ × √ 0.7.3
deposit √ × √ 0.7.3
send √ × √ 0.7.3
sendfrom √ × √ 0.7.3
sendmore √ × √ 0.7.3

Transaction

Method Online-required Admin-required Account-required Version
gettx √ × × 0.7.3
listtxs √ × √ 0.7.3

Multi-Signatue

Method Online-required Admin-required Account-required Version
createmultisigtx × × √ 0.7.3
getpublickey × × √ 0.7.3
deletemultisig × × √ 0.7.3
getnewmultisig × × √ 0.7.3
listmultisig × × √ 0.7.3
signmultisigtx × × √ 0.7.3

Rawtx(offline-sign)

Method Online-required Admin-required Account-required Version
createrawtx × × × 0.7.3
signrawtx × × √ 0.7.3
decoderawtx × × × 0.7.3
sendrawtx √ × × 0.7.3

DID

Method Online-required Admin-required Account-required Version
registerdid √ × √ 0.8.0
didchangeaddress √ × √ 0.8.0
listdids × × × 0.8.0
getdid × × × 0.8.0
didsend √ × √ 0.8.0
didsendmore √ × √ 0.8.0
didsendasset √ × √ 0.8.0
didsendassetfrom √ × √ 0.8.0

MST

Method Online-required Admin-required Account-required Version
createasset × × √ 0.7.3
deletelocalasset × × √ 0.7.3
getaccountasset √ × √ 0.7.3
getaddressasset √ × √ 0.7.3
getasset × × × 0.7.3
issue √ × √ 0.7.3
issuefrom √ × √ 0.7.3
listassets √ × optional 0.7.3
sendasset √ × √ 0.7.3
sendassetfrom √ × √ 0.7.3

Cert

Method Online-required Admin-required Account-required Version
issuecert √ × √ 0.8.0
transfercert √ × √ 0.8.0

MIT

Method Online-required Admin-required Account-required Version
registermit √ × √ 0.8.0
transfermit √ × √ 0.8.0
listmits × × optional 0.8.0
getmit × × × 0.8.0
  • Method : JSON-RPC Method
  • Online-required: whether needs to wait for almost latest height.

  • Admin-required: whether provides administrator authorization, defaluts to no. (name: administrator)(password: mvsgo).

    # mvs.conf
    [server]
    administrator_required = 1

  • Account-required : user account name, password required.

  • Version : release in version.

mvs-cli

mvs-cli uses /rpc/v2 to call mvsd after v0.7.3.

Next