# 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:

{% embed url="<https://github.com/Lossless-Cash/lossless-v2/blob/master/contracts/LosslessGuardian.sol>" %}

### 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

```solidity
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

```solidity
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

```solidity
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

```solidity
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

```solidity
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

```solidity
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

```solidity
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. |