Git Source

Inherits: Context, RuleAdministratorOnly, IEconomicEvents, IInputErrors, IAppRuleInputErrors, IRiskInputErrors

Author: @ShaneDuncan602 @oscarsernarosero @TJ-Everett

This contract sets and gets the App Rules for the protocol

Setters and getters for Application level Rules

​
State Variables

​
MAX_ACCESSLEVELS

uint8 constant MAX_ACCESSLEVELS = 5;

​
MAX_RISKSCORE

uint8 constant MAX_RISKSCORE = 99;

​
Functions

​
addAccountMaxValueByAccessLevel

The position within the array matters. Position 0 represents access level 0, and position 4 represents level 4.

Function add an Account Max Value By Access Level rule

Function has RuleAdministratorOnly Modifier and takes AppManager Address Param

function addAccountMaxValueByAccessLevel(address _appManagerAddr, uint48[] calldata _maxValues)
    external
    ruleAdministratorOnly(_appManagerAddr)
    returns (uint32);

Parameters

NameTypeDescription
_appManagerAddraddressAddress of App Manager
_maxValuesuint48[]Balance restrictions for each 5 levels from level 0 to 4 in whole USD.

Returns

NameTypeDescription
<none>uint32position of new rule in array

​
addAccountMaxValueOutByAccessLevel

The position within the array matters. Position 0 represents access level 0, and position 4 represents level 4.

Function add an Account Max Value Out By Access Level rule

Function has ruleAdministratorOnly Modifier and takes AppManager Address Param

function addAccountMaxValueOutByAccessLevel(address _appManagerAddr, uint48[] calldata _withdrawalAmounts)
    external
    ruleAdministratorOnly(_appManagerAddr)
    returns (uint32);

Parameters

NameTypeDescription
_appManagerAddraddressAddress of App Manager
_withdrawalAmountsuint48[]withdrawal amaount restrictions for each 5 levels from level 0 to 4 in whole USD.

Returns

NameTypeDescription
<none>uint32position of new rule in array

​
addAccountMaxTxValueByRiskScore

_maxValue size must be equal to _riskScore. This means that the positioning of the arrays is ascendant in terms of risk scores, and descendant in the size of transactions. (i.e. if highest risk scores is 99, the last balanceLimit will apply to all risk scores of 100.) eg. risk scores balances resultant logic

0-24 = NO LIMIT 25 500 25-49 = 500 50 250 50-74 = 250 75 100 75-99 = 100

Function add an Account Max Transaction Value By Risk Score rule

Function has ruleAdministratorOnly Modifier and takes AppManager Address Param

function addAccountMaxTxValueByRiskScore(
    address _appManagerAddr,
    uint48[] calldata _maxValue,
    uint8[] calldata _riskScore,
    uint16 _period,
    uint64 _startTime
) external ruleAdministratorOnly(_appManagerAddr) returns (uint32);

Parameters

NameTypeDescription
_appManagerAddraddressAddress of App Manager
_maxValueuint48[]array of max-tx-size allowed within period (whole USD max values —no cents) Each value in the array represents max USD value transacted within _period, and its positions indicate what range of risk scores it applies to. A value of 1000 here means $1000.00 USD.
_riskScoreuint8[]array of risk score ceilings that define each range. Risk scores are inclusive.
_perioduint16amount of hours that each period lasts for. 0 if no period is desired.
_startTimeuint64start timestamp for the rule

Returns

NameTypeDescription
<none>uint32position of new rule in array

​
addAccountMaxValueByRiskScore

_maxValue size must be equal to _riskScore. The positioning of the arrays is ascendant in terms of risk score, and descendant in the size of transactions. (i.e. if highest risk score is 99, the last balanceLimit will apply to all risk scores of 100.) eg. risk scores balances resultant logic

0-24 = NO LIMIT 25 500 25-49 = 500 50 250 50-74 = 250 75 100 75-99 = 100

Function to add new AccountMaxValueByRiskScore Rules

Function has ruleAdministratorOnly Modifier and takes AppManager Address Param

function addAccountMaxValueByRiskScore(
    address _appManagerAddr,
    uint8[] calldata _riskScores,
    uint48[] calldata _maxValue
) external ruleAdministratorOnly(_appManagerAddr) returns (uint32);

Parameters

NameTypeDescription
_appManagerAddraddressAddress of App Manager
_riskScoresuint8[]User Risk Score Array
_maxValueuint48[]Account Max Value Limit in whole USD for each score range. It corresponds to the _riskScores array. A value of 1000 in this arrays will be interpreted as $1000.00 USD.

Returns

NameTypeDescription
<none>uint32position of new rule in array

​
_addAccountMaxValueByRiskScore

Internal Function to avoid stack too deep error

function _addAccountMaxValueByRiskScore(uint8[] calldata _riskScores, uint48[] calldata _maxValue)
    internal
    returns (uint32);

Parameters

NameTypeDescription
_riskScoresuint8[]Account Risk Score
_maxValueuint48[]Account Max Value Limit for each Score in USD (no cents). It corresponds to the _riskScores array. A value of 1000 in this arrays will be interpreted as $1000.00 USD.

Returns

NameTypeDescription
<none>uint32position of new rule in array
ERC20RuleProcessorFacetRuleProcessorCommonLib