Registry
Inherits: Governance
Author: yearn.finance
Serves as an on chain registry to track any Yearn V3 vaults and strategies that a certain party wants to endorse. Can also be used to deploy new vaults of any specific API version.
State Variables
releaseRegistry
address public immutable releaseRegistry;
MULTI_STRATEGY_TYPE
uint256 public constant MULTI_STRATEGY_TYPE = 1;
SINGLE_STRATEGY_TYPE
uint256 public constant SINGLE_STRATEGY_TYPE = 2;
name
string public name;
legacyRegistry
address public legacyRegistry;
taggers
mapping(address => bool) public taggers;
endorsers
mapping(address => bool) public endorsers;
vaultInfo
mapping(address => Info) public vaultInfo;
assetIsUsed
mapping(address => bool) public assetIsUsed;
_endorsedVaults
mapping(address => address[]) internal _endorsedVaults;
assets
address[] public assets;
Functions
onlyEndorsers
Can only be gov or an endorser.
modifier onlyEndorsers();
onlyTaggers
Can only be gov or a tagger.
modifier onlyTaggers();
_isEndorser
Check is gov or an endorser.
function _isEndorser() internal view;
_isTagger
Check is gov or a tagger.
function _isTagger() internal view;
constructor
constructor(address _governance, string memory _name, address _releaseRegistry) Governance(_governance);
Parameters
| Name | Type | Description |
|---|---|---|
_governance | address | Address to set as owner of the Registry. |
_name | string | The custom string for this custom registry to be called. |
_releaseRegistry | address | The Permissionless releaseRegistry to deploy vaults through. |
numAssets
Returns the total number of assets being used as the underlying.
function numAssets() external view virtual returns (uint256);
Returns
| Name | Type | Description |
|---|---|---|
<none> | uint256 | The amount of assets. |
getAssets
Get the full array of tokens being used.
function getAssets() external view virtual returns (address[] memory);
Returns
| Name | Type | Description |
|---|---|---|
<none> | address[] | The full array of underlying tokens being used/. |
numEndorsedVaults
The amount of endorsed vaults for a specific token.
function numEndorsedVaults(address _asset) public view virtual returns (uint256);
Returns
| Name | Type | Description |
|---|---|---|
<none> | uint256 | The amount of endorsed vaults. |
getEndorsedVaults
Get the array of vaults endorsed for an _asset.
function getEndorsedVaults(address _asset) external view virtual returns (address[] memory);
Parameters
| Name | Type | Description |
|---|---|---|
_asset | address | The underlying token used by the vaults. |
Returns
| Name | Type | Description |
|---|---|---|
<none> | address[] | The endorsed vaults. |
getAllEndorsedVaults
Get all endorsed vaults deployed using the Registry.
This will return a nested array of all vaults deployed separated by their underlying asset. This is only meant for off chain viewing and should not be used during any on chain tx's.
function getAllEndorsedVaults() external view virtual returns (address[][] memory allEndorsedVaults);
Returns
| Name | Type | Description |
|---|---|---|
allEndorsedVaults | address[][] | A nested array containing all vaults. |
isEndorsed
Check if a vault is endorsed in this registry.
This will check if the asset variable in the struct has been
set for an easy external view check.
function isEndorsed(address _vault) external view virtual returns (bool);
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | Address of the vault to check. |
Returns
| Name | Type | Description |
|---|---|---|
<none> | bool | . The vaults endorsement status. |
isLegacyVault
Check if a vault is endorsed in the legacy registry.
function isLegacyVault(address _vault) public view virtual returns (bool);
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | The vault to check. |
Returns
| Name | Type | Description |
|---|---|---|
<none> | bool | True if the vault is endorsed in the legacy registry, false otherwise. |
newEndorsedVault
Create and endorse a new multi strategy "Allocator" vault and endorse it in this registry.
Throws if caller isn't owner.
Throws if no releases are registered yet.
Emits a NewEndorsedVault event.*
function newEndorsedVault(
address _asset,
string memory _name,
string memory _symbol,
address _roleManager,
uint256 _profitMaxUnlockTime
) public virtual returns (address _vault);
Parameters
| Name | Type | Description |
|---|---|---|
_asset | address | The asset that may be deposited into the new Vault. |
_name | string | Specify a custom Vault name. . |
_symbol | string | Specify a custom Vault symbol name. |
_roleManager | address | The address authorized for guardian interactions in the new Vault. |
_profitMaxUnlockTime | uint256 | The time strategy profits will unlock over. |
Returns
| Name | Type | Description |
|---|---|---|
_vault | address | address of the newly-deployed vault |
newEndorsedVault
Create and endorse a new multi strategy "Allocator" vault and endorse it in this registry.
Throws if caller isn't owner.
Throws if no releases are registered yet.
Emits a NewEndorsedVault event.*
function newEndorsedVault(
address _asset,
string memory _name,
string memory _symbol,
address _roleManager,
uint256 _profitMaxUnlockTime,
uint256 _releaseDelta
) public virtual onlyEndorsers returns (address _vault);
Parameters
| Name | Type | Description |
|---|---|---|
_asset | address | The asset that may be deposited into the new Vault. |
_name | string | Specify a custom Vault name. . |
_symbol | string | Specify a custom Vault symbol name. |
_roleManager | address | The address authorized for guardian interactions in the new Vault. |
_profitMaxUnlockTime | uint256 | The time strategy profits will unlock over. |
_releaseDelta | uint256 | The number of releases prior to the latest to use as a target. NOTE: Set to 0 for latest. |
Returns
| Name | Type | Description |
|---|---|---|
_vault | address | address of the newly-deployed vault |
endorseMultiStrategyVault
Endorse an already deployed multi strategy vault.
To be used with default values for _releaseDelta, _vaultType
and _deploymentTimestamp.
function endorseMultiStrategyVault(address _vault) external virtual;
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | Address of the vault to endorse. |
endorseSingleStrategyVault
Endorse an already deployed Single Strategy vault.
To be used with default values for _releaseDelta, _vaultType
and _deploymentTimestamp.
function endorseSingleStrategyVault(address _vault) external virtual;
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | Address of the vault to endorse. |
endorseVault
Adds an existing vault to the list of "endorsed" vaults for that asset.
Throws if caller isn't owner.
Throws if no releases are registered yet.
Throws if vault's api version does not match the release specified.
Emits a NewEndorsedVault event.*
function endorseVault(address _vault, uint256 _releaseDelta, uint256 _vaultType, uint256 _deploymentTimestamp)
public
virtual
onlyEndorsers;
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | The vault that will be endorsed by the Registry. |
_releaseDelta | uint256 | Specify the number of releases prior to the latest to use as a target. |
_vaultType | uint256 | Type of vault to endorse. |
_deploymentTimestamp | uint256 | The timestamp of when the vault was deployed for FE use. |
_registerVault
Function used to register a newly deployed or added vault.
This well set all of the values for the vault in the vaultInfo
mapping as well as add the vault and the underlying asset to any
relevant arrays for tracking.
function _registerVault(
address _vault,
address _asset,
uint256 _releaseTarget,
uint256 _vaultType,
uint256 _deploymentTimestamp
) internal virtual;
tagVault
Tag a vault with a specific string.
This is available to governance to tag any vault or strategy on chain if desired to arbitrarily classify any vaults. i.e. Certain ratings ("A") / Vault status ("Shutdown") etc.
function tagVault(address _vault, string memory _tag) external virtual onlyTaggers;
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | Address of the vault or strategy to tag. |
_tag | string | The string to tag the vault or strategy with. |
removeVault
Remove a _vault.
Can be used as an efficient way to remove a vault
to not have to iterate over the full array.
NOTE: This will not remove the asset from the assets array
if it is no longer in use and will have to be done manually.
function removeVault(address _vault) external virtual onlyEndorsers;
Parameters
| Name | Type | Description |
|---|---|---|
_vault | address | Address of the vault to remove. |
removeAsset
Removes a specific _asset at _index from assets.
Can be used if an asset is no longer in use after a vault or strategy has also been removed.
function removeAsset(address _asset, uint256 _index) external virtual onlyEndorsers;
Parameters
| Name | Type | Description |
|---|---|---|
_asset | address | The asset to remove from the array. |
_index | uint256 | The index it sits at. |
setEndorser
Set a new address to be able to endorse or remove an existing endorser.
function setEndorser(address _account, bool _canEndorse) external virtual onlyGovernance;
Parameters
| Name | Type | Description |
|---|---|---|
_account | address | The address to set. |
_canEndorse | bool | Bool if the _account can or cannot endorse. |
setTagger
Set a new address to be able to tag a vault.
function setTagger(address _account, bool _canTag) external virtual onlyGovernance;
Parameters
| Name | Type | Description |
|---|---|---|
_account | address | The address to set. |
_canTag | bool | Bool if the _account can or cannot tag. |
setLegacyRegistry
Set a legacy registry if one exists.
function setLegacyRegistry(address _legacyRegistry) external virtual onlyGovernance;
Parameters
| Name | Type | Description |
|---|---|---|
_legacyRegistry | address | The address of the legacy registry. |
Events
NewEndorsedVault
Emitted when a new vault is deployed or added.
event NewEndorsedVault(address indexed vault, address indexed asset, uint256 releaseVersion, uint256 vaultType);
RemovedVault
Emitted when a vault is removed.
event RemovedVault(address indexed vault, address indexed asset, uint256 releaseVersion, uint256 vaultType);
VaultTagged
Emitted when a vault is tagged with a string.
event VaultTagged(address indexed vault);
UpdateTagger
Emitted when gov adds ore removes a tagger.
event UpdateTagger(address indexed account, bool status);
UpdateEndorser
Emitted when gov adds ore removes a endorser.
event UpdateEndorser(address indexed account, bool status);
Structs
Info
struct Info {
address asset;
uint96 releaseVersion;
uint64 vaultType;
uint128 deploymentTimestamp;
uint64 index;
string tag;
}