元界智能资产(MST)使用说明

MST 新增特性

  1. MST 介绍
  2. MST 新增特性 - 发行
  3. MST 新增特性 - 增发
  4. MST 新增特性 - 条件释放
  5. MST 新增特性 - 多重签名
  6. MST 新增特性 - 域名和证书
  7. MST 新增特性 - 销毁

以下为 v0.8.0 之前的 MST 功能，以及 v0.8.0 对这些功能的扩展。

前提简述

这里主要介绍资产相关的命令行操作，其它的命令可以参考 Command-line

首先，你要有帐户和数字身份(did)，可以通过 "mvs-cli getnewaccount 帐户名 密码" 和 "mvs-cli issuedid 帐户名 密码 测试地址 测试did" 生成，生成后切记妥善保存主私钥（mnemonic-key）。

为了方便，下文中我统一使用帐户名为 test1，密码为 passwd1，测试did为testdid，地址为测试地址，您在参考时请修改为自己的帐户名和密码，同时注意使用正确的地址。

有了帐户，如果要发布或发送资产等，你还得确保该帐号下有 ETP 交手续费。可以通过 "mvs-cli getbalance test1 passwd1" 查询帐户总余额详情，也可以通过 "mvs-cli listbalances test1 passwd1" 查询帐户里各个地址下的余额。

所有命令都可以通过 help 查询帮助，例如使用 "mvs-cli help createasset" 或者 "mvs-cli createasset -h" 查询命令 createasset 的帮助。

创建资产

createasset

Usage:
mvs-cli createasset [-h] --symbol value --volume value
[--description value] [--issuer value] [--decimalnumber value]
[--rate value] ACCOUNTNAME ACCOUNTAUTH

选项:
-h [--help]          获取帮助。
-d [--description]   资产描述,默认为空。
-i [--issuer]        资产发布人的did。
-n [--decimalnumber] 小数位数，默认为0。
-r [--rate]          资产增发阈值，默认为0。合法取值范围为 -1 到 100，
                     其中 -1 表示可任意增发，0 表示永不增发，
                     1 到 100 表示需要资产持有百分比超过指定阈值才可增发。
-s [--symbol]        资产符号，全网惟一。
-v [--volume]        资产发行总量。

位置参数:
ACCOUNTNAME          帐户名，必须提供。
ACCOUNTAUTH          帐户密码，必须提供。

示例：
$ mvs-cli createasset --symbol MVS.TST --volume 1000000000000 --description "testing asset of MVS" --issuer testdid --decimalnumber 8 --rate 30 test1 passwd1

注：”-r [–rate]” 为新增参数(v0.8.0)，用于资产增发验证。

注：小数位数（decimalnumber）的意义很重要，请勿必理解。从开发者角度来看，其作用是去除在交易中使用浮点数，命令中全部使用整数以提高运算效率和精度。从普通用户角度来看，其作用是设定最小交易单位，例如当小数位数为8时，最小单位为聪，此时在命令中使用的数值都是以聪为单位的。当小数位数为其它值时，情况类似。如果您觉得这样不太符合您的思维方式，您可以使用默认值0即可。

扩展功能 (v0.8.0)

  1. -r [--rate] 为新增参数，用于增发的一个验证条件.
    参考 MST 新增特性 - 增发
  2. -i [--issuer] 限制发行者必须是数字身份.
    参考 数字身份 (Avatar)

查询资产

资产有几种状态："unissued"，"issued"，"unspent"，分别表示 “未发布”，“已发布”，“未花费”。

getaccountasset

根据帐户获取资产，包含未发布资产。返回结果中含有资产的地址信息。
注： 如果指定了 SYMBOL 参数，则返回指定 SYMBOL 的资产；否则返回该账户下所有的资产。
输出资产的数量是各个地址下所有资产数量的总和，按地址进行汇总计算。
本命令不输出未发布的资产。

$ mvs-cli getaccountasset test1 passwd1

getaddressasset

根据地址获取已成功发布资产
输出资产的数量是该地址下所有资产数量的总和。
本命令不输出未发布的资产。

$ mvs-cli getaddressasset MKWjVNAGSDjhQmUW9VUwcBNGTscYozNopJ

listassets

获取全网资产或指定帐户资产总计
注： 如果没有指定账户，则列出所有全网已发布的资产。否则列出指定账户下的所有资产（包括未发布的本地资产）。
输出资产的数量是所有资产数量的总和，已发布资产和未发布资产分别列出，按账户求和。

# 列出所有已成功发布的资产
$ mvs-cli listassets
# 列出指定帐户的资产，包含未发布资产。返回结果中不含资产地址信息。
$ mvs-cli listassets test1 passwd1

getasset

获取已成功发布的资产

# 获取所有已成功发布的资产符号列表
$ mvs-cli getasset
# 获取已成功发布的指定资产符号的资产
$ mvs-cli getasset MVS.TST

扩展功能 (v0.8.0)

  1. listassets, getasset, getaddressasset and getaccountasset 有一个 --cert 选项用于获取资产证书。

删除本地资产(未发布的资产)

deletelocalasset

删除本地资产，也即还没发布的资产。注：资产一经发布，则不能删除了。

# 临时创建一个本地资产，再将其删除。
$ mvs-cli createasset --symbol MVS.TST2 --volume 10000 --description "temp testing asset of MVS" --issuer testdid --decimalnumber 0 test1 passwd1
$ mvs-cli deletelocalasset --symbol MVS.TST2 test1 passwd1

发布资产

注：已经发布的资产不能再次发布，再次发布会报错”validate transaction failure”

issue

该命令所需三个参数依次为：帐户名，密码，资产符号

$ mvs-cli issue test1 passwd1 MVS.TST

可以通过选项 "--fee 整数值" 设定发布资产的手续费，默认为10ETP。手续费多的话可能矿工们更愿意将此次交易打包进区块中去，交易确认的时间可能会更短一些。一般使用默认值即可。

扩展功能 (v0.8.0)

  1. 可以通过 -m [--model] 参数指定条件释放模型
    参考 MST 新增特性 - 条件释放
  2. 发布资产时会自动颁发一些相应的证书
    参考 MST 新增特性 - 域名和证书

发送资产

注：资产需要发布后才能发送

sendasset

该命令所需五个参数依次为：帐户名，密码，接收地址，资产符号，发送数量
注： 只能指定接收地址, 不需指定发送地址

$ mvs-cli sendasset test1 passwd1 MQTAjXoteFzzZoWpNEamG88gf5b82z6o9Q MVS.TST 100

sendassetfrom

该命令所需六个参数依次为：帐户名，密码，发送地址，接收地址，资产符号，发送数量
注： 手续费从发送地址扣除

$ mvs-cli sendassetfrom test1 passwd1 MKWjVNAGSDjhQmUW9VUwcBNGTscYozNopJ MQTAjXoteFzzZoWpNEamG88gf5b82z6o9Q MVS.TST 900

以上两个命令均可以通过选项 "--fee 整数值" 设定发送资产的手续费，默认为10000ETP bits(也即0.0001ETP)。手续费多的话可能矿工们更愿意将此次交易打包进区块中去，交易确认的时间可能会更短一些。一般使用默认值即可。

扩展功能 (v0.8.0)

  1. 可以通过 -m [--model] 参数指定条件释放模型
    参考 MST 新增特性 - 条件释放