>>> create_asset <issuer> <symbol> <precision> <options> {} false
note: A
falseat the end allows to check and verify the constructed transaction and does not broadcast it. The empty{}could be used to construct a Market Pegged Assets and is subject of another tutorial.
The precision can any positive integer starting from 0. As options we pass a JSON object that can contain these settings:
{
"max_supply" : 10000, # Integer in satoshi! (100 for precision 1 and max 10)
"market_fee_percent" : 3,
"max_market_fee" : 1000, # in satoshi
"issuer_permissions" : <permissions>,
"flags" : <flags>,
"core_exchange_rate" : {
"base": {
"amount": 21, # denominator
"asset_id": "1.3.0" # BTS
},
"quote": {
"amount": 76399, # numerator
"asset_id": "1.3.1" # !THIS! asset
}
},
"whitelist_authorities" : [],
"blacklist_authorities" : [],
"whitelist_markets" : [],
"blacklist_markets" : [],
"description" : "My fancy description"
}
The flags are construction as an JSON object containing these flags/permissions:
{
"charge_market_fee" : true,
"white_list" : true,
"override_authority" : true,
"transfer_restricted" : true,
"disable_force_settle" : true,
"global_settle" : true,
"disable_confidential" : true,
"witness_fed_asset" : true,
"committee_fed_asset" : true
}
Permissions and flags are modelled as sum of binary flags
After creation of the asset, no shares will be in existence until they are issued by the issuer:
issue_asset <account> <amount> <symbol> <memo> True
from grapheneapi import GrapheneClient
import json
perm = {}
perm["charge_market_fee"] = 0x01
perm["white_list"] = 0x02
perm["override_authority"] = 0x04
perm["transfer_restricted"] = 0x08
perm["disable_force_settle"] = 0x10
perm["global_settle"] = 0x20
perm["disable_confidential"] = 0x40
perm["witness_fed_asset"] = 0x80
perm["committee_fed_asset"] = 0x100
class Config():
wallet_host = "localhost"
wallet_port = 8092
wallet_user = ""
wallet_password = ""
if __name__ == '__main__':
graphene = GrapheneClient(Config)
permissions = {"charge_market_fee" : True,
"white_list" : True,
"override_authority" : True,
"transfer_restricted" : True,
"disable_force_settle" : True,
"global_settle" : True,
"disable_confidential" : True,
"witness_fed_asset" : True,
"committee_fed_asset" : True,
}
flags = {"charge_market_fee" : False,
"white_list" : False,
"override_authority" : False,
"transfer_restricted" : False,
"disable_force_settle" : False,
"global_settle" : False,
"disable_confidential" : False,
"witness_fed_asset" : False,
"committee_fed_asset" : False,
}
permissions_int = 0
for p in permissions :
if permissions[p]:
permissions_int += perm[p]
flags_int = 0
for p in permissions :
if flags[p]:
flags_int += perm[p]
options = {"max_supply" : 10000,
"market_fee_percent" : 0,
"max_market_fee" : 0,
"issuer_permissions" : permissions_int,
"flags" : flags_int,
"core_exchange_rate" : {
"base": {
"amount": 10,
"asset_id": "1.3.0"},
"quote": {
"amount": 10,
"asset_id": "1.3.1"}},
"whitelist_authorities" : [],
"blacklist_authorities" : [],
"whitelist_markets" : [],
"blacklist_markets" : [],
"description" : "My fancy description"
}
tx = graphene.rpc.create_asset("nathan", "SYMBOL", 3, options, {}, True)
print(json.dumps(tx, indent=4))
A UIA can be modified by the issuer after creation. For this, a separated call update_asset has been created.
What can and cannot be changed
Except for
- Symbol
- Precision,
every parameter, option or setting can be updates.
Note: Once a persmission is removed, it can not be re-enabled again!
from grapheneapi import GrapheneClient
import json
perm = {}
perm["charge_market_fee"] = 0x01
perm["white_list"] = 0x02
perm["override_authority"] = 0x04
perm["transfer_restricted"] = 0x08
perm["disable_force_settle"] = 0x10
perm["global_settle"] = 0x20
perm["disable_confidential"] = 0x40
perm["witness_fed_asset"] = 0x80
perm["committee_fed_asset"] = 0x100
class Config():
wallet_host = "localhost"
wallet_port = 8092
wallet_user = ""
wallet_password = ""
if __name__ == '__main__':
graphene = GrapheneClient(Config)
permissions = {"charge_market_fee" : True,
"white_list" : True,
"override_authority" : True,
"transfer_restricted" : True,
"disable_force_settle" : True,
"global_settle" : True,
"disable_confidential" : True,
"witness_fed_asset" : True,
"committee_fed_asset" : True,
}
flags = {"charge_market_fee" : True,
"white_list" : True,
"override_authority" : True,
"transfer_restricted" : True,
"disable_force_settle" : True,
"global_settle" : False,
"disable_confidential" : True,
"witness_fed_asset" : False,
"committee_fed_asset" : True,
}
permissions_int = 0
for p in permissions :
if permissions[p]:
permissions_int += perm[p]
flags_int = 0
for p in permissions :
if flags[p]:
flags_int += perm[p]
options = {"max_supply" : 100000000000,
"market_fee_percent" : 0,
"max_market_fee" : 0,
"issuer_permissions" : permissions_int,
"flags" : flags_int,
"core_exchange_rate" : {
"base": {
"amount": 10,
"asset_id": "1.3.0"},
"quote": {
"amount": 10,
"asset_id": "1.3.1"}},
"whitelist_authorities" : [],
"blacklist_authorities" : [],
"whitelist_markets" : [],
"blacklist_markets" : [],
"description" : "My fancy description 2"
}
tx = graphene.rpc.update_asset("SYMBOL", None, options, True)
print(json.dumps(tx, indent=4))