Naming Conventions
yVaults
Dev Cheat Sheet (Examples)
- Vanilla ERC20 tokens
- Name:
${token.symbol()} or override yVault - Symbol:
yv${token.symbol()} or override- Examples:
USDC yVault,yvUSDC,aLINK yVault,yvaLINK
- Examples:
- Name:
- LP positions
- Curve
- Name:
Curve + pool + Pool yVault- Examples:
Curve sBTC Pool yVault,Curve 3pool yVault,Curve Y Pool yVault
- Examples:
- Symbol:
yvCurve-pool- Examples:
yvCurve-sBTC,yvCurve-3pool,yvCurve-Y. We make an exception for the last one and call ityUSD.
- Examples:
- Name:
- Uniswap
- Name:
Uniswap + v${self.version()} + TOKEN-TOKEN + LP yVault- Examples:
Uniswap v2 USDT-WETH LP yVault,Uniswap v2 WBTC-WETH LP yVault
- Examples:
- Symbol:
yvUni-TOKEN-TOKEN- Examples:
yvUni-USDT-WETH,yvUni-WBTC-WETH
- Examples:
- Note: Version was included for Uniswap LP tokens to help limit confusion between UNI-v2 LP tokens and upcoming UNI-v3 LP tokens.
- Name:
- Balancer
- Name:
Balancer + TOKEN-TOKEN + Pool yVault- Examples:
Balancer USDT-WETH Pool yVault,Balancer WBTC-WETH Pool yVault
- Examples:
- Symbol:
yvBal-TOKEN-TOKEN- Examples:
yvBal-USDT-WETH,yvBal-WBTC-WETH
- Examples:
- Name:
- SushiSwap
- Name:
SushiSwap + TOKEN-TOKEN + LP yVault- Examples:
SushiSwap USDT-WETH LP yVault,Uniswap v2 WBTC-WETH LP yVault
- Examples:
- Symbol:
yvSushi-TOKEN-TOKEN- Examples:
yvSushi-USDT-WETH,yvSushi-WBTC-WETH
- Examples:
- Name:
- Curve
- Experimental
- No hard rules for
nameorsymbol, just be sure to endnamewith "yVault".- Examples:
yveCRV-DAO yVault,yveCRV-DAO,St. Banteg of Yearn Patron of Plebs Lido St. Ether yVault,sboypoplyvstETH
- Examples:
- No hard rules for
Overview and Explanation
- Acceptable alternative names include Yearn Vaults, or informally referring to the product as vaults.
- When referring to a specific yVault, the preferred name is generally
TOKEN + yVault; this matches thenamefield on the yVault contract. However, it is also acceptable to useyvTOKEN + Vault,Yearn + TOKEN + VaultoryvTOKEN; the latter matchessymbolin the contract.- Examples:
DAI yVault,yvDAI Vault,Yearn DAI Vault, or simplyyvDAI
- Examples:
- For each yVault, name and symbol conventions are as follows:
- Name:
${token.symbol()} or override yVault - Symbol:
yv${token.symbol()} or override
- Name:
- A
versionfield is included in the token contract to correspond to the major yVault release version.- Additionally, developers may find it useful to denote
versionwithin thenamefield itself to help clarify the token to be deposited. Useful examples include Uniswap LPs (below), and also v1 vs v2 Aave aTokens.
- Additionally, developers may find it useful to denote
- The predominant use case for name and symbol override is for LP tokens. The use of the term
PoolorLPis interchangeable, and will be selected based on colloquial use for each protocol.- For instance, Curve and Balancer LP positions are typically referred to as pools since they can contain more than two tokens, while Uniswap and SushiSwap positions are typically referred to as LPs.
- Curve
- Name:
Curve + pool + Pool yVault- Examples:
Curve sBTC Pool yVault,Curve 3pool yVault,Curve Y Pool yVault - In this case,
poolis taken directly from Curve.fi's UI, and we can adjust for capitalization as needed. In the case of the3pool, the redundant "Pool" is removed.
- Examples:
- Symbol:
yvCurve-pool- Examples:
yvCurve-sBTC,yvCurve-3pool,yvCurve-Y
- Examples:
- Note: In this methodology,
yvCurve-Yrefers to the vault previously known asyUSD. Please see below for a more detailed discussion on proper use ofyUSD.
- Name:
- Uniswap
- Name:
Uniswap + v${self.version()} + TOKEN-TOKEN + LP yVault- Examples:
Uniswap v2 USDT-WETH LP yVault,Uniswap v2 WBTC-WETH LP yVault
- Examples:
- Symbol:
yvUni-TOKEN-TOKEN- Examples:
yvUni-USDT-WETH,yvUni-WBTC-WETH
- Examples:
- Note: Version was included for Uniswap LP tokens to help limit confusion between UNI-v2 LP tokens and upcoming UNI-v3 LP tokens.
- Name:
- Balancer
- Name:
Balancer + TOKEN-TOKEN + Pool yVault- Examples:
Balancer USDT-WETH Pool yVault,Balancer WBTC-WETH Pool yVault
- Examples:
- Symbol:
yvBal-TOKEN-TOKEN- Examples:
yvBal-USDT-WETH,yvBal-WBTC-WETH
- Examples:
- Note: Since Balancer allows more than two tokens per pool, append as many
TOKENas needed for the pool in question.
- Name:
- SushiSwap
- Name:
SushiSwap + TOKEN-TOKEN + LP yVault- Examples:
SushiSwap USDT-WETH LP yVault,Uniswap v2 WBTC-WETH LP yVault
- Examples:
- Symbol:
yvSushi-TOKEN-TOKEN- Examples:
yvSushi-USDT-WETH,yvSushi-WBTC-WETH
- Examples:
- Name:
yVault Want Token
- In Yearn's UI, it may be useful to denote the desired token to deposit into a specific yVault. For basic ERC20
wanttokens,nameandsymbolcan be pulled directly from the token contract and utilized as-is.- Examples:
USD Coin,USDC,ChainLink Token,LINK
- Examples:
- However, for LP positions, naming needs to be standardized.
- Curve
- Name:
Curve + pool + Pool- Examples:
Curve sBTC Pool,Curve 3pool,Curve Y Pool,Curve Compound Pool - In this case,
poolis taken directly from Curve.fi's UI, and we can adjust for capitalization as needed. In the case of the3pool, the redundant "Pool" is removed.
- Examples:
- Symbol:
crvPOOL or override- Examples:
crvBUSD,crvCOMP,crvGUSD,crvMUSD,crvTBTC,crvSBTC,yCRV,3Crv
- Examples:
- These names were chosen as
crvBUSDandcrvSBTCare already fairly widely used, and applying this formula works well for other pools.yCRVand3Crvare the allowed exceptions, asyCRVis the most widely used name for that pool, and3Crvusage is now fairly common with the recent admin fee distribution.
- Name:
- Uniswap
- Name:
Uniswap + v${self.version()} + TOKEN-TOKEN + LP- Examples:
Uniswap v2 USDT-WETH LP,Uniswap v2 WBTC-WETH LP
- Examples:
- Symbol:
TOKEN-TOKEN UNI- Examples:
USDT-WETH UNI,WBTC-WETH UNI
- Examples:
- Name:
- Balancer
- Name:
Balancer + TOKEN-TOKEN + Pool- Examples:
Balancer USDT-WETH Pool,Balancer WBTC-WETH Pool
- Examples:
- Symbol:
TOKEN-TOKEN BPT- Examples:
USDT-WETH BPT,WBTC-WETH BPT
- Examples:
- Note: Since Balancer allows more than two tokens per pool, append as many
TOKENas needed for the pool in question.
- Name:
- SushiSwap
- Name:
SushiSwap + TOKEN-TOKEN + LP- Examples:
SushiSwap USDT-WETH LP,Uniswap v2 WBTC-WETH LP
- Examples:
- Symbol:
TOKEN-TOKEN SLP- Examples:
USDT-WETH SLP,WBTC-WETH SLP
- Examples:
- Name:
- Curve
yUSD
- While the term
yUSDwas used to refer to the Curve Y Pool yVault in the past, under our updated naming convention this vault token is nowyvCurve-Y. However, usage ofyUSDis still permissable when referring to the asset itself.- Example: Yearn pays monthly grants in
yUSD.
- Example: Yearn pays monthly grants in
- In the future, if Yearn creates a new
yUSDthat is a collection of several yVault tokens (as has been previously discussed), then the currentyUSDwill simply be referred to asyvCurve-Yand only the new token will beyUSD.
yEarn
These are Yearn's original yield-aware tokens, whose v1 and v2 contracts can be found here or by clicking on the etherscan icon when viewing the vault:
These products should be referred to as yEarn Tokens,
underlying token name + Earn, ory{token.symbol()}v${self.version()}- Examples:
yDAIv2,yDAI Earn,yBUSDv3,yBUSD Earn
- Examples:
Test Products
- For deployed contracts that have not reached their final production version, a simple modification is included to designate these on the contract level as being test products.
- Name:
${token.symbol()} or override + Test + Product - Symbol:
yt${token.symbol()} or override - Examples:
DAI Test yVault,ytDAI
- Name:
- Additionally, the v2 yVault contracts have upgradeable
nameandsymbolfields. This means that should a test contract perform well, these fields can be updated to reflect that it is no longer a test contract, removing the need to deploy new contracts.
Future Products
- Future products can follow a simple naming convention:
y + product, where the product and any potential token names follow similar guidelines as above with yVaults. These can then be further modified as needed based on the product(s).- Examples:
ySwap,yBorrow,yTrade
- Examples: