# **17. Settings**
###### tags: `Done`, `Functions`

**Purpose:**
* Understand what settings are available on 3.Finance.
* Understand how options within settings work on 3.finance.

Content:

> Definitions
> References
> Settings

# Definitions
* A **Signal** is when a user, during the harvest process; selects a specific direction they wish emissions to be harvested.
* The **Signals** contract referrs to the smart contract that registers how each connected wallet has directed their emissions during their **last** harvest. This **Signal** is then used by other functions when harvesting on behalf of other registered wallets.
* A **Registered Wallet** is a wallet that has once connected to and transacted on or via the 3.Finance protocol and is therefore, for all intents and purposes: registered with the protocol.

# References
Access to settings:

View 1. Walkthrough state, no settings access.

View 2. Connected state, settings access visible: top right of screen.

# Settings

## Options & their effects:
This section describes what opptions are available to users within the settings menu.

1. Settings are only available to users who have connected a wallet.
2. Once a wallet has been connected, users may access the settings menu from the '**Settings**' button located at the top right of the screen, directly underneath the users wallet details.
3. Selecting the '**Settings**' button will open the settings action drawer. For MVP, in this drawer, users will find the following options:

**Option 1**:
* Show or Hide: '**Help**'.
* This is the default option selected and thus visible when the settings drawer first opens.
* This option either displays or hides the help text that is visible on all '**Action drawers**'. (For example: see View 3 below)

View 3. Red arrow indicates *sample* '**Help**' text.

* If the '**Help**' option is set to '**Show**', the text will be displayed as shown.
* If the '**Help**' option is set to '**Hide**', the text visible in '**View 3**' will be removed from view and all remaining elements in the drawer will move upwards.
* Selecting and saving a help option will save a cookie to the users browser, so on revisiting the app, their settings are applied on load.

> (If a view without '**Help**' text is desired, forward a request to Gravity on our design team)

**Option 2**:
* Switch between a **Currency** of choice.
* By default, '**FRAX**' will be selected.
* For MVP, there will only be two (2) currency options: **FRAX** and **CRV**, however we intend to add currency options as the protocol matures and wish this feature to include the ability to add and remove currency options.
* Selecting **CRV** will reflect all balances in terms of CRV
* Selecting **FRAX** will reflect all balances in terms of FRAX
* Selecting and saving a currency option will save a cookie to the users browser, so on revisiting the app, their settings are applied on load.

**Option 3**:
* Setting a global '**Signal**'.
* Within signals, there will be three options:
* Curve (Converts all liquid emissions to **CRV**)
* Convex (Converts all liquid emissions to **CVX**)
* Bent (Converts all liquid emissions to **BENT**)
* By default, a new user to 3.Finance will have their '**Signal**' set to '**Convex**', thus until changed, all liquid emissions earned will be converted to **CVX**.
* Signals may be changed locally within each individual emission's '**Action drawer**' or here within '**Settings**'.
* Changing a signal (**globally**) within Settings will update and set all current and future liquid emissions to the signal selected.
* Changing a signal (**locally**) within an individual emission's action drawer will only update that specific emission's signal.
* Changes locally superseeds any prior global changes.
* **Note:** A local change will not change the global UI. Ie. If I set '**Convex**' globally and on a specific pool I set **Bent**' locally, then if I were to return to '**Settings**' I would still see '**Convex**' selected because this indicates to me what all other emissions and any future emissions I begin to earn will be set too.
* Changes globally superseeds any and all prior local changes.
* Thus this option exists to save users the trouble of updating local signals one at a time.
* Each time a signal is changed, a signature and transaction are required to make those updates to the '**Signals**' smart contract.

END