LosslessGuardian

This contract is a contract that maintains data needed for the protection mechanism to function properly. It allows verified protection strategy contracts to communicate with lossless controller by working as an intermediary.

Contract can be found here:

lossless-v2/contracts/LosslessGuardian.sol at master · Lossless-Cash/lossless-v2GitHub

Variables

• protectionAdmin

• verifiedStrategies

• verifiedTokens

• verifiedAddresses

• lossless

protectionAdmin

Every token has a protection admin. Protection admin is allowed to configure protections for the verified addresses.

verifiedStrategies

This mapping defines which strategy contracts are allowed to interact with this guardian contract.

verifiedTokens

Before LERC20 token can start using any of the protections, it must first be verified by the lossless team. This variable saves verified contracts.

verifiedAddresses

Before a verified LERC20 token can have a protected address, that particular address must first be verified by the lossless team. This variables saves verified addresses.

lossless

Lossless controller's address.

Events

• event TokenVerified(address indexed token, bool value)

• event AddressVerified(address indexed token, address indexed verifiedAddress, bool value)

• event ProtectionAdminSet(address indexed token, address indexed admin)

• event StrategyVerified(address indexed strategy, bool value)

Modifiers

• onlyLosslessAdmin

• onlyVerifiedStrategy

• onlyVerifiedToken

onlyLosslessAdmin

Checks if msg.sender is admin.

onlyVerifiedStrategy

Checks if msg.sender is a verifiedStrategy smart contract.

onlyVerifiedToken

Checks if msg.sender is verifiedToken smart contract.

Functions

• isAddressVerified

• verifyStrategies

• verifyToken

• verifyAddress

• setProtectionAdmin

• setProtectedAddress

• removeProtectedAddresses

isAddressVerified

function isAddressVerified(address token, address addressToCheck) external view returns(bool) 

Returns if the addressToCheck is verified for token.

Parameters:

Name	Type	Description
token	address	Token for which the verification is set.
addressToCheck	address	Address to check the verification for.

verifyStrategies

function verifyStrategies(address[] calldata strategies, bool value) external onlyLosslessAdmin

Sets either true or false for every address in the strategies list. This either marks address as verified strategy or removes the verification. Can be called only by lossless admin.

Parameters:

Name	Type	Description
strategies	address[]	Smart contracts that should be verified or have their verification removed.
value	bool	Value that defines if contracts in the list should be verified.

verifyToken

function verifyToken(address token, bool value) external onlyLosslessAdmin 

Sets either true or false for token address. This either marks token address as verified or removes the verification. Can be called only by lossless admin.

Parameters:

Name	Type	Description
token	address	Token which should be verified or have it's verification removed.
value	bool	Value that defines if token should be verified or have it's verification removed.

verifyAddress

function verifyAddress(address token, address verifiedAddress, bool value) external onlyLosslessAdmin onlyVerifiedToken(token) 

Sets either true or false for protected address. This either marks address as verified or removes the verification. Can be called only by lossless admin. Only verified addresses are allowed to have protection rules turned on.

Parameters:

Name	Type	Description
token	address	Token which should be verified.
verifiedAddress	bool	Value that defines if address should be verified or not.

setProtectionAdmin

function setProtectionAdmin(address token, address admin) external onlyVerifiedToken(token) {

Sets protection admin for the token. Can be called only by the LERC20 admin address and only for the token that is already verified.

Parameters:

Name	Type	Description
token	address	Token for which the protection admin should be set.
admin	bool	New protection admin address.

setProtectedAddress

function setProtectedAddress(address token, address guardedAddress) external onlyVerifiedStrategy 

Sets protection rules for a particular address. Can be done only for verified token and for verified address. Can be called only by verified strategy.

Parameters:

Name	Type	Description
token	address	Token for which the protection should be applied.
guardedAddress	bool	Address for which the protection rules should be applied.

removeProtectedAddresses

function removeProtectedAddresses(address token, address protectedAddress) external

Removes protection rules for a particular address. Can be called only by the verified strategy or by protection admin of a particular token.

Parameters:

Name	Type	Description
token	address	Token for which the protection removal should be applied.
protectedAddress	bool	Address for which the protection rules should be removed.