IFrictionlessComplianceFactory

Git Source

Author: DEFYCA Labs S.à.r.l

Copyright © 2023 DEFYCA Labs S.à.r.l Permission is hereby granted, free of charge, to any person obtaining a copy of the Frictionless protocol smart contracts (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL DEFYCA LABS S.à.r.l BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Interface defining the upgradeable compliance factory for all tokens in the Frictionless protocol.

Functions

setTreasuryManager

Sets the Treasury Manager to be the specified address.

function setTreasuryManager(address newTreasuryManager_) external;

Parameters

updateModularComplianceImpl

Updates and upgrades the modular compliance implementation

function updateModularComplianceImpl(address newModularComplianceImpl_) external;

Parameters

updateSupportedComplianceData

Updates the set of supported modular compliance modules.

function updateSupportedComplianceData(UpdateSupportedComplianceData[] calldata updateSupportedComplianceDataArr_)
    external;

Parameters

updateModularComplianceData

Updates the modular compliance data.

function updateModularComplianceData(UpdateModularComplianceData[] calldata updateModularComplianceDataArr_) external;

Parameters

deployCompliance

Deploys the compliance contract using the ProxyBeacon with the associated FrictionlessPermissionsManager contract

function deployCompliance(IBasicFrictionlessToken.FrictionlessTokenTypes tokenType_) external returns (address);

Parameters

Returns

treasuryManager

returns the address of the treasuryManager

function treasuryManager() external view returns (address);

Returns

modularComplianceBeacon

returns the ProxyBeacon of the ModularCompliance

function modularComplianceBeacon() external view returns (ProxyBeacon);

Returns

getModularComplianceImpl

returns the address of the ModularCompliance

function getModularComplianceImpl() external view returns (address);

Returns

getModularComplianceTokenType

returns the FrictionlessTokenTypes which is bound by the ModularCompliance

function getModularComplianceTokenType(address modularComplianceAddr_)
    external
    view
    returns (IBasicFrictionlessToken.FrictionlessTokenTypes);

Parameters

Returns

getSupportedComplianceModulesCount

returns the amount of supported compliances ModularCompliance for the specified tokenType_

function getSupportedComplianceModulesCount(IBasicFrictionlessToken.FrictionlessTokenTypes tokenType_)
    external
    view
    returns (uint256);

Parameters

Returns

getSupportedComplianceModules

returns the array of supported compliances ModularCompliance for the specified tokenType_

function getSupportedComplianceModules(IBasicFrictionlessToken.FrictionlessTokenTypes tokenType_)
    external
    view
    returns (address[] memory);

Parameters

Returns

getSupportedComplianceInfo

function getSupportedComplianceInfo(IBasicFrictionlessToken.FrictionlessTokenTypes tokenType_)
    external
    view
    returns (ModularComplianceInfo memory);

isSupportedComplianceModule

returns true if the compliance module supports the Frictionless token type, otherwise false

function isSupportedComplianceModule(IBasicFrictionlessToken.FrictionlessTokenTypes tokenType_, address moduleToCheck_)
    external
    view
    returns (bool);

Parameters

Returns

isModularCompliance

Returns true if the address provided is a ModularCompliance contract

function isModularCompliance(address modularComplianceAddr_) external view returns (bool);

Parameters

Returns

Events

FrictionlessComplianceDeployed

Event emitted upon successful deployment of a compliance contract.

event FrictionlessComplianceDeployed(
    IBasicFrictionlessToken.FrictionlessTokenTypes indexed tokenType, address newComplianceContract
);

Errors

FrictionlessComplianceFactoryZeroAddr

error thrown if the specified contract address is a zero address, during init, setTreasuryManager, and updateModularComplianceImpl

error FrictionlessComplianceFactoryZeroAddr(string);

FrictionlessComplianceFactoryNotATreasuryManager

error thrown if the msg.sender is not the treasury manager during the function deployCompliance

error FrictionlessComplianceFactoryNotATreasuryManager(address);

FrictionlessComplianceFactoryNotAModularCompliance

error thrown if the modular compliance is invlaid for hte token type during the function updateModularCompliancesModules

error FrictionlessComplianceFactoryNotAModularCompliance(address);

FrictionlessComplianceFactoryInvalidTokenType

error thrown if an invalid tokenType is specified during deployCompliance

error FrictionlessComplianceFactoryInvalidTokenType();

FrictionlessComplianceFactoryInvalidModularComplianceData

error thrown if an invalid module is specified during updateModularCompliancesModules

error FrictionlessComplianceFactoryInvalidModularComplianceData(UpdateModularComplianceData modularComplianceData);

Structs

SupportedComplianceData

struct SupportedComplianceData {
    uint256 maxModulesCount;
    EnumerableSet.AddressSet modules;
    bytes32[48] _gap;
}

ModularComplianceInfo

struct ModularComplianceInfo {
    uint256 maxModulesCount;
    address[] modules;
}

UpdateModularComplianceData

Structure to represent the update of modular compliance data.

struct UpdateModularComplianceData {
    address modularCompliance;
    ModularComplianceInfo complianceInfo;
    bool isAdding;
}

UpdateSupportedComplianceData

Structure to represent the update of modular compliance data for a given token type

struct UpdateSupportedComplianceData {
    IBasicFrictionlessToken.FrictionlessTokenTypes tokenType;
    ModularComplianceInfo complianceInfo;
    bool isAdding;
}