Update mechanism.md

source/mechanism.md

@@ -37,13 +37,16 @@ Magnolia are inflationary, which should incentivise an early adoption and contin
 Magnolia are not needed to participate as a seller or bidder on the DutchX.
 
 ## Whitelist
-Whitelisted tokens are those that have the potential to generate Magnolia when traded in a whitelisted pair. The idea of whitelisted tokens is that no token can be added to the DutchX Protocol with the mere intention to create Magnolia and benefit from liquidity contributions.<br/>
-Whitelisting will - in future - be decided by the DAO.<br/>  
-This is the complete list of the [currently whitelisted tokens](https://github.com/gnosis/dx-contracts/blob/master/test/resources/approve-tokens/dxDAO_approved_tokens.js) (as per February 2019).<br/>  
-They were selected based on a legal assessment of token characteristics, which suggest that legislation of major jurisdictions regulating securities, financial instruments or similar and/or mandating customer due diligence procedures do not apply to them at this point in time for the purposes of the DutchX protocol.<br/>
+Whitelisted tokens are those that generate Magnolia when traded in a whitelisted pair. Not whitelisted tokens can still be traded (if added to the DutchX protocol), but will not generate Magnolia! The idea of whitelisted tokens is to maintain MGN's benefit: no token  should be traded with the sole intention to create Magnolia and benefit from liquidity contributions (and others' liquidity contribution to be hence reduced).<br/>
+Whitelisting will - in future - be decided by [the dxDAO](https://dutchx.readthedocs.io/en/latest/dxDAO.html).<br/>  
+During the Vote Staking Period, Gnosis will whitelist any tokens that are added to the protocol, which have a reasonable pricefeed AND are part of this [suggested whitelist](https://github.com/gnosis/dx-contracts/blob/master/test/resources/approve-tokens/dxDAO_approved_tokens.js).<br/>  
+This list was put together based on a legal assessment of token characteristics, which suggest that legislation of major jurisdictions regulating securities, financial instruments or similar and/or mandating customer due diligence procedures do not apply to them at this point in time for the purposes of the DutchX protocol.<br/>
 Regardless of being whitelisted, tokens will still first need to be added to the protocol before trading is possible.  
 
-Note that whitelisted tokens are not the same as **listed** and **traded** tokens. A whitelisted token has the potential to create Magnolia tokens (used for reduction of liquidity contribution) if traded in a whitelisted pair. Tokens can be listed for trading on the DutchX protocol, albeit not whitelisted (and hence trades do not generate Magnolia); on the flip side, tokens could be whitelisted, however not listed/traded on the DutchX protocol.
+Note that whitelisted tokens are not the same as **listed** and **traded** tokens. A whitelisted token has the potential to create Magnolia tokens (used for reduction of liquidity contribution) if traded in a whitelisted pair. Tokens can be listed for trading on the DutchX protocol, albeit not whitelisted (and hence trades do not generate Magnolia); on the flip side, tokens could in future also be whitelisted by the dxDAO, however not listed/traded on the DutchX protocol.
+
+- Check out [this API endpoint](https://dutchx.d.exchange/api/docs/#!/Markets_and_supported_tokens/getWhitelistedTokens) on actually whitelisted tokens.
+- Check out [this API endpoint](https://dutchx.d.exchange/api/docs/#!/Markets_and_supported_tokens/getTokens) on added tokens to the DutchX protocol.
 
 ## GNO
 There is no special use case for GNO. It is treated as any other ERC20 token.
@@ -53,8 +56,7 @@ In version DutchX 2.0, OWL is part of the DutchX Protocol:
 
 ### What is OWL?
 - OWL is an ERC20 token. Check it out on [Etherscan](https://etherscan.io/token/0x1a5f9352af8af974bfc03399e3767df6370d82e4).
-- It is a token that given GNO its utility and is creating by GNO holders locking down GNO (for a period of time).
-- There has been one initial instance of creating OWL, with more to follow. Read this [communication](https://blog.gnosis.pm/generate-your-first-owl-using-gno-2205eb098f8) about it.
+- Read this [blog post](https://blog.gnosis.pm/owl-token-use-cases-6094027ecb37) on all the various use cases.
 
 ### What is OWL used for on the DutchX?
 - Useres *may* use OWL to settle half of their liquidity contribution. The rest is settled in the token they are taking part in.
@@ -74,8 +76,8 @@ In version DutchX 2.0, OWL is part of the DutchX Protocol:
 - You might be able to acquire it for less than 1USD worth and would hence reduce your liquidity contribution!
 
 ### How does one get OWL?
-- There is no generation ongoing. Check [this website](https://owl.gnosis.io/) to see prior generations and claim back your GNO if you haven't done so already.
-- Stay tuned for further generation announcement on public channels. For this, one needs GNO.
+- OWL is generated by locking GNO (of course you get the GNO back) during special generation times. 
+- Check [this website](https://owl.gnosis.io/) to see if there is an ongoing generation or to see past generations and claim back your GNO if you haven't done so already.
 - OWL may be traded on secondary markets or OTC.
 
 ## Auctioneer Powers