SiloRepository
SiloRepository
SiloRepository handles the creation and configuration of Silos.
Stores configuration for each asset in each silo. Each asset in each Silo starts with a default config can later be changed by the contract owner. Stores registry of Factory contracts that deploy different versions of Silos. It is possible to have multiple versions/implementations of Silo and use different versions for different tokens. For example, one version can be used for UNI (ERC20) and the other can be used for UniV3LP tokens (ERC721). Manages bridge assets. Each Silo can have 1 or more bridge assets. New Silos are created with all currently active bridge assets. Silos that are already developed must synchronize bridge assets. Sync can be done by anyone, function has public access. Is a single source of truth for other contract addresses.

Methods

acceptOwnership

function acceptOwnership() external nonpayable
Transfers ownership of the contract to a pending owner Can only be called by the pending owner.

addBridgeAsset

function addBridgeAsset(address _newBridgeAsset) external nonpayable
Adds new bridge asset
New bridge asset must be unique. Duplicates in bridge assets are not allowed. It's possible to add bridge asset that has been removed in the past. Note that all Silos must be synced manually. Callable only by owner.

Parameters

Name
Type
Description
_newBridgeAsset
address
bridge asset address

assetConfigs

function assetConfigs(address, address) external view returns (uint64 maxLoanToValue, uint64 liquidationThreshold, contract IInterestRateModel interestRateModel)
maps silo => asset => config

Parameters

Name
Type
Description
_0
address
undefined
_1
address
undefined

Returns

Name
Type
Description
maxLoanToValue
uint64
undefined
liquidationThreshold
uint64
undefined
interestRateModel
contract IInterestRateModel
undefined

bridgePool

function bridgePool() external view returns (address)
Silo for bridge asset. We can have only one bridge pool

Returns

Name
Type
Description
_0
address
undefined

defaultAssetConfig

function defaultAssetConfig() external view returns (uint64 maxLoanToValue, uint64 liquidationThreshold, contract IInterestRateModel interestRateModel)
Default values for AssetConfig. Used if values are not configured manually.

Returns

Name
Type
Description
maxLoanToValue
uint64
undefined
liquidationThreshold
uint64
undefined
interestRateModel
contract IInterestRateModel
undefined

ensureCanCreateSiloFor

function ensureCanCreateSiloFor(address _asset, bool _assetIsABridge) external view
checks all conditions for new silo creation and throws when not possible to create

Parameters

Name
Type
Description
_asset
address
address of asset for which you want to create silo
_assetIsABridge
bool
bool TRUE when _asset is bridge asset, FALSE when it is not

entryFee

function entryFee() external view returns (uint256)
Get protocol fee for opening a borrow position

Returns

Name
Type
Description
_0
uint256
fee in precision points (BaseSilo.PRECISION_DECIMALS() == 100%)

fees

function fees() external view returns (uint64 entryFee, uint64 protocolShareFee, uint64 protocolLiquidationFee)

Returns

Name
Type
Description
entryFee
uint64
undefined
protocolShareFee
uint64
undefined
protocolLiquidationFee
uint64
undefined

getBridgeAssets

function getBridgeAssets() external view returns (address[])
Get current bridge assets
Keep in mind that not all Silos may be synced with current bridge assets so it's possbile that some assets in that list are not part of given Silo.

Returns

Name
Type
Description
_0
address[]
address array of bridge assets

getInterestRateModel

function getInterestRateModel(address _silo, address _asset) external view returns (contract IInterestRateModel model)
Get Interest Rate Model address for asset in given Silo
If dedicated config is not set, method returns default config

Parameters

Name
Type
Description
_silo
address
address of Silo
_asset
address
address of an asset

Returns

Name
Type
Description
model
contract IInterestRateModel
address of interest rate model

getLiquidationThreshold

function getLiquidationThreshold(address _silo, address _asset) external view returns (uint256)
Get liquidation threshold for asset in given Silo
If dedicated config is not set, method returns default config

Parameters

Name
Type
Description
_silo
address
address of Silo
_asset
address
address of an asset

Returns

Name
Type
Description
_0
uint256
liquidation threshold in precision points (BaseSilo.PRECISION_DECIMALS())

getMaxSiloDeposits

function getMaxSiloDeposits(address _silo, address _asset) external view returns (uint256)
Gets deposit limit for Silo

Parameters

Name
Type
Description
_silo
address
Silo address for which to set limit
_asset
address
Silo asset for which to set limit

Returns

Name
Type
Description
_0
uint256
deposit limit for Silo

getMaximumLTV

function getMaximumLTV(address _silo, address _asset) external view returns (uint256)
Get maximum LTV for asset in given Silo
If dedicated config is not set, method returns default config

Parameters

Name
Type
Description
_silo
address
address of Silo
_asset
address
address of an asset

