EToken

This is an ERC20 compatible contract that represents the capital of each liquidity provider in a given pool. The valuation is one-to-one with the underlying stablecoin. The view scr() returns the amount of capital that's locked backing up policies. For this capital locked, the pool receives an interest (scrInterestRate() / tokenInterestRate()) that is continuously accrued in the balance of eToken holders. See more.

Roles

The specific roles and functions of the contract are as follows:

( * ) Global means that the role can be delegated to a user at the protocol level (for all components) or only for a specific component. Non-global roles can only be granted for a specific component.

Interactions

Parameters

Packed parameters

To save gas, the parameters are stored in a packed struct that fits in 256bits (a word in the EVM). This is not visible externally, but put's limits on the precision of the parameters. The wad ones, have 4 decimals as precision, so 1.12345 will be truncated to 1.1234.

Events

SCRLocked

event SCRLocked(uint256 interestRate, uint256 value)

Event emitted when part of the funds of the eToken are locked as solvency capital.

SCRUnlocked

event SCRUnlocked(uint256 interestRate, uint256 value)

Event emitted when the locked funds are unlocked and no longer used as solvency capital.

Transfer

event Transfer(address indexed from, address indexed to, uint256 value)

Event emitted when value tokens are moved from one account (from) to another (to).

InternalLoan

event InternalLoan(address indexed borrower, uint256 value, uint256 amountAsked)

Event emitted when PremiumsAccount borrow money from the eTokens to cover the payouts.

InternalLoanRepaid

event InternalLoanRepaid(address indexed borrower, uint256 value)

Event emitted when the premiums account has a surplus (losses less than expected) and repay to eTokens.

InternalBorrowerAdded

event InternalBorrowerAdded(address indexed borrower)

Event emitted when PolicyPool adds an authorized borrower to the eToken.

InternalBorrowerRemoved

event InternalBorrowerRemoved(address indexed borrower, uint256 defaultedDebt)

Event emitted when PolicyPool removes an authorized borrower to the eToken.

External Methods

deposit

function deposit(address provider, uint256 amount) external returns (uint256)

Registers a deposit of liquidity in the pool. Called from the PolicyPool, assumes the amount has already been transferred. amount of eToken are minted and given to the provider in exchange of the liquidity provided.

Requirements:

• Must be called by policyPool()

• The amount was transferred

• utilizationRate() after the deposit is >= minUtilizationRate()

Events:

• Emits {Transfer} with from = 0x0 and to = provider

withdraw

function withdraw(address provider, uint256 amount) external returns (uint256 withdrawn)

Withdraws an amount from an eToken. withdrawn eTokens are be burned and the user receives the same amount in currency(). If the asked amount can't be withdrawn, it withdraws as much as possible

Requirements:

• Must be called by policyPool()

Events:

• Emits {Transfer} with from = provider and to = 0x0

addBorrower

function addBorrower(address borrower) external

Adds an authorized borrower to the eToken. This borrower will be allowed to lock/unlock funds and to take loans.

Requirements:

• Must be called by policyPool()

Events:

• Emits {InternalBorrowerAdded}

removeBorrower

function removeBorrower(address borrower) external

Removes an authorized borrower to the eToken. The borrower can't no longer lock funds or take loans.

Requirements:

• Must be called by policyPool()

Events:

• Emits {InternalBorrowerRemoved} with the defaulted debt

scr

function scr() external view returns (uint256)

Returns the amount of capital that's locked as solvency capital for active policies.

lockScr

function lockScr(uint256 scrAmount, uint256 policyInterestRate) external

Locks part of the liquidity of the EToken as solvency capital.

Requirements:

• Must be called by a borrower previously added with addBorrower.

• scrAmount <= fundsAvailableToLock()

Events:

• Emits {SCRLocked}

unlockScr

function unlockScr(uint256 scrAmount, uint256 policyInterestRate, int256 adjustment) external

Unlocks solvency capital previously locked with lockScr. The capital no longer needed as solvency.

Requirements:

• Must be called by a borrower previously added with addBorrower.

• scrAmount <= scr()

Events:

• Emits {SCRUnlocked}

internalLoan

function internalLoan(uint256 amount, address receiver, bool fromAvailable) external returns (uint256)

Lends amount to the borrower (msg.sender), transferring the money to receiver. This reduces the totalSupply() of the eToken, and stores a debt that will be repaid (hopefully) with repayLoan.

Requirements:

• Must be called by a borrower previously added with addBorrower.

Events:

• Emits {InternalLoan}

• Emits {ERC20-Transfer} transferring lent to receiver

repayLoan

function repayLoan(uint256 amount, address onBehalfOf) external

Repays a loan taken with internalLoan.

Requirements:

• msg.sender approved the spending of currency() for at least amount

Events:

• Emits {InternalLoanRepaid}

• Emits {ERC20-Transfer} transferring amount from msg.sender to this

getLoan

function getLoan(address borrower) external view returns (uint256)

Returns the updated debt (principal + interest) of the borrower.

Setting parameters

Usually, LEVEL2_ROLE or LEVEL3_ROLE is requested for performing operations that change numerical parameters of the components. Both global and component role are accepted. If the user has LEVEL3_ROLE the changes might be restricted to small tweaks.

Inherited from Reserve

assetManager

function assetManager() public view virtual returns (contract IAssetManager)

Returns the address of the asset manager for this reserve. The asset manager is the contract that manages the funds to generate additional yields. Can be address(0) if no asset manager has been set.

setAssetManager

function setAssetManager(contract IAssetManager newAM, bool force) external

Sets the asset manager for this reserve. If the reserve had previously an asset manager, it will deinvest all the funds, making all of the liquid in the reserve balance.

Requirements:

• The caller must have been granted of global or component roles GUARDIAN_ROLE or LEVEL1_ROLE.

Events:

• Emits ComponentChanged with action setAssetManager or setAssetManagerForced

rebalance

function rebalance() public

Calls {IAssetManager-rebalance} of the assigned asset manager (fails if no asset manager). This operation is intended to give the opportunity to rebalance the liquid and invested for better returns and/or gas optimization.

• Emits {IAssetManager-MoneyInvested} or {IAssetManager-MoneyDeinvested}

recordEarnings

function recordEarnings() public

Calls {IAssetManager-recordEarnings} of the assigned asset manager (fails if no asset manager). The asset manager will return the earnings since last time the earnings where recorded. It then calls _assetEarnings to reflect the earnings in the way defined for each reserve.

• Emits {IAssetManager-EarningsRecorded}

checkpoint

function checkpoint() external

Function that calls both recordEarnings() and rebalance() (in that order). Usually scheduled to run once a day by a keeper or crontask.

forwardToAssetManager

function forwardToAssetManager(bytes functionCall) external returns (bytes)

This function allows to call custom functions of the asset manager (for example for setting parameters). This functions will be called with delegatecall, in the context of the reserve.

Requirements:

• The caller must have been granted of global or component roles LEVEL2ROLE.