Notional V3 User Docs
  • Product Guides
    • Lending
    • Fixed Rate Lending
    • Providing Liquidity
    • Borrowing
    • Fixed Rate Borrowing
    • Leveraged Liquidity
    • Leveraged Yield Farming
    • Leveraged Points Farming
    • Leveraged Pendle PTs
  • Risk Framework
  • Developer Docs
  • 🏦Prime Money Market
    • Overview
    • Interest Rate Model
    • Borrow Fees
  • 💸fCash
    • What is fCash
    • Using fCash
    • fCash Maturity
  • 💹Trading fCash
    • Transaction Fees
    • Exiting Early
    • Interest Rate Risk
  • 💰Borrower Resources
    • Loan to Value (LTV)
    • Health Factor
    • Liquidation
    • Max LTV Table
  • 🚰Fixed Rate Liquidity Pools
    • What are Fixed Rate Liquidity Pools
    • Fixed Rate Liquidity Pool Mechanics
  • 🪙nTokens
    • What are nTokens
    • nToken Mechanics
      • nToken Portfolio
      • Minting nTokens
      • Redeeming nTokens
    • nToken Returns
    • nToken Risks
  • ⚡Leveraged Vaults
    • What are Leveraged Vaults
    • Entering and Exiting a Vault
    • Liquidation
    • Settlement
    • Vault Returns
    • Vault Risks
    • Vault FAQs
  • ⚖️Governance
    • NOTE
    • NOTE Staking
  • Smart Contracts
    • Deployments (Mainnet)
    • Deployments (Arbitrum)
    • Audits
    • Bug Bounty
Powered by GitBook
On this page
  • nToken Overview
  • Deposit shares
  • Depositing into liquidity pools
  1. nTokens

nToken Mechanics

PreviousWhat are nTokensNextnToken Portfolio

Last updated 1 year ago

nToken Overview

nTokens are like a portfolio manager for liquidity providers. Instead of needing to provide liquidity directly to individual liquidity pools and roll positions when they mature, the nToken handles everything on behalf of Notional LPs.

To mint nTokens, a user deposits cash into the nToken account. The nToken account then distributes the user's liquidity into the underlying fixed rate liquidity pools for that currency and holds the liquidity tokens that it gets back.

The nToken account divides liquidity between individual markets based on governance parameters called deposit shares.

Deposit shares

Deposit shares are percentage figures that tell the nToken account how much of a user's total liquidity to deposit into each individual market.

Deposit shares allow Notional governors to direct liquidity to the maturities where there is the greatest end-user demand for borrowing and lending. For example, governors may decide on a set of deposit shares which would direct more liquidity to long-dated maturities and less liquidity to short-dated maturities, or vice versa depending on relative demand.

Depositing into liquidity pools

For example, to provide 100 DAI in liquidity to a liquidity pool that is 50% cDAI and 50% fDAI, the LP would need to mint a pair of +100 fDAI and -100 fDAI. The LP would then convert their DAI into Prime DAI, and put the Prime DAI + fDAI into the liquidity pool in exchange for liquidity tokens.

This would leave the LP with -100 fDAI + liquidity tokens.

At any time, the nToken account will hold Prime Cash, fCash, and liquidity tokens from different liquidity pools.

The nToken account provides liquidity to an individual liquidity pool in the . The nToken account mints a pair of offsetting fCash tokens, places the Prime Cash along with the positive fCash into the liquidity pool in exchange for liquidity tokens, and holds the negative fCash alongside the liquidity tokens in its portfolio.

From the :

🪙
same way as any other account
LP mechanics section