Description
API Methods
createassetcreateasset
- Parameters (optional)
-dor[--description]The asset description.-ior[--issuer]The did symbol specified its issuer.-nor[--decimalnumber]The asset amount decimal number.-ror[--rate]The percent threshold value when you secondary issue.-sor[--symbol]The asset symbol/name. Global unique.-vor[--volume]The asset maximum supply volume.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH"
]
Returns
Object- the asset just createdExample
// Request
curl -X POST -d '{
"id":25,
"jsonrpc":"2.0",
"method":"createasset",
"params":[
"test",
"123456",
{
"description": "test asset",
"issuer": "testdid01",
"decimalnumber": 8,
"symbol": "MVS.TST",
"volume": 10000000,
"rate": -1
}
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 25,
"jsonrpc" : "2.0",
"result" :
{
"address" : "",
"decimal_number" : 8,
"description" : "test asset",
"is_secondaryissue" : false,
"issuer" : "testdid01",
"maximum_supply" : 10000000,
"secondaryissue_threshold" : 127,
"status" : "unissued",
"symbol" : "MVS.TST"
}
}
deletelocalassetdeletelocalasset
- Parameters (optional)
-sor[--symbol]The asset symbol/name. Global unique.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH"
]
Returns
Object-operate- delete operationresult- successsymbol- asset symbolExample
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"deletelocalasset",
"params":["test", "123456", {"symbol": "MVS.TST2"}],"id":36}' http://127.0.0.1:8820/rpc/v3
// Response
{
"jsonrpc" : "2.0",
"id": 36,
"result" :
{
"status" : "deleted successfully",
"symbol" : "MVS.TST2"
}
}
issueissue
- Parameters (optional)
-for[--fee]The fee of tx. default_value 10 etp-mor[--model]The token offering model by block height.-por[--percentage]Percentage of fee send to miner. minimum is 20.-sor[--subsidy]The block subsidy parameters for mining.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.SYMBOLissued asset symbolparams:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"SYMBOL"
]
Returns
Object- transactionExample
// Request
curl -X POST -d '{
"id":25,
"jsonrpc":"2.0",
"method":"issue",
"params":[
"test",
"123456",
"MVS.TST"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 25,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "60036d05751217dcb8966b72bf6a63b9698119852b8db207aae2a097f33e97f1",
"inputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "f9a5b1b9b24596ae196644bf4c570a6dfae3a640eca9770894cbf1b15e3e929b",
"index" : 0
},
"script" : "[ 3044022054d56e8d58c35a5301b202637526c50b6a21ec15d957627735fd73efa6895d3102202f44387331d5f51b4a495d921c435bf3706dabc5ac627e4d8363716ef040fb3e01 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "8674c31635d01b553e82d43c40cd8d244305ffdd36d70f2cdc6c452c531a6dd3",
"index" : 0
},
"script" : "[ 30450221008214b82a6bf56130f267fb076e4279b45c5a59f4f5961a31161b154bead3334a022021c0718d8616cc12c750288ae2d0e09556219e7fe7e26ad4defa3930684b70da01 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "3741336e1183b2c0547d7a77f149c32025b3baa5794fa9d89e74289aafe0e237",
"index" : 0
},
"script" : "[ 30440220692ce6e3f045e378027358d2556d847d26fe4f3b9e9eaa8b0bee7de4929c11d302203f6c7cab72ca85974493f64eda13ccd01037db15e773188aa60f46d43197f26001 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "df120d742c43340141125e142890fd47cbbc49936e8c698efc466d171b7e5094",
"index" : 0
},
"script" : "[ 3045022100b4378e808d398ac69498c2e9c9eac39ab62fb5ca80508644b15f7bed8d78370002202294a44691a98726c70e652587639ee265a823566b36182097075598d64b976401 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid01",
"quantity" : 10000000,
"secondaryissue_threshold" : 127,
"symbol" : "MVS.TST",
"type" : "asset-issue"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "issue",
"owner" : "testdid01",
"symbol" : "MVS.TST",
"type" : "asset-cert"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "domain",
"owner" : "testdid01",
"symbol" : "MVS",
"type" : "asset-cert"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"type" : "etp"
},
"index" : 3,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 200000000
}
],
"version" : "3"
}
}
getaccountassetgetaccountasset
- Parameters (optional)
-cor[--cert]If specified, then only get related cert. Default is not specified.-dor[--deposited]If specified, then only get deposited assets.-tor[--type]If specified, then only get related type of cert.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.SYMBOLAsset symbol.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"SYMBOL"
]
Returns
Object- account assetsExample
// Request to get asset
curl -X POST -d '{
"id":25,
"jsonrpc":"2.0",
"method":"getaccountasset",
"params":[
"test",
"123456",
"MVS.TST",
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 25,
"jsonrpc" : "2.0",
"result" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid01",
"locked_quantity" : 0,
"quantity" : 10000000,
"secondaryissue_threshold" : 127,
"status" : "unspent",
"symbol" : "MVS.TST"
}
]
}// Request to get cert
curl -X POST -d '{
"id":25,
"jsonrpc":"2.0",
"method":"getaccountasset",
"params":[
"test",
"123456",
"MVS.TST",
"--cert"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 25,
"jsonrpc" : "2.0",
"result" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "issue",
"owner" : "testdid01",
"symbol" : "MVS.TST"
}
]
}
getaddressassetgetaddressasset
- Parameters (optional)
-cor[--cert]If specified, then only get related cert. Default is not specified.-dor[--deposited]If specified, then only get deposited assets. Default is not specified.-sor[--symbol]Asset symbol.-ror[--range]Pick utxo whose value is between this range [begin:end).-uor[--utxo]If specified, list all utxos. Default is not specified.-xor[--utxominimumconfirmations]If specified, list utxos which minimum confirmations. defaults to 3.
- Parameters (positional)
ADDRESSaddressparams:[
"ADDRESS"
]
Returns
Object- address assetsExample
// Request
curl -X POST -d '{
"id":38,
"jsonrpc":"2.0",
"method":"getaddressasset",
"params":["MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m"]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 38,
"jsonrpc" : "2.0",
"result" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid01",
"locked_quantity" : 0,
"quantity" : 10000000,
"secondaryissue_threshold" : 127,
"status" : "unspent",
"symbol" : "MVS.TST"
}
]
}// Request
curl -X POST -d '{
"id":25,
"jsonrpc":"2.0",
"method":"getaddressasset",
"params":[
"MGb4a2vtRHY6kkEH486hHrGsziGhTcSiyn",
"-r",
"0:999999999999",
"-s", "DNA",
"--utxo",
"--utxominimumconfirmations", 100
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 25,
"jsonrpc" : "2.0",
"result" :
[
{
"available" : 11,
"balance" : 11,
"frozen" : 0,
"symbol" : "DNA",
"utxo_block" : 175161,
"utxo_hash" : "85fa132f9d44a4a91576ef78c731ee78f7cf6656606344458085eef24ba29e2e",
"utxo_index" : 0
},
{
"available" : 11,
"balance" : 11,
"frozen" : 0,
"symbol" : "DNA",
"utxo_block" : 174943,
"utxo_hash" : "83d7e9bc1b01df0ed55349ee0127ecc6b8fb8e42fa6ea44afc3066da73a2f2b5",
"utxo_index" : 0
}
]
}
getassetgetasset by symbol
- Parameters (optional)
-cor[--cert]If specified, then only get related cert. Default is not specified.-ior[--issuer]If specified, then only get asset/cert issued by this issuer.
- Parameters (positional)
SYMBOLAsset symbol.params:[
"SYMBOL"
]
Returns
Object- assets with specified symbolExample
// Request
curl -X POST -d '{
"id":38,
"jsonrpc":"2.0",
"method":"getasset",
"params":[
"MVS",
"--cert"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 38,
"jsonrpc" : "2.0",
"result" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "domain",
"owner" : "testdid01",
"symbol" : "MVS"
}
]
}
listassetslist assets details.
- Parameters (optional)
-cor[--cert]If specified, then only get related cert. Default is not specified.-tor[--type]If specified, then only get related type of cert.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH"
]
Returns
Object- assetsExample
// Request
curl -X POST -d '{
"id":38,
"jsonrpc":"2.0",
"method":"listassets",
"params":[
"test",
"123456"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 38,
"jsonrpc" : "2.0",
"result" :
[
{
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid01",
"locked_quantity" : 0,
"quantity" : 10000000,
"secondaryissue_threshold" : 127,
"status" : "unspent",
"symbol" : "MVS.TST"
}
]
}
sendassetsendasset, aliasdidsendasset- Parameters (optional)
-cor[--change]Change to this did/address.-for[--fee]The fee of tx. default_value 0.0001 etp.-ior[--memo]Attached memo for this transaction.-mor[--model]The token offering model by block height.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.TOAsset receiver did/address.SYMBOLAsset symbol/name.AMOUNTAsset count.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"TO",
"SYMBOL",
"AMOUNT"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"sendasset",
"params":[
"test",
"123456",
"avatar2@test",
"MVS.TST",
"1000"]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "26b4fdb3d142c98685a83107d8126b2f127eeb1c321f5829458dbd9f02889888",
"inputs" :
[
{
"address" : "MQA3r2AVy9TLzoYwdyCmT2roCqTHVRk2Tj",
"previous_output" :
{
"hash" : "58f3e33ecdb7a6310d37e7946f752843656f2ff479abc55d7a710699cb4f3180",
"index" : 4
},
"script" : "[ 3045022100d18cd54b30b38066bfb7c8dd91016b74eab95267df6eae38d35b17b3a27890b902203e76503c5bb5c4c0df6b6e31ba768c3d5f9b6cd0c39ab70684291cd9e414a25a01 ] [ 028c56141ad8a906286a9d0abedf38e74d8d023b9fd1d94a550bb65e2f0cdc51f9 ]",
"sequence" : 4294967295
},
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"previous_output" :
{
"hash" : "a007f6811107a6f3207973eca13cb79ee7ddb9ef234827f4b4ff8f47211c831a",
"index" : 0
},
"script" : "[ 3044022100c9b6d2e40d316102d6ea1ec96b7c23bcaa7146348c40c00d269a1a011346a20e021f6aa02312b8d757f76e212bb101ab6a84dece9d18314f202136eb5a3dbf082801 ] [ 029cc98cc43c694e5ef26e504fdcdcb818563ce8b910fb2ffbf5ca2e399a0a9ce1 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MDdET3ybWc2cGEXXxBcjtXNCcmzJe48bhc",
"attachment" :
{
"from_did" : "",
"quantity" : 1000,
"symbol" : "MVS.TST",
"to_did" : "avatar2@test",
"type" : "asset-transfer"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ 3ecd9eb8af1d9459da10fc3a096c460ff24aaa6d ] equalverify checksig",
"value" : 0
},
{
"address" : "MQA3r2AVy9TLzoYwdyCmT2roCqTHVRk2Tj",
"attachment" :
{
"type" : "etp"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ b252ebbfdbfc38f1ed7d845bbb1f8e25fa7c1693 ] equalverify checksig",
"value" : 99990000
},
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"attachment" :
{
"quantity" : 19999999000,
"symbol" : "MVS.TST",
"type" : "asset-transfer"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 5a40f31ced32e9fcad58a9b54e6f607843efac87 ] equalverify checksig",
"value" : 0
}
],
"version" : "4"
}
}
sendmoreassetsendmoreasset, aliassendassetmore- Parameters (optional)
-cor[--change]Change to this did/address.-for[--fee]The fee of tx. default_value 0.0001 etp.-ior[--memo]Attached memo for this transaction.-mor[--model]The token offering model by block height.-ror[--receivers]Send to [did/address:amount]
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.ASSETAsset MST symbol/name.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"ASSET"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"sendmoreasset",
"params":[
"test",
"123456",
"MVS.TST",
{
"receivers":"tBQZQevpppGQEeha126cTPjdmKeWqQCjsW:1",
"change": "tRL8yxhSd3AAxpRcbxmEasv89VZ7ZJgh3y"
}
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "f882e1185712949b09c6c5db3db74cda529ab4858e3c5cb2e73588c4deeb83f0",
"inputs" :
[
{
"address" : "tCQGGTk2dRZqo5cQZmu5RDmnjKwrFW3u5v",
"previous_output" :
{
"hash" : "690d4c3a08ddb1fc246897dac26567fe7c5d0089cd5f3c70f441dd8735e0bb86",
"index" : 2
},
"script" : "[ 3045022100a5a05b0a67d2d2144857db36feccb31e1e87f678d7aa0e4a2d0f12e84a2bc6a80220575f0b4c8320d7ea501ef5c44ceb8367ab7544bd391bfdce81070380a8d5363c01 ] [ 02abf9cbebc65dce3471c61c4a3c4f8aaedca1b036233fe479fab66e7e99832c80 ]",
"sequence" : 4294967295
},
{
"address" : "tCQGGTk2dRZqo5cQZmu5RDmnjKwrFW3u5v",
"previous_output" :
{
"hash" : "690d4c3a08ddb1fc246897dac26567fe7c5d0089cd5f3c70f441dd8735e0bb86",
"index" : 1
},
"script" : "[ 304402207fbd3b49ab79233f8cb5ba87be277c56a07535bd3c7785948c0c02e890115c2e02204122ff1fa8d23180432a55dcb394a2255052b5cb5bcbac9644943132e051103b01 ] [ 02abf9cbebc65dce3471c61c4a3c4f8aaedca1b036233fe479fab66e7e99832c80 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "tBQZQevpppGQEeha126cTPjdmKeWqQCjsW",
"attachment" :
{
"quantity" : 1,
"symbol" : "MVS.TST",
"type" : "asset-transfer"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ 3129f231441ed9865cce2ed4337095ec1c245f95 ] equalverify checksig",
"value" : 0
},
{
"address" : "tRL8yxhSd3AAxpRcbxmEasv89VZ7ZJgh3y",
"attachment" :
{
"type" : "etp"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ c9e5a7523f9f51858ad923995de69be769a2ed7d ] equalverify checksig",
"value" : 199799860000
},
{
"address" : "tRL8yxhSd3AAxpRcbxmEasv89VZ7ZJgh3y",
"attachment" :
{
"quantity" : 99998997,
"symbol" : "MVS.TST",
"type" : "asset-transfer"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ c9e5a7523f9f51858ad923995de69be769a2ed7d ] equalverify checksig",
"value" : 0
}
],
"version" : "4"
}
}
sendassetfromsendassetfrom, aliasdidsendassetfrom- Parameters (optional)
-cor[--change]Change to this did/address.-for[--fee]The fee of tx. default_value 0.0001 etp.-ior[--memo]Attached memo for this transaction.-mor[--model]The token offering model by block height.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.FROMFrom did/addressTOTarget did/addressSYMBOLasset symbolAMOUNTThe asset amount sharesparams:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"FROM",
"TO",
"SYMBOL",
"AMOUNT"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"sendassetfrom",
"params":[
"test",
"123456",
"avatar1@test",
"avatar2@test",
"MVS.TST",
"1000"]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "48e9c786a9967133d797c2a4d357c6cbcc9aae9950a22bece8952a0f9f0a2c64",
"inputs" :
[
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"previous_output" :
{
"hash" : "26b4fdb3d142c98685a83107d8126b2f127eeb1c321f5829458dbd9f02889888",
"index" : 2
},
"script" : "[ 3045022100ff7454a3f2b182c21644633ccd619b461fba80825b03c589c9cf3d2dc754f36502204df868be4cac9620410eba6f0a44985e48ef3506fc6cc299d4954f4995fc635701 ] [ 029cc98cc43c694e5ef26e504fdcdcb818563ce8b910fb2ffbf5ca2e399a0a9ce1 ]",
"sequence" : 4294967295
},
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"previous_output" :
{
"hash" : "a007f6811107a6f3207973eca13cb79ee7ddb9ef234827f4b4ff8f47211c831a",
"index" : 2
},
"script" : "[ 304402203a5f5ebc7ec3a69e85de66aab9040d65d59d53c251ed7200503f23fc970f8a7502204025820e443c32a3c44a443e7c00668e4b9a1be3cccc9750ae1c2590769a3c8901 ] [ 029cc98cc43c694e5ef26e504fdcdcb818563ce8b910fb2ffbf5ca2e399a0a9ce1 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MDdET3ybWc2cGEXXxBcjtXNCcmzJe48bhc",
"attachment" :
{
"from_did" : "avatar1@test",
"quantity" : 1000,
"symbol" : "MVS.TST",
"to_did" : "avatar2@test",
"type" : "asset-transfer"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ 3ecd9eb8af1d9459da10fc3a096c460ff24aaa6d ] equalverify checksig",
"value" : 0
},
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"attachment" :
{
"type" : "etp"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 5a40f31ced32e9fcad58a9b54e6f607843efac87 ] equalverify checksig",
"value" : 199980000
},
{
"address" : "MG8NrUax9CwCmXxYcGFcEsDxYMMC2WyPvk",
"attachment" :
{
"quantity" : 19999998000,
"symbol" : "MVS.TST",
"type" : "asset-transfer"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 5a40f31ced32e9fcad58a9b54e6f607843efac87 ] equalverify checksig",
"value" : 0
}
],
"version" : "4"
}
}
secondaryissue- Parameters (optional)
-for[--fee]The fee of tx. default_value 0.0001 etp-mor[--model]The asset attenuation model parameter-ior[--memo]Attached memo for this transaction.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.TODIDtarget didSYMBOLasset symbolVOLUMEThe asset amount sharesparams:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"TODID",
"SYMBOL",
"VOLUME"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"secondaryissue",
"params":[
"test",
"123456",
"testdid02",
"MVS.TST",
"300000"]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
{
"hash" : "ffc81240ba9450536ae536c73371278cdfc6d93525e5cf90f6f70505cd4d3aa4",
"inputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "60036d05751217dcb8966b72bf6a63b9698119852b8db207aae2a097f33e97f1",
"index" : 1
},
"script" : "[ 30440220546c550449497870675d6a3e147f710c19816561860d08b8f4d2d733f548773302202951b60405c8089b6543934225db7f6b9b65375ef0cfdf0680f488924c9c8f9801 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"previous_output" :
{
"hash" : "a0202fb916487d2d8d3a28a26e3f1eeb1429b4f59c3ead992a003dff7081410c",
"index" : 1
},
"script" : "[ 3044022068f1ff4b5a92d97f2972cbce91e5c2b14f736064da84b6b7c8ee0e20cf779fc702207eede510ab696de35710d75d848209e84aef762f6a9ff94fc51150de2d311a2201 ] [ 0264f9e773328d677de10b4e4fdd4abd69a9cd08e37dd12cc6762a71917a578662 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid02",
"quantity" : 300000,
"secondaryissue_threshold" : 127,
"symbol" : "MVS.TST",
"type" : "asset-issue"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ dae1cde292d5b762c49ecdb18900e8e115df9695 ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "issue",
"owner" : "testdid01",
"symbol" : "MVS.TST",
"type" : "asset-cert"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"type" : "etp"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ dae1cde292d5b762c49ecdb18900e8e115df9695 ] equalverify checksig",
"value" : 103199990000
}
],
"version" : "3"
}
}// Request with attenuation model
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"secondaryissue",
"params":[
"test",
"123456",
"testdid02",
"MVS.TST",
"800000",
{
"model":"TYPE=1;LQ=60002;LP=6002;UN=3"
}
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "a6671a3b74694f2d5da143153697d3d8cfda7f57aaa74fab0c83ef0ada2fc8de",
"inputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "ffc81240ba9450536ae536c73371278cdfc6d93525e5cf90f6f70505cd4d3aa4",
"index" : 1
},
"script" : "[ 3045022100c78829ab256e18b1a417bf80b6a7e1ed99f99b572e02b0f42a881de7b2ab2e7c022002ef7aa6c30f26a5096fda3e30ca17ebe57a2e5c1ccf06104c5e2bcde2f6d14901 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"previous_output" :
{
"hash" : "ffc81240ba9450536ae536c73371278cdfc6d93525e5cf90f6f70505cd4d3aa4",
"index" : 2
},
"script" : "[ 3044022063b51643bc0b448c68dc5550215b6879dba865f5427fe2283bfaa831ebe30c0e022063f177655474c98ec7f78c85402c7e1a39540df7f7baa53d6dafe06997201dc701 ] [ 0264f9e773328d677de10b4e4fdd4abd69a9cd08e37dd12cc6762a71917a578662 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"decimal_number" : 8,
"description" : "test asset",
"issuer" : "testdid02",
"quantity" : 800000,
"secondaryissue_threshold" : 127,
"symbol" : "MVS.TST",
"type" : "asset-issue"
},
"attenuation_model_param" :
{
"current_period_nbr" : 0,
"lock_period" : 6002,
"lock_quantity" : 60002,
"next_interval" : 2000,
"total_period_nbr" : 3,
"type" : 1
},
"index" : 0,
"locked_height_range" : 0,
"script" : "[ 504e3d303b4c483d323030303b545950453d313b4c513d36303030323b4c503d363030323b554e3d33 ] [ 0000000000000000000000000000000000000000000000000000000000000000ffffffff ] checkattenuationverify dup hash160 [ dae1cde292d5b762c49ecdb18900e8e115df9695 ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "issue",
"owner" : "testdid01",
"symbol" : "MVS.TST",
"type" : "asset-cert"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"type" : "etp"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ dae1cde292d5b762c49ecdb18900e8e115df9695 ] equalverify checksig",
"value" : 103199980000
}
],
"version" : "3"
}
issuecert- Parameters (optional)
-for[--fee]The fee of tx. default_value 0.0001 etp-dor[--description]Cert description, default is empty.-mor[--memo]Attached memo for this transaction.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.TODIDtarget didSYMBOLasset symbolCERTAsset cert type name. eg. namingparams:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"TODID",
"SYMBOL",
"CERT"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"issuecert",
"params":[
"test",
"123456",
"testdid02",
"MVS.NAMINGRIGHT",
"naming"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "b56abab5be918ee63b5913002dd15387d675ce67fc13e273bc5593e0e444b9a9",
"inputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "962d72e108c024ed9a5a2e4009e9d8e7dda6d52436921f371dde9fbe1b256eb9",
"index" : 0
},
"script" : "[ 3045022100bf7d56117349d3e8d99f4ec204f5a986ee02d4251bd0f17ea31ecf1c7e3459a602202f1a0a07eeb59a9010f00c3e0cd3f28c9e91b6f3b32d862323cc38413b8be2c801 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "60036d05751217dcb8966b72bf6a63b9698119852b8db207aae2a097f33e97f1",
"index" : 2
},
"script" : "[ 3045022100be9fd9b641871c97dd17bdaaedd05383a34aad99f6e863d71ee208981e93ea9802202ad2169c6fc6e553d518c3da4e4ea66ddd1b7a2ed73b4117cc8674293be68f4f01 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"cert" : "naming",
"owner" : "testdid02",
"symbol" : "MVS.NAMINGRIGHT",
"type" : "asset-cert"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ dae1cde292d5b762c49ecdb18900e8e115df9695 ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "domain",
"owner" : "testdid01",
"symbol" : "MVS",
"type" : "asset-cert"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"type" : "etp"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 299990000
}
],
"version" : "3"
}
}
transfercert- Parameters (optional)
-for[--fee]The fee of tx. default_value 0.0001 etp
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.TODIDtarget didSYMBOLasset symbolCERTAsset cert type name. eg. “issue”, “domain” or “naming”params:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"TODID",
"SYMBOL",
"CERT"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"transfercert",
"params":[
"test",
"123456",
"testdid01",
"MVS.NAMINGRIGHT",
"issue"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "6339e14720d4b38025bb4c44a367eea547186788a9b09b6af255c59032149481",
"inputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "2a26cafb20aef05af30c74a5e29da87ec229fceeaedbfaecba3cf8c94bf12388",
"index" : 0
},
"script" : "[ 30440220611aa6418141e2cfb1439e39b98c9a8597d2a37eb38f2a0da24d927aabf3de15022057776cf5e10f71e679301fe38014070a5ae5b66ef08465b8a76a1658eea62ee601 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "95ad43927b77d21567114db0511f459a6f2c3195e680df8875f444824942654d",
"index" : 0
},
"script" : "[ 3045022100e255df205a2cefb843dd830308bd7e5a0c3b4598671a0171e1dd05405d9443b702204086ff9b467397ed5fa5b8e400f6b9cb71b1317f00eec193063dc3d012197d8301 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "3726bb530ef6388b190c97f4fdb43a9274088928e8b1fabdf9419eb14769de80",
"index" : 1
},
"script" : "[ 3044022022f133daa5c47d723414e9d7b428a7b47525355dbf0d20b90cd2d7a6dd93304a02205fc31bf159567bea4daad0341c43d5e429b57fd5809defb1c793218a787a494c01 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"cert" : "domain",
"owner" : "testdid02",
"symbol" : "MVS",
"type" : "asset-cert"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "dup hash160 [ 830aa1718fc50ef867aa15bb8e4b3354a6b86bf1 ] equalverify checksig",
"value" : 0
},
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"attachment" :
{
"address" : "MTrW3QK8mjmTYSozdkLa7k9hyCExUBWYwP",
"cert" : "naming",
"owner" : "testdid01",
"symbol" : "MVS.NAMINGRIGHT",
"type" : "asset-cert"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 830aa1718fc50ef867aa15bb8e4b3354a6b86bf1 ] equalverify checksig",
"value" : 0
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"type" : "etp"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 299990000
}
],
"version" : "2"
}
}
burn- Parameters (optional)
-cor[--cert]cert type name, If specified, then only burn related cert. Default is not specified.-mor[--mit]If specified, then only burn related mit. Default is not specified.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.SYMBOLAsset symbolAMOUNTAsset integer bitsparams:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"SYMBOL",
"AMOUNT"
]
Returns
Object-Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"burn",
"params":[
"test",
"123456",
"MVS.NAMINGRIGHT",
"60000000"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"hash" : "107ab89c649e0489a2a0bebf2927a594d26d024393767eb2103633a6c35ccc42",
"inputs" :
[
{
"address" : "MLGuT4fp23SjyG2v5TW2PreQZTbXr7dyJe",
"previous_output" :
{
"hash" : "e5c1c9f069bb271298983f13ef9790d3cba2d92422dd3c5d4eff27b592c90e17",
"index" : 0
},
"script" : "[ 304402205722ed333a2f0412baa6a3ddd882afa69247567cd0480287dbd526dfd6b61b5a02201301b6974b1b9e1c95023e1a5a388fac98d277a67167465c90df8c773ea3eb7901 ] [ 02a6c7f2cbb0d0dff030f8082ce0f1b9f89ceb3340294fff2cb0a9ed78567cd37b ]",
"sequence" : 4294967295
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"previous_output" :
{
"hash" : "3726bb530ef6388b190c97f4fdb43a9274088928e8b1fabdf9419eb14769de80",
"index" : 0
},
"script" : "[ 304402207a1ed5f4eacbc6b168553ccd4190304397fe77bcdb3d22776f6fbf1442c449530220060c43d04e3a969133dc5ad8ea7efec19f85789da7d03ca7794568057582839301 ] [ 02729cae0c16009f44440f306b76fafb7a7d2503741a619c15b41ff927c1afd6b9 ]",
"sequence" : 4294967295
}
],
"lock_time" : "0",
"outputs" :
[
{
"address" : "1111111111111111111114oLvT2",
"attachment" :
{
"quantity" : 60000000,
"symbol" : "MVS.NAMINGRIGHT",
"type" : "asset-transfer"
},
"index" : 0,
"locked_height_range" : 0,
"script" : "return",
"value" : 0
},
{
"address" : "MLGuT4fp23SjyG2v5TW2PreQZTbXr7dyJe",
"attachment" :
{
"type" : "etp"
},
"index" : 1,
"locked_height_range" : 0,
"script" : "dup hash160 [ 87be522ed3375aaf991b71fe72db89006c803e29 ] equalverify checksig",
"value" : 1300000000
},
{
"address" : "MKXa7mtzNaGCEF9vM2sUmmTS93iDpHYd4m",
"attachment" :
{
"quantity" : 66600000000,
"symbol" : "MVS.NAMINGRIGHT",
"type" : "asset-transfer"
},
"index" : 2,
"locked_height_range" : 0,
"script" : "dup hash160 [ 7f8c4bf15a7c4183ea69d853626be85e9336e09e ] equalverify checksig",
"value" : 0
}
],
"version" : "2"
}
}
validatesymbol- Parameters (optional)
-cor[--cert]If specified name of cert type, then validate cert symbol. Default is not specified.
- Parameters (positional)
ACCOUNTNAMEAccount name.ACCOUNTAUTHAccount password/authorization.SYMBOLSymbol to be validated.params:[
"ACCOUNTNAME",
"ACCOUNTAUTH",
"SYMBOL"
]
Returns
status:available,exsited,no_permissionorforbidden.Example
// Request
curl -X POST --data '{
"id":7,
"jsonrpc":"2.0",
"method":"validatesymbol",
"params":[
"test",
"123456",
"ERC20.EE"
]
}' http://127.0.0.1:8820/rpc/v3
// Response
{
"id" : 7,
"jsonrpc" : "2.0",
"result" :
{
"asset_symbol" : "no_permission",
"did_symbol" : "available",
"mit_symbol" : "available"
}
}