# **14. Permissions**
###### tags: `Done`, `Education`

**Purpose:**
* Understand how 3.Finance uses 3Fi tokens and NFTs as permissions to perform specific functions or access specific features.
* Understand which features and functions are effected by permissions and what their requirements are.

Content:

> Definitions
> References
> Permissions:
>> Features & Functions
>> NFT Requirements

## Definitions
*(If there is a term in this document you wish clarification on, please add a comment and I will add a definition for that term)*

## References
*(References will be added here when they are deemed necessary)

## Permissions
3.Finance uses its own 3Fi tokens and NFTs as a mechanism to allow or disallow access to specific features and functions of the 3.Finance web app. Below is a list of those features and functions and the token and/or NFT requirements to access each:

### 3Fi Collateral Wallets
Found in the 'Emissions' space, '3Fi Collateral Wallets' is a group that contains tokens with 'Collateral' status. Asset-stacks will each contain one asset with 'Collateral' status. (In the case of the Curve asset-stack; CRV has 'Collateral' status)

***Specific to the Curve asset-stack:***
Collateral status is only applied to CRV Emissions.

***Applied to all asset-stacks. CRV is used as an example here:***
Collateral status is only applied when a user (connected wallet) has a 3Fi token position and/or a 3Fi NFT position(s). Collateral status means; users have the option to direct their *(CRV)* collateral emissions in one of two ways:
1. Users may continue to direct *(CRV)* collateral emissions found in the Emissions space to the *(Curve)* C.P.D to continue compounding their *(CRV)* position. OR
2. Users may direct *(CRV)* collateral emissions found in the Emissions space to the 3Fi Collateral Wallet. In this case, the *'**CRV Wallet**'*

Directing *(CRV)* collateral to the 3Fi Collateral Wallet allows users to perform one of two actions:
1. Allocate all or part of the collateral balance to be sent and used within connected money apps. OR
2. Converted to FRAX and Claim; transferring FRAX to the connected wallet.

To access 3Fi Collateral Wallets and related functionality, the following must be met:

#### **Requirements:**
Found in the '**Deposits**' space, is a group titled '**3Fi Collateral**'. This group displays two types of cards:
1. A users (connected wallet) position of 3Fi tokens held. And...
2. A users (connected wallet) position of each 3Fi NFT held.

Users will be required to mint 3Fi tokens by accessing the 3Fi Card and executing mint actions within it.

