Lossless Vault Protection User Guide
This user guide is directed to projects that already have a token and want to add lossless Vault Protection: Whitelist or Single Limit. Note that EITHER Single Limit OR Whitelist can be enabled on a given wallet (address, vault). If an address has a Single Limit enabled and you impose Whitelist on the same address, the Single Limit will be removed (and vice versa).
1. Ask lossless to approve your token.
2. Think which addresses (vaults) you would like to protect, send a list of these addresses to the lossless team for verification.
3. Keep your token admin wallet at hand, go to https://vault.lossless.cash/protection-admin and choose a protection admin address such that you do not have to do everything from token admin (good opsec practice!). Put in the desired address, transact with your wallet. Note that after the transaction goes through, your protection admin address will be displayed on the Protection Admin page. After this, switch the active wallet to the protection admin address
4. Go to https://vault.lossless.cash/protected-addresses. Initially, no protected addresses are shown, even though you have sent a list of addresses (vaults) to lossless for verification. As a protection admin, you may enable protection on these addresses. After you do, they will show up in the list.
5. Click “Add new address”. Select either Whitelist or Single Limit.
6. Let us discuss Whitelist first. If you selected Whitelist and clicked “Next”, you are presented with a list of addresses window. This window accepts addresses one address per line either by direct input (browser) or by uploading a file. After entering the addresses, click “Next”.
Then you will be presented with a whitelist confirmation dialog. Clicking “confirm” will fire a transaction.
After this transaction goes through, your address (vault) is protected. From now on, transactions from the protected address to non-whitelisted addresses will fail; only transactions moving tokens to whitelisted addresses will succeed.
7. You may review and edit the whitelist by clicking the protected address at https://vault.lossless.cash/protected-addresses. There, you may remove the protection completely by clicking “Remove protection”. You may also remove addresses from the whitelist either one-by-one by clicking the dustbin button. Alternatively, you can pick and choose which addresses to remove by clicking tickboxes next to addresses and then clicking “Remove Selected Addresses”. You can also add more addresses to the whitelist on this page.
8. Switching gears to Single Limit now: time-based limits on a wallet (vault) can be added by starting at https://vault.lossless.cash/protected-addresses, clicking “Add new address”, selecting “Single limit”, and clicking “Next”. You will then have to enter the address of the wallet that you’d like to protect and click “Next”. The subsequent screen asks for several parameters, all of them are required:
- Start time — when the limit goes into effect; this time cannot be in the future; it can be chosen such that the period matches, eg, the midday.
- Limit period — over which period will the limit be enforced.
- Amount of tokens — if this amount over the Limit period is reached, no further token transfers from that address is allowed.
Click “Save” to proceed; a confirmation dialog pops up, click “Confirm” and then go ahead with the metamask transaction.
9. If you have an address of “Single Limit” type, going to https://vault.lossless.cash/protected-addresses and clicking on that address allows you to view how many tokens can still be transferred in a given period (Amount Left in Period) out of the total (Amount Allowed per Period); the same information is also given in a piechart. Furthermore, this page also allows editing the single limit protection properties, as well as removing the protection. If a Single Limit has been exceeded inadvertently with no malicious actions, it can be manually reset by using the Reset Period Now button.