Allow owner of a UIA to close markets and stop trading in a UIA

[dnotestein]

User Story
As a UIA owner, I want to be able to discontinue usage of my UIA, either temporarily or permanently. One example is that I'm transitioning from an OLD UIA to a new UIA with different characteristics and I want to force an exchange between the two assets. Another case is when the asset gets hacked and I want to claim it back from hacked accounts. In such cases, I can't claim back the asset if the asset is tied up in open exchange orders.

CORE TEAM TASK LIST

• Evaluate / Prioritize Feature Request
• Refine User Stories / Requirements
• Define Test Cases
• Design / Develop Solution
• Perform QA/Testing
• Update Documentation

[pmconrad]

Please specify more precisely what you mean with "discontinue usage". The two examples given are quite different.

[ryanRfox]

Thank you for providing the detailed User Story @dnotestein.

Please note: I unticked the items in the Core Team Task List within the Description. The intention there is for the Core team to tick them off as the Issue is developed. We also use the 2 Series of Labels to indicate the progression. Once we finish disucssing the Issue, this one will get prioritized on the Unassigned - Protocol Enhancements project board. Then we will tick the box on the Core Team Task List and change the Label to 2 Gathering Requirements...

[abitmore]

I guess some of the functionalities (if not all) described in OP are already implemented, check whitelist_markets and blacklist_markets in bitshares-core/libraries/chain/include/graphene/chain/protocol/asset_ops.hpp:

bitshares-core/libraries/chain/include/graphene/chain/protocol/asset_ops.hpp

Lines 68 to 71 in f1b19b1

	/** defines the assets that this asset may be traded against in the market */
	flat_set<asset_id_type> whitelist_markets;
	/** defines the assets that this asset may not be traded against in the market, must not overlap whitelist */
	flat_set<asset_id_type> blacklist_markets;

By the way, funds in hacked accounts can also be stuck in other objects e.g. vesting balances, collateral and etc, but not only limit orders.

[dnotestein]

@abitmore With the fields you mentioned above, how would you cancel existing orders? Does blacklisting cancel existing orders? Also, what state would you use to say this asset can't be traded in any market? I'm assuming you could use whitelist to say it could only trade against one market, but it's not obvious to me how you could then prevent it from trading in that market. Maybe whitelist it AND blacklist it against that one market?

[clockworkgr]

@dnotestein If I'm not mistaken, your conclusion is correct. Blacklist "trumps" whitelist so to speak so if you had it whitelisted for one market and then blacklist it, it will in fact disallow trading.

[abitmore]

bitshares-core/libraries/chain/market_evaluator.cpp

Lines 45 to 48 in f1b19b1

	if( _sell_asset->options.whitelist_markets.size() )
	FC_ASSERT( _sell_asset->options.whitelist_markets.find(_receive_asset->id) != _sell_asset->options.whitelist_markets.end() );
	if( _sell_asset->options.blacklist_markets.size() )
	FC_ASSERT( _sell_asset->options.blacklist_markets.find(_receive_asset->id) == _sell_asset->options.blacklist_markets.end() );