Returns

Name
Type
Description
_0
uint256
maximum LTV in precision points (BaseSilo.PRECISION_DECIMALS())

getNotificationReceiver

function getNotificationReceiver(address) external view returns (contract INotificationReceiver)
Maps Silo address to incentive contract that will distribute rewards for that Silo

Parameters

Name
Type
Description
_0
address
undefined

Returns

Name
Type
Description
_0
contract INotificationReceiver
undefined

getRemovedBridgeAssets

function getRemovedBridgeAssets() external view returns (address[])
Get removed bridge assets
Keep in mind that not all Silos may be synced with bridge assets so it's possbile that some assets in that list are still part of given Silo.

Returns

Name
Type
Description
_0
address[]
address array of bridge assets

getSilo

function getSilo(address) external view returns (address)
maps token address to silo address, asset => silo

Parameters

Name
Type
Description
_0
address
undefined

Returns

Name
Type
Description
_0
address
undefined

isPaused

function isPaused() external view returns (bool globalPause)

Returns

Name
Type
Description
globalPause
bool
undefined

isSilo

function isSilo(address _silo) external view returns (bool)
Check if contract address is a Silo deployment

Parameters

Name
Type
Description
_silo
address
address of expected Silo

Returns

Name
Type
Description
_0
bool
true if address is Silo deployment, otherwise false

isSiloPaused

function isSiloPaused(address _silo, address _asset) external view returns (bool)
Check given asset in a Silo is paused

Parameters

Name
Type
Description
_silo
address
address of Silo
_asset
address
address of an asset

Returns

Name
Type
Description
_0
bool
true if given asset in a Silo is paused, otherwise false

maxLiquidity

function maxLiquidity() external view returns (bool globalToggle, uint256 defaultMaxLiquidity)

Returns

Name
Type
Description
globalToggle
bool
undefined
defaultMaxLiquidity
uint256
undefined

newSilo

function newSilo(address _siloAsset, uint128 _siloVersion, bytes _siloData) external nonpayable
use this method only when off-chain verification is OFF
Silo does NOT support rebase and deflationary tokens

Parameters

Name
Type
Description
_siloAsset
address
silo asset
_siloVersion
uint128
version of silo implementation
_siloData
bytes
(optional) data that may be needed during silo creation

owner

function owner() external view returns (address)
Get owner role address of Repository

Returns

Name
Type
Description
_0
address
owner role address

pendingOwner

function pendingOwner() external view returns (address)
Returns the address of the pending owner.

Returns

Name
Type
Description
_0
address
undefined

priceProvidersRepository

function priceProvidersRepository() external view returns (contract IPriceProvidersRepository)
PriceProvidersRepository contract that manages ProceProviders implementations and is an entry point for reading prices for Silos.

Returns

Name
Type
Description
_0
contract IPriceProvidersRepository
undefined

protocolLiquidationFee

function protocolLiquidationFee() external view returns (uint256)
Get protocol liquidation fee

Returns

Name
Type
Description
_0
uint256
protocol liquidation fee in precision points (BaseSilo.PRECISION_DECIMALS() == 100%)

protocolShareFee

function protocolShareFee() external view returns (uint256)
Get protocol share fee

Returns

Name
Type
Description
_0
uint256
protocol share fee in precision points (BaseSilo.PRECISION_DECIMALS() == 100%)

registerSiloVersion

function registerSiloVersion(contract ISiloFactory _factory, bool _isDefault) external nonpayable
Registers new Silo version
User can choose which Silo version he wants to deploy. It's possible to have multiple versions of Silo. Callable only by owner.

Parameters

Name
Type
Description
_factory
contract ISiloFactory
factory contract that deploys new version of Silo
_isDefault
bool
true if this version should be used as default

removeBridgeAsset

function removeBridgeAsset(address _bridgeAssetToRemove) external nonpayable
Removes bridge asset
Note that all Silos must be synced manually. Callable only by owner.

Parameters

Name
Type
Description
_bridgeAssetToRemove
address
bridge asset address to be removed

renounceOwnership

function renounceOwnership() external nonpayable
Leaves the contract without owner. It will not be possible to call onlyOwner functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.

replaceSilo

function replaceSilo(address _siloAsset, uint128 _siloVersion, bytes _siloData) external nonpayable
use this method to deploy new version of Silo for an asset that already has Silo deployed. Only owner (DAO) can replace.
Silo does NOT support rebase and deflationary tokens

Parameters

Name
Type
Description
_siloAsset
address
silo asset
_siloVersion
uint128
version of silo implementation. Use 0 for default version which is fine for 99% of cases.
_siloData
bytes
(optional) data that may be needed during silo creation

router

function router() external view returns (address)
SiloRouter utility contract that combines number of actions (Deposit, Withdraw, Borrow, Repay) for batch execution in single transaction.

