# Trevee Ecosystem

<figure><img src="/files/AK5FFrBbAoTVldFgyaPe" alt=""><figcaption></figcaption></figure>

Trevee is the unified brand for all incentive and yield products developed by [Mithras Labs](https://x.com/Mithras_Labs), bringing together the legacy of Paladin’s innovative solutions, including the renowned Quest platform, and the Rings protocol, now rebranded as Trevee Earn and Trevee Quest. This consolidation marks a new era, where all current and future products from Mithras Labs will be launched and managed under the Trevee banner, ensuring a cohesive and recognizable experience for users across the ecosystem.

#### Trevee currently features two flagship products:

* **Trevee Quest**: Formerly known as Warden Quest, this platform revolutionizes the way users acquire gauge votes for protocols such as Curve, Balancer, Bunni, and any compatible veToken or vlToken system. Unlike traditional incentives platforms that risk inefficiency and overpayment, Trevee Quest enables creators to set fixed or ranged reward rates per vote, allowing for targeted, transparent, and cost-effective campaigns. Voters benefit from knowing their exact rewards upfront, while creators can fine-tune their incentives and audience with advanced targeting and exclusion options, all with minimal fees and a seamless user experience.
* **Trevee Earn**: Previously Rings, Trevee Earn introduces meta-assets like USD, ETH, and BTC, offering users diversified earning opportunities. The protocol is designed for extensibility, with the potential to support additional assets and deploy across multiple blockchains. Each deployment can be tailored to the unique characteristics of its host chain, ensuring optimal functionality and adaptability as Trevee Earn expands.

As Mithras Labs continues to innovate, **all upcoming products and features will be integrated into the Trevee ecosystem.** This unified approach fosters synergy between platforms, delivers a consistent interface, and empowers users with a growing suite of tools to maximize their on-chain participation and rewards.

> Trevee represents the next step in decentralized incentives and yield optimization, bringing together proven solutions under one powerful, evolving brand.


# Overview

<figure><img src="/files/FXc66h33dXDJkIpUmJcZ" alt=""><figcaption></figcaption></figure>

Trevee Earn introduces a new class of "meta-assets" (USD, ETH, BTC and more), designed to provide users with flexible and diversified earning opportunities.&#x20;

While these meta-assets are initially available on the Sonic chain, the architecture of Trevee Earn is built with extensibility in mind: additional assets may be introduced in the future, and the protocol is designed to support deployment across multiple blockchains.&#x20;

It is important to note that the mechanics and parameters governing each meta-asset can be adapted to best fit the unique characteristics and requirements of each chain where Trevee Earn is deployed. As Trevee Earn expands beyond Sonic, users can expect tailored implementations that leverage the strengths and address the specificities of each supported network, ensuring an optimized experience across the evolving multi-chain ecosystem.


# Sonic scAssets

Treveen earn on Sonic introduced meta-assets for USD, ETH & BTC offering competitive yield for stakers, providing deep liquidity for Sonic DeFi, and funding [Sonic ](https://www.soniclabs.com/)DeFi projects via its lockers.

Built on the [Veda](https://veda.tech/) BoringVaults and draws inspiration from [Blast](https://blast.io/en)’s bridge capital efficiency and [Solidly](https://solidly.com/)’s ve(3,3) model. Trevee Earn aims to establish itself as the premier medium of exchange within the Sonic ecosystem.

<figure><img src="/files/knp6WHHHMe1N1oZPiPly" alt=""><figcaption></figcaption></figure>


# Veda Vaults

All assets deposited into Trevee Earn flow into Veda [BoringVaults](https://docs.veda.tech/architecture-overview/boringvault). The curators (Veda, Paladin & Tholgar for now) allocate these assets to whitelisted strategies deemed to be the safest possible in DeFi. Veda’s BoringVaults were chosen as they are a battle-tested solution that has been [audited](https://github.com/Se7en-Seas/boring-vault/tree/main/audit) and are used to secure approximately $3B of assets for protocols like ether.fi, Lombard, Mantle, pumpBTC and others.

On Trevee Earn, BoringVaults are used in two places. The first is for minting the scAssets as vault receipt tokens using whitelisted collateral, and the second as an opt-in staking vault on Sonic for generating yield on scAssets through Sonic DeFi integrations.

<figure><img src="/files/XJlz8cPikzDahBhO00Fi" alt=""><figcaption><p>scAssets minting</p></figcaption></figure>

{% hint style="info" %}
Learn more about Veda BoringVault in their [Docs](https://docs.veda.tech/architecture-overview/boringvault).
{% endhint %}


# Collateral vault (Ethereum)

### On Ethereum

ETH, BTC and Stablecoin holders can deposit their assets on Trevee Earn directly from Ethereum mainnet, which are then being bridged via the Sonic Gateway for fast and secure transfer to the Sonic network, where the ETH, BTC and stablecoin deposited will be used to mint scETH, scBTC or scUSD token at a 1:1 ratio.

<figure><img src="/files/z0YGEAndl7ld9mNmhMqq" alt=""><figcaption><p>scAssets minting and Collateral stored in an Ethereum BoringVault</p></figcaption></figure>

### On Sonic

When minting scETH, scBTC or scUSD tokens on Sonic, Trevee Earn protocol automatically sends the underlying ETH, BTC and Stablecoins to a Veda boring vault (on Ethereum mainnet) where it will be put to work in farming strategies using protocols like AAVE, Convex, Morpho, and assets like crvUSD, sDAI and more. The yield generated by these farming strategies is continuously auto compounded within the Veda vault to increase APY, and once per epoch all the yield generated by the mainnet Veda vault is swapped in ETH, BTC and stablecoins to mint new scETH, scBTC or scUSD that will be sent to Trevee Earn veNFT gauge system and distributed among Sonic dapps based on the gauge vote results every epoch.

<figure><img src="/files/g6ixGAMOUrkYbYIyhmyt" alt=""><figcaption><p>scAssets minting on Sonic and Collateral bridged and stored in an Ethereum BoringVault</p></figcaption></figure>

{% hint style="success" %}
**Some of the criteria to whitelist strategies are the following:**

* Fully audited;&#x20;
* Pass our additional internal security Due Diligence;
* Lending or staking only;
* Protocol TVL greater than$100M;
* Deployed for more than 6 months;&#x20;
* Offering direct redeemability or an equivalent;
* The vault cannot be more than 10% of the TVL of where it deposits.
  {% endhint %}

{% hint style="info" %}
scAssets can be redeemed after a 3 day cooldown.&#x20;
{% endhint %}

{% hint style="info" %}
Veda takes a 10% performance fee on yield processed by the vault.
{% endhint %}


# Staking vault (Sonic)

Trevee Earn users can stake their scETH, scBTC or scUSD to activate the native yield bearing properties of the assets, when staked the scETH, scBTC or scUSD are sent to a Veda boring vault (on Sonic this time), automating farming strategies, rebalancing assets, and redistributing yield to stakers.

<figure><img src="/files/8ZBcWOUEIiDbNzuHqhm0" alt=""><figcaption><p>Staking of scAssets on Sonic to earn yield</p></figcaption></figure>

{% hint style="success" %}
**Some of the criteria to whitelist strategies are the following:**

* Fully audited;&#x20;
* Pass our additional internal security Due Diligence;
* Protocol TVL great than $1M;
* The vault cannot be more than 25% of the TVL of where it deposits;
* Offering direct redeemability or an equivalent;
* No strategies leading to excessive impermanent loss;
  {% endhint %}


# Gauge Listing Framework

## Protocol Criteria

1. Must have contracts deployed on Sonic and an active team there
2. Must be incentivizing scUSD and / or scETH activity;

## Gauge Cap

1. For protocols with TVL under 1M$: gauges are capped at 5%&#x20;
2. If between 1 and 10M$: gauges are capped at 10%
3. Above 10M$: gauges are capped at 20%
4. Trevee Earn gauge is the dev gauge used to support continuous development for the protocol and has no caps.


# Treasury / Backing Address

{% hint style="success" %}
Here's a bundle link for Trevee Earn Veda Vault from Ethereum and Sonic

<https://debank.com/bundles/211213/accounts>&#x20;
{% endhint %}

## ETHEREUM - Underlying Stablecoin&#x20;

The Veda BoringVault on Ethereum accepts a select group of stablecoins: USDC, USDT, DAI, and GHO from Ethereum, as well as USDC.e from Sonic.&#x20;

{% hint style="info" %}
Octav: [0xd3dce716f3ef535c5ff8d041c1a41c3bd89b97ae](https://pro.octav.fi/?addresses=0xd3dce716f3ef535c5ff8d041c1a41c3bd89b97ae)

Debank: <https://debank.com/profile/0xd3dce716f3ef535c5ff8d041c1a41c3bd89b97ae>
{% endhint %}

***

## ETHEREUM - Underlying ETH

The Veda BoringVault on Ethereum accepts a select group of Ethereum assets: ETH, eETH and stETH from Ethereum, as well as WETH from Sonic.&#x20;

{% hint style="info" %}
Octav: [0x3bce5cb273f0f148010bbea2470e7b5df84c7812](https://pro.octav.fi/?addresses=0x3bce5cb273f0f148010bbea2470e7b5df84c7812)

Debank: <https://debank.com/profile/0x3bce5cb273f0f148010bbea2470e7b5df84c7812>
{% endhint %}

***

## ETHEREUM - underlying BTC

The Veda BoringVault on Ethereum accepts a select group of stablecoins: WBTC, eBTC & LBTC from Ethereum and WBTC & LBTC from Sonic.&#x20;

{% hint style="info" %}
Octav: [0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd](https://sonicscan.org/address/0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd)

Debank: <https://debank.com/profile/0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd>
{% endhint %}

***

## SONIC - scUSD

The Veda BoringVault on Sonic only accepts scUSD from Sonic.

{% hint style="info" %}
Octav: [0x4d85ba8c3918359c78ed09581e5bc7578ba932ba](https://pro.octav.fi/?addresses=0x4d85ba8c3918359c78ed09581e5bc7578ba932ba)

Debank: <https://debank.com/profile/0x4d85ba8c3918359c78ed09581e5bc7578ba932ba>
{% endhint %}

***

## SONIC - scETH

The Veda BoringVault on Sonic only accepts scETH from Sonic.

{% hint style="info" %}
Octav: [0x455d5f11Fea33A8fa9D3e285930b478B6bF85265](https://pro.octav.fi/?addresses=0x455d5f11Fea33A8fa9D3e285930b478B6bF85265)

Debank: <https://debank.com/profile/0x455d5f11Fea33A8fa9D3e285930b478B6bF85265>
{% endhint %}

***

## SONIC - scBTC

The Veda BoringVault on Sonic only accepts scETH from Sonic.

{% hint style="info" %}
Octav: [0xDb58c4DB1a0f45DDA3d2F8e44C3300BB6510c866](https://pro.octav.fi/?addresses=0xDb58c4DB1a0f45DDA3d2F8e44C3300BB6510c866)

Debank: <https://debank.com/profile/0xDb58c4DB1a0f45DDA3d2F8e44C3300BB6510c866>
{% endhint %}

***

{% hint style="success" %}
These funds are strategically deployed across different protocols, adhering to a comprehensive risk management [framework](/trevee-earn/sonic-scassets/security-framework-and-audits) that is publicly accessible for transparency.
{% endhint %}


# Developers

## Veda BoringVaults

[Veda ](https://veda.tech/)is native yield infrastructure for protocols and applications. Users deposit assets into Veda's contracts, which then securely deploy that capital across DeFi protocols. Veda’s mission is to bring crypto mass-adoption through transparent and accessible yields.

We envision every protocol, application, and ecosystem having deeply integrated native yield. Native yield provides a number of benefits for both users and protocol builders.

Veda Docs: <https://docs.veda.tech/>


# Staked scAssets & yield distribution

The yield distribution for staked scAssets will be implemented through two methods:

1. A weekly Merkle tree claim system
2. An ERC4626 wrapper (wstkscUSD / wstkscETH)

The Merkle tree claim process allows for efficient and gas-optimized distribution of yields on a weekly basis. Users can claim their rewards by providing proof of their eligibility, which is verified against the Merkle root stored on-chain. This method ensures a fair and transparent distribution of yields while minimizing gas costs for both the protocol and users.

For those seeking a more streamlined experience, the ERC4626 wrapper tokens (wstkscUSD and wstkscETH) will automatically compound yields. These wrapper tokens represent a user's stake in the underlying scAssets, including accrued yields, making them ideal for users who prefer a "set-and-forget" approach to earning yields on their staked assets.

This dual approach to yield distribution offers flexibility and efficiency, catering to different user preferences within the ecosystem.


# scUSD/scETH veNFT

### Trevee Earn **veNFT follow the ve(3, 3) design.**

VotingEscrow and Voter contracts have been forked from [Thena](https://docs.thena.fi/thena) and slightly modified to add a voting approval logic.\
\
To acquire a veNFT, users create a lock by specifying an amount of stkscToken and a lock duration. Active veNFT have a “balance”, which is the locked amount, prorated from the maximum locking duration (52 weeks). The “balance” does not represent the amount of underlying token locked, it does only count the vote power of the veNFT.

{% hint style="info" %}
Example : A veNFT with a locked amount of 5200 stscToken and a duration of one week will have a “balance” of 100 ((5200 / 52) \* 1).
{% endhint %}

The veNFTs “balances” are used by the voter contracts when a user votes for protocol gauges.\
When a veNFT is used to cast a vote, it becomes frozen until the voting period is over or the veNFT is reseted.


# Smart Contracts

## Ethereum: <a href="#ethereum" id="ethereum"></a>

<table><thead><tr><th width="455">Contract</th><th>Name</th></tr></thead><tbody><tr><td>​<a href="https://etherscan.io/address/0xd3DCe716f3eF535C5Ff8d041c1A41C3bd89b97aE">0xd3DCe716f3eF535C5Ff8d041c1A41C3bd89b97aE</a>​</td><td>scUSD</td></tr><tr><td>​<a href="https://etherscan.io/address/0x358CFACf00d0B4634849821BB3d1965b472c776a">0x358CFACf00d0B4634849821BB3d1965b472c776a</a>​</td><td>scUSD teller</td></tr><tr><td>​<a href="https://etherscan.io/address/0x3754480db8b3E607fbE125697EB496a44A1Be720">0x3754480db8b3E607fbE125697EB496a44A1Be720</a>​</td><td>scUSD withdraw queue</td></tr><tr><td>​<a href="https://etherscan.io/address/0x3bcE5CB273F0F148010BbEa2470e7b5df84C7812">0x3bcE5CB273F0F148010BbEa2470e7b5df84C7812</a>​</td><td>scETH</td></tr><tr><td>​<a href="https://etherscan.io/address/0x31A5A9F60Dc3d62fa5168352CaF0Ee05aA18f5B8">0x31A5A9F60Dc3d62fa5168352CaF0Ee05aA18f5B8</a>​</td><td>scETH teller</td></tr><tr><td>​<a href="https://etherscan.io/address/0x555f4dF2180df6257860F23b29d653c1AAFb7957">0x555f4dF2180df6257860F23b29d653c1AAFb7957</a>​</td><td>scETH withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd">0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd</a>​</td><td>scBTC</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xAce7DEFe3b94554f0704d8d00F69F273A0cFf079">0xAce7DEFe3b94554f0704d8d00F69F273A0cFf079</a>​</td><td>scBTC teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x488000E6a0CfC32DCB3f37115e759aF50F55b48B">0x488000E6a0CfC32DCB3f37115e759aF50F55b48B</a>​</td><td>scBTC withdraw queue</td></tr></tbody></table>

## Sonic: <a href="#sonic" id="sonic"></a>

<table><thead><tr><th width="454">Contract</th><th>Name</th></tr></thead><tbody><tr><td>​<a href="https://sonicscan.org/address/0xd3DCe716f3eF535C5Ff8d041c1A41C3bd89b97aE">0xd3DCe716f3eF535C5Ff8d041c1A41C3bd89b97aE</a>​</td><td>scUSD</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x358CFACf00d0B4634849821BB3d1965b472c776a">0x358CFACf00d0B4634849821BB3d1965b472c776a</a>​</td><td>scUSD teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x3754480db8b3E607fbE125697EB496a44A1Be720">0x3754480db8b3E607fbE125697EB496a44A1Be720</a>​</td><td>scUSD withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x4D85bA8c3918359c78Ed09581E5bc7578ba932ba">0x4D85bA8c3918359c78Ed09581E5bc7578ba932ba</a>​</td><td>stkscUSD</td></tr><tr><td>​<a href="https://sonicscan.org/token/0x9fb76f7ce5fceaa2c42887ff441d46095e494206">0x9fb76f7ce5FCeAA2C42887ff441D46095E494206</a>​</td><td>wtskscUSD</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x5e39021Ae7D3f6267dc7995BB5Dd15669060DAe0">0x5e39021Ae7D3f6267dc7995BB5Dd15669060DAe0</a>​</td><td>stkscUSD teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x5448A65ddB14e6F273cd0eD6598805105A39d8cC">0x5448A65ddB14e6F273cd0eD6598805105A39d8cC</a>​</td><td>stkscUSD withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x0966CAE7338518961c2d35493D3EB481A75bb86B">0x0966CAE7338518961c2d35493D3EB481A75bb86B</a>​</td><td>veUSD</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xB84194E28f624BBBA3C9181F3a1120eE76469337">0xB84194E28f624BBBA3C9181F3a1120eE76469337</a>​</td><td>scUSD voter</td></tr></tbody></table>

<table><thead><tr><th width="456">Contract</th><th>Name</th></tr></thead><tbody><tr><td>​<a href="https://sonicscan.org/address/0x3bcE5CB273F0F148010BbEa2470e7b5df84C7812">0x3bcE5CB273F0F148010BbEa2470e7b5df84C7812</a>​</td><td>scETH</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x31A5A9F60Dc3d62fa5168352CaF0Ee05aA18f5B8">0x31A5A9F60Dc3d62fa5168352CaF0Ee05aA18f5B8</a>​</td><td>scETH teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x555f4dF2180df6257860F23b29d653c1AAFb7957">0x555f4dF2180df6257860F23b29d653c1AAFb7957</a>​</td><td>scETH withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x455d5f11Fea33A8fa9D3e285930b478B6bF85265">0x455d5f11Fea33A8fa9D3e285930b478B6bF85265</a>​</td><td>stkscETH</td></tr><tr><td>​<a href="https://sonicscan.org/token/0xe8a41c62bb4d5863c6eadc96792cfe90a1f37c47">0xE8a41c62BB4d5863C6eadC96792cFE90A1f37C47</a>​</td><td>wtskscETH</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x49AcEbF8f0f79e1Ecb0fd47D684DAdec81cc6562">0x49AcEbF8f0f79e1Ecb0fd47D684DAdec81cc6562</a>​</td><td>stkscETH teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x65b6AFB8C1521B48488dF04224Dc019Ea390E133">0x65b6AFB8C1521B48488dF04224Dc019Ea390E133</a>​</td><td>stkscETH withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x1Ec2b9a77A7226ACD457954820197F89B3E3a578">0x1Ec2b9a77A7226ACD457954820197F89B3E3a578</a>​</td><td>veETH</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x43739B96B19aE7C2E0d80BE7832325846f55Fa05">0x43739B96B19aE7C2E0d80BE7832325846f55Fa05</a>​</td><td>scETH voter</td></tr></tbody></table>

<table><thead><tr><th width="459">Contract</th><th>Name</th></tr></thead><tbody><tr><td>​<a href="https://sonicscan.org/address/0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd">0xBb30e76d9Bb2CC9631F7fC5Eb8e87B5Aff32bFbd</a>​</td><td>scBTC</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xAce7DEFe3b94554f0704d8d00F69F273A0cFf079">0xAce7DEFe3b94554f0704d8d00F69F273A0cFf079</a>​</td><td>scBTC teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x488000E6a0CfC32DCB3f37115e759aF50F55b48B">0x488000E6a0CfC32DCB3f37115e759aF50F55b48B</a>​</td><td>scBTC withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xD0851030C94433C261B405fEcbf1DEC5E15948d0">0xD0851030C94433C261B405fEcbf1DEC5E15948d0</a>​</td><td>stkscBTC</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xDb58c4DB1a0f45DDA3d2F8e44C3300BB6510c866">0xDb58c4DB1a0f45DDA3d2F8e44C3300BB6510c866</a>​</td><td>wstkscBTC</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x825254012306bB410b550631895fe58DdCE1f4a9">0x825254012306bB410b550631895fe58DdCE1f4a9</a>​</td><td>stkscBTC teller</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x6dF97Ed8B28d9528cd34335c0a151F10E48b6eF3">0x6dF97Ed8B28d9528cd34335c0a151F10E48b6eF3</a>​</td><td>stkscBTC withdraw queue</td></tr><tr><td>​<a href="https://sonicscan.org/address/0x7585D9C32Db1528cEAE4770Fd1d01B888F5afA9e">0x7585D9C32Db1528cEAE4770Fd1d01B888F5afA9e</a>​</td><td>veBTC</td></tr><tr><td>​<a href="https://sonicscan.org/address/0xc31c4BC46BCd55e7483f2aAF194f7cF7641Ee7c3">0xc31c4BC46BCd55e7483f2aAF194f7cF7641Ee7c3</a>​</td><td>veBTC voter</td></tr></tbody></table>


# Security Framework and Audits

## Audits

Trevee Earn **is built on the** [**Veda**](https://veda.tech/) **BoringVaults and its tokenomics are a fork of** [**Thena**](https://thena.fi/)**’s ve(3,3) model.**

* **Veda Boring Vault audited by** [**Spearbit and 0xMacro**](https://github.com/Se7en-Seas/boring-vault/tree/main/audit)**.**

{% hint style="info" %}
The Veda Boring vault has already secured more than $3 billion in TLV in products such as EtherFi's Liquid and Lombard's LBTC.
{% endhint %}

* **THENA V2 has been audited by** [**OpenZeppelin**](https://blog.openzeppelin.com/retro-thena-audit)**.**

{% hint style="info" %}
Only the delegation of voting power and a simplified gauge system (limiting gauge recipient to one) are used from the Thena codebase.
{% endhint %}

## Safety Measures

### Veda Boring Vault Protocol Whitelisting Criteria

* Only integrate fully audited protocols
* Minimum requirements: $100M+ TVL and 6+ months since deployment
* No experimental or high-risk strategies

### **Safety Mechanisms**

* 5-day cooldown for scAsset redemptions
* 24h timelock delays for protocol changes

### **Risk Management**

* Vault deposits capped at:
  * 10% of a protocol's TVL on Ethereum
  * 25% of a protocol's TVL on Sonic

{% hint style="success" %}
These measures ensure the protection of underlying assets on Ethereum and of scAssets in the Sonic ecosystem, prioritizing user safety and protocol stability.
{% endhint %}


# Bug Bounties

**Scope:** Issues which can lead to substantial loss of money, critical bugs like a broken live-ness condition or irreversible loss of funds.

## Disclosure policy: <a href="#disclosure-policy" id="disclosure-policy"></a>

* Let us know as soon as possible upon discovery of a potential security issue.
* Provide us a reasonable amount of time to resolve the issue before any disclosure **to the public or a third-party**.

## Exclusions: <a href="#exclusions" id="exclusions"></a>

* Already known vulnerabilities.
* Vulnerabilities in front-end code not leading to smart contract vulnerabilities.

#### Eligibility: <a href="#eligibility" id="eligibility"></a>

* You must be the first reporter of the vulnerability
* You must be able to verify a signature from same address
* Provide enough information about the vulnerability

## Bounty payout: <a href="#bounty-payout" id="bounty-payout"></a>

| Up to 1,000$ | Up to 10,000$                                                   | Up to 100,000$                                                                                  |
| ------------ | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Misc         | Vulnerabilities and ability to manipulate the gauge allocations | Ability to unlock and steal underlying from veNFTs or redirect harvest fees to another address. |


# Plasma plAssets

Treveen earn on Plasma introduced plUSD and splUSD, offering competitive yield for stakers.

Built on the [Midas](https://midas.app/) Vaults Infrastructure, Trevee Earn aims to establish itself as the premier medium of exchange within the Plasma ecosystem.

***

All assets deposited into Trevee Earn Plasma flow into Midas Vault. The curators (Midas and Mithras) allocate these assets to whitelisted strategies deemed to be the safest possible in DeFi. Midas Vaults were chosen as they are a battle-tested solution that has been audited and are used to secure approximately $1.5B of assets.

## How it works ?

When minting plUSD tokens with USDT on Plasma, Trevee protocol automatically sends the underlying Stablecoins to a Midas vault (on Plasma mainnet) where it will be put to work in farming strategies using protocols like Aave, Fluid, and more. The yield generated by these farming strategies is continuously auto compounded within the Midas vault to increase APY, and all the yield generated by the mainnet Midas vault is swapped in stablecoins to mint new plUSD that will be sent to plUSD staking Contract (splUSD) as auto-compound rewards.

<figure><img src="/files/brAcHw0PdZbvY8wk2tqa" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Some of the criteria to whitelist strategies are the following:**

* Fully audited;&#x20;
* Pass our additional internal security Due Diligence;
* Lending or staking only;
* Protocol TVL greater than$100M;
* Deployed for more than 6 months;&#x20;
* Offering direct redeemability or an equivalent;
* The vault cannot be more than 10% of the TVL of where it deposits.
  {% endhint %}


# Treasury / Backing Address

#### USDT to be deployed: (plUSD mint, USDT treasury)

<https://debank.com/profile/0xd1e70089bd036896b7454ed5dc5e74c656cc0f7a>

#### splUSD Yielding Vault: (USDT yield generation)

<https://debank.com/profile/0xa1ff1458aad268b846005ce26d36ec6a7fc658da>

{% hint style="info" %}
Do take into account all capital isn't deployed immeditaly for security reasons

Find all smart contracts [here](/trevee-earn/plasma-plassets/smart-contracts)
{% endhint %}

***


# Unstaking and Redemption

**During the Pre-deposit phase (2 weeks):** no unstake or redemption

**After the Pre-deposit phase:**

* Frequency: Redemptions processed twice daily (morning and evening).
* Processing Days: Only business days (Monday to Friday, no weekends).
* Processing Time: Takes 2 business days (not 72 hours).
* Example: Redeem on Thursday, processed by Monday (weekends excluded).

*Note: Plan redemptions considering non-processing days (Saturday/Sunday).*


# Security and Audits

## Audits

Trevee is built on the Midas Vaults infrastructure.

* Midas Audits: <https://docs.midas.app/resources/audits>

{% hint style="info" %}
The Midas Vault has already secured more than $1.5 billion in TLV
{% endhint %}

## Safety Measures

### Midas Vault Protocol Whitelisting Criteria

* Only integrate fully audited protocols
* Minimum requirements: $100M+ TVL and 6+ months since deployment
* No experimental or high-risk strategies

### **Safety Mechanisms**

* 72h cooldown for Asset redemptions
* 24h timelock delays for protocol changes


# Smart Contracts

## plUSD

<table><thead><tr><th width="432"></th><th></th></tr></thead><tbody><tr><td>0xf91c31299E998C5127Bc5F11e4a657FC0cF358CD</td><td>plUSD Token</td></tr><tr><td>0x4718e64C12cAE76552696934f0b346cfc1e9a7d3</td><td>Custom Feed</td></tr><tr><td>0x2b3F3514867cbCcfadC80121297BB8088c683432</td><td>Data Feed</td></tr><tr><td>0x2b690Cab819A815732544aEb422474EfDc1B0615</td><td>Deposit Vault</td></tr><tr><td>0x24e49D2Ad8f0bcD0cF7F2A5Ab560Ca4319f6bd75</td><td>Redemption Vault Swapper</td></tr></tbody></table>

## splUSD

<table><thead><tr><th width="436"></th><th></th></tr></thead><tbody><tr><td>0x616185600989Bf8339b58aC9e539d49536598343</td><td>splUSD Token</td></tr><tr><td>0xfE5AE64f5Ba6a45B9267A5BA274620539Fa59566</td><td>Custom Feed</td></tr><tr><td>0xAA24bABA4DA60b2Aeaf80B1Db07B0A4A7fd84455</td><td>Data Feed</td></tr><tr><td>0x4Ef9fF56162bD3Cb5073FB20DbD355C59084093f</td><td>Deposit Vault</td></tr><tr><td>0x69EcaB6aA7bDFDdD99deF0891c0317076430ae50</td><td>Redemption Vault Swapper</td></tr></tbody></table>


# More chain soon 👀


# Overview

https\://quest.trevee.xyz/

<figure><img src="/files/0asxbWFTheDVlBBaLTuR" alt=""><figcaption></figcaption></figure>

Trevee Quest offers a unique approach to **acquire gauge votes for Curve, Balancer and any other compatible veToken protocol, via the veToken layer as well as vlToken layer built on top of them.**

Most incentives platforms can only allow buyers to offer an arbitrary amount of rewards to influence voters. Buyers can easily overpay this way, and voters are also always at the risk of getting diluted by other voters. Instead, Quest allows buyers to fix the rate of rewards per vote.

This way, **a Quest creator can target a specific amount of votes while voters have the benefit of knowing exactly how much rewards they could earn before joining a Quest. With V2, creators can also now specify a range of incentives per vote they wish to pay, setting up a minimum and maximum amount of votes.** Creators can also target specific groups of voters and also blacklist any address from rewards.

{% hint style="info" %}
**There are no fees for voters on Quest.** Quest creators pay a low creation fee for setting up incentives.
{% endhint %}

**vlCVX and vlAURA holders can delegate to Paladin for optimized voting across all incentives platforms.** Delegating is not mandatory. You can vote yourself to receive incentives.

(Note: to be eligible for the latest round’s rewards, you have to be locked and delegated before the snapshot proposal starts.)

To understand more about how Quest determines rewards for voters read [Reward Distribution.](https://docs.paladin.vote/quest-v2/reward-distribution)

## QUEST V2.1 <a href="#quest-v2.1" id="quest-v2.1"></a>

Paladin’s last UI update brings new features to get more information about the Quests.

You can select the protocol to see the different quests associated with it.

On the header you have several information about the current round such as the time left, the weekly incentives and the total votes for the round.

<figure><img src="https://docs.paladin.vote/~gitbook/image?url=https%3A%2F%2F28883482-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYjrAl3ZoOhJHgpqFnV%252Fuploads%252FEGNaeo4v5vT5avsvzJYx%252Fimage.png%3Falt%3Dmedia%26token%3Da67c1070-a494-420c-bc1e-d919616bf7f8&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=597e1c82&#x26;sv=2" alt=""><figcaption></figcaption></figure>

#### Each quest is displayed with the following information:

* The chain and reward token.
* The number of votes needed.
* The state of the votes in quest with a small chart : the dot represents the current state (Y axis is the current APR and X is the number of the votes received), along with the current APR and the current reward per vote. Note that there are 2 types of charts ranged and fixed depending on the type of quest, the fixed one has a fixed APR resulting in a straight line on the chart.
* You can see more details about the quest by clicking on the "More info" link.

<figure><img src="https://docs.paladin.vote/~gitbook/image?url=https%3A%2F%2F28883482-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYjrAl3ZoOhJHgpqFnV%252Fuploads%252FdKPmuh4Xiy4ouXwRXFtC%252Fimage.png%3Falt%3Dmedia%26token%3Ddf8d757b-5406-4a0d-b6b3-4e7ffb36da3a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b8165c43&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Additional information is provided such as the minimum objective for the quest and extensive view of the current state of votes. Each reward token is displayed separately with the reward per vote and weekly reward. The reward simulator allows you to calculate the reward you would get for a given number of votes and the chart will update accordingly, changing color to differentiate it from the current state.


# Quest Types & Features

With V2, Quest introduces different modes & features to personalize your Quest at creation.

## Reward Types : <a href="#reward-types" id="reward-types"></a>

In V2, there is now 2 types of Quests : the Fixed Quests, and the Ranged Quests.

### Fixed Quest <a href="#fixed-quest" id="fixed-quest"></a>

A Fixed Quest is the equivalent to a V1 Quest, with a specific target of votes, and a unique reward per vote amount, rewarding voters until the target is reached. If the vote does not reach its target of votes, a part of the rewards are not distributed (pro-rata of the uncompleted target) and can be either claimed back by the creator, or used in one of the new V2 features (see [Undistributed Rewards section](#undistributed-rewards-types)).

### Ranged Quest <a href="#ranged-quest" id="ranged-quest"></a>

A Ranged Quest is a new system, similar to dilutive vote incentives, but allowing the creator to specify a minimum and a maximum reward per vote value. Coupled with the total amount of rewards for the period, those 2 reward per vote values will translate into a minimum target of vote, and a maximum target of votes.

Until the minimum target of vote is not reached, all voters will be rewarded with the maximum reward per vote specified. Once the minimum target is reached, and votes still accrue for the Quest, the reward per vote of all voters in the Quest will start reducing towards the minimum reward per vote, until the maximum target of votes. After that maximum reward of vote is reached, no other voter is rewarded, and all eligible voters will be rewarded based on the minimum reward per vote specified.

If at the end of the period, the amount of votes received for the Quest is somewhere between the minimum target and the maximum target, voters will share all of the period total rewards, based on a reward per vote calculated depending on the minimum reward per vote, the maximum reward per vote, and the total amount of votes received on the Quest.

{% hint style="info" %}
If the Quest does not reach its minimum target of votes, only a part of the rewards are distributed (pro-rata of the amount of vote received), and the rest of the rewards can be either claimed back by the creator, or used in one of the new V2 features (see [Undistributed Rewards section](#undistributed-rewards-types)).
{% endhint %}

## Voting Types : <a href="#voting-types" id="voting-types"></a>

With Quest V2, instead of having different QuestBoards handling different type of votes, here everything is handled via a single Board for each ecosystem, using 3 different Vote types:

* **The Normal Voting** **type** is a basic Quest, where all votes on the gauge are accounted for, and all voters are eligible.
* **The Blacklist Voting type** allows the Quest creator to specify a list of veToken voters not allowed to receive the rewards from the Quest, and their votes will not be counted for the completion of the Quest objective. Note that the Blacklist only applies to veToken voters, and not for addresses voting using a layer upon the veToken (for example, vlToken voters are not concerned by that Blacklist). The Blacklist can also block a layer built upon a veToken (vlToken, liquid locker, etc ...) and ignore all the votes coming from that layer at once.
* **The Whitelist Voting type** allows the Quest creator to list specific veToken voters that will be exclusively allowed to receive rewards from the Quest. This system has 2 specific uses :
  * List only the veToken Voter contract from a vlToken for example, allowing only the vlToken voters to vote and receive rewards from the Quest
  * Make an OTC deal Quest where only 1 or a few addresses listed will be allowed to participate in the Quest, allowing the Quest creator to specify the terms of the deal, and the Voter(s) who can opt-in if the terms are acceptable.

## Undistributed Rewards Types : <a href="#undistributed-rewards-types" id="undistributed-rewards-types"></a>

With Quest V1, all undistributed rewards at the end of a Quest period were available for the Quest creator to claim back. With V2, 2 new options are offered for the Quest creator to use the undistributed rewards at the end of each period.

* **Claim back :** Similar to V1, this allows the Quest creator to claim back the undistributed rewards from the Quest Board.
* **Rollover :** The Rollover system allows to push all undistributed rewards at the end of a period into the total budget for the next period, increasing the reward per vote of the Quest for the next period while keeping the same target(s) amount of votes. In the case of a Ranged Quest, this will increase both the minimum reward per vote and the maximum reward per vote.
* **Gauge Distribution :** This system requires the Quest Board to be listed to distribute rewards on the gauge linked to the Quest (for most systems, via a Governance or an admin authorization from Curve, Balancer or Bunni). At the end of the period, all undistributed rewards will be directly sent to the gauge to be distributed as extra rewards (as Liquidity Mining) .

## Fee Framework: <a href="#fee-framework" id="fee-framework"></a>

<figure><img src="https://docs.paladin.vote/~gitbook/image?url=https%3A%2F%2F28883482-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MYjrAl3ZoOhJHgpqFnV%252Fuploads%252FDpaDMr16RjP7GRVnqO1n%252Fimage.png%3Falt%3Dmedia%26token%3Dcc7cf27b-b64a-40f8-a25e-b0c2596fa85c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b1cfb81&#x26;sv=2" alt=""><figcaption><p>New fee framework voted on PIP-19</p></figcaption></figure>

By adopting this flexible fee structure, Quest positions itself as the most competitive product on the market for vote incentives, rewarding both large and regular clients. The loyalty discount for all tiers, ensures that all customers benefit from our comprehensive incentive program.


# Creating a Quest

Choosing your Quest type

Whether you want to quickly offer vote incentives or execute a long-term strategy, Quests can be configured to fit all of your needs.&#x20;

V2 offers two Quest types: Fixed and Ranged. Simply, if you’re aiming for a specific target of votes with a predictable APR choose Fixed. If you want to aggressively meet your core targets with a higher APR and then reduce your rate for additional votes choose Ranged.&#x20;

[Learn more on the features page](broken://pages/mDrK9hKu2QRq3sgm8pMI). Step by step guides can be found below.

{% hint style="info" %}
*A reminder about voting periods*

With Quest, set up rewards before or during a vote. Here's the standard timeline for voters,

**Weekly Voting:**&#x20;

Curve, Balancer, and Bunni: Open weekly, ending at 0:00 UTC every Thursday.&#x20;

**Bi-Weekly Voting:**&#x20;

Convex, Aura, and Liquis: Start on Thursdays at approximately 02:00 UTC and end at 00:00 UTC the following Tuesday.
{% endhint %}


# Fixed Quests

Offer voters predictable APR

Fixed Quests are the same as the original Quests in V1. If you know how much you want to reward per vote you can cap your rewards when your vote target is reached. This is the straightforward way to offer a specific APR to voters. Now there are also `Reward rollover` abilities to automate more of your strategy.&#x20;

## 1. Fill the Quest’s basic info&#x20;

<figure><img src="/files/GUOySBWtXZ6oeFnW0BpN" alt=""><figcaption><p>Step 1: Fill ecosystem, gauge, token, and vote period</p></figcaption></figure>

## 2. Select which voters you want to target

<figure><img src="/files/TRkOmr5uiUBRW3PvNSQg" alt=""><figcaption><p>Step 2</p></figcaption></figure>

## 2a. Optionally you can blacklist or whitelist specific voters

<figure><img src="/files/ihD2U7nhunrdbvHO3XEB" alt=""><figcaption><p>Optional step to add permissions</p></figcaption></figure>

## 3. Set your Quest’s budget and the APR you want to offer

1. Your budget is distributed across the `Numbers of weeks` you choose
2. Select `Fixed` reward type
3. Price your `Reward per vote`. The $ per vote is displayed.&#x20;
4. Choose your `Reward rollover` option

<figure><img src="/files/t1YA8YbqxjtlqJUmDiP9" alt=""><figcaption><p>Final step</p></figcaption></figure>

{% hint style="success" %}
**With this done you can create your Quest for the voting period.** For expert advice on budgeting or liquidity management, please consult the Paladin team.
{% endhint %}


# Ranged Quests

Offer voters a performance based APR

The newest addition in V2, Ranged Quests allow you to offer a maximum APR until your threshold vote target is reached and then it dilutes to your minimum APR. Once the total budget is spent the Quest is capped as normal. If you have core vote needs this ranged approach can give you the needed flexibility to move with the market.&#x20;

## 1. Fill the Quest’s basic info

<figure><img src="/files/iXLq9AgaZhD6d73kFsdH" alt=""><figcaption><p>Step 1: Fill ecosystem, gauge, token, and vote period</p></figcaption></figure>

## 2. Select which voters you want to target

<figure><img src="/files/L4XgviPz4Dj2e23vnDjp" alt=""><figcaption><p>Step 2</p></figcaption></figure>

## 2a. Optionally you can blacklist or whitelist specific voters

<figure><img src="/files/PA1AfIjHpiRl4PASQ9tK" alt=""><figcaption><p>Optional step to add permissions</p></figcaption></figure>

## 3. Set your Quest’s budget and the APR you want to offer

1. Your budget is distributed across the `Numbers of weeks` you choose
2. Select `Ranged` reward type
3. Price your `Min reward` and your `Max reward` The $ per vote is displayed.&#x20;
4. Choose your `Reward rollover` option

<figure><img src="/files/GfmevOdKGB2Sr2lMoHMm" alt=""><figcaption><p>Final step</p></figcaption></figure>

{% hint style="success" %}
**With this done you can create your Quest for the voting period.** For expert advice on budgeting or liquidity management, please consult the Paladin team.
{% endhint %}


# Voting for Quests

Earning rewards for your Gauge Vote

{% hint style="success" %}
CVX and AURA voters can [delegate](/trevee-quest/overview/delegating-your-vote) their vote to Paladin's Auto voter for automated rewards.
{% endhint %}

All active Quests can be found on the `Dashboard`. If a Quest is not at 100% progress then eligible voters can still join and capture incentives. The Quest board displays the essential information about the incentives to allow you to quickly decide if you'd like to vote. All the detailed information related to the incentives can be found on the `More info` page.

#### **The Basic info includes:**

* The gauge's pool name
* The Quest's progress and how many votes are needed
* The reward type
  * Fixed: The token reward per vote won't change
  * Ranged: There's an initial max APR that dilutes to a min APR depending on the votes received
* The Quest's duration
* The eligible voters who can receive incentives when voting for the Quest&#x20;

<figure><img src="/files/zxUVMRGGy6ywhy72IHD0" alt=""><figcaption><p>Active vote incentives are listed</p></figcaption></figure>

If there is a shield icon on the Quest then permissions are active and some voters won't be eligible for the rewards. To check if you're able to join the Quest go to the `More info` page and check the blocked addresses.

<figure><img src="/files/gBmyDqV1i3gDcT6T2log" alt=""><figcaption><p>Quest with active permissions</p></figcaption></figure>

## How to join a Quest and earn rewards

If you are eligible to join a Quest and it's not full, simply select the vote button on the Quest and complete your vote transaction on your respective protocol.&#x20;

<figure><img src="/files/EDY0OJkRIgBMWoRxXs27" alt=""><figcaption><p>Ready to vote</p></figcaption></figure>

### veCRV and veBAL Voters

To vote for the Quest, you must make sure your voting power is available and that previous votes are removed from their gauges (there's a 10 day cool down between each vote).

Voters can split their votes, and vote for multiple Gauges (and get rewards from multiple Quests) at once, by setting a smaller weight for each Gauge (ex: to vote for 2 Gauges, you can set 50% Vote Weight for each Gauge). Or you can set your gauge vote to 100%.&#x20;

Once you vote on a Quest your vote is set to the gauge for each new weekly period, until you reset it. That means you only need to vote on a Quest once to secure your position and receive rewards during the total duration.

### vlCVX and vlAURA Voters

To earn rewards from Quest you can delegate to Paladin, or vote manually on the Convex or Aura Snapshot space.\
\
When voting manually, you can distribute your voting weight across gauges. Rewards from Quests are always proportional to the share of voting power you set to the gauge.

{% hint style="success" %}

## Once you vote you're done ✅

Rewards will be available the following Thursday. [More info here](/trevee-quest/overview/claiming-rewards)
{% endhint %}


# Delegating your vote

Automated Gauge vote rewards

## Context

The Voting Market Maker concept is an essential part of the bribe economy as it enables the bootstrapping of gauge weight.

Market making in DeFi has been split into the capital coordination layer by AMMs, and the liquidity provisioning layer by individuals or professionals. The DeFi market-makers arbitrage the volume-to-depth opportunities between pools.

Due to the creation of liquid lockers, it is now possible to participate in the governance layer while retaining the ability to transfer and liquidate your position. This route was initiated by the “vlToken” model from Convex and created two new market-making opportunities. The first being delegated inflation management.

**Pros**

* Help mitigate the risk that individual players take control over base layers (Balancer or Curve) governances.
* Unifying rewards reduce gas cost, gives a better sight on dilution and vote efficiency&#x20;
* Delegate the quantitative work to algo + experienced team > arbitrage and enhanced yield
* Better coordination among voter / governance layers / multi-chain participants (e.g Tetu / Aura)

***

## How to delegate to Paladin

Visit <https://quest.paladin.vote/#/autovoter>
\
Click on Delegate, sign the transaction and that's it!

<figure><img src="/files/Jw4TnF40yf6SZrpI1yZr" alt=""><figcaption><p>Delegation page</p></figcaption></figure>

### Addresses

Paladin-voter.eth (deployed on Ethereum & Polygon)

0x68378fCB3A27D5613aFCfddB590d35a6e751972C


# Claiming rewards

Your vote incentives

<figure><img src="/files/3MamG1g34HsqmdsaDcP9" alt=""><figcaption><p>Your rewards will appear on the Claim app</p></figcaption></figure>

### <https://quest.paladin.vote/#/claim>

After successfully voting for a Quest, voters will receive rewards pro rata to their voting weight. This is the same for CVX and AURA voters who have delegated to Paladin's Auto voter.&#x20;

Every week rewards are available on Thursday mornings/afternoons depending on your timezone. Head to the Claim app in the side bar to find your rewards. The rewards are grouped together by ecosystem so if you have tokens from multiple Quests you'll be able to claim them all at once in one transaction.&#x20;

{% hint style="info" %}
You don't need to claim every week. Quest rewards accrue so you're free to claim your earnings anytime.
{% endhint %}


# Reward Distribution

**Rewards for voting in a Quest are calculated and distributed on a weekly basis.** For each period, the amount of rewards for a Quest voter is calculated based on the amount of rewards for each vote, set at the creation of the Quest, and the user's voting balance at the start of that period. In the case of a Ranged Quest, the reward per vote is based on the amount of vote received for the period.

(Note: as veCRV, veBAL & veLIT balances decrease over time, the rewards a user could receive for voting for a Quest will naturally decrease if the vote-escrowed lock is not updated).

**Since Quests have an objective target of votes (or a minimal objective and a maximal objective), only the votes that fill that amount (or the range) are counted for the reward distribution.** For example, if the maximum objective is 1 million votes, and the gauge receives 1.2 millions, only the first 1 million are rewarded. Votes are sorted from the oldest still active vote to the newest, prioritizing votes that are loyal to the gauge.

In the Curve, Balancer and Bunni voting systems, the vote of a user is counted every period as long as it is not changed, so **voters can vote for the gauge during the 1st period of a Quest, and be rewarded every period after without having to recast their vote.**

In case the minimum objective of the Quest is not reached at the end of the period, only the active amount of votes signalled to the gauge is used to calculate distribution, and the rest of the rewards can be withdrawn by the Quest creator or rolled over based on the system chosen by the Quest creator.


# Smart Contracts (V2.1)

## Quest V2.1 <a href="#quest-v2_1" id="quest-v2_1"></a>

QuestBoard veCRV : [0xAa1698f0A51e6d00F5533cc3E5D36010ee4558C6](https://etherscan.io/address/0xAa1698f0A51e6d00F5533cc3E5D36010ee4558C6#code)​​

MultiMerkleDistributor veCRV : [0x1327C85CE6F3C83faBC4f5C294F57ac05bCb51eB](https://etherscan.io/address/0x1327C85CE6F3C83faBC4f5C294F57ac05bCb51eB#code)

​​QuestBoard veBAL : [0xfEb352930cA196a80B708CDD5dcb4eCA94805daB](https://etherscan.io/address/0xfEb352930cA196a80B708CDD5dcb4eCA94805daB#code)​​

MultiMerkleDistributor veBAL : [0x1F7b4Bf0CD21c1FBC4F1d995BA0608fDfC992aF4](https://etherscan.io/address/0x1F7b4Bf0CD21c1FBC4F1d995BA0608fDfC992aF4#code)

QuestBoard veBAL Aura : [0xfd9F19A9B91BecAE3c8dABC36CDd1eA86Fc1A222](https://etherscan.io/address/0xfd9F19A9B91BecAE3c8dABC36CDd1eA86Fc1A222#code)​​

{% hint style="info" %}
(variation for veBAL sending \`DISTRIBUTE\` rewards to Aura instead of Balancer gauges)
{% endhint %}

MultiMerkleDistributor veBAL Aura: [0xaEB7993A35e297e42990c62D4E27470B201e8674](https://etherscan.io/address/0xaEB7993A35e297e42990c62D4E27470B201e8674#code)

QuestBoard veLIT : [0xDD3cbe4E0f10910eb435EA6DBe97469ABc3d7e9c](https://etherscan.io/address/0xDD3cbe4E0f10910eb435EA6DBe97469ABc3d7e9c#code)​​

MultiMerkleDistributor veLIT : [0x2DD0496690E7fbb7ca1E590986D5B9d2e58069Bf](https://etherscan.io/address/0x2DD0496690E7fbb7ca1E590986D5B9d2e58069Bf#code)

QuestBoard veFXN : [0x59AbF8642f4c7D8d3C5633eDCBBf6B12234FF02D](https://etherscan.io/address/0x59AbF8642f4c7D8d3C5633eDCBBf6B12234FF02D#code)​​

MultiMerkleDistributor veFXN : [0x8964c76B6f0253A77129D58cBA5D184d414d7C9a](https://etherscan.io/address/0x8964c76B6f0253A77129D58cBA5D184d414d7C9a#code)


# QuestDataTypes

## **PeriodState**

```
enum PeriodState {
  ZERO,
  ACTIVE,
  CLOSED,
  DISTRIBUTED
}
```

State of each Period for each Quest

All Periods are `ACTIVE` at creation since the voters from past periods are also accounted for the future period

## **QuestVoteType**

```
enum QuestVoteType {
  NORMAL,
  BLACKLIST,
  WHITELIST
}
```

Types of Vote logic for Quests

* `NORMAL`: basic vote logic
* `BLACKLIST`: remove the blacklisted voters bias from the gauge biases
* `WHITELIST`: only sum up the whitelisted voters biases

## **QuestRewardsType**

```
enum QuestRewardsType {
  FIXED,
  RANGE
}
```

Types of Rewards logic for Quests

* `FIXED`: reward per vote is fixed
* `RANGE`: reward per vote is a range between min and max, based on the Quest completion between min objective and max objective

## **QuestCloseType**

```
enum QuestCloseType {
  NORMAL,
  ROLLOVER,
  DISTRIBUTE
}
```

Types of logic for undistributed rewards when closing Quest periods

* `NORMAL`: undistributed rewards are available to be withdrawn by the creator
* `ROLLOVER`: undistributed rewards are added to the next period, increasing the reward/vote parameter
* `DISTRIBUTE`: undistributed rewards are sent to the gauge for direct distribution


# QuestBoard


# MultiMerkleDistributorV2


# Cross Chain

### Ethereum :&#x20;

#### veCRV :&#x20;

Root Proxy Arbitrum : 0xe38a880Bf996098887f7e33C6667d6807485385a

Root Proxy Polygon : 0x6920E13dcaD8F19fAA6F8AebF64C30C3b4600e4f

#### veBAL :&#x20;

Root Proxy Arbitrum : 0x532B795d9429b3f0c5b462567d8e0ece00374E86

Root Proxy Optimism : 0xa538B7F3C02c3f42e37fb0D557ee420dE7f9d4d8

Root Proxy Polygon : 0x6F01709CDB0b2DF3795f7DD74F5f0FaB9C204921

(Deprecated) Old Root Proxy Arbitrum : 0x42dE2101FA5eE922392eE5D752Ed7399022E6a53

#### veLIT :&#x20;

Root Proxy Arbitrum : 0x99284Cb5207A7f5fE43e7803315da73C55AE6Cd4

#### Misc :&#x20;

Root Multi Call : 0x76A3Eb63A20d656bcd1cE03E740D3D4691D29078

***

### Arbitrum :&#x20;

#### veCRV :&#x20;

Quest Board : 0x2Aa638596429e4734D872feC6e7a42e3f3D9fBf8

Child Proxy : 0x12Da7E0c469CEeC4EFADa2F5E8CAedCD3F3E6748

MultiMerkleDistributor : 0x089154A7E4C562d5998AB3D7Ca57B504A8912482

#### veBAL :&#x20;

Quest Board : 0x997523eF97E0b0a5625Ed2C197e61250acF4e5F1

Child Proxy : 0x1afA840938Cb67CDD1f1D748bdAc5FC68E82d9B1

MultiMerkleDistributor : 0x5E90Fb83Bc3B733D028454f7372A80b2977d7e6a

(Deprecated)

Old Quest Board : 0x8EdcFE9Bc7d2a735117B94C16456D8303777abbb

Old Child Proxy : 0x0DA8D50945c97309cc4e35F4fC593257Fed4391E

Old MultiMerkleDistributor : 0xB5757D5D93a26EaA3Bc6b0b25cb2364bE8d5b90E

#### veLIT :&#x20;

Quest Board : 0x04C70Abaa9D3eB14F090094eDc72D5581Dc65A22

Child Proxy : 0xA04A36614e4C1Eb8cc0137d6d34eaAc963167828

MultiMerkleDistributor : 0x4772ca88A5BFA9d196472b208566fee948D272B3

***

### Optimism :&#x20;

#### veBAL :&#x20;

Quest Board : 0x12Da7E0c469CEeC4EFADa2F5E8CAedCD3F3E6748

Child Proxy : 0x089154A7E4C562d5998AB3D7Ca57B504A8912482

MultiMerkleDistributor : 0x2e2f6aece0B7Caa7D3BfDFb2728F50b4e211F1eB

***

### Polygon :&#x20;

#### veCRV :&#x20;

Quest Board : 0x089154A7E4C562d5998AB3D7Ca57B504A8912482

Child Proxy : 0x2e2f6aece0B7Caa7D3BfDFb2728F50b4e211F1eB

MultiMerkleDistributor : 0xe0be968a0D6Bba03720DfDB2F3d4b3ED0083b4c7

#### veBAL :&#x20;

Quest Board : 0x0482A2d6e2F895125b7237de70c675cd55FE17Ca

Child Proxy : 0xA6Ed52EB3e39891CE5029817CdB5eAc97A2834B3

MultiMerkleDistributor : 0x3682518b529e4404fb05250F9ad590C3218E5F9f


# Sonic

Quest Rings veUSD : 0xA04A36614e4C1Eb8cc0137d6d34eaAc963167828

MultiMerkleDistributor Rings veUSD : 0x4772ca88A5BFA9d196472b208566fee948D272B3

Quest Rings veETH : 0xc20824bEd473525bA640f6c2Ae5D89469636DDCb

MultiMerkleDistributor Rings veETH : 0x0337Ca0a9E62560F1c3934a885B42c5B3a8ED680

Quest Rings veBTC : 0xb031DEDb0689059855f45B479BD29c0F964Ec97b

MultiMerkleDistributor Rings veBTC : 0xd672BCe6332e42B9185A83A7818f231e0444917D


# Audits

**Audit performed on Quest:**

[Spearbit Audit](https://github.com/PaladinFinance/Warden-Quest/blob/main/audit/Spearbit%20-%20Quest%20audit.pdf) (May 2022)


# BUILDING...

Something big is coming.


# Tokenomic (Migration)

## Migrate now on [http://migration.trevee.xyz](https://t.co/GHWcG4ZZaF)&#x20;

#### All [$PAL](https://x.com/search?q=%24PAL\&src=cashtag_click) that were Staked and Locked will be Mass-unlocked soon, during this time, you can claim your accumulated [$PAL](https://x.com/search?q=%24PAL\&src=cashtag_click) Rewards and migrate.

<figure><img src="/files/kbzpbD1isHhJJNwfhqBI" alt=""><figcaption></figcaption></figure>

The [$PAL](https://x.com/search?q=%24PAL\&src=cashtag_click) to [$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click) token migration is LIVE! Following Paladin’s rebrand to Trevee & governance proposals, this aligns the product & token with a simplified tokenomic: staking, buybacks, & excess revenue distribution.

[$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click) migration starts Today! You have 1 year to send old [$PAL](https://x.com/search?q=%24PAL\&src=cashtag_click) tokens to the migration contract.&#x20;

Option 1: Get 100%, Stake for 80 days&#x20;

Option 2: Get 75% tokens but fully liquid

<figure><img src="/files/2xeB4vwSKFDVCN2ZdDGz" alt=""><figcaption></figcaption></figure>

[$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click) tokens are natively deployed on Sonic and are also available on Ethereum  Plasma via LayerZero, with plans to expand to additional chains. Bridge on Stargate

[$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click)'s new tokenomics introduces a Safety Module! Stake [$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click) for Value Accrual from dApps Excess Revenue, with mandatory governance participation or delegation. Up to 30% slashing for security events. Earn now targets \~110% collateralization with [$scUSD](https://x.com/search?q=%24scUSD\&src=cashtag_click), [$plUSD](https://x.com/search?q=%24plUSD\&src=cashtag_click) & [$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click)!

<figure><img src="/files/DG1PqJVRgdGnwiTlGD4O" alt=""><figcaption></figcaption></figure>

The new Tokenomic also include the Reservoir mechanism: A sustainable emission flywheel! Dynamically drip 1% of reserve weekly (no fixed cap), replenished by Trevee Quest revenue buybacks to counter sell pressure.

Ties growth to revenue for long-term reflexivity. No more dilution!

<figure><img src="/files/w0mw7w5twOffOEdhRO7l" alt="" width="375"><figcaption></figcaption></figure>

The [$TREVEE](https://x.com/search?q=%24TREVEE\&src=cashtag_click) Token is available to trade on [Beets ](https://beets.fi/pools/sonic/v3/0x802e7175e8f2168f15b0cc57540169c61d63c9d4)(Sonic) an [Lithos ](https://lithos.to/pools/deposit?pool=0xc8319a16ae5ab41c2d715bd65045c9473b0ec4e0&__cf_chl_tk=DrXSbtpyNZeVsS2azFFSAiNdWrFvYl9FjJ2ZwFoj6LQ-1760974364-1.0.1.1-mswwgyf_eOAWoIFX.4_Ovrdw3SdCcSmoHVY4WZwXcdA)(Plasma)

***

Tokenomic Proposal: <https://gov.paladin.vote/t/pip-30-restructuring-paladin-tokenomics/617>

Migration Proposal: <https://gov.paladin.vote/t/pip-28-restructuring-paladin-migration/603>


# Governance

The Trevee Governance Forum is now on Discord:&#x20;

<figure><img src="/files/wFEwEdrvSWrLoWL8bcsg" alt=""><figcaption></figcaption></figure>

If you want to take part in the governance of Trevee, all you have to do is join the Discord and carefully follow the various discussions posted there.

### Trevee Improvement Protocol (TIP),

TIPs are about the most important modifications either on the protocol directly, on the DAO, on the constitution or on the governance framework.

### Trevee Governance Management (TGM),

TGMs are mainly about the treasury, the DAO organization and common governance proposals. It would regroup several topics.

### Trevee Integration Request (TIR),

TIRs are mainly focus on integrations and would regroup several topics

### Trevee Emergency Protocol (TEP),

Considering the importance of timing in certain situations, this category aims to prepare the DAO for any potential emergency action that might have to be done.

***

You can find all the **OLD** governance proposals mentioned above here: [https://gov.paladin.vote](https://t.co/H3NG9NZwmW)&#x20;


# Smart Contract

## Sonic

| Smart Contract                                                                                                       | Description   |
| -------------------------------------------------------------------------------------------------------------------- | ------------- |
| [0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac](https://sonicscan.org/token/0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac) | TREVEE Token  |
| [0x3ba32287b008ddf3c5a38df272369931e3030152](https://sonicscan.org/token/0x3ba32287b008ddf3c5a38df272369931e3030152) | sTREVEE Token |

## Ethereum

| Smart Contract                                                                                                      | Description  |
| ------------------------------------------------------------------------------------------------------------------- | ------------ |
| [0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac](https://etherscan.io/token/0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac) | TREVEE Token |

## Plasma

| Smart Contract                                                                                                                    | Description  |
| --------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| [0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac](https://plasmascan.to/token/0xe90fe2de4a415ad48b6dcec08ba6ae98231948ac?chainid=9745) | TREVEE Token |