1 of 5

IFrictionlessTreasuryManager

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.

The IFrictionlessTreasuryManager is responsible for all token operations, minting, transferring and burning in the Frictionless protocol. The tokens and their lifecycles are defined in the public README for the Frictionless protocol at https://gitlab.com/dfyclabs/protocol/dfyclabs-tokens/-/tree/main?ref_type=heads#tokens-overview

Functions

setTokensInitData

Sets and associates the implementation authority with the associated token type

Parameters

mintFundDepositForTreasury

Mints a Fund Deposit Token in the specified currency/IBAN pair. This function is invoked to create the genesis mint of the deposit token in the PROTOCOL_TREASURY.

Parameters

Returns

mintDigitalSecurity

Mints a FrictionlessDigitalSecurityToken as the future dated cash distribution from the underlying FrictionlessOnChainAssetToken. This function is invoked to create the genesis mint of the deposit token in the PROTOCOL_TREASURY.

Parameters

Returns

mintOnChainAsset

Mints a FrictionlessOnChainAssetToken as the representation of the asset to be securitized, fractionalized & sold. This function is invoked to create the genesis mint of the deposit token to the PERMISSIONED_CUSTODIAN.

Parameters

Returns

mintTokenForUser

Used to increase the mint of a Frictionless token which already exists.

Parameters

Name

Type

Description

token

address

the address of the token

userAddress

address

the address to min the token to

amount

uint256

the amount of tokens to mint emits FrictionlessTokenMinted event

transferToken

Used to increase the mint of a Frictionless token which already exists.

function transferToken(address token, address userAddressFrom, address userAddressTo, uint256 amount) external;

Parameters

Name

Type

Description

token

address

the address of the token

userAddressFrom

address

the address to transfer the tokens from

userAddressTo

address

the address to transfer the tokens to

amount

uint256

the amount of tokens to mint emits FrictionlessTokenTransferred event

burnToken

Used to burn an amount of Frictionless token which already exists.

function burnToken(address token, address userAddress, uint256 amount) external;

Parameters

Name

Type

Description

token

address

the address of the token

userAddress

address

the address to burn the tokens from

amount

uint256

the amount of tokens to burn emits FrictionlessTokenBurned event

getFundDepositToken

returns the address of the fund deposit token by currency and fundIBAN

function getFundDepositToken(string calldata currency_, string calldata fundIBAN_) external view returns (address);

Parameters

Name

Type

Description

currency_

string

the currency of the fund deposit token

fundIBAN_

string

the fundIBAN of the fund deposit token

Returns

getFundDepositTokenKey

returns fund deposit token key by currency and fundIBAN

Parameters

Returns

Events

FrictionlessTokenMinted

Event emitted when a FrictionlessFundDeposit, FrictionlessDigitalSecurity or FrictionlessOnChainAsset is minted.

FrictionlessTokenTransferred

Event emitted when a FrictionlessFundDeposit, FrictionlessDigitalSecurity or FrictionlessOnChainAsset is transferred.

FrictionlessTokenBurned

Event emitted when a FrictionlessFundDeposit, FrictionlessDigitalSecurity or FrictionlessOnChainAsset is burned.

Errors

FrictionlessIsZeroAddress

throws if specific address is zero.

FrictionlessTreasuryManagerNotAProtocolTreasury

error throw if the function caller is not a PROTOCOL_TREASURY address. Thrown during the mintFundDepositForTreasury

FrictionlessTreasuryManagerFundDepositTokenAlreadyExists

error throw if the FundDepositToken for specified currency and fundIBAN already exists

FrictionlessTreasuryManagerInvalidTokenInitData

error throw if the data for the token init data FrictionlessTokenInitData is invalid. Thrown during the _setTokensInitData

FrictionlessTreasuryManagerUnableToUpdateTokenInitData

error throw if the data for the token init data FrictionlessTokenInitData is already set. Thrown during the _setTokensInitData

FrictionlessTreasuryManagerInvalidDepositData

error throw if the data for the IFrictionlessFundDepositToken is invalid. Thrown during the mintFundDepositForTreasury

FrictionlessTreasuryManagerInvalidFDSImmutableData

error throw if the data for the IFrictionlessDigitalSecurityToken is invalid. Thrown during the mintDigitalSecurity

FrictionlessTreasuryManagerInvalidFOCASpecData

error throw if the data for the IFrictionlessDigitalSecurityToken is invalid. Thrown during the mintOnChainAsset

FrictionlessTreasuryManagerInvalidFOCAIssuanceData

error throw if the data for the IFrictionlessDigitalSecurityToken is invalid. Thrown during the mintOnChainAsset

Structs

FrictionlessTokenInitData

Structure that encapsulates both the implAuthority and the compliance for the specific token.