NOTE, DEX, and Lending Market

When building DApps, you may wish to leverage Canto's Free Public Infrastructure, such as its native unit of account, DEX, or lending market. This page provides an overview of how these primitives are designed and how you can interact with them.

For mainnet and testnet deployment addresses, refer to the Contract Addresses page:

Contract Addresses

NOTE

NOTE must be borrowed from the Accountant via the Canto Lending Market. The amount of NOTE circulating at any given time (including NOTE that users have supplied back to the Canto Lending Market) is equal to the sum of all NOTE and cNOTE not held by the Accountant.

The NOTE smart contract may be modified and redeployed at a new address in the future. For this reason, DApps should use the CToken.underlying() view on the cNOTE contract to determine the address for NOTE instead of hardcoding it.

Canto DEX

The Canto DEX is built around three contracts: BaseV1Factory, BaseV1Pair, and BaseV1Router01. Each liquidity pool is represented by a unique BaseV1Pair contract generated by the BaseV1Factory.

For most use cases, BaseV1Router01 offers sufficient functionality. Key methods include:

Method	Description
pairFor	Calculates the address for a pair
isPair	Checks if an address is a valid pair
getReserves	Fetches and sorts the reserves for a pair
getAmountOut	Calculates amount out for a specified pair
addLiquidity	Adds liquidity to a pair
removeLiquidity	Removes liquidity from a pair
swapExactTokensforTokensSimple	Swaps one token for another directly
swapExactTokensforTokens	Swaps one token for another using a specified route
getUnderlyingPrice	Gets underlying asset price as a mantissa

For CANTO-specific and other methods, refer to the contract source code.

Canto Lending Market

The Canto Lending Market is an adaptation of Compound v2. Its functional design is unchanged in that the primary means of interacting with the lending market is the CToken, an ERC20 representation of a supplied asset.

Key methods on CToken contracts include:

Method	Description
mint	Deposits a token and mints the corresponding CToken
redeem	Redeems a specified amount of CToken tokens for the underlying token
redeemUnderlying	Redeems CToken tokens for a specified amount of the underlying token
borrow	Borrows the underlying token
repayBorrow	Repays a borrow of the underlying token

For more information on the Canto Lending Market's design, see the Compound v2 docs.