**Notes:**
Minting is not the requirement, having a balance of 3Fi tokens or NFTs associated to the connected wallet IS. (So if users don't mint, they may also purchase)

### Money Apps
**(Not included in MVP)**
Access to the '**Money App**' space is not restricted, however actions within the space ARE.
Access to all of the below listed actions require the same conditions to be met as those described above in '**3Fi Collateral Wallets**' unless otherwise stated below.

Money App actions:

* Starting a new application to list a Money App.
* In addition '**3Fi Collateral Wallets**' described requirements, this action will also require **a Guild NFT** to be held.
* Voting to accept or reject a Money App application.
* Submitting widget designs requirements.
* Submitting micro-site design requirements.
* Adding a money app to one's own dashboard.

More about '**Money Apps**' is shared in document '10'.

### Micro Sites
**(Not included in MVP)**
Micro sites are accessed by selecting widgets found on a users dashboard within the 'Dashboard' space. Selecting a widget will open a new tab and direct the user to a specific micro site.

**Note:**
Users may access micro sites from external sources.

#### **Requirements:**

Upon landing on a micro site, if a user had not previously connected their wallet (via 3.Finance) they will be asked to connect their wallet in the form of a lightbox with three visible options:
* As a guest - which allows the user to access limited data and functionality **without connecting their wallet**.
* As an investor - which allows the user access depending upon the 3Fi assets held in their connected wallet.
* As a contributor - which is the same as the investor access however in this case; the user first has the opportunity to stake an NFT or NFT receipt. IF the user does this, their connected wallet will gain full access to all data and functionality regardless of other 3Fi positions they hold in their connected wallet.

With their wallet connected, access will be determined by the following means:

* As **Guest**:
* No wallet needs to be connected.
* The user may navigate the micro-site via the **Community** view only.
* Users will be able to see default views of analytics
* Users will be able to select a group or collection to view one layer deep.
* Users will not have any access to action drawer content.
* As an **Investor**:
* Wallets are required to be connected.
* If the connected wallet has not added the associated widget to their dashboard on 3.Finance, no access will be granted.
* (A prompt will request they add the money app to their 3.Finance dashboard)
* If the connected wallet does not hold a TomAi NFT or higher, access will be treated like **Guest** and restricted to:
* Functionality necessary for a user to manage their collateral positions within that money app.
* Users will be able to see default views of analytics
* Users will be able to select a group or collection to view one layer deep.
* Users will not have any access to action drawer content.
* If the user (connected wallet) holds a TomAi NFT or higher, full access will be granted.
* As a **Contributor**:
* Wallets are required to be connected.
* If the connected wallet chooses to or has currently; a staked NFT of any power-level, that connected wallet will be granted full access.
* If the user chooses the contributor route and fails to stake an NFT of any power-level, their connected wallet will be treated like an **Investor** or **Guest** depending upon their held 3Fi positions.

More about '**Micro sites**' is shared in document '11'.

### Community Harvesting (Wallet Emissions)
**(Not included in MVP)**
In the '**Emissions**' space, a tab will be visible with three options: Individual, Community and NFT Holders.

* Individual - refers to a view of the connected wallets emissions.
* **Community - refers to a view displaying the emissions collected by all other wallets associated to 3.Finance.**
* NFT Holders - refers to a view displaying the emissions collected by NFTs.

Each of the above views are accessible to everyone, however the following actions are NOT:

* **From the Community tab:**

* If a user (connected wallet) holds a TomAi NFT or lower, they will have view only access.
* If a user (connected wallet) holds a MolAi NFT or higher, they will be able to collectively harvest compound and/or liquid emissions on behalf of wallets owned by other community memebers.
* **Notes:**
* All emissions are harvested and compounded according to individual signals. (CRV (Compounded or as Collateral), CVX or BENT)
* All emissions harvested are subject to a 1% Fee. This fee is split between the wallet performing the Harvest and 3.Finance. How this fee is split will be determined by Sir.Conrad.

More about '**Community Harvesting**' is shared in document '09'.

### Community Harvesting (NFT Emissions)

> **Amendment:** This is required for MVP, however; note that this view is expected to be exactly the same as the '**Individual**' tab view. The difference is that it reflects emissions received by NFT controlled positions and all harvesting is restricted to specific asset: CRV, DAI or FRAX (as defined by the NFT owners).

In the '**Emissions**' space, a tab will be visible with three options: Individual, Community and NFT Holders.

* Individual - refers to a view of the connected wallets emissions.
* Community - refers to a view displaying the emissions collected by all other wallets associated to 3.Finance.
* **NFT Holders - refers to a view displaying the emissions collected by NFTs.**

Each of the above views are accessible to everyone, however the following actions are NOT:

* **From the NFT Holders tab:**

* If a user (connected wallet) holds a MolAi NFT or lower, they will have view only access.
* If a user (connected wallet) holds a MatAi NFT or higher, they will be able to collectively harvest compound and/or liquid emissions on behalf of wallets owned by other community members.
* **Notes:**
* Liquid emissions are harvested according to individual signals. (CRV as collateral or FRAX)
* All emissions harvested are subject to a 1% Fee. This fee is split between the wallet performing the Harvest and 3.Finance. How this fee is split will be determined by Sir.Conrad.

> **Amendment:**
> Acception to the above requirements should be to whitelist the official 3.Finance treasury wallet (multi-sig) so that the protocol can (auto?) harvest all emissions until a community member reaches the necessary NFT requirements to perform harvests.

More about '**NFT Harvesting**' is shared in document '09'.

END