Navigating Tokemak (UX)

https://www.tokemak.xyz/ Landing Page

Before entering the Tokemak dapp, there's a landing page which gives users a brief overview of the protocol. To enter the dapp, click either one of the "LAUNCH APP" buttons found here:

Connecting Your Wallet

After launching the Tokemak dApp, you'll notice the usual Connect Wallet button in the top right, where you'll connect your Metamask, other preferred browser wallet, or hardware wallet:
Once your wallet is connected, you'll notice a number of informational items and options:
In the top left, you'll see the current Cycle number and a countdown until the next Cycle.
In the center, you'll notice the total (non-TOKE) TVL as well as the TOKE TVL. TOKE and non-TOKE TVL are separated to clearly indicate how much TVL there is from LPs vs. LDs.
Above that, there's a button to access your Dashboard to see your assets at a glance and claim any emitted TOKE.

Depositing and Withdrawing TOKE

The Deposit button will trigger a modal with two options: Deposit or Withdraw:
Depositing is pretty straight forward, but withdrawing assets requires a two-step process. You must first "REQUEST WITHDRAWAL," which will trigger a request to withdraw the indicated amount of assets from the system. They will not be fully available to withdraw until a Cycle ends. When a Cycle concludes and rolls over into the next, your assets will then be fully withdrawable and will require a second transaction to withdraw them to your wallet.

Depositing and Withdrawing non-TOKE Assets

To deposit non-TOKE assets (eg. ETH, USDC or other protocols native tokens) you will find a deposit button next to the tokens logo in the list of active reactors. Clicking the deposit button will open a module where you can specify the amount you would like to deposit before prompting you to approve and sign the transaction. The same rules that apply to TOKE withdrawals also apply to withdrawals of non-TOKE assets. Meaning you will first have to request withdrawal before completing the withdrawal once a new cycle has begun.

Directing Liquidity

Once you have deposited TOKE, the voting purse will populate with your total votes available to be allocated, your total votes submitted and your blended voting APR.
To begin directing liquidity (required for earning rewards on your deposited TOKE), you will need to allocate your votes to one or multiple Pair or Token Reactors from the list of active Reactors below your voting purse. As you allocate votes, you will see the 'votes remaining' figure update. Once you have allocated all of your votes, you can then submit them by clicking the 'submit votes' button and sign the transaction - this is a gasless (free) transaction.
You can rearrange your votes at any time clicking 'remove votes', reallocating before submitting votes again.

Directing Liquidity with Pro Mode

Pro Mode allows the user to direct liquidity to specific exchange venues. To find Pro Mode click the toggle button on the corresponding reactor you would like to allocate votes to.
Note: Pro Mode is only available for Token Reactors, not Pair Reactors.
Note: Pro Mode is only available for Token Reactors, not Pair Reactors.
Once inside the Pro Mode modal, you are able to allocate votes as usual by typing the number of votes into the input field for the exchange venue you have selected. Click the green submit votes button and sign the transaction to complete your action.

The Dashboard

When you access the Dashboard, you'll find your total balance in USD as well as assets locked in the system (on the left side, highlighted in green).
You'll also see earned and claimable "Rewards."
Underneath "Withdrawals," you'll find any assets that are currently available to be withdrawn. Remember, you must first "Request" to withdraw assets and they'll only become fully withdrawable at the end of the current Cycle. Once they're able to be withdrawn, they'll appear in this column and will no longer be earning TOKE rewards.
Copy link
Outline