Returns

Name
Type
Description
_0
address
undefined

setAssetConfig

function setAssetConfig(address _silo, address _asset, ISiloRepository.AssetConfig _assetConfig) external nonpayable
Set configuration for given asset in given Silo
Callable only by owner

Parameters

Name
Type
Description
_silo
address
Silo address for which config applies
_asset
address
asset address for which config applies
_assetConfig
ISiloRepository.AssetConfig
: - _maxLoanToValue maximum Loan-to-Value, for detailes see Repository.AssetConfig.maxLoanToValue - _liquidationThreshold liquidation threshold, for detailes see Repository.AssetConfig.maxLoanToValue - _interestRateModel interest rate model address, for detailes see Repository.AssetConfig.interestRateModel

setDefaultInterestRateModel

function setDefaultInterestRateModel(contract IInterestRateModel _defaultInterestRateModel) external nonpayable
Set default interest rate model
Callable only by owner

Parameters

Name
Type
Description
_defaultInterestRateModel
contract IInterestRateModel
default interest rate model

setDefaultLiquidationThreshold

function setDefaultLiquidationThreshold(uint64 _defaultLiquidationThreshold) external nonpayable
Set default liquidation threshold
Callable only by owner

Parameters

Name
Type
Description
_defaultLiquidationThreshold
uint64
default liquidation threshold in precision points (BaseSilo.PRECISION_DECIMALS())

setDefaultMaximumLTV

function setDefaultMaximumLTV(uint64 _defaultMaxLTV) external nonpayable
Set default maximum LTV
Callable only by owner

Parameters

Name
Type
Description
_defaultMaxLTV
uint64
default maximum LTV in precision points (BaseSilo.PRECISION_DECIMALS())

setDefaultSiloMaxDepositsLimit

function setDefaultSiloMaxDepositsLimit(uint256 _maxDeposits) external nonpayable
Sets default deposit limit for all Silos

Parameters

Name
Type
Description
_maxDeposits
uint256
deposit limit amount in ETH

setDefaultSiloVersion

function setDefaultSiloVersion(uint128 _defaultVersion) external nonpayable
Set default Silo version
Callable only by owner.

Parameters

Name
Type
Description
_defaultVersion
uint128
Silo version to be set as default

setFees

function setFees(ISiloRepository.Fees _fees) external nonpayable
Set default fees
Callable only by owner

Parameters

Name
Type
Description
_fees
ISiloRepository.Fees
: - _entryFee one time protocol fee for opening a borrow position in precision points (BaseSilo.PRECISION_DECIMALS()) - _protocolShareFee protocol revenue share in interest paid in precision points (BaseSilo.PRECISION_DECIMALS()) - _protocolLiquidationFee protocol share in liquidation profit in precision points (BaseSilo.PRECISION_DECIMALS()). It's calculated from total collateral amount to be transferred to liquidator.

setGlobalPause

function setGlobalPause(bool _globalPause) external nonpayable
Pause all Silos
Callable only by owner.

Parameters

Name
Type
Description
_globalPause
bool
true to pause all Silos, otherwise false

setNotificationReceiver

function setNotificationReceiver(address _silo, contract INotificationReceiver _newNotificationReceiver) external nonpayable
Set NotificationReceiver contract
Callable only by owner

Parameters

Name
Type
Description
_silo
address
silo address for which to set _notificationReceiver
_newNotificationReceiver
contract INotificationReceiver
undefined

setPriceProvidersRepository

function setPriceProvidersRepository(address _repository) external nonpayable
Set price provider repository
Callable only by owner

Parameters

Name
Type
Description
_repository
address
price provider repository address

setRouter

function setRouter(address _router) external nonpayable
Set router contract
Callable only by owner

Parameters

Name
Type
Description
_router
address
router address

setSiloMaxDepositsLimit

function setSiloMaxDepositsLimit(address _silo, address _asset, uint256 _maxDeposits) external nonpayable
Sets deposit limit for Silo

Parameters

Name
Type
Description
_silo
address
Silo address for which to set limit
_asset
address
Silo asset for which to set limit
_maxDeposits
uint256
deposit limit amount in ETH

setSiloPause

function setSiloPause(address _silo, address _asset, bool _pauseValue) external nonpayable
Pause single asset in a single Silo
Callable only by owner.

Parameters

Name
Type
Description
_silo
address
address of Silo in which _asset is being paused
_asset
address
address of an asset that is being paused
_pauseValue
bool
true to pause, false to unpause

setTokensFactory

function setTokensFactory(address _tokensFactory) external nonpayable
Set factory contract for debt and collateral tokens for each Silo asset
Callable only by owner

Parameters

Name
Type
Description
_tokensFactory
address
address of TokensFactory contract that deploys debt and collateral tokens

