bitshares.asset module

class bitshares.asset.Asset(*args, **kwargs)[source]

Bases: bitshares.instance.BlockchainInstance, bitshares.asset.Asset

Deals with Assets of the network.

Parameters:
  • Asset (str) – Symbol name or object id of an asset
  • lazy (bool) – Lazy loading
  • full (bool) – Also obtain bitasset-data and dynamic asset data
  • blockchain_instance (bitshares.bitshares.BitShares) – BitShares instance
Returns:

All data of an asset

Return type:

dict

Note

This class comes with its own caching function to reduce the load on the API server. Instances of this class can be refreshed with Asset.refresh().

add_authorities(type, authorities=[])[source]

Add authorities to an assets white/black list

Parameters:
  • type (str) – blacklist or whitelist
  • authorities (list) – List of authorities (Accounts)
add_markets(type, authorities=[], force_enable=True)[source]

Add markets to an assets white/black list

Parameters:
  • type (str) – blacklist or whitelist
  • markets (list) – List of markets (assets)
  • force_enable (bool) – Force enable white_list flag
bitshares

Alias for the specific blockchain

blockchain
blockchain_instance_class

alias of bitshares.instance.BlockchainInstance

cache(key=None)
calls
chain

Short form for blockchain (for the lazy)

clear() → None. Remove all items from D.
static clear_cache()
copy() → a shallow copy of D
define_classes()[source]

Needs to define instance variables that provide classes

disableflag(flag)[source]

Enable a certain flag.

Parameters:flag (str) – Flag name
enableflag(flag)[source]

Enable a certain flag.

Parameters:flag (str) – Flag name
ensure_full()[source]
feed
feeds
flags

List the permissions that are currently used (flags)

fromkeys()

Returns a new dict with keys from iterable and values equal to value.

get(k[, d]) → D[k] if k in D, else d. d defaults to None.
get_call_orders(limit=100)[source]
get_instance_class()

Should return the Chain instance class, e.g. bitshares.BitShares

get_settle_orders(limit=100)[source]
getcache(id)
halt()[source]

Halt this asset from being moved or traded

classmethod inject(cls)
is_bitasset

Is the asset a market pegged asset?

is_fully_loaded

Is this instance fully loaded / e.g. all data available?

iscached(id)
items() → a set-like object providing a view on D's items
keys() → a set-like object providing a view on D's keys
market_fee_percent
max_market_fee
static objectid_valid(i)
permissions

List the permissions for this asset that the issuer can obtain

pop(k[, d]) → v, remove specified key and return the corresponding value.

If key is not found, d is returned if given, otherwise KeyError is raised

popitem() → (k, v), remove and return some (key, value) pair as a

2-tuple; but raise KeyError if D is empty.

precision
refresh()[source]

Refresh the data from the API server

release(whitelist_authorities=[], blacklist_authorities=[], whitelist_markets=[], blacklist_markets=[])[source]

Release this asset and allow unrestricted transfer, trading, etc.

Parameters:
  • whitelist_authorities (list) – List of accounts that serve as whitelist authorities
  • blacklist_authorities (list) – List of accounts that serve as blacklist authorities
  • whitelist_markets (list) – List of assets to allow trading with
  • blacklist_markets (list) – List of assets to prevent trading with
remove_authorities(type, authorities=[])[source]

Remove authorities from an assets white/black list

Parameters:
  • type (str) – blacklist or whitelist
  • authorities (list) – List of authorities (Accounts)
remove_markets(type, authorities=[])[source]

Remove markets from an assets white/black list

Parameters:
  • type (str) – blacklist or whitelist
  • markets (list) – List of markets (assets)
seize(from_account, to_account, amount)[source]

Seize amount from an account and send to another

… note:: This requires the override_authority to be
set for this asset!
Parameters:
set_market_fee(percentage_fee, max_market_fee)[source]

Set trading percentage fee

Parameters:
static set_shared_blockchain_instance(instance)

This method allows us to override default instance for all users of SharedInstance.instance.

Parameters:instance (chaininstance) – Chain instance
set_shared_config(config)

This allows to set a config that will be used when calling shared_blockchain_instance and allows to define the configuration without requiring to actually create an instance

setdefault(k[, d]) → D.get(k,d), also set D[k]=d if k not in D
setoptions(flags)[source]

Enable a certain flag.

Flags:

  • charge_market_fee
  • white_list
  • override_authority
  • transfer_restricted
  • disable_force_settle
  • global_settle
  • disable_confidential
  • witness_fed_asset
  • committee_fed_asset
Parameters:flag (dict) – dictionary of flags and boolean
settlements
shared_blockchain_instance()

This method will initialize SharedInstance.instance and return it. The purpose of this method is to have offer single default instance that can be reused by multiple classes.

space_id = 1
symbol
test_valid_objectid(i)
testid(id)
type_id = None
type_ids = []
update([E, ]**F) → None. Update D from dict/iterable E and F.

If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]

update_cer(cer, account=None, **kwargs)[source]

Update the Core Exchange Rate (CER) of an asset

update_feed_producers(producers)[source]

Update bitasset feed producers

Parameters:producers (list) – List of accounts that are allowed to produce a feed
values() → an object providing a view on D's values