.. _retire-label:

===============
Retiring Tokens
===============

Once you have connected your wallet and have enough CPCO2 tokens
(see :ref:`buy-label`), you can now retire your CPCO2 tokens.
Each CPCO2 token represents one actual tonne of carbon locked away in the ground.
Steps in retiring your CPCO2 tokens are as follows:

1. `Open Retire tab`_
    :ref:`Optional: Select Well<Select Well>`
2. `Enter Retirement amount`_
3. `Confirm Retire transaction`_
4. `Retire transaction Result`_


.. _Open Retire tab:

---------------
Open Retire tab
---------------

Open Trade page by clicking on |Buy Tokens Button| or the "Buy Tokens" in *My Wallet* similar to :ref:`opening Buy tab<Open Buy tab>`.
Then, click "Retire" to switch tabs.


If you have enough tokens, you can also open Retire tab directly from Well View. 
Click on the well you want to retire to, then click the "Retire CPCO2 Tokens" button below when in the Well Overview.
This way, selected well will be automatically updated.

.. figure:: /images/retireWellView.png
   :alt: Opening Retire tab from Well View
   :align: center

   Opening Retire tab from Well View


.. _Select Well:

^^^^^^^^^^^^^^^^^^^^^
Optional: Select Well
^^^^^^^^^^^^^^^^^^^^^

**This is an optional step**. By default, CarbonPath selects the well with the least number of retirements.
To change which well you want to retire your tokens at, click "Yes" to toggle the *Retire Token to specific well*.
This will show a search bar and a dropdown list of all available wells.
Search and select the well of your choice. 
The currently selected well is visible along with the maximum number of tokens it can accept.

.. figure:: /images/retireSpecific.png
   :alt: Toggled Retire Tokens to specific well.
   :align: center

   Toggled Retire Tokens to specific well


.. _Enter Retirement amount:

-----------------------
Enter Retirement amount
-----------------------

Input number of tokens to be retired or select a percentage of your token balance. 
The following are consired for a valid retirement input:

* Numerical input up to two decimal places
* Input should be at least 0.01 CPCO2 tokens
* Input is less than *Max value* which depends on your CPCO2 tokens and token limit of well


Then, click *Retire CPCPO2 Tokens* to continue with transaction.


.. figure:: /images/retireInput.png
   :alt: Retire Input
   :align: center
   
   Retire Input


.. _Confirm Retire transaction:

--------------------------
Confirm Retire transaction 
--------------------------

*Retire Summary* shows retirement information before proceeding. 
Click *Confirm* to proceed. Click *Back* to return to *Retire Input*.

*Retire Processing* screen will be shown once *Retire Summary* is confirmed.
Depending on how you connected your wallet, *Retire Processing* may proceed automatically.
Otherwise, click *Initiate Retire* and confirm pop-ups in your wallet to proceed.
Progress of each step is shown (completed = check mark).


.. figure:: /images/retireConfirm.png
   :alt: Retire Summary screen on the left, and Retire Processing screen on the right
   :align: center
   
   (left) Retire Summary (right) Retire Processing


.. _Retire transaction Result:

-------------------------
Retire transaction Result
-------------------------

After waiting for Retire transaction to finish, a *Retire Success/Error* screen will be shown. 
For desktop, you can click your balance on the header to refresh if it remained the same after the transaction -- delays depend on network and blockchain traffic.

^^^^^^^^^^^^^^
Retire Success
^^^^^^^^^^^^^^

Once a retire transaction is completed, a recap will be shown along with its equivalent impact. 
An invoice for your transaction will then be available for download. 
Click *Done* to finish transaction and reset Retire tab. 
Click *Total Impact* to reset retire screen and redirect you to the *Impact section*.

.. figure:: /images/retireSuccess.png
   :alt: Retire Success screen
   :align: center
   
   Retire Success


^^^^^^^^^^^^
Retire Error
^^^^^^^^^^^^

Should any error be encountered while processing the transaction, the retire screen will be shown with the corresponding error message.
Click *Try Again* to return to Retire Input screen.



.. |Buy Tokens Button| image:: images/buyTokensButton.png 
  :height: 6ex