Assets Class Usage¶
Library to work with RecordsKeeper assets.
You can create new assets, send assets and list all assets by using Assets class. You just have to pass the required parameters to invoke the pre-defined functions of Assets class.
Import these python libraries first to get started with the functionality.
import requests import json from requests.auth import HTTPBasicAuth import yaml import sys import binascii
Entry point for accessing Address class resources.
- URL: Url to connect to the chain ([RPC Host]:[RPC Port])
- Chain-name: chain name
with open("config.yaml", 'r') as ymlfile: cfg = yaml.load(ymlfile)
network = cfg['network'] #network variable to store the network that you want to access
url = network['url'] chain = network['chain']
Importing values from config file.
- User name: The rpc user is used to call the APIs.
- Password: The rpc password is used to authenticate the APIs.
user = network['rkuser'] password = network['passwd']
Now we have node authentication credentials.
Assets class is used to call asset related functions like create assets, send assets and list assets functions which are used on the RecordsKeeeper Blockchain.
1. Create Assets on the RecordsKeeper Blockchain
createAsset() function is used to create or issue an asset.
createAsset(address, asset_name, asset_qty) txid = createAsset(address, asset_name, asset_qty) #createAsset() function call print txid # prints transaction id of the issued asset
It will return the transaction id of the issued asset.
2. Send Assets to a particular address on the RecordsKeeper Blockchain
You have to pass these three arguments to the sendAsset function call:
- address: address which will send the asset
- asset_name: name of the asset
- qty: quantity of asset to be sent
sendAsset() function is used to send an asset.
sendAsset(address, assetname, qty) txid = sendAsset(address, assetname, qty) #sendAsset() function call print txid #prints transaction id of the sent asset
It will return the transaction id of the sent asset.
3. List all assets on the RecordsKeeper Blockchain
retrieveAssets() function is used to list all the assets, no of the assets, issued quantity of the assets and issued transaction id of all the assets on the RecordsKeeper Blockchain.
retrieveAssets() result = retrieveAssets() #retrieveAssets() function call print result['name'] #prints name of all the assets print result['asset count'] #prints total asset count print result['id'] #prints assets issued quantity print result['qty'] #prints assets issued transaction id
It will return all the assets, the count of the assets, issued quantity of the assets and issued transaction id of the assets on the RecordsKeeper Blockchain.