@chainlink/ace 0.5.0

package/packages/vendor/erc-3643/registry/interface/IIdentityRegistry.sol

@@ -0,0 +1,251 @@
+// SPDX-License-Identifier: GPL-3.0
+//
+//                                             :+#####%%%%%%%%%%%%%%+
+//                                         .-*@@@%+.:+%@@@@@%%#***%@@%=
+//                                     :=*%@@@#=.      :#@@%       *@@@%=
+//                       .-+*%@%*-.:+%@@@@@@+.     -*+:  .=#.       :%@@@%-
+//                   :=*@@@@%%@@@@@@@@@%@@@-   .=#@@@%@%=             =@@@@#.
+//             -=+#%@@%#*=:.  :%@@@@%.   -*@@#*@@@@@@@#=:-              *@@@@+
+//            =@@%=:.     :=:   *@@@@@%#-   =%*%@@@@#+-.        =+       :%@@@%-
+//           -@@%.     .+@@@     =+=-.         @@#-           +@@@%-       =@@@@%:
+//          :@@@.    .+@@#%:                   :    .=*=-::.-%@@@+*@@=       +@@@@#.
+//          %@@:    +@%%*                         =%@@@@@@@@@@@#.  .*@%-       +@@@@*.
+//         #@@=                                .+@@@@%:=*@@@@@-      :%@%:      .*@@@@+
+//        *@@*                                +@@@#-@@%-:%@@*          +@@#.      :%@@@@-
+//       -@@%           .:-=++*##%%%@@@@@@@@@@@@*. :@+.@@@%:            .#@@+       =@@@@#:
+//      .@@@*-+*#%%%@@@@@@@@@@@@@@@@%%#**@@%@@@.   *@=*@@#                :#@%=      .#@@@@#-
+//      -%@@@@@@@@@@@@@@@*+==-:-@@@=    *@# .#@*-=*@@@@%=                 -%@@@*       =@@@@@%-
+//         -+%@@@#.   %@%%=   -@@:+@: -@@*    *@@*-::                   -%@@%=.         .*@@@@@#
+//            *@@@*  +@* *@@##@@-  #@*@@+    -@@=          .         :+@@@#:           .-+@@@%+-
+//             +@@@%*@@:..=@@@@*   .@@@*   .#@#.       .=+-       .=%@@@*.         :+#@@@@*=:
+//              =@@@@%@@@@@@@@@@@@@@@@@@@@@@%-      :+#*.       :*@@@%=.       .=#@@@@%+:
+//               .%@@=                 .....    .=#@@+.       .#@@@*:       -*%@@@@%+.
+//                 +@@#+===---:::...         .=%@@*-         +@@@+.      -*@@@@@%+.
+//                  -@@@@@@@@@@@@@@@@@@@@@@%@@@@=          -@@@+      -#@@@@@#=.
+//                    ..:::---===+++***###%%%@@@#-       .#@@+     -*@@@@@#=.
+//                                           @@@@@@+.   +@@*.   .+@@@@@%=.
+//                                          -@@@@@=   =@@%:   -#@@@@%+.
+//                                          +@@@@@. =@@@=  .+@@@@@*:
+//                                          #@@@@#:%@@#. :*@@@@#-
+//                                          @@@@@%@@@= :#@@@@+.
+//                                         :@@@@@@@#.:#@@@%-
+//                                         +@@@@@@-.*@@@*:
+//                                         #@@@@#.=@@@+.
+//                                         @@@@+-%@%=
+//                                        :@@@#%@%=
+//                                        +@@@@%-
+//                                        :#%%=
+//
+/**
+ *     NOTICE
+ *
+ *     The T-REX software is licensed under a proprietary license or the GPL v.3.
+ *     If you choose to receive it under the GPL v.3 license, the following applies:
+ *     T-REX is a suite of smart contracts implementing the ERC-3643 standard and
+ *     developed by Tokeny to manage and transfer financial assets on EVM blockchains
+ *
+ *     Copyright (C) 2023, Tokeny sàrl.
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     GNU General Public License for more details.
+ *
+ *     You should have received a copy of the GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+pragma solidity ^0.8.23;
+
+import "./ITrustedIssuersRegistry.sol";
+import "./IClaimTopicsRegistry.sol";
+import "./IIdentityRegistryStorage.sol";
+
+import "../../../onchain-id/interface/IClaimIssuer.sol";
+import "../../../onchain-id/interface/IIdentity.sol";
+
+interface IIdentityRegistry {
+  /**
+   *  this event is emitted when the ClaimTopicsRegistry has been set for the IdentityRegistry
+   *  the event is emitted by the IdentityRegistry constructor
+   *  `claimTopicsRegistry` is the address of the Claim Topics Registry contract
+   */
+  event ClaimTopicsRegistrySet(address indexed claimTopicsRegistry);
+
+  /**
+   *  this event is emitted when the IdentityRegistryStorage has been set for the IdentityRegistry
+   *  the event is emitted by the IdentityRegistry constructor
+   *  `identityStorage` is the address of the Identity Registry Storage contract
+   */
+  event IdentityStorageSet(address indexed identityStorage);
+
+  /**
+   *  this event is emitted when the TrustedIssuersRegistry has been set for the IdentityRegistry
+   *  the event is emitted by the IdentityRegistry constructor
+   *  `trustedIssuersRegistry` is the address of the Trusted Issuers Registry contract
+   */
+  event TrustedIssuersRegistrySet(address indexed trustedIssuersRegistry);
+
+  /**
+   *  this event is emitted when an Identity is registered into the Identity Registry.
+   *  the event is emitted by the 'registerIdentity' function
+   *  `investorAddress` is the address of the investor's wallet
+   *  `identity` is the address of the Identity smart contract (onchainID)
+   */
+  event IdentityRegistered(address indexed investorAddress, IIdentity indexed identity);
+
+  /**
+   *  this event is emitted when an Identity is removed from the Identity Registry.
+   *  the event is emitted by the 'deleteIdentity' function
+   *  `investorAddress` is the address of the investor's wallet
+   *  `identity` is the address of the Identity smart contract (onchainID)
+   */
+  event IdentityRemoved(address indexed investorAddress, IIdentity indexed identity);
+
+  /**
+   *  this event is emitted when an Identity has been updated
+   *  the event is emitted by the 'updateIdentity' function
+   *  `oldIdentity` is the old Identity contract's address to update
+   *  `newIdentity` is the new Identity contract's
+   */
+  event IdentityUpdated(IIdentity indexed oldIdentity, IIdentity indexed newIdentity);
+
+  /**
+   *  this event is emitted when an Identity's country has been updated
+   *  the event is emitted by the 'updateCountry' function
+   *  `investorAddress` is the address on which the country has been updated
+   *  `country` is the numeric code (ISO 3166-1) of the new country
+   */
+  event CountryUpdated(address indexed investorAddress, uint16 indexed country);
+
+  /**
+   *  @dev Register an identity contract corresponding to a user address.
+   *  Requires that the user doesn't have an identity contract already registered.
+   *  This function can only be called by a wallet set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _identity The address of the user's identity contract
+   *  @param _country The country of the investor
+   *  emits `IdentityRegistered` event
+   */
+  function registerIdentity(address _userAddress, IIdentity _identity, uint16 _country) external;
+
+  /**
+   *  @dev Removes an user from the identity registry.
+   *  Requires that the user have an identity contract already deployed that will be deleted.
+   *  This function can only be called by a wallet set as agent of the smart contract
+   *  @param _userAddress The address of the user to be removed
+   *  emits `IdentityRemoved` event
+   */
+  function deleteIdentity(address _userAddress) external;
+
+  /**
+   *  @dev Replace the actual identityRegistryStorage contract with a new one.
+   *  This function can only be called by the wallet set as owner of the smart contract
+   *  @param _identityRegistryStorage The address of the new Identity Registry Storage
+   *  emits `IdentityStorageSet` event
+   */
+  function setIdentityRegistryStorage(address _identityRegistryStorage) external;
+
+  /**
+   *  @dev Replace the actual claimTopicsRegistry contract with a new one.
+   *  This function can only be called by the wallet set as owner of the smart contract
+   *  @param _claimTopicsRegistry The address of the new claim Topics Registry
+   *  emits `ClaimTopicsRegistrySet` event
+   */
+  function setClaimTopicsRegistry(address _claimTopicsRegistry) external;
+
+  /**
+   *  @dev Replace the actual trustedIssuersRegistry contract with a new one.
+   *  This function can only be called by the wallet set as owner of the smart contract
+   *  @param _trustedIssuersRegistry The address of the new Trusted Issuers Registry
+   *  emits `TrustedIssuersRegistrySet` event
+   */
+  function setTrustedIssuersRegistry(address _trustedIssuersRegistry) external;
+
+  /**
+   *  @dev Updates the country corresponding to a user address.
+   *  Requires that the user should have an identity contract already deployed that will be replaced.
+   *  This function can only be called by a wallet set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _country The new country of the user
+   *  emits `CountryUpdated` event
+   */
+  function updateCountry(address _userAddress, uint16 _country) external;
+
+  /**
+   *  @dev Updates an identity contract corresponding to a user address.
+   *  Requires that the user address should be the owner of the identity contract.
+   *  Requires that the user should have an identity contract already deployed that will be replaced.
+   *  This function can only be called by a wallet set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _identity The address of the user's new identity contract
+   *  emits `IdentityUpdated` event
+   */
+  function updateIdentity(address _userAddress, IIdentity _identity) external;
+
+  /**
+   *  @dev function allowing to register identities in batch
+   *  This function can only be called by a wallet set as agent of the smart contract
+   *  Requires that none of the users has an identity contract already registered.
+   *  IMPORTANT : THIS TRANSACTION COULD EXCEED GAS LIMIT IF `_userAddresses.length` IS TOO HIGH,
+   *  USE WITH CARE OR YOU COULD LOSE TX FEES WITH AN "OUT OF GAS" TRANSACTION
+   *  @param _userAddresses The addresses of the users
+   *  @param _identities The addresses of the corresponding identity contracts
+   *  @param _countries The countries of the corresponding investors
+   *  emits _userAddresses.length `IdentityRegistered` events
+   */
+  function batchRegisterIdentity(
+    address[] calldata _userAddresses,
+    IIdentity[] calldata _identities,
+    uint16[] calldata _countries
+  )
+    external;
+
+  /**
+   *  @dev This functions checks whether a wallet has its Identity registered or not
+   *  in the Identity Registry.
+   *  @param _userAddress The address of the user to be checked.
+   *  @return 'True' if the address is contained in the Identity Registry, 'false' if not.
+   */
+  function contains(address _userAddress) external view returns (bool);
+
+  /**
+   *  @dev This functions checks whether an identity contract
+   *  corresponding to the provided user address has the required claims or not based
+   *  on the data fetched from trusted issuers registry and from the claim topics registry
+   *  @param _userAddress The address of the user to be verified.
+   *  @return 'True' if the address is verified, 'false' if not.
+   */
+  function isVerified(address _userAddress) external view returns (bool);
+
+  /**
+   *  @dev Returns the onchainID of an investor.
+   *  @param _userAddress The wallet of the investor
+   */
+  function identity(address _userAddress) external view returns (IIdentity);
+
+  /**
+   *  @dev Returns the country code of an investor.
+   *  @param _userAddress The wallet of the investor
+   */
+  function investorCountry(address _userAddress) external view returns (uint16);
+
+  /**
+   *  @dev Returns the IdentityRegistryStorage linked to the current IdentityRegistry.
+   */
+  function identityStorage() external view returns (IIdentityRegistryStorage);
+
+  /**
+   *  @dev Returns the TrustedIssuersRegistry linked to the current IdentityRegistry.
+   */
+  function issuersRegistry() external view returns (ITrustedIssuersRegistry);
+
+  /**
+   *  @dev Returns the ClaimTopicsRegistry linked to the current IdentityRegistry.
+   */
+  function topicsRegistry() external view returns (IClaimTopicsRegistry);
+}

package/packages/vendor/erc-3643/registry/interface/IIdentityRegistryStorage.sol

@@ -0,0 +1,191 @@
+// SPDX-License-Identifier: GPL-3.0
+//
+//                                             :+#####%%%%%%%%%%%%%%+
+//                                         .-*@@@%+.:+%@@@@@%%#***%@@%=
+//                                     :=*%@@@#=.      :#@@%       *@@@%=
+//                       .-+*%@%*-.:+%@@@@@@+.     -*+:  .=#.       :%@@@%-
+//                   :=*@@@@%%@@@@@@@@@%@@@-   .=#@@@%@%=             =@@@@#.
+//             -=+#%@@%#*=:.  :%@@@@%.   -*@@#*@@@@@@@#=:-              *@@@@+
+//            =@@%=:.     :=:   *@@@@@%#-   =%*%@@@@#+-.        =+       :%@@@%-
+//           -@@%.     .+@@@     =+=-.         @@#-           +@@@%-       =@@@@%:
+//          :@@@.    .+@@#%:                   :    .=*=-::.-%@@@+*@@=       +@@@@#.
+//          %@@:    +@%%*                         =%@@@@@@@@@@@#.  .*@%-       +@@@@*.
+//         #@@=                                .+@@@@%:=*@@@@@-      :%@%:      .*@@@@+
+//        *@@*                                +@@@#-@@%-:%@@*          +@@#.      :%@@@@-
+//       -@@%           .:-=++*##%%%@@@@@@@@@@@@*. :@+.@@@%:            .#@@+       =@@@@#:
+//      .@@@*-+*#%%%@@@@@@@@@@@@@@@@%%#**@@%@@@.   *@=*@@#                :#@%=      .#@@@@#-
+//      -%@@@@@@@@@@@@@@@*+==-:-@@@=    *@# .#@*-=*@@@@%=                 -%@@@*       =@@@@@%-
+//         -+%@@@#.   %@%%=   -@@:+@: -@@*    *@@*-::                   -%@@%=.         .*@@@@@#
+//            *@@@*  +@* *@@##@@-  #@*@@+    -@@=          .         :+@@@#:           .-+@@@%+-
+//             +@@@%*@@:..=@@@@*   .@@@*   .#@#.       .=+-       .=%@@@*.         :+#@@@@*=:
+//              =@@@@%@@@@@@@@@@@@@@@@@@@@@@%-      :+#*.       :*@@@%=.       .=#@@@@%+:
+//               .%@@=                 .....    .=#@@+.       .#@@@*:       -*%@@@@%+.
+//                 +@@#+===---:::...         .=%@@*-         +@@@+.      -*@@@@@%+.
+//                  -@@@@@@@@@@@@@@@@@@@@@@%@@@@=          -@@@+      -#@@@@@#=.
+//                    ..:::---===+++***###%%%@@@#-       .#@@+     -*@@@@@#=.
+//                                           @@@@@@+.   +@@*.   .+@@@@@%=.
+//                                          -@@@@@=   =@@%:   -#@@@@%+.
+//                                          +@@@@@. =@@@=  .+@@@@@*:
+//                                          #@@@@#:%@@#. :*@@@@#-
+//                                          @@@@@%@@@= :#@@@@+.
+//                                         :@@@@@@@#.:#@@@%-
+//                                         +@@@@@@-.*@@@*:
+//                                         #@@@@#.=@@@+.
+//                                         @@@@+-%@%=
+//                                        :@@@#%@%=
+//                                        +@@@@%-
+//                                        :#%%=
+//
+/**
+ *     NOTICE
+ *
+ *     The T-REX software is licensed under a proprietary license or the GPL v.3.
+ *     If you choose to receive it under the GPL v.3 license, the following applies:
+ *     T-REX is a suite of smart contracts implementing the ERC-3643 standard and
+ *     developed by Tokeny to manage and transfer financial assets on EVM blockchains
+ *
+ *     Copyright (C) 2023, Tokeny sàrl.
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     GNU General Public License for more details.
+ *
+ *     You should have received a copy of the GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+pragma solidity ^0.8.23;
+
+import "../../../onchain-id/interface/IIdentity.sol";
+
+interface IIdentityRegistryStorage {
+  /// events
+
+  /**
+   *  this event is emitted when an Identity is registered into the storage contract.
+   *  the event is emitted by the 'registerIdentity' function
+   *  `investorAddress` is the address of the investor's wallet
+   *  `identity` is the address of the Identity smart contract (onchainID)
+   */
+  event IdentityStored(address indexed investorAddress, IIdentity indexed identity);
+
+  /**
+   *  this event is emitted when an Identity is removed from the storage contract.
+   *  the event is emitted by the 'deleteIdentity' function
+   *  `investorAddress` is the address of the investor's wallet
+   *  `identity` is the address of the Identity smart contract (onchainID)
+   */
+  event IdentityUnstored(address indexed investorAddress, IIdentity indexed identity);
+
+  /**
+   *  this event is emitted when an Identity has been updated
+   *  the event is emitted by the 'updateIdentity' function
+   *  `oldIdentity` is the old Identity contract's address to update
+   *  `newIdentity` is the new Identity contract's
+   */
+  event IdentityModified(IIdentity indexed oldIdentity, IIdentity indexed newIdentity);
+
+  /**
+   *  this event is emitted when an Identity's country has been updated
+   *  the event is emitted by the 'updateCountry' function
+   *  `investorAddress` is the address on which the country has been updated
+   *  `country` is the numeric code (ISO 3166-1) of the new country
+   */
+  event CountryModified(address indexed investorAddress, uint16 indexed country);
+
+  /**
+   *  this event is emitted when an Identity Registry is bound to the storage contract
+   *  the event is emitted by the 'addIdentityRegistry' function
+   *  `identityRegistry` is the address of the identity registry added
+   */
+  event IdentityRegistryBound(address indexed identityRegistry);
+
+  /**
+   *  this event is emitted when an Identity Registry is unbound from the storage contract
+   *  the event is emitted by the 'removeIdentityRegistry' function
+   *  `identityRegistry` is the address of the identity registry removed
+   */
+  event IdentityRegistryUnbound(address indexed identityRegistry);
+
+  /// functions
+
+  /**
+   *  @dev adds an identity contract corresponding to a user address in the storage.
+   *  Requires that the user doesn't have an identity contract already registered.
+   *  This function can only be called by an address set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _identity The address of the user's identity contract
+   *  @param _country The country of the investor
+   *  emits `IdentityStored` event
+   */
+  function addIdentityToStorage(address _userAddress, IIdentity _identity, uint16 _country) external;
+
+  /**
+   *  @dev Removes an user from the storage.
+   *  Requires that the user have an identity contract already deployed that will be deleted.
+   *  This function can only be called by an address set as agent of the smart contract
+   *  @param _userAddress The address of the user to be removed
+   *  emits `IdentityUnstored` event
+   */
+  function removeIdentityFromStorage(address _userAddress) external;
+
+  /**
+   *  @dev Updates the country corresponding to a user address.
+   *  Requires that the user should have an identity contract already deployed that will be replaced.
+   *  This function can only be called by an address set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _country The new country of the user
+   *  emits `CountryModified` event
+   */
+  function modifyStoredInvestorCountry(address _userAddress, uint16 _country) external;
+
+  /**
+   *  @dev Updates an identity contract corresponding to a user address.
+   *  Requires that the user address should be the owner of the identity contract.
+   *  Requires that the user should have an identity contract already deployed that will be replaced.
+   *  This function can only be called by an address set as agent of the smart contract
+   *  @param _userAddress The address of the user
+   *  @param _identity The address of the user's new identity contract
+   *  emits `IdentityModified` event
+   */
+  function modifyStoredIdentity(address _userAddress, IIdentity _identity) external;
+
+  /**
+   *  @notice Adds an identity registry as agent of the Identity Registry Storage Contract.
+   *  This function can only be called by the wallet set as owner of the smart contract
+   *  This function adds the identity registry to the list of identityRegistries linked to the storage contract
+   *  cannot bind more than 300 IR to 1 IRS
+   *  @param _identityRegistry The identity registry address to add.
+   */
+  function bindIdentityRegistry(address _identityRegistry) external;
+
+  /**
+   *  @notice Removes an identity registry from being agent of the Identity Registry Storage Contract.
+   *  This function can only be called by the wallet set as owner of the smart contract
+   *  This function removes the identity registry from the list of identityRegistries linked to the storage contract
+   *  @param _identityRegistry The identity registry address to remove.
+   */
+  function unbindIdentityRegistry(address _identityRegistry) external;
+
+  /**
+   *  @dev Returns the identity registries linked to the storage contract
+   */
+  function linkedIdentityRegistries() external view returns (address[] memory);
+
+  /**
+   *  @dev Returns the onchainID of an investor.
+   *  @param _userAddress The wallet of the investor
+   */
+  function storedIdentity(address _userAddress) external view returns (IIdentity);
+
+  /**
+   *  @dev Returns the country code of an investor.
+   *  @param _userAddress The wallet of the investor
+   */
+  function storedInvestorCountry(address _userAddress) external view returns (uint16);
+}

package/packages/vendor/erc-3643/registry/interface/ITrustedIssuersRegistry.sol

@@ -0,0 +1,161 @@
+// SPDX-License-Identifier: GPL-3.0
+//
+//                                             :+#####%%%%%%%%%%%%%%+
+//                                         .-*@@@%+.:+%@@@@@%%#***%@@%=
+//                                     :=*%@@@#=.      :#@@%       *@@@%=
+//                       .-+*%@%*-.:+%@@@@@@+.     -*+:  .=#.       :%@@@%-
+//                   :=*@@@@%%@@@@@@@@@%@@@-   .=#@@@%@%=             =@@@@#.
+//             -=+#%@@%#*=:.  :%@@@@%.   -*@@#*@@@@@@@#=:-              *@@@@+
+//            =@@%=:.     :=:   *@@@@@%#-   =%*%@@@@#+-.        =+       :%@@@%-
+//           -@@%.     .+@@@     =+=-.         @@#-           +@@@%-       =@@@@%:
+//          :@@@.    .+@@#%:                   :    .=*=-::.-%@@@+*@@=       +@@@@#.
+//          %@@:    +@%%*                         =%@@@@@@@@@@@#.  .*@%-       +@@@@*.
+//         #@@=                                .+@@@@%:=*@@@@@-      :%@%:      .*@@@@+
+//        *@@*                                +@@@#-@@%-:%@@*          +@@#.      :%@@@@-
+//       -@@%           .:-=++*##%%%@@@@@@@@@@@@*. :@+.@@@%:            .#@@+       =@@@@#:
+//      .@@@*-+*#%%%@@@@@@@@@@@@@@@@%%#**@@%@@@.   *@=*@@#                :#@%=      .#@@@@#-
+//      -%@@@@@@@@@@@@@@@*+==-:-@@@=    *@# .#@*-=*@@@@%=                 -%@@@*       =@@@@@%-
+//         -+%@@@#.   %@%%=   -@@:+@: -@@*    *@@*-::                   -%@@%=.         .*@@@@@#
+//            *@@@*  +@* *@@##@@-  #@*@@+    -@@=          .         :+@@@#:           .-+@@@%+-
+//             +@@@%*@@:..=@@@@*   .@@@*   .#@#.       .=+-       .=%@@@*.         :+#@@@@*=:
+//              =@@@@%@@@@@@@@@@@@@@@@@@@@@@%-      :+#*.       :*@@@%=.       .=#@@@@%+:
+//               .%@@=                 .....    .=#@@+.       .#@@@*:       -*%@@@@%+.
+//                 +@@#+===---:::...         .=%@@*-         +@@@+.      -*@@@@@%+.
+//                  -@@@@@@@@@@@@@@@@@@@@@@%@@@@=          -@@@+      -#@@@@@#=.
+//                    ..:::---===+++***###%%%@@@#-       .#@@+     -*@@@@@#=.
+//                                           @@@@@@+.   +@@*.   .+@@@@@%=.
+//                                          -@@@@@=   =@@%:   -#@@@@%+.
+//                                          +@@@@@. =@@@=  .+@@@@@*:
+//                                          #@@@@#:%@@#. :*@@@@#-
+//                                          @@@@@%@@@= :#@@@@+.
+//                                         :@@@@@@@#.:#@@@%-
+//                                         +@@@@@@-.*@@@*:
+//                                         #@@@@#.=@@@+.
+//                                         @@@@+-%@%=
+//                                        :@@@#%@%=
+//                                        +@@@@%-
+//                                        :#%%=
+//
+
+/**
+ *     NOTICE
+ *
+ *     The T-REX software is licensed under a proprietary license or the GPL v.3.
+ *     If you choose to receive it under the GPL v.3 license, the following applies:
+ *     T-REX is a suite of smart contracts implementing the ERC-3643 standard and
+ *     developed by Tokeny to manage and transfer financial assets on EVM blockchains
+ *
+ *     Copyright (C) 2023, Tokeny sàrl.
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     GNU General Public License for more details.
+ *
+ *     You should have received a copy of the GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+pragma solidity ^0.8.23;
+
+import "../../../onchain-id/interface/IClaimIssuer.sol";
+
+interface ITrustedIssuersRegistry {
+  /**
+   *  this event is emitted when a trusted issuer is added in the registry.
+   *  the event is emitted by the addTrustedIssuer function
+   *  `trustedIssuer` is the address of the trusted issuer's ClaimIssuer contract
+   *  `claimTopics` is the set of claims that the trusted issuer is allowed to emit
+   */
+  event TrustedIssuerAdded(IClaimIssuer indexed trustedIssuer, uint256[] claimTopics);
+
+  /**
+   *  this event is emitted when a trusted issuer is removed from the registry.
+   *  the event is emitted by the removeTrustedIssuer function
+   *  `trustedIssuer` is the address of the trusted issuer's ClaimIssuer contract
+   */
+  event TrustedIssuerRemoved(IClaimIssuer indexed trustedIssuer);
+
+  /**
+   *  this event is emitted when the set of claim topics is changed for a given trusted issuer.
+   *  the event is emitted by the updateIssuerClaimTopics function
+   *  `trustedIssuer` is the address of the trusted issuer's ClaimIssuer contract
+   *  `claimTopics` is the set of claims that the trusted issuer is allowed to emit
+   */
+  event ClaimTopicsUpdated(IClaimIssuer indexed trustedIssuer, uint256[] claimTopics);
+
+  /**
+   *  @dev registers a ClaimIssuer contract as trusted claim issuer.
+   *  Requires that a ClaimIssuer contract doesn't already exist
+   *  Requires that the claimTopics set is not empty
+   *  Requires that there is no more than 15 claimTopics
+   *  Requires that there is no more than 50 Trusted issuers
+   *  @param _trustedIssuer The ClaimIssuer contract address of the trusted claim issuer.
+   *  @param _claimTopics the set of claim topics that the trusted issuer is allowed to emit
+   *  This function can only be called by the owner of the Trusted Issuers Registry contract
+   *  emits a `TrustedIssuerAdded` event
+   */
+  function addTrustedIssuer(IClaimIssuer _trustedIssuer, uint256[] calldata _claimTopics) external;
+
+  /**
+   *  @dev Removes the ClaimIssuer contract of a trusted claim issuer.
+   *  Requires that the claim issuer contract to be registered first
+   *  @param _trustedIssuer the claim issuer to remove.
+   *  This function can only be called by the owner of the Trusted Issuers Registry contract
+   *  emits a `TrustedIssuerRemoved` event
+   */
+  function removeTrustedIssuer(IClaimIssuer _trustedIssuer) external;
+
+  /**
+   *  @dev Updates the set of claim topics that a trusted issuer is allowed to emit.
+   *  Requires that this ClaimIssuer contract already exists in the registry
+   *  Requires that the provided claimTopics set is not empty
+   *  Requires that there is no more than 15 claimTopics
+   *  @param _trustedIssuer the claim issuer to update.
+   *  @param _claimTopics the set of claim topics that the trusted issuer is allowed to emit
+   *  This function can only be called by the owner of the Trusted Issuers Registry contract
+   *  emits a `ClaimTopicsUpdated` event
+   */
+  function updateIssuerClaimTopics(IClaimIssuer _trustedIssuer, uint256[] calldata _claimTopics) external;
+
+  /**
+   *  @dev Function for getting all the trusted claim issuers stored.
+   *  @return array of all claim issuers registered.
+   */
+  function getTrustedIssuers() external view returns (IClaimIssuer[] memory);
+
+  /**
+   *  @dev Function for getting all the trusted issuer allowed for a given claim topic.
+   *  @param claimTopic the claim topic to get the trusted issuers for.
+   *  @return array of all claim issuer addresses that are allowed for the given claim topic.
+   */
+  function getTrustedIssuersForClaimTopic(uint256 claimTopic) external view returns (IClaimIssuer[] memory);
+
+  /**
+   *  @dev Checks if the ClaimIssuer contract is trusted
+   *  @param _issuer the address of the ClaimIssuer contract
+   *  @return true if the issuer is trusted, false otherwise.
+   */
+  function isTrustedIssuer(address _issuer) external view returns (bool);
+
+  /**
+   *  @dev Function for getting all the claim topic of trusted claim issuer
+   *  Requires the provided ClaimIssuer contract to be registered in the trusted issuers registry.
+   *  @param _trustedIssuer the trusted issuer concerned.
+   *  @return The set of claim topics that the trusted issuer is allowed to emit
+   */
+  function getTrustedIssuerClaimTopics(IClaimIssuer _trustedIssuer) external view returns (uint256[] memory);
+
+  /**
+   *  @dev Function for checking if the trusted claim issuer is allowed
+   *  to emit a certain claim topic
+   *  @param _issuer the address of the trusted issuer's ClaimIssuer contract
+   *  @param _claimTopic the Claim Topic that has to be checked to know if the `issuer` is allowed to emit it
+   *  @return true if the issuer is trusted for this claim topic.
+   */
+  function hasClaimTopic(address _issuer, uint256 _claimTopic) external view returns (bool);
+}