# EYWA Locker Interface
## EYWA Locker Interface Description
**EYWA Locker** is a smart contract where holders lock their EYWA tokens, EYWA token safes, EYWA NFTs with EYWA tokens, and project safes for various durations. The purpose of such locking is to obtain project votes - veEYWA voting power. A user’s voting power depends on the duration for which their tokens are locked. The maximum lock period is 3 years (156 weeks), which provides the highest ratio: 1 locked token = 1 vote. More details can be found [here](https://docs.eywa.fi/eywa-token/eywa-dao/obtaining-veeywa-and-calculating-the-boost#the-formula-for-the-linear-relationship-between-lock-time-and-voting-power-boost-is).
To start using the **CrossCurve** application, navigate to the **EYWA Locker** page under the **DAO** section. Click «**Connect wallet**», select a suitable wallet from the list, and confirm the connection, ensuring you are on the official page:
On the **EYWA Locker** page, the current EYWA DAO statistics are displayed:
* **Total locked EYWA** - the total number of locked EYWA tokens
* **Total supply veEYWA** - the total issued veEYWA tokens
For detailed mechanics on how voting power is calculated when locking EYWA tokens, click **Read docs**.
To create a new EYWA token lock, click **Lock Tokens**
The page **Create token lock** contains the following elements:
* **Now you have** - the number of created locks and the total veEYWA amount in these locks.
* **Amount to lock** - the number of EYWA tokens from your wallet balance for the new lock, increasing the total veEYWA amount.
* **Select your vested EYWA to receive veEYWA** - an option to select vesting safes for the new lock, adding EYWA tokens from vesting safes to increase the total veEYWA amount.
* **Select your EYWA NFTs and boost voting power** - an option to select EYWA NFTs for the new lock, adding EYWA tokens from the NFT container and increasing the total veEYWA amount. It also grants a voting power boost based on the rarity of the EYWA NFT.
* **Lock time** - selection of the locking duration.
The **Create Token Lock** application allows you to add EYWA tokens from your wallet, vesting safes, and the EYWA NFT container either separately or simultaneously**\***.
You can specify the number of EYWA tokens from your wallet balance in the **Amount to lock** field, select vesting safes in the **Select your vested EYWA to receive veEYWA** menu, and select EYWA tokens from NFT containers in the **Select your EYWA NFTs and boost voting power** menu. After selecting the desired amount of EYWA tokens, vesting safes, and EYWA NFT containers, the application calculates the total locked EYWA tokens in the **You lock** field and the veEYWA voting power based on the selected lock duration in the **You’ll get** field.
{% hint style="info" %}
***\**** ***Note:** Creating a lock requires signing multiple transactions, as indicated on the **Create Token Lock**. For example: if you selected n EYWA tokens from your wallet balance, three vesting safes, and two EYWA NFTs, the total number of transactions to sign will be 5.*
{% endhint %}
### 1. Creating a lock with EYWA Tokens from your wallet
To create a lock with EYWA tokens from your wallet balance, enter the number of locked tokens in the **Amount to lock** field and select the lock duration using the slider in the **Lock time** field. The possible lock duration ranges from 0 to 156 weeks.
**The maximum lock duration is 3 years (156 weeks), ensuring the highest ratio: 1 locked token = 1 vote. The minimum lock duration is a few days (until the end of the current epoch), for example, 2 days provide 2/1092 votes.**
Example: 156 locked tokens for a week provide 1 vote. More details can be found in the [lock formula section](https://docs.eywa.fi/eywa-token/eywa-dao/obtaining-veeywa-and-calculating-the-boost#the-formula-for-the-linear-relationship-between-lock-time-and-voting-power-boost-is), but the simple explanation is:
* 1 EYWA, locked for 3 years = 1 veEYWA
* 1 EYWA, locked for 2 years = 0.66(6) veEYWA
* 1 EYWA, locked for 1.5 years = 0.5 veEYWA
* 1 EYWA, locked for 1 year = 0.33(3) veEYWA
The longer you lock your EYWA, the greater your Voting Power and the bigger the boost you can achieve. Voting power is expressed in the number of veEYWA.
After ensuring the number of locked tokens and the lock duration, the amount of voting power in veEYWA tokens obtained will be displayed in the **You’ll get** field. Below, the current EYWA DAO statistics will be displayed:
* **Total locked EYWA** - the total number of locked EYWA tokens in DAO
* **Total supply veEYWA** - the total issuance of veEYWA tokens
* **Average EYWA NFT boost** - the average boost multiplier obtained for locking an EYWA NFT, depending on the rarity of the NFT being locked (more details [here](https://docs.eywa.fi/eywa-token/eywa-dao/obtaining-veeywa-and-calculating-the-boost#increasing-veeywa-using-eywa-nfts))
To create a lock, click **Create Token lock** and sign the transaction in your wallet. If you do not have EYWA tokens in your wallet, use the direct **Buy token** link for purchase.
After successful on-chain conformation of the transaction, detailed information about the existing locks will be displayed on the [**EYWA Locker**](https://app.crosscurve.fi/locker) page:
### 2. Selecting vesting safes for a new lock
To add EYWA tokens from vesting safes to the newly created lock, select safes by clicking **Select your vested EYWA to receive veEYWA** in the **Create Token Lock** menu. The possible [lock duration](https://docs.crosscurve.fi/user-documentation/dao/eywa-locker-interface#maximum-lock-duration) ranges from 0 to 156 weeks.
In the modal window, you will see a list of all available **Vested EYWA** safes and information about the total number of safes **Total in wallet**, as well as the sum of all EYWA tokens in them.
Select a safe (or a group of safes of the same type) to create a lock by clicking the checkbox to the left of the safe. **EYWA Locker** will display the number of selected safes and EYWA tokens in them in the **You selected** window. A maximum of 100 safes can be selected per transaction when creating one lock**\***. To continue, click **Lock selected**.
{% hint style="info" %} **\*** *Adding any type of vesting safes to a lock is only possible when creating a new lock. For an already created lock, it is possible to add vesting safes* [*attached to an EYWA NFT*](https://docs.crosscurve.fi/user-documentation/eywa-nft/eywa-nft-manager-interface#attaching-tokens-to-an-nft-safe)*.*
{% endhint %}
Returning to the **Create Token Lock** menu, the number of selected safes and EYWA tokens in them will be displayed in the **Selecting** field.
To add Vested EYWA safes to the lock, select the lock duration using the slider in the **Lock time** field. The possible [lock duration](https://docs.crosscurve.fi/user-documentation/dao/eywa-locker-interface#maximum-lock-duration) ranges from 0 to 156 weeks. After selecting the lock duration, the **You’ll get** field will display the total amount of voting power received in veEYWA tokens. If you need to create a lock only from vesting safes, click **Create Token lock** and sign the transaction in your wallet.
### 3. Boosting voting power by locking EYWA NFT.
To add EYWA tokens from EYWA NFT containers to the newly created lock, click **Select your EYWA NFTs and boost voting power** in the **Create Token Lock** menu. The possible [lock duration](https://docs.crosscurve.fi/user-documentation/dao/eywa-locker-interface#maximum-lock-duration) ranges from 0 to 156 weeks.
In the modal window, you will see a list of all available EYWA NFTs in the connected wallet, sorted by their rarity, along with detailed information:
* **EYWA tokens** - the number of EYWA tokens attached to the NFT container (more details [here](https://docs.eywa.fi/eywa-token/eywa-nft-collection#container))
* **Capacity** - the capacity of the NFT container (more details [here](https://docs.eywa.fi/eywa-token/eywa-nft-collection#container))
* **veEYWA Boosted** - NFT boost (more details [here](https://docs.eywa.fi/eywa-token/eywa-dao/overview-of-eywa-dao#nft-boosts))
If there are no EYWA NFTs in the connected wallet, use the quick buy link in the **Aurora (**[**tofunft**](https://tofunft.com/collection/eywa-arbi/items)**)** or **Arbitrum (**[**opensea**](https://opensea.io/collection/eywaprotocol)**)**
Select an NFT**\*** (or a group of NFTs of the same rarity) to create a lock by clicking the checkbox to the left of the NFT. **EYWA Locker** will display the number of selected NFTs and EYWA tokens in containers in the **Selected** field. A maximum of 100 NFTs can be selected per transaction when creating one lock. To continue, click **Lock EYWA NFTs**.
{% hint style="warning" %} **\*** **Attention!** In some cases, EYWA NFT may be unavailable for adding to the lock:
{% endhint %}
* If you have detached EYWA tokens from the EYWA NFT container, that EYWA NFT will have a 4-hour freeze period. Only after the timer has expired can you add that NFT to the lock.
* If the EYWA NFT container has EYWA tokens without vesting attached, you must [detach ](https://docs.crosscurve.fi/user-documentation/eywa-nft/eywa-nft-manager-interface#detaching-tokens-from-the-nft-container)them in **EYWA NFT Manager** (use quick [link](https://app.crosscurve.fi/nft-manager)) so that this NFT becomes available for adding to the lock. After detaching EYWA tokens, this NFT will be frozen for 4 hours (frontrun protection).
Returning to the **Create Token Lock** menu, the line **Selecting** will display the number of selected NFTs and the number of EYWA tokens in the containers, and in the line **Average EYWA NFT boost**, the average boost for vote will be calculated depending on the rarity of the selected NFTs.
To create the EYWA NFTs lock, select the lock duration using the slider in the **Lock time** field. The possible [lock duration](https://docs.crosscurve.fi/user-documentation/dao/eywa-locker-interface#maximum-lock-duration) ranges from 0 to 156 weeks. After selecting the lock duration, the **You’ll get** field will display the amount of voting power boost obtained (more details [here](https://docs.eywa.fi/eywa-token/eywa-dao/obtaining-veeywa-and-calculating-the-boost#increasing-veeywa-using-eywa-nfts)). If you need to create a lock only from EYWA NFTs, click **Create Token lock** and sign the transaction in your wallet.
If the **Amount to Lock** field is set to 0 EYWA and no EYWA in vesting is selected, and you have selected an EYWA NFT with no EYWA tokens attached, a message will appear: **Unselect NFTs with 0 EYWA or add EYWA tokens**. In this case, to create the lock, you must fulfill one of the following conditions:
* Unselect the NFT with 0 EYWA tokens in the selection menu **Select your EYWA NFTs and boost voting power**
* Add EYWA tokens from your wallet balance in the **Amount to lock**, or add EYWA tokens with vesting in the selection menu **Select your vested EYWA to receive veEYWA**.
## EYWA Locker
During the lock period, you can manage accrued rewards and add EYWA tokens and EYWA NFTs to the lock.
To start working using the **CrossCurve** application, go to the **EYWA Locker** page in the **DAO** section. Click «**Connect wallet**», select the appropriate wallet from the list, and confirm the connection, ensuring you are on the official page:
On the **EYWA Locker** page, detailed information about existing locks will be displayed:
* **id** - D number of EYWA DAO NFT (ID number assigned after creating a new lock through Create lock)
* **Locked EYWA** - the number of EYWA tokens in the EYWA DAO NFT safe
* **NFTs** - the number of EYWA NFTs inside the lock
* **Unlock time** - the next lock expiration date
* **veEYWA** - the voting power amount in veEYWA tokens for the selected lock
* **Staking APY** - the APY yield for locked EYWA tokens (more details on staking APY [here](https://docs.eywa.fi/eywa-token/eywa-dao/staking#staking-apy-table-with-10-million-locked-tokens-increments))
* **Transferable** - the status of the selected NFT’s transferability**\***
* **Staking rewards** - the amount of rewards received in EYWA tokens for the past lock period
**\*** *There are two states of lock transferability:*
1. The label **Available**, means that this EYWA DAO NFT (lock) is free for transfer, sale, and unlocking if the lock period has expired.
2. The  snowflake icon means that the transfer is frozen, and this EYWA DAO NFT cannot be moved, sold, or unlocked. Freezing can occur for two reasons:
3. 1. EYWA DAO NFT is currently or was previously involved in voting during an epoch. In this case, to remove the frozen status, you need to cancel the vote by clicking **Unfreeze** 
2. If an EYWA NFT was detached from an EYWA DAO NFT, a timer will be displayed showing the time remaining until the freeze is lifted, after which the EYWA DAO NFT can be moved. This is one of the front-running protection mechanisms. 
The **Available** status means that the EYWA DAO NFT can be transferred, sold, or unlocked (if the lock period has ended).
The  status with the **Unfreeze** link next to it means that the transfer is frozen - this lock is currently participating in voting for the current or previous epoch. To transfer, you must cancel the vote. To cancel the vote, click **Unfreeze** and confirm the vote cancellation in the modal window.
To confirm vote cancellation in the current/previous voting rounds, click **Reset votes** and sign the transaction in your wallet.
After confirming the transaction on-chain, the EYWA DAO NFT will become available for transfer.
The  status with the **Timer** icon means that the EYWA DAO NFT is unavailable for transfer after detaching the EYWA NFT. You must wait 4 hours (front-running protection) before the EYWA DAO NFT can be moved.
Once the timer expires, the transferability status will change to **Available**.
1. To add accrued **Staking rewards** to the lock, click **Compound** and sign the transaction in your wallet. The EYWA Staking rewards tokens will be added to the lock for which they were received, for the same duration as the existing lock.
1. To add EYWA tokens to an existing lock and extend it, click **Manage**.
Information about the selected lock will be displayed:
* **Unlocking on** - the lock expiration date
* **Already locked** - the number of locked EYWA tokens and vesting safes
* **Owned** - voting power in veEYWA tokens
To view detailed information about existing vesting safes, click **View**
In the **Vested EYWA** modal window, detailed information about your vesting safes will be displayed:
* The round name when the safe was received and the number of identical vesting safes (more details [here](https://docs.eywa.fi/eywa-token/tokenomics-eywa-crosscurve))
* **All tokens** - the number of EYWA tokens in the vesting safe
* **Unlocked EYWA** - the number of EYWA tokens received from the vesting safe
* **Vesting ends in** - the vesting expiration time
* **Total in lock** - the total number of vesting safes in the lock and the total amount if EYWA tokens in them.
2.1 To add EYWA tokens to the lock, enter the amount in the **Amount to compound** field.
To update the lock duration, select **Update time lock** and set a new lock duration using the slider.
After entering the amount and selecting the lock duration, the application will display the total number of EYWA tokens ready for locking in the **You lock** field and the voting power (veEYWA) obtained after the changes in the **You’ll get** field. To update the lock, click **Update Locker** and confirm the transaction in your wallet.
2.2 To add EYWA tokens from EYWA NFT containers to the lock and receive a voting power boost, click **Select your EYWA NFTs and boost voting power** in the **Manage Locke**r menu.
In the modal window, you will see a list of all EYWA NFTs available in your connected wallet, sorted by rarity, along with detailed information. If there are no EYWA NFTs in your connected wallet, use the quick purchase link for **Aurora (**[**tofunft**](https://tofunft.com/collection/eywa-arbi/items)**)** or **Arbitrum (**[**opensea**](https://opensea.io/collection/eywaprotocol)**)**
Select an NFT (or a group of NFTs of the same rarity) to add to the lock by clicking the checkbox next to the NFT. **EYWA Locker** will display the number of selected NFTs and EYWA tokens in the containers in the **Selected** field. A maximum of 100 NFTs can be selected per transaction when adding NFTs to a lock. To continue, click **Lock EYWA NFTs**
Returning to the **Manage Locker** menu, the **Selecting** field will display the number of selected NFTs and EYWA tokens in the containers. To update the lock duration, select **Update time lock** and set a new lock duration using the slider.
After selecting the lock duration, the application will display the total number of EYWA tokens ready for locking in the **You lock** field, the voting power (veEYWA) obtained after the changes in the **You’ll get** field, and the average voting power boost in the **Average EYWA NFT boost**. To update the lock, click **Update Locker** and confirm the transaction in your wallet.
The EYWA NFT in locks window displays detailed information about EYWA NFTs locked in the DAO:
* **Transferable** - lock transferability status (more details here)
* **Locked EYWA NFTs** - the number of EYWA NFTs locked in the DAO
* **Unboosted tokens** - the number of EYWA tokens that were not counted in the boost calculation due to container capacity limitations.
{% hint style="info" %}
***For example**, if you have 1,000,000 EYWA tokens and one Legendary EYWA NFT with a container capacity of 250,000 tokens, then Unboosted tokens = 750,000, since tokens exceeding the container size are not included in the boost calculation*
{% endhint %}
* **Average boost** - the average boost value obtained for the EYWA NFT lock (more details [here](https://docs.eywa.fi/eywa-token/eywa-dao/obtaining-veeywa-and-calculating-the-boost#increasing-veeywa-using-eywa-nfts))
To transfer an NFT from the lock, click **Withdraw**
In the modal window, you will see a list of EYWA NFTs locked in the DAO, sorted by rarity and detailed information:
* **Capacity** - NFT container capacity (more details here)
* **veEYWA Boosted** - NFT boost (more details here)
If there are no EYWA NFTs in your connected wallet, use the quick purchase link for **Aurora (**[**tofunft**](https://tofunft.com/collection/eywa-arbi/items)**)** or **Arbitrum (**[**opensea**](https://opensea.io/collection/eywaprotocol)**)**
Select an NFT**\*** (or a group of NFTs of the same rarity) to unlock by clicking the checkbox next to an NFT. A maximum of 100 NFTs can be unlocked per transaction.
{% hint style="info" %} **\*** If the EYWA DAO NFT you selected for unlocking participated in voting, it is in Freeze status, and you need to cancel votes by clicking **Unfreeze to withdraw**
{% endhint %}
To confirm vote cancellation in the current/previous voting rounds, click **Reset votes** and sign the transaction in your wallet.
After confirming the transaction on-chain, the EYWA NFT will become available for unlocking.
To continue unlocking EYWA NFTs, click **Withdraw EYWA NFTs** and confirm the transaction in your wallet.
1. Once the lock period ends, the **Unlock** button will become available. To unlock the EYWA DAO NFT and manage safes, click **Unlock**.
To confirm unlocking**\*** click **OK** and sign the transaction in your wallet.
{% hint style="info" %}
***\*** Unlocking after the lock period allows managing vesting safes in* [***EYWA Locker***](https://app.crosscurve.fi/locker)*.*
{% endhint %}
3.1. If you want to unlock the EYWA DAO NFT that is/was involved in voting, you need to cancel the votes. To cancel the votes, click **Unfreeze** and confirm the vote cancellation in the modal window.
Alternatively, clicking **Unlock** will bring up a modal window displaying the lock contents and a prompt to unfreeze the EYWA DAO NFT to access its contents.
To unfreeze the selected EYWA DAO NFT, click **Unfreeze to unlock**. The **You’ll get** field will show the number of unlocked EYWA tokens, vesting safes, and NFTs.
To confirm the vote cancellation in the current/previous voting rounds, click **Reset votes** and sign the transaction in your wallet.
After confirming the transaction on-chain, the EYWA DAO NFT will become available for unlocking.
3.2. If you want to unlock an EYWA DAO NFT that has a timer set after detaching an NFT, you must wait 4 hours (front-running protection) before it can be moved. Click **Unlock** to initiate the process.
Once the timer expires, the EYWA DAO NFT will become available for transfer.
