# Circuit Protocol

Circuit is a non-custodial, auto-compounding protocol that maximizes your APY.

Circuit is a decentralized yield optimizer operating on the Mantle L2 modular EVM. We offer non-custodial vaults that allow users to earn compound interest on their crypto holdings. Circuit gives you the highest APYs without the hassle. Deposit, set-and-forget. Withdraw at any time.

We use smart contracts to automatically maximize your rewards as a liquidity provider through multiple decentralized finance protocols. These can range from AMMs, lending protocols and more.

Our vaults are non-custodial. Meaning you always have access and control of your funds. When you stake in our vaults, the vault sends your crypto to a strategy that begins earning yield. When you wish to withdraw, the vault takes back your original crypto assets plus any yield gained and returns it to you. Your assets are never held by a central entity.

Circuit takes advantage of the power of trustless and permissionless smart contracts to create a system that optimizes your returns while still giving you complete control of your funds.

Happy farming!


# Getting Started

How does it work?

There are a few steps before being able to interact with our vaults.

{% hint style="success" %}
Got questions? Ask them in our discord or telegram channels! 
{% endhint %}


# Setting up your wallet

Circuit Protocol is a decentralized finance (DeFi) protocol. This means that you are in control of your crypto. It also means that you are responsible for whatever happens to it. Please follow these best practices:

{% hint style="success" %}

* Never share your private keys.
* Never share your recovery phrases with anyone. Ever.
* Never input your recovery phrase or private key into a website or app, other than your wallet app when you are importing your wallet on a new device.
* Be wary of fake websites, giveaways, or other malicious acts. If it sounds too good to be true, it is.
* Download and install only the latest wallet version from official sources.
* Follow the setup guides of your wallet of preference carefully.
* Safely back up your recovery phrases, preferably somewhere offline.
  {% endhint %}

There are a number of wallets out there. You should research and make the decision for yourself as to which one is best. The most comonly used wallet is MetaMask.

## MetaMask<img src="https://29735739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FseojiZQF5Y5MagRVWqrP%2Fuploads%2F9zJIvLfGWsWjMjPJviSJ%2Fimage.png?alt=media&amp;token=c33d51c1-d6cf-4bac-8aad-50f2e3acd8c9" alt="" data-size="line"> <img src="broken://files/z9DGfmYNZUzWfs3oi7VS" alt="" data-size="original">

MetaMask is a browser-based wallet plugin. It supports Ethereum by default, and every other Ethereum compatible blockchain (EVM). For example, Avalanche, Fantom and Mantle. These networks are manually added. MetaMask is also compatible with hardware wallets like Ledger and Trezor.

* [Download MetaMask](https://metamask.io/download.html)
* [MetaMask FAQ](https://metamask.io/faqs/)


# Bridging to Mantle

After your wallet has funds, you will need to bridge those funds to Mantle.&#x20;

The official Mantle Bridge is [here](https://bridge.mantle.xyz/).&#x20;

Bridging will cost gas to perform the transaction. Ethereum can be quite expensive, so consider the costs beforehand.&#x20;

Gas is paid in ETH on Ethereum mainnet. However, on Mantle, gas is paid through MNT. You will need MNT to pay transaction gas on Mantle's L2, as well as pay for bridging funds off Mantle back to Ethereum.&#x20;

Still have questions? You can follow the official step-by-step guide by Mantle [`here`](https://www.mantle.xyz/blog/announcements/bridging-on-mantle-mainnet).


# Connecting your wallet to Circuit

Simple as the click of a button!

1. Click the Connect Wallet button
2. Select your wallet from the available options
3. Approve the connection
4. Done!


# Mantle

Circuit protocol is an official recipient of the Mantle Foundation Ecosystem Grants Program


# Vaults

## What are Circuit Vaults?

Our protocol uses a modular design approach. Each position uses a vault and strategy pair for yield farming. At this time, one vault has one strategy. In the future we may focus on developing a multi-strategy vault.&#x20;

The vault contract accepts user deposits, sends those deposits to the strategy contract (who puts them to work) and in return mints a receipt to the user. When the user wants their funds back, the vault accepts the receipt token from the user, burns it, then withdraws the appropriate amount of funds and sends those back to the user.&#x20;

Our vaults use automation to determine optimum compounding frequency. This allows the user to avoid lengthy and tedious tasks. It also socializes the gas cost of compounding.&#x20;

A typical process of compounding involves these steps:

1. Get LP token.&#x20;
2. Deposit LP token.&#x20;
3. Claim rewards.&#x20;
4. Sell rewards for token0.&#x20;
5. Sell rewards for token1.
6. Create new LP token with new token0 and token1.
7. Deposit LP token

These steps are repeated the entire duration of farming, sometimes multiple times a day! And each of these steps costs gas and time.

With Circuit Protocol, the user only needs to make one step!

1. Deposit LP in vault.

Thats it!

Our vaults allow users to avoid all that and instead simply deposit the LP into the vault. We handle the rest. Users only need to make one transaction, saving time and gas fees.&#x20;

## Vaults Expanded

Vaults can handle any asset. In the example above, it supposes an LP token similar to Pancakeswap or Sushiswap. But our strategies can involve more than just a masterchef and a DEX. We can make strategies for Money Market protocols like Compound or AAVE or Perpetual Futures protocols like GMX.&#x20;

Vaults do not 'lock'. Users can withdraw at any time, though some vaults may have a tiny 0.1% withdraw fee. Keep in mind that this fee is distributed to other users in the vault, not Circuit Protcol's dev team. This is only in place to prevent potential abuse of depositing-earning-withdrawing in a single transaction.&#x20;

## **What are cvTokens?**

A **cvToken (circuit vault token)** is a receipt from the vault. It is essentially interest-bearing, as the quantity of assets it represents increases overtime as the vault compounds. That means that there is no 1:1 ratio of assets and cvTokens, as the value of the cvToken increases with each compounding event in the vault.

cvTokens are prefixed with 'circuit'. A typical format is: "circuit - token name - platform".&#x20;

For example "circuit-LEND-MNT-Lendle".&#x20;

{% hint style="info" %}
Don't share cTokens! They are receipts and represent your deposited funds! Loss of the cToken = loss of deposited funds!&#x20;
{% endhint %}

## How often are vaults harveste&#x64;**?**

Our harvester bot checks for the profitability of harvesting a vault every 15 minutes.&#x20;

Profitability is determined by:&#x20;

`if (cost to harvest < calling fee) { harvest}`&#x20;

The calling fee is accounted for as part of the 4.2% profit fees deducted from yield profit. Anyone who calls the harvest function will earn this fee.&#x20;

If the cost to harvest is greater than the calling fee, it will not harvest the vault.&#x20;

Vaults that have not been harvested in 24 hours will automatically be harvested anyway. The maximum wait time is 24 hours.&#x20;

Profitability will increase based on more TVL being in the vault, as this will generate more collective farming rewards.&#x20;

## How do I redeem **cvTokens?**

When a user wishes to redeem the cvToken for the underlying crypto asset, they simply need to withdraw. Our contract will automatically burn the cvToken in exchange for the appropriate underlying asset. You get back the same number of tokens deposited + any gained yield.&#x20;

## **Are there fees?**

Short answer, yes.&#x20;

Circuit Protocol takes a modest 4.2% fee on **profits**. We never take a deposit fee from the deposited assets. We do this in order to pay for the cost of compounding the vault, as well as ensure the longterm sustainability of the protocol. We are actively developing this protocol! This fee percent is quite low in contrast to other protocols.

The profit fee is already built into the APY% you see. So if your vault is earning 100% APY, that's the number! You don't need to calculate anything else because our API is already doing that math for you.&#x20;

## What risks are there?

No DeFi protocol is without risk.

Our vaults use battle-tested code. But there are still inherent risks that all users should consider before interacting with DeFi.

* The value of the asset deposited in the vault may decrease over time. The quantity will always increase, but the $ value may decrease.&#x20;
* As with all smart contracts, the ultimate risk is that funds can end up stolen or unable to be withdrawn. We take steps to ensure this wont happen. But you should always consider the risk of failure with smart contracts.&#x20;
* External risks. Our vaults and strategy contracts may work perfectly well, only for the third party protocol we integrate with to have a bug of their own. This can, ultimately, lead to a loss of funds. We will do our best to ensure that the protocol we integrate with meets a level of standards, but ultimately those contracts are not ours, and we have no control over what other protocols do.&#x20;


# Cleopatra Vaults

For our vaults designed to farm on Cleopatra.exchange, a few points to bear in mind.&#x20;

When creating liquidity tokens (LP), Cleopatra's frontend will automatically help you create than stake LP in their farm.&#x20;

If you intend to instead farm with Circuit, you will want to create LP tokens then exit out of their transaction prompts.&#x20;

For example, looking at the screenshot below, users will want to "Add Liquidity", then click on the X to exit out of the transaction prompts.&#x20;

This will allow you to create the LP tokens and not stake them.&#x20;

From there, you can proceed to deposit the LP tokens into the respective Circuit vault.

<figure><img src="https://29735739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FseojiZQF5Y5MagRVWqrP%2Fuploads%2FxjEOmiWre42qn4XZjKS9%2Fimage.png?alt=media&amp;token=f5678896-96d6-474a-8960-039ebd5aa6bb" alt=""><figcaption></figcaption></figure>


# Boosts

Vault Boosts

Circuit's vault contracts mint receipt tokens on every deposit. These tokens are ERC-20 tokens, and can be used just like any other token. But remember, they are your receipt! Don't share them or give them away!&#x20;

One use-case with these tokens is BOOSTING!&#x20;

Boosting is when you can get additional rewards on top of the yield already being earned from depositing assets into the vaults.&#x20;

### How do I Boost?

Boosting occurs through a separate boost contract. If the vault is eligible, the app will say so.&#x20;

<figure><img src="https://29735739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FseojiZQF5Y5MagRVWqrP%2Fuploads%2FtUGedvAmpgxZvz6edKE5%2Fimage.png?alt=media&amp;token=47812c51-e6c9-484f-8c53-f0258384859c" alt=""><figcaption></figcaption></figure>

To Boost, simply deposit into the vault like normal (if you haven't already).&#x20;

On the vault page, scroll down to the Boost card

<figure><img src="https://29735739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FseojiZQF5Y5MagRVWqrP%2Fuploads%2FP8knktdQnXk8ET3wmmuO%2Fimage.png?alt=media&amp;token=bb976b5d-094f-4070-982a-893bc482530e" alt=""><figcaption></figcaption></figure>

Then, simply deposit as many vaul tokens as you like. The default is 'max' to earn as much additional rewards as you can.&#x20;

The click 'BOOST VAULT'! That's it!


# Audit

Our core contracts have been audited by SourceHat&#x20;

The contents of the audit can be found here: <https://sourcehat.com/audits/CircuitProtocol/>


# Contract Addresses

You can always find the address of the deployed vault or strategy through our app. Just click the vault page in question and scroll down to the Strategy Description card. Then click on the relevant button.

<figure><img src="https://29735739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FseojiZQF5Y5MagRVWqrP%2Fuploads%2F3Ufqts1h09pGJgv4DkYE%2Fimage.png?alt=media&amp;token=3f9415c6-934d-4861-8745-9e157625747d" alt=""><figcaption></figcaption></figure>

Choose below for further links

[Vaults, Strategies, Boosts](/products/contract-addresses/vaults-strategies-boosts)

[Infrastructure](/products/contract-addresses/infrastructure-contracts)&#x20;


# Vaults, Strategies, Boosts

[Boosts](/products/contract-addresses/vaults-strategies-boosts/boosts)

[Moe Vaults](/products/contract-addresses/vaults-strategies-boosts/moe-vaults)

[Lendle Vaults](/products/contract-addresses/vaults-strategies-boosts/lendle-vaults)

[KTC Vault](/products/contract-addresses/vaults-strategies-boosts/ktc-vault)


# Boosts

| ID                      | Boost Contract                             |
| ----------------------- | ------------------------------------------ |
| cvt\_lendle-wmnt-looped | 0xCfAb453ac159FFF8Af0A61cd1a50Fb9B9377917b |
| cvt\_lendle-weth-looped | 0x1cC89504a77be95442e8CFbED8010A51a385c31a |
| cvt\_lendle-usdt-looped | 0x466d27347A97ACa51b25FEd5D33E10AAe92b466A |
| cvt\_lendle-usdc-looped | 0xF948bB87664B9A9306fc108C786787E2F1129285 |
| cvt\_lendle-meth-looped | 0x4eBfee1D60c59BE90fcAe4f7c240C41957E54e0b |
| cvt\_moe-meth-weth      | 0xBa81f677609Ab095acd9c1d549EA3BfFbd047047 |


# Moe Vaults

| ID            | Vault                                      | Strategy                                   |
| ------------- | ------------------------------------------ | ------------------------------------------ |
| moe-joe-moe   | 0x6f73203E8Bf6a87720135c2f79aFfE7D2dF5D430 | 0x66851184B2D6367040adC7013D07eE3Ae54D7d60 |
| moe-usdt-moe  | 0x15937B6342415145B559FDD1d112BC7132549b85 | 0xE63a560E4475Af22Ae773F3aC88e905c604ea63c |
| moe-moe-wmnt  | 0xa3647389cf2bF9279ab239d3710bB8a2eFE0BC8B | 0xf089E4b54d0E3B12767356cC1eFa6b583B047713 |
| moe-ktc-wmnt  | 0x76708cD9Db069B5250995790D589AEb6a6D461D4 | 0x4aaf4eADe2C408925f9B51C78099317EeD647ACE |
| moe-wmnt-wbtc | 0x7196E8eF846Fe146F1d1c4B35eb6B8D60ee6234a | 0x91d8dc1D28Dcc0Ac6C5497502fBce95c55567bd7 |
| moe-usdt-lend | 0x7680868ec18Dae8f7dAF1D5dC5ECB1A9aa08F80d | 0x0c56F8Dd36Fd613918a7311382be6661856C1EfE |
| moe-lend-wmnt | 0x6CeaC8F90B7cAA311E025480503Bb0020B66f22A | 0x7349c007abAAc14BDEF08a1eE43DA97A89d6a630 |
| moe-joe-wmnt  | 0x0Fda2Aa0ae7A16c8065Cb08a7f4328fC7450716a | 0x986Dc6cA99acE0bA8FE5b61e0412C02256270e36 |
| moe-usdt-minu | 0xe8Ba7DbaEc78717113a23E3aBda7b22C1e28b078 | 0xF82eB0afA9d9bd6153695AeCF83875FFEF97Ca08 |
| moe-minu-wmnt | 0x6DEC755Effd9A7663995DC7Cf90fc6Cc8A52be0C | 0x4Ca43a50f87658D87C0d66a2517c207b293A9795 |
| moe-wmnt-weth | 0xEE2e6C7E355bdcBfd60ed1fB858e10D431f3e6ca | 0x8a0DE398ca6b8959399Cf6561edc72C4ef31016D |
| moe-usdt-wmnt | 0x43FcfD956826A8c3A545c742C316B824470AB921 | 0x3AB8afA97eD64240B9BCb867833094D75eFeE518 |
| moe-usdc-usdy | 0xc425A0fC1e62bEDa428Ff628597dC8EA1C13d0e4 | 0x7B9E34f0Eb3EDA43d34112A6cBA2039Cd2EDcF45 |
| moe-usdt-weth | 0x2eBCE2007B5427F146323DE7f5812a7cAf51Be7D | 0x6e27bF838e09760310d395015f2af65aDE62E2fc |
| moe-usdc-wmnt | 0xB892c7642f3ad35174Efa8deEE3910AfA5bC7d71 | 0x5E13D463c5dC546b5559cD0A981574fbEd34cb5b |
| moe-usdc-weth | 0x3E88bCEdd8B3B26aF961EF9aBf2f702508D25bFa | 0x69A247A883Ece54F30403cA67127f736F808a564 |
| moe-meth-weth | 0x16FA0C5f3eA649259C02c075dbA1C31fc66ea4E0 | 0x6A583373144B3247229215FF3F228Ef806250b7b |
| moe-usdc-usdt | 0x671b28c4337A248b2fF71162267BBe5b00123F4A | 0xC0994C701D2B470831DFb77879b2616914c234B9 |


# KTC Vault

| ID             | Vault                                      | Strategy                                   |
| -------------- | ------------------------------------------ | ------------------------------------------ |
| ktx-mantle-ktc | 0x5b5EDFEC1D3d1906a71EBC23BD2b040302579388 | 0xF9B40F4eBb68bD33CB5A8bFdD0a9aa0bd90805AF |


# Lendle Vaults

| ID                  | Vault                                          | Strategy                                       |
| ------------------- | ---------------------------------------------- | ---------------------------------------------- |
| ~~lendle-lend-mnt~~ | ~~0xC8f1664b9725Fd0a0A2Ad288D82F2dFB53B56F4c~~ | ~~0x28a1446368566FEDBec5a042A0105e96F5142f29~~ |
| lendle-usdc-looped  | 0x5323E58f8A957823936d41637acB87311614104D     | 0xC19d385a1418b0A0034c742305B6DfC6B2Fc0400     |
| lendle-usdt-looped  | 0xa7cF0544fDaC7e173fb73733429AaE8a27Cb2637     | 0xe927c9a9b9a2aa58468e2326e43d087d09ad4216     |
| lendle-wbtc-looped  | 0x693cb6bA442A19226f15233ab1D5a14530170398     | 0x906d083552275085fdd3247e8a99932ad5708c5e     |
| lendle-weth-looped  | 0x803903BfCF6Aa63620F3598b1C60ccbA9C752276     | 0xb10e2a7352d879209d1e6fafe42d3d0d7bd2256f     |
| lendle-wmnt-looped  | 0x2fA81D08d060c173305800D0bB72ebF71Ba2162B     | 0x65De3eA95F4BA7aa3734937df640A744D5C88C6A     |
| lendle-meth-looped  | 0x96520c74eF5CD3b4197871387cdd7C827463aBBb     | 0x9AA49112c0A2e3FAEb51c3D4407Ec3C664099fbA     |


# Infrastructure Contracts

| Name                        | Address                                    |
| --------------------------- | ------------------------------------------ |
| Multicall                   | 0xb2998D5Ab8349c15728B2953F72f1661259501d4 |
| CircuitLastHarvestMulticall | 0x27310869A09840C0E2D1ec0644976a9c7e59e4F0 |
| CircuitPriceMulticall       | 0xf5B7522c64f2dbAAD9742a1D6A16dC467cEd1561 |
| CircuitStrategyMulticall    | 0x36Dd6B8dC12AdFD7c7EC66E68f030fb8E261c16F |
| CircuitAppMulticall         | 0x9b49F97D3E3d105a4691C06270896cCF9ebde1E0 |
| CircuitFeeConfigurator      | 0x7AEfd4C1b60DE7Dbe9791ad7142F54F3546a24D5 |
| MulticallV3.sol             | 0xdd1Cd46EA5B7391553ba59a3cDE98AC6af33eD30 |


# Social Links

App: <https://www.circuit.farm>

Twitter: <https://twitter.com/circuitprotocol>

Telgram: <https://t.me/+T1rRb_lQv3w4ODhh>

Discord: <https://discord.gg/pv3uHZTS8e>


# Media Kit

Logo Circuit Title SVG

{% file src="/files/VtL96qkMxs1NhPOusbFt" %}

Logo Circuit Title Black and White SVG

{% file src="/files/oPTPWBOZeyaN5EQGhu0b" %}

Logo Circuit Icon SVG

{% file src="/files/3UvP8k4rnDYPeLBIZb4D" %}

Circuit Logo Green SVG

{% file src="/files/S6EnrETgbGjV5nELL59w" %}

Logo Icon Black and White PNG

{% file src="/files/mEUpTU6q1FRh5yyPNLJY" %}

Social Link PNG

{% file src="/files/UP5Jwy1Q86MSX3GgXMYD" %}


# Legal Disclaimer

##

{% hint style="danger" %}
Circuit Protocol does its best to ensure the code works as intended. Smart contracts and DeFi carry inherent risk. Interacting with Circuit Protocol, or any DeFi protocol, may, in the worst case, result in a complete and permanent loss of funds.&#x20;
{% endhint %}

## Legal Disclaimer

Legal Disclaimer Please carefully read this disclaimer before using <https://circuit.farm> and/or any of its sub-domains (referred to as the "Website").By using the Website, you confirm your acceptance of this legal disclaimer and agree to comply with its terms. If you do not agree, please refrain from using the Website.

&#x20;As a condition to accessing or using the Services or the Site, you represent and warrant to the Website the following:

1. if you are entering into these Terms as an individual, then you are of legal age in the jurisdiction in which you reside and you have the legal capacity to enter into these Terms and be bound by them and if you are entering into these Terms as an entity, then you must have the legal authority to accept these Terms on that entity's behalf, in which case "you" (except as used in this paragraph) will mean that entity;
2. you are not a resident, national, or agent of the United States, Iran, Cuba, North Korea, Syria, or the Crimean Region of the Ukraine or any other country to which the United States embargoes goods or imposes similar sanctions (collectively, "**Restricted Territories**");
3. you are not a member of any sanctions list or equivalent maintained by the United States government, the United Kingdom government, the European Union, or the United Nations (collectively, "**Sanctions Lists Persons**") and you do not intend to transact with any Restricted Person or Sanctions List Person;
4. you do not, and will not, use VPN software or any other privacy or anonymization tools or techniques to circumvent, or attempt to circumvent, any restrictions that apply to the Services; and
5. your access to the Services is not (a) prohibited by and does not otherwise violate or assist you to violate any domestic or foreign law, rule, statute, regulation, by-law, order, protocol, code, decree, or another directive, requirement, or guideline, published or in force that applies to or is otherwise intended to govern or regulate any person, property, transaction, activity, event or other matter, including any rule, order, judgment, directive or other requirement or guideline issued by any domestic or foreign federal, provincial or state, municipal, local or other governmental, regulatory, judicial or administrative authority having jurisdiction over Circuit Protocol, you, the Website or the Services, or as otherwise duly enacted, enforceable by law, the common law or equity (collectively, "**Applicable Laws**"); or (b) contribute to or facilitate any illegal activity.<br>

### Information not advice  <a href="#information-not-advice" id="information-not-advice"></a>

The information provided on the Website is not intended as investment advice, financial advice, trading advice, or any other form of advice. Our team offers the Website as a public service and disclaims all liability for damages arising from the use, reference to, or reliance on any information within the Website. While efforts are made to update the information periodically, no guarantee is provided regarding its accuracy, completeness, or timeliness.

### Usage and investment risks <a href="#usage-and-investment-risks" id="usage-and-investment-risks"></a>

The Website is not liable for losses, damages, or claims resulting from user mistakes, software issues, technical failures, security problems, or actions of third parties. Investing in cryptocurrencies carries risks, and the information on the Website does not guarantee protection against financial loss. Users are responsible for understanding and assessing these risks and making informed decisions when using the Website. Decentralized finance is new and risk-prone.  Users of the Website accept the risk of losing up to 100% of their cryptocurrencies.&#x20;

### Compliance with tax obligations  <a href="#compliance-with-tax-obligations" id="compliance-with-tax-obligations"></a>

Users are solely responsible for determining their tax obligations related to cryptocurrency holdings. The Website's owners and contributors are not liable for determining user tax liabilities arising from transactions.

### No warranties  <a href="#no-warranties" id="no-warranties"></a>

The Website is provided "as is" without any warranties regarding its functionality, content, data, materials, or services. The Website's operation may be fully or partially disabled without prior notice.

### Security  <a href="#security" id="security"></a>

Security audits do not eliminate all risks. The Website is not guaranteed to be secure or free from bugs or viruses.

### Limitation of liability  <a href="#limitation-of-liability" id="limitation-of-liability"></a>

Unless required by law, the Website's owners and contributors shall not be liable for any damages, including but not limited to loss of use, profits, or data, arising from the use of the Website.

### Arbitration  <a href="#arbitration" id="arbitration"></a>

By using the Website, you agree to arbitrate any dispute related to the Website or this disclaimer, except for disputes involving copyrights, trademarks, trade names, trade secrets, or patents.