siloFactory

function siloFactory(uint256) external view returns (contract ISiloFactory)
Maps version => ISiloFactory. Versions start at 1 and are incremented by 1.

Parameters

Name
Type
Description
_0
uint256
undefined

Returns

Name
Type
Description
_0
contract ISiloFactory
undefined

siloRepositoryPing

function siloRepositoryPing() external pure returns (bool)

Returns

Name
Type
Description
_0
bool
undefined

siloReverse

function siloReverse(address) external view returns (address)
maps silo address to token address, silo => asset

Parameters

Name
Type
Description
_0
address
undefined

Returns

Name
Type
Description
_0
address
undefined

siloVersion

function siloVersion() external view returns (uint128 byDefault, uint128 latest)

Returns

Name
Type
Description
byDefault
uint128
undefined
latest
uint128
undefined

toggleLimitedMaxLiquidity

function toggleLimitedMaxLiquidity() external nonpayable
Switch to turn on and off limited liquidity

tokensFactory

function tokensFactory() external view returns (contract ITokensFactory)
Factory contracts that deploys debt and collateral tokens for each asset in Silo

Returns

Name
Type
Description
_0
contract ITokensFactory
undefined

transferOwnership

function transferOwnership(address newOwner) external nonpayable
Transfers ownership of the contract to a new account (newOwner). Can only be called by the current owner.

Parameters

Name
Type
Description
newOwner
address
undefined

transferPendingOwnership

function transferPendingOwnership(address newPendingOwner) external nonpayable
Transfers pending ownership of the contract to a new account (newPendingOwner). Can only be called by the current owner.

Parameters

Name
Type
Description
newPendingOwner
address
undefined

unregisterSiloVersion

function unregisterSiloVersion(uint128 _siloVersion) external nonpayable
Unregisters Silo version
Callable only by owner.

Parameters

Name
Type
Description
_siloVersion
uint128
Silo version to be unregistered

Events

BridgeAssetAdded

event BridgeAssetAdded(address newBridgeAsset)
Emitted on new bridge asset

Parameters

Name
Type
Description
newBridgeAsset
address
undefined

BridgeAssetRemoved

event BridgeAssetRemoved(address bridgeAssetRemoved)
Emitted on removed bridge asset

Parameters

Name
Type
Description
bridgeAssetRemoved
address
undefined

BridgePool

event BridgePool(address indexed pool)
Emitted when new Silo (or existing one) becomes a bridge pool (pool with only bridge tokens).

Parameters

Name
Type
Description
pool indexed
address
undefined

DefaultSiloMaxDepositsLimitUpdate

event DefaultSiloMaxDepositsLimitUpdate(uint256 newMaxDeposits)
Emitted when default max liquidity limit is changed

Parameters

Name
Type
Description
newMaxDeposits
uint256
undefined

FeeUpdate

event FeeUpdate(uint64 newEntryFee, uint64 newProtocolShareFee, uint64 newProtocolLiquidationFee)
Emitted when default fee is updated

Parameters

Name
Type
Description
newEntryFee
uint64
undefined
newProtocolShareFee
uint64
undefined
newProtocolLiquidationFee
uint64
undefined

GlobalPause

event GlobalPause(bool globalPause)
Emitted when all Silos are paused or unpaused

Parameters

Name
Type
Description
globalPause
bool
undefined

InterestRateModel

event InterestRateModel(contract IInterestRateModel newModel)
Emitted when default interest rate model is changed

Parameters

Name
Type
Description
newModel
contract IInterestRateModel
undefined

LimitedMaxLiquidityToggled

event LimitedMaxLiquidityToggled(bool newLimitedMaxLiquidityState)
Emitted when max liquidity toggle is switched

Parameters

Name
Type
Description
newLimitedMaxLiquidityState
bool
undefined

NewDefaultLiquidationThreshold

event NewDefaultLiquidationThreshold(uint64 defaultLiquidationThreshold)

Parameters

Name
Type
Description
defaultLiquidationThreshold
uint64
undefined

NewDefaultMaximumLTV

event NewDefaultMaximumLTV(uint64 defaultMaximumLTV)

Parameters

Name
Type
Description
defaultMaximumLTV
uint64
undefined

NewSilo

event NewSilo(address indexed silo, address indexed asset, uint128 siloVersion)
Emitted on new Silo creation

Parameters

Name
Type
Description
silo indexed
address
undefined
asset indexed
address
undefined
siloVersion
uint128
undefined

NotificationReceiverUpdate

event NotificationReceiverUpdate(contract INotificationReceiver newIncentiveContract)
Emitted on INotificationReceiver address update

Parameters

Name
Type
Description
newIncentiveContract
contract INotificationReceiver
undefined

OwnershipPending

event OwnershipPending(address indexed previousOwner, address indexed newOwner)