Projects

Contributors

Events

Resources

Docs

Articles

Canto, built to deliver on the promise of DeFi.

Canto

large_profile header.png

medium_profile header.png

small_profile header.png

thumbnail_profile header.png

profile header.png

logo green.png

About

medium_ava-03.png

small_ava-03.png

thumbnail_ava-03.png

ava-03.png

small_logo + name green-1.png

thumbnail_logo + name green-1.png

logo + name green-1.png

The [Canto Bridge](https://bridge.canto.io/) allows you to bridge assets to Canto from Ethereum or Cosmos Hub. It also supports bridging back to Ethereum.

## Ethereum <-> Canto

At present, the Ethereum <-> Canto bridge supports ETH, USDC, and USDT transfers.

### Ethereum -> Canto

To bridge assets from the Ethereum network to the Canto network, follow these steps:

Navigate to [bridge.canto.io](https://bridge.canto.io) and connect your MetaMask wallet, making sure you are on the Ethereum network.

Before bridging assets to Canto, you will be asked to generate a Canto public key, which is associated with your Ethereum address. You will only need to do this once per wallet. This is so you can sign Canto transactions from that Ethereum address. There is no interaction with private keys. 

![image 2.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_2_26198758f8.png)

Select the token you would like to bridge and input the quantity. Quantities less than 1 must include a 0 in the ones place value (e.g. 0.99).

Confirm the approval transaction in your wallet to approve transfer of the asset to the bridge.
Sign the message in your wallet to confirm the transfer.

![image 3.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_3_28ddd9b5c5.png)

Assets bridged to Canto will arrive on the native Canto blockchain 96 ETH blocks (20 minutes) after the Ethereum transfer is confirmed. If you want to use the Canto Lending Market, Canto DEX, and other DApps, you must convert your assets to the Canto EVM.

## Canto -> Ethereum

Bridging from Canto to Ethereum is possible via Gravity Bridge. To bridge assets on Canto back to Ethereum, you must have:

An IBC wallet (such as Keplr Wallet)
An Ethereum wallet such as MetaMask

You can only bridge assets on the native Canto blockchain back to Ethereum. If your assets are on the Canto EVM, you must convert them first.

Once you are ready to bridge from Canto to Ethereum, follow these steps:

Navigate to [bridge.canto.io](https://bridge.canto.io) and connect your MetaMask wallet, making sure you are on the Canto network.

Select Canto as the from network and Gravity Bridge as the to network.

![image 4.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_4_af37827eb4.png)

Select the token you wish to bridge and enter an amount.

![image 5.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_5_84282e6296.png)

Open your Keplr wallet and change the network to Gravity Bridge. Copy your Gravity Bridge address and paste it into the bridge interface:

![image 6.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_6_ad534b8fd9.png)

Click send token and sign the transaction in MetaMask. After a few minutes, you should see the tokens in your Keplr wallet at the address you provided.

![image 7.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_7_42869186dc.png)

Once the tokens are in your Keplr wallet, bridge from Gravity Bridge to Ethereum using the Gravity Bridge portal.

>To bridge assets from Gravity Bridge to Ethereum, you no longer need $GRAV tokens to pay gas. Fees are paid in whatever token you are bridging. Select your fee option in the Gravity Bridge portal carefully, the 24 hour fee level for example will take about 24 hours.

![image 8.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_8_38557870db.png)

## Cosmos Hub -> Canto

At present, the Cosmos Hub -> Canto bridge only supports $ATOM by means of IBC transfer.

Do not attempt to transfer $ATOM to the Canto address in your Keplr wallet. Follow the instructions below.

### Cosmos Hub -> Canto

To bridge $ATOM from the Cosmos Hub network to the Canto Network, follow these steps:

Navigate to  and connect your MetaMask wallet, making sure you are on the Ethereum network.

Before bridging assets to Canto, you will be asked to generate a Canto public key, which is associated with your Ethereum address. You will only need to do this once per wallet. This is so you can sign Cosmos transactions from that Ethereum address. There is no interaction with private keys. 

![image 9.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667920254/image_9_0b4debee37.png)

Add the Canto network to your Keplr wallet.

![image 10.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667920254/image_10_8819ae78fb.png)

Copy your Canto native address.

![image 11.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_11_3a36ef6e7d.png)

Make sure "Show Advanced IBC Transfers" option is toggled on in Keplr wallet settings.

![image 12.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_12_76800373b7.png)

 In Keplr, switch to the Cosmos Hub. Then click IBC Transfer.

![image 13.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_13_4a406bcd25.png)

Select “Canto Mainnet” as the destination chain. If bridging for the first time, add Canto by clicking "New IBC Transfer Channel", selecting Canto Mainnet and entering channel-358.

![image 14.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919492/image_14_b257421f55.png) 

![image 15.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919492/image_15_847411e8f2.png)

Enter the amount you want to transfer and complete the transaction. Your $ATOM should arrive after a few minutes.

![image 16.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919492/image_16_c454ef25d7.png)

Assets bridged to Canto will arrive on the native Canto blockchain.

## Gravity Bridge <-> Canto

This guide allows you to move ETH, USDC, and USDT from Canto to the Cosmos ecosystem and back using IBC, without having to send funds to Ethereum.

### Gravity Bridge -> Canto

Do not attempt to transfer Gravity tokens to the Canto address in your Keplr wallet. Follow the instructions below.

To bridge assets from Gravity Bridge to the Canto network, follow these steps:

Navigate to  and connect your MetaMask wallet

![image 17.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_17_317d201c30.png)

Copy your Canto native address by clicking on it

Navigate to [bridge.canto.io](https://bridge.canto.io) and connect your Keplr wallet

Select Gravity Bridge as the source chain and Canto as the destination.

![image 18.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919492/image_18_6fc96a553d.png)

Connect your Gravity Keplr wallet. Do not connect Keplr to Canto instead, click the lock icon under 'transfer address' and paste your Canto native address there.

Select the token you would like to bridge and input the quantity. Quantities less than 1 must include a 0 in the ones place value (e.g. 0.99).

Sign the message in your wallet to confirm the transfer.

Assets bridged to Canto will arrive on the native Canto blockchain within 60 seconds of the Gravity Bridge transaction being confirmed.

## Canto -> Gravity Bridge

You will need the following to bridge from Canto to Gravity Bridge

An IBC wallet (such as Keplr Wallet)

If your assets are on the Canto EVM, you must [convert them](https://canto.minipent.xyz/resources/convert) first.

Once you are ready to bridge from Canto to Gravity Bridge, follow these steps:

Navigate to [bridge.canto.io](https://bridge.canto.io) and connect your MetaMask wallet, making sure you are on the Canto network.

Select Canto as the from network and Gravity Bridge as the to network.

![image 19.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_19_523071893e.png)

Select the token you wish to bridge and enter an amount.

![image 20.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_20_80bedfbc7e.png)

Open your Keplr wallet and change the network to Gravity Bridge. Copy your Gravity Bridge address and paste it into the bridge interface:

![image 21.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919494/image_21_f15b7a100d.png)


Click send token and sign the transaction in MetaMask. After about a minute, you should see the tokens in your Keplr wallet at the address you provided.

![image 22.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919493/image_22_fae061bae0.png)

Once the tokens are in your Keplr wallet, bridge from Gravity Bridge to any Cosmos ecosystem destination using the .


Bridge assets to Canto from Ethereum or Cosmos Hub, and back to Ethereum

Bridging Assets

Assuming you have already installed and configured  in your browser of choice, start by adding the Canto network:

- Open the MetaMask extension
- At the top of the interface, click on the network you are connected to e.g. "Ethereum Mainnet".
- Click on "Add Network":

![image 1.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667919329/image_1_0002a81304.png)

Enter the following RPC settings:

- Network Name: CANTO
- New RPC URL: 
- Chain ID: 7700
- Currency Symbol: CANTO
- Block Explorer URL: 

Alternatively, you can connect to the Canto network with the following RPC settings:

- Network Name: CANTO
- New RPC URL: 
- Chain ID: 7700
- Currency Symbol: CANTO
- Block Explorer URL: 

- Network Name: CANTO
- New RPC URL: 
- Chain ID: 7700
- Currency Symbol: CANTO
- Block Explorer URL: 

If using the Canto Testnet, connect with the following RPC settings: 

- Network Name: Canto Testnet
- RPC URL: 
- Chain ID: 740
- Currency Symbol: CANTO

After saving the network, you will be able to connect to it at any time using the dropdown menu.

If you skip this step and attempt to connect to applications on, a MetaMask prompt will appear allowing you to add the network with a single click.

As an EVM compatible chain, you can connect to the Canto network using MetaMask.

Connect to Canto

When users land on the site, they will see all available pools to provide liquidity for. To begin with, Canto will go live with 5 pools; Canto/Note, Canto/Eth, Canto/Atom, Note/USDC, and Note/USDT. In the table, the asset, TVL, current wallet's position and % share of the pool will be displayed.

![image 60.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517481/image_60_c50bf30f0b.png)

### Add Liquidity

In order to add liquidity to the Canto LP Interface: 
1. Click on the pool that you are looking to add liquidity to. This will open the "Add Liquidity" modal:

![image 61.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_61_8e76792ac1.png)

2. If necessary, enable the tokens which you wish to add liquidity for on the Canto network. 

![image 62.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_62_ee8adf529b.png)

3. After completing the enable transaction, enter how much liquidity you wish to provide, and click the "Add Liquidity" button.

![image 63.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_63_81ec1944fd.png)

4. You will then be shown the details around the transaction, such as the current exchange rate between the two tokens, the share of the pool you will own, and the amount of LP tokens you will receive. Once you are certain you wish to make this transaction, click "confirm".

![image 64.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_64_95b5f9fd7d.png)

5. Once the transaction is complete, you will see all the pools you are currently providing liquidity to under the "current position" section.

![image 65.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517482/image_65_2c30e58897.png)


### Remove Liquidity
In order to remove liquidity from the Canto LP Interface: 

1. Select the pool from your current positions that you wish to remove liquidity from. Then select the remove button.
![image 66.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_66_8f82c52701.png)

2. Enable the Canto network to remove liquidity for that specific pool. 
![image 67.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_67_c0b3441fde.png)

3. Enter the percent of liquidity you wish to remove, and click the remove liquidity button.

![image 68.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_68_f2d8497409.png)

4. You will then see details about the transaction. Once you are certain you want to make this transaction, press confirm.

![image 69.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668517479/image_69_58cba8386e.png)


5. Once the transaction is complete, you will see your current position in that pool updated.

![image 70.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668520182/image_70_a8258015b6.png)

medium_ava-01.png

small_ava-01.png

thumbnail_ava-01.png

ava-01.png

The Canto LP Interface allows users to provide liquidity and receive LP tokens.

Providing Liquidity

## Metrics

Here is a breakdown of the metrics that are displayed in the Canto Lending Market:

### Lending Market Home Page

![image 52.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521680/image_52_8d290b467b.png)
_Lending Market Home_

1. Total Supply Balance

![image 53.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_53_5a813642aa.png)
_The supply balance is the sum of all assets supplied, converted into $NOTE_

2. Total Borrow Balance

![image 54.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_54_b58228fba6.png)
_The borrow balance is the sum of all assets borrowed, converted into $NOTE_

3. Borrow Limit Meter

![image 55.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521680/image_55_28ba8dd130.png)
The borrow limit meter shows how much of your total borrow limit you are currently using. This limit is calculated by summing all of the supplied tokens, along with their individual collateral factors and converting into $NOTE. Beware of using more than 80% of your total borrow limit since going over may lead to liquidation.

4. Current Supplied Assets

![image 56.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_56_7c258b6199.png)
_Supply Table_

The currently supplying row consists of the asset name, apy (top: supply apy, bottom: distribution apy), balance (top: token supplied, bottom: token supplied balance in $NOTE), and a collateral switch indicating if this asset is currently being used as collateral in the lending market. 

5. Available Assets to Supply

![image 57.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_57_2a00432c36.png)
_Available Supply Table_

The available supply table shows the markets you have not entered yet. Each row contains the asset name, supply APY, total wallet balance, and the collateral switch to indicate if this asset is used as collateral. (An asset that is not currently supplied may have this switch turned on if it is currently being borrowed, since any borrowed asset is automatically used as collateral)

6. Current Borrowed Assets

![image 58.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_58_8dd85fb871.png)
_Borrowing Table_

The current borrowed assets are shown to see which markets you are currently borrowing from. Each row consists of the asset name, total borrow apy (accrued interest) on the asset, balance in terms of the token denomination and $NOTE, as well as the percentage of your total borrow limit that this market is using.

7. Available Assets to Borrow

![image 59.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521679/image_59_0132fd1fe4.png)
_Available Borrow Table_

The available borrow table displays which assets are currently available to borrow. Each row contains the asset name, borrow APY, user wallet balance, and total liquidity in the pool in terms of $NOTE. 

A breakdown of the metrics that are displayed in the Canto Lending Market

Lend/Borrow Metrics

This allows you to contribute to the blockchain and place votes on changes that will directly impact the Canto community. 

![image 25.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523196/image_25_5645f9d2db.png)
_Governance Landing Page_

#### Proposals
When entering the governance page, a list of all completed and ongoing proposals are shown. The title of the proposal, start time, end time, and a bar representing the current votes is shown in each block. For more information on each proposal, click on the proposal and a modal will open.  


![image 26.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_26_b81fc575ed.png)
_Proposal Details_

In the proposal modal, you can see more in depth information about the proposal including the description, individual vote count, and thresholds for the proposal. If the vote has ended, you will not be able to vote, and the bottom of the modal will display voting has ended. 


![image 27.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_27_1b1305edc1.png)
_Voting Ended_

#### Voting
If the proposal is still ongoing, and you have staked canto at staking.canto.io, you are eligible to vote on the active proposal. You will see 4 options to choose from when voting, yes, no, veto, and abstain.


![image 28.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_28_93ee562867.png)
_Voting Options_

After selecting an option, you can click vote and metamask will open with the transaction to sign.

![image 29.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_29_86ab58cc5f.png)
_Voting_


![image 30.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_30_0d1b6e4546.png)
_Metamask Transaction_

After signing the vote, you will see a success message and the screen will refresh with your new vote added to the proposal.

![image 31.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668523195/image_31_628bec9439.png)
_Vote Success_

small_Screen Shot 2022-11-13 at 7.51 1.png

thumbnail_Screen Shot 2022-11-13 at 7.51 1.png

Screen Shot 2022-11-13 at 7.51 1.png

The Canto governance page is a place where all users who have staked Canto can vote on proposals.

Governance

### Supplying Tokens

To supply an asset, click on a row in the available supply table and the supply modal will open.

![image 36.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521026/image_36_33e6d13c63.png)
_Supply Modal_

In order to supply any asset, it must first be enabled by the market by clicking the enable button. Once approved, the asset is ready to be supplied. You can either manually type the amount of asset you wish to supply, or click the max button to supply your entire wallet balance of this asset. 
![image 37.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_37_2c64b4f3a3.png)
_Supply Modal_

Once a value is inputted, the modal will update with the hypothetical borrow limit as well as the hypothetical borrow limit used if this transaction were to be made. If you are ready to supply this asset, click the supply button and Metamask will open with the transaction ready to sign. 
![image 38.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_38_3449e06812.png)
_Metamask Confirmation_

Click confirm in Metamask and the transaction will be validated. The modal will update with the transaction status letting you know when the supply has gone through. After the supply has been validated, you will receive cTokens in your Metamask wallet, the total of which depend on the exchange rate between the underlying asset and the cToken. These cTokens are used to track your total supply in the market and can be used to redeem your supply balance in the withdraw modal.

![image 39.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521026/image_39_3ee63891c0.png)
_cToken in Metamask_

### Withdrawing Supply

If you wish to withdraw any of your supply balance, you can click on the currently supplying row and switch to the withdraw tab.

![image 40.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_40_d2de3157b3.png)
_Withdraw Modal_

The withdraw tab will show how much of the asset you are currently supplying, and you can manually type in the amount desired to be withdrawn, in terms of the underlying token, or you can click the max button to withdraw your entire balance. (You will not be able to withdraw if the hypothetical borrow limit used will go over 100% as this will result in liquidation). The withdraw modal will also automatically update the hypothetical borrow limits as the value in the withdraw input changes. 

![image 41.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_41_658972ddf5.png)
_Withdraw Modal_

Once you are ready to withdraw, click withdraw and Metamask will open with the transaction ready to be signed and verified. After the transaction is completed, you will see your cToken balance of this asset decrease and the underlying token balance increase by the amount you have requested to withdraw.

### Collateralizing

In order to borrow any asset from the lending market, you must collateralize your supply. The amount you can borrow is directly related to the collateral factor of each specific token and how much you have supplied in the market. To collateralize an asset, click on the collateral switch in the supply rows. 
 
![image 42.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521026/image_42_8d926932f0.png)
_Collateral Modal_

In this modal, you can click use 'asset' as collateral and the transaction will open up in Metamask. After the transaction has been verified, you will see the switch in the lending market flip. 

![image 43.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_43_ffd7d3d7c3.png)
_Supply Row With Collateral On_

### Decollateralizing

If you would like to decollateralize an asset, the same switch can be clicked and this modal will open: 
![image 44.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_44_bb4a4c9401.png)
_Collateral Modal_

In this modal, you can click disable 'asset' as collateral and the transaction will open in Metamask. This button will not be available if performing this action will put you above 80% of your borrow limit, since this may lead to liquidation.
![image 45.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521026/image_45_2838ac9e2a.png)
_Collateral Modal_

### Borrowing
In order to borrow an asset, there must be enough supply in the lending market to borrow against. To borrow, click on the row in the available borrow table. This will open the borrow modal.
![image 46.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_46_545a0e0067.png)
_Borrow Modal_

In this modal, you can type in a manual amount to borrow or click the 80% limit button to use 80% of your total borrow limit. More than this may be manually entered, but be careful of using too much of your borrow limit. As the value in the input changes, the hypothetical borrow limits are also updated to reflect your position if this transaction were made. 
![image 47.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_47_a06a1aeb41.png)
_Borrow Modal_

Once you are ready to borrow this asset, click borrow and the transaction will open up in Metamask to be signed and verified. (Note that any asset borrowed will automatically switch this asset to "collateralized")

### Repaying Borrows

To repay a borrowed asset, click on the currently borrowing row and switch to the repay tab. 

![image 48.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_48_2837bdccc6.png)
_Repay Modal_

In order to repay any asset, it must first be enabled by the market by clicking the enable button. Once approved, the asset is ready to be repaid. You can either manually type the amount of asset you wish to repay, or click the max button to repay your entire borrow balance of this asset (if you currently do not have enough to pay back the entire borrow balance, the max button will input your entire wallet balance instead). 
![image 49.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_49_5762e325c0.png)
_Repay Modal_

Once a value is inputted, the hypothetical borrow limits will update and when you are ready to repay the borrowed asset, click repay. This will bring the transaction to metamask where it can be signed and verified. Once verified, the screen will update and your borrow balance will update accordingly

### Claim Rewards

After supplying assets, you will receive distribution apy. To claim these rewards click on claim rewards in the top right corner of the page. 

![image 50.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_50_515b385176.png)
_Claim Rewards Button_

![image 51.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521027/image_51_d36d559408.png)
_Claim Rewards Modal_

The claim rewards modal will show how much Canto you have in your wallet, how much unclaimed Canto rewards you have, and the $Note value of these rewards. In order to claim these rewards, click claim and metamask will open with the claim rewards transaction.

>Disclaimer: These rewards are paid out in WCANTO, the wrapped ERC20 token with the same value as Canto. This token can be converted back to Canto native token.

 The Canto Lending Market allows you to supply and borrow assets, including LP tokens received from the Canto LP Interface. 

Lending and Borrowing

If you have just bridged from Ethereum or Cosmos, your assets are on the native Canto blockchain. To use the Canto Lending Market, Canto DEX, and other DApps, you must convert your assets to the Canto EVM.

If your assets are already on the Canto EVM but you would like to bridge them back to Ethereum or Cosmos, you must first convert them to the native Canto blockchain:

### Native Canto -> Canto EVM

To convert assets from native Canto to Canto EVM, you must have at least 0.3 $CANTO in your MetaMask wallet. If necessary, you can request a drip from the social-faucet.

To convert assets from native Canto to the Canto EVM, follow these steps:
1. Navigate to [convert.canto.io](https://convert.canto.io) and connect your MetaMask wallet, making sure you are on the Canto network.
2. Select the token you would like to convert and input the quantity. Quantities less than 1 must include a 0 in the ones place value (e.g. 0.99).
3. Make sure the arrow is pointing left to right, showing the flow of assets from Canto Native to Canto EVM.
4. Click `transfer` and sign the message in your wallet.

![image 23.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667928825/image_23_fce7830044.png)

### Canto EVM -> Native Canto

To convert assets from the Canto EVM to native Canto, follow these steps:
1. Navigate to [convert.canto.io](https://convert.canto.io) and connect your MetaMask wallet, making sure you are on the Canto network.
2. Click on the arrow to toggle the flow of assets from Canto EVM to Canto Native.
3. Select the token you would like to convert and input the quantity. Quantities less than 1 must include a 0 in the ones place value (e.g. 0.99).
4. Make sure the arrow is pointing right to left, showing the flow of assets from Canto Native to Canto EVM.
5. Click `transfer` and sign the message in your wallet.

![image 24.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1667928825/image_24_6cd31231f8.png)

There are two Canto ledgers: native Canto and the Canto EVM. Depending on what you want to do on Canto, you may need to convert assets from one chain to the other.

Converting assets

In exchange for locking up your tokens, you'll earn rewards in the form of additional $CANTO, as well as voting power for governance proposals.

Staked tokens are subject to a 21 day unbonding period. If you decide to unstake $CANTO, you will have to wait 21 days before it returns to your wallet.

### How to Stake
Follow these steps to stake your $CANTO:

1. Navigate to  and connect your wallet.
2. Click on the "all validators" tab to see a list of network validators:

![image 32.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521984/image_32_7477c456e7.png)

3. After choosing a validator, click on the "manage" button next to that validator:

![image 33.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521983/image_33_3f17ec0620.png)

4. Enter the amount of $CANTO you would like to stake and click "delegate".
5. Confirm the transaction in your wallet.

### Claiming Rewards
1. Navigate to  and connect your wallet.
2. Click on "claim rewards" and confirm the transaction in your wallet.
Note: You must claim rewards separately for every validator you have delegated to.

![image 34.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521984/image_34_2cd0a6fd0b.png)
_Claiming staking rewards_

### Re-Delegating
You may wish to move your stake between validators without subjecting yourself to the unbonding period. This can be done by re-delegating your stake:
1. Navigate to  and connect your wallet.
2. On the "staking" tab, click "view my delegations".
3. Click on the "manage" button next to your chosen delegation.
4. In the green box at the bottom of the pop-up, enter the amount of $CANTO you would like to re-delegate and select a new validator from the dropdown box.
5. Click on "re-delegate" and confirm the transaction in your wallet.
_You can only re-delegate from an account once every 21 days._

### How to Unstake
Follow these steps to unstake your $CANTO:
1. Navigate to  and connect your wallet.
2. On the "staking" tab, click "view my delegations".
3. Click on the "manage" button next to your chosen delegation.
4. Enter the amount of $CANTO you would like to stake and click "undelegate".
5. Confirm the transaction in your wallet.

When you unstake tokens, they will will be subject to a 21 day unbonding period. To see the progress of the unbonding period for an account, hover over the clock icon on the undelegations column.

![image 35.png](https://res.cloudinary.com/pentaclexyz/image/upload/v1668521984/image_35_7751f1e243.png)
_Viewing all undelegations for a particular validator_

Note: You can only have 7 concurrent undelegations at a time for each validator. In other words, you can unstake 7 times from a given validator within a 21 day period.

### Risks (Slashing)
Staking $CANTO is not without risk. By delegating tokens to a validator, you assume some responsibility for their behavior, proportionally to the size of your stake.

If a validator misbehaves, any tokens delegated to them will be slashed by:
-0.75% in the case of prolonged downtime
-4% in the case of consensus faults

Due to slashing, performing due diligence on validators before staking any tokens and splitting your stake across multiple validators is highly recommended.

Aside from slashing, staked tokens are subject to a 21 day unbonding period from the moment they are unstaked, as previously mentioned. During this time, you will not be able to access your tokens.

large_header.png

medium_header.png

small_header.png

thumbnail_header.png

header.png

 Staking, also known as delegating, is the process of locking up your $CANTO tokens for a period of time to contribute to the security of the Canto network.

Staking

### $NOTE is Canto’s unit of account and one of the three core DeFi primitives to be featured on Canto at launch. 

$NOTE is:

- Fully decentralized
- Over-collateralized
- Backed by M1 assets
- Automated

### How is $NOTE issued?

$NOTE is a fully immutable ERC-20 Standard Token. On genesis, the entire supply of $NOTE in existence is minted and sent to the Canto Lending Market (CLM)’s Accountant contract. $NOTE can be borrowed from the Canto Lending Market (CLM) by users who have posted collateral including: other stablecoins, $CANTO, $ETH, $ATOM or Canto LP tokens. $NOTE can only be borrowed from CLM; no new $NOTE can be created.

### Who governs $NOTE?

The $NOTE supply is controlled by automated smart contracts, like the Accountant contract mentioned earlier, that are ultimately governed by the Canto DAO. The $NOTE token itself is a standard ERC-20 with no upgradeability or owner.

### Capital efficiency

Canto Lending Market achieves superior capital efficiency by allowing stablecoin collateral backing $NOTE to be lent out to other participants. For example, a DeFi participant can lend $USDC to Canto Lending Market and then borrow $NOTE. If the borrow rate for $NOTE is less than the supply rate for $USDC, that DeFi participant will be getting paid to hold $NOTE on Canto.

_Important: Canto Lending Market will launch with conservative parameters. Over time, the Canto DAO will be able to raise the capital efficiency of CLM to its full potential._

### How does $NOTE maintain stability?

Since $NOTE cannot be created, only borrowed, the Accountant contract utilizes interest rates to manage the circulating supply of $NOTE. The interest rate on $NOTE automatically adjusts up or down every 6 hours based on a TWAP of the market price of $NOTE. It’s worth highlighting that as a protocol aiming to be a public utility the algorithm responsible for adjusting this interest rate is designed to change the interest rate in order to promote a less volatile value as opposed to maximizing revenue.

If $NOTE is trading under $1, the interest rate is raised to strengthen the incentive for buying and lending $NOTE. If $NOTE is trading over a dollar, the interest rate is lowered to make borrowing and selling $NOTE more attractive.

For launch, each interest epoch will be 6 hours and the rate will adjust by 0.25 of the difference between the price of $NOTE and $1.00.

#### The Formula:

_newInterestRate = max(0,(1 - price of $NOTE)*Adjuster Coefficient+ priorInterestRate)_

#### Example:

_Current Interest Rate: 4%.$NOTE average price over the last 6 hours: 1.04._

_New Interest Rate: 3% = max (0,  (1 - 1.04)* 0.25 + 4%)_

_If $NOTE is trading above $1, the interest rate is lowered to weaken the $NOTE price. If $NOTE is trading below $1, the interest rate is raised to strengthen the $NOTE price._

### What makes $NOTE’s interest rate model unique?

In line with the ethos of Canto, all interest paid on $NOTE will be distributed to lenders, with no interest extracted as revenue by the lending protocol. Both the Supply and Borrow rate for $NOTE are always identical. As previously mentioned, all $NOTE is minted and sent to the Accountant smart contract at launch. In effect, you can think of the Accountant as the primary supplier of $NOTE to Canto Lending Market (CLM).

In order to avoid inflating the supply, the protocol must effectively account for the amount of interest the Accountant earns versus the amount of interest borrowers are paying. This is accomplished by having the Accountant supply or redeem liquidity when a user deposits or withdraws $NOTE. This results in there never being any $NOTE present in the cNOTE market other than during function calls, while also providing an infinite amount of NOTE to be borrowed or redeemed from the Market.

The interest paid by the market to borrow $NOTE that goes to the Accountant is eventually swept into the community treasury governed by Canto DAO. Ultimately, $NOTE earned in this way will be used by the Canto DAO to support further development of free public infrastructure and Canto Public Goods.

### Is $NOTE a stablecoin?

No. For most people, stablecoin means a token that is pegged to a fiat currency. $NOTE interest rate policy is centered around $1, and our hypothesis is that the $NOTE price will be cointegrated with the dollar, but it is not pegged. The price of $NOTE can and will have its own volatility, especially in the early days of CANTO.

### Are there risks?

Yes! To our knowledge, no one has tried this yet, and there may be unknown problems with the design. Please limit your financial risk to Canto with only money you can afford to lose. We are trying many things for the first time, and risk of loss is high.

thumbnail_image 53.png

image 53.png

$NOTE is Canto’s unit of account and one of the three core DeFi primitives to be featured on Canto at launch.

$NOTE

Having observed the growth of the DeFi space, from the launch of DAI in late 2017 to the emergence of many DeFi projects in 2021, three core primitives have emerged to anchor any healthy DeFi ecosystem: 
- Decentralized exchanges (DEXes) such as Uniswap and Sushiswap
- Lending markets such as Compound and Aave
- Decentralized unit of accounts such as DAI, USDC or USDT

As the ecosystem has grown, every core primitive has made the same decision: launch a governing protocol token that derives value from its ability to extract rent from future users.

Canto takes a different approach by choosing to launch these core DeFi primitives as public utility protocols, or Free Public Infrastructure (FPI). 

Where existing protocols serve their community more similarly to a pay-by-hour private parking garage, Canto’s FPI intends to provide for its community in a manner more akin to free parking on a city street.

For Canto’s decentralized exchange, the protocol cannot be upgraded and will remain ungoverned. It will run in perpetuity on Canto without ever being able to launch a token or implement additional fees over time, preventing the possibility of a predatory evolution toward rent-seeking behaviors.

For the Canto Lending Market, governance is controlled by Canto stakers. Canto stakers have broad interests in the growth of the ecosystem and fostering the best environment for both developers and DeFi users. As such, they have no incentive to extract rent at the application layer.

For $NOTE, the unit of account token, the interest charged to stabilize its price will be contributed toward funding public goods. The algorithm responsible for adjusting this interest rate is designed to change the interest rate in order to promote a less volatile value as opposed to maximizing revenue. All interest paid by borrowers will be distributed to lenders, with no fees extracted at the protocol layer.

By giving governance powers to the chain, we expect the operation of the primitives to naturally align with the public interest, resulting in a healthy and robust ecosystem free from zero-sum games that have since come to dominate the once egalitarian system of decentralized finance.

small_Screen Shot 2022-11-13 at 7.51 4.png

thumbnail_Screen Shot 2022-11-13 at 7.51 4.png

Screen Shot 2022-11-13 at 7.51 4.png

Canto realizes the vision set out by the first builders that core primitives should exist as Free Public Infrastructure (FPI).