@etherisc/gif-next 0.0.2-eb7397c → 0.0.2-eb7c077-523

package/contracts/registry/ChainNft.sol

@@ -1,15 +1,30 @@
 // SPDX-License-Identifier: Apache-2.0
-pragma solidity ^0.8.19;
+pragma solidity ^0.8.20;
 
 import {ERC721, ERC721Enumerable} from "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";
-import {IChainNft} from "./IChainNft.sol";
+import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol";
 
-contract ChainNft is
-    ERC721Enumerable,
-    IChainNft
-{
-    string public constant NAME = "Dezentralized Insurance Protocol Registry";
-    string public constant SYMBOL = "DIPR";
+import {ITransferInterceptor} from "./ITransferInterceptor.sol";
+
+contract ChainNft is ERC721Enumerable {
+
+    // constants
+    string public constant NAME = "Dezentralized Insurance Protocol NFT";
+    string public constant SYMBOL = "DIPNFT";
+
+    uint256 public constant PROTOCOL_NFT_ID = 1101;
+    uint256 public constant GLOBAL_REGISTRY_ID = 2101; //TODO make dependent of MAINNET_CHAIN_ID constant?
+
+    // custom errors
+    error ErrorChainNftCallerNotRegistry(address caller);
+    error ErrorChainNftRegistryAddressZero();
+    error ErrorChainNftUriEmpty();
+    error ErrorChainNftUriAlreadySet();
+
+    // contract state
+
+    // remember interceptors
+    mapping(uint256 tokenId => address interceptor) private _interceptor;
 
     // remember token uri
     mapping(uint256 tokenId => string uri) private _uri;
@@ -18,156 +33,186 @@ contract ChainNft is
     address private _registry;
 
     // only used for _getNextTokenId
-    uint256 internal _chainIdInt; 
-    uint256 internal _chainIdDigits;
-    uint256 internal _chainIdMultiplier;
     uint256 internal _idNext;
     uint256 internal _totalMinted;
 
-
     modifier onlyRegistry() {
-        require(msg.sender == _registry, "ERROR:NFT-001:CALLER_NOT_REGISTRY");
+        if (msg.sender != _registry) { revert ErrorChainNftCallerNotRegistry(msg.sender); }
         _;
     }
 
-
-    constructor(address registry)
-        ERC721(NAME, SYMBOL)
-    {
-        require(registry != address(0), "ERROR:NFT-010:REGISTRY_ZERO");
+    constructor(address registry) ERC721(NAME, SYMBOL) {
+        if (registry == address(0)) { revert ErrorChainNftRegistryAddressZero(); }
 
         _registry = registry;
 
-        _chainIdInt = block.chainid;
-        _chainIdDigits = _countDigits(_chainIdInt);
-        _chainIdMultiplier = 10 ** _chainIdDigits;
+        // the first object registered through normal registration starts with id 4
+        // 1 -> protocol
+        // 2 -> registry
+        // 3 -> staking
+        // >= 4 -> all other objects
+        _idNext = 4;
+    }
 
-        // on mainnet/goerli start /1 (reserved for protocol nft) on other chains with 2
-        if(block.chainid == 1 || block.chainid == 5) {
-            _idNext = 1;
-        } else {
-            _idNext = 2;
-        }
+    /**
+    * @dev mints a token for a specified token id
+    * not part of the IRegistry interface only needed for
+    * initial registry setup (protocol and global registry objects)
+    */
+    function mint(address to, uint256 tokenId) external onlyRegistry {
+        _totalMinted++;
+        _safeMint(to, tokenId);
     }
 
 
+    /**
+    * @dev mints the next token to register new objects
+    * non-zero transferInterceptors are recorded and called during nft token transfers.
+    * the contract receiving such a notification may decides to revert or record the transfer
+    */
     function mint(
         address to,
+        address interceptor,
         string memory uri
-    )
-        external
-        override
-        onlyRegistry
-        returns(uint256 tokenId)
-    {
+    ) public onlyRegistry returns (uint256 tokenId) {
         tokenId = _getNextTokenId();
-        _totalMinted++;
 
-        _safeMint(to, tokenId);
+        if (interceptor != address(0)) {
+            _interceptor[tokenId] = interceptor;
+        }
 
-        if(bytes(uri).length > 0) {
+        if (bytes(uri).length > 0) {
             _uri[tokenId] = uri;
         }
+
+        _totalMinted++;
+        _safeMint(to, tokenId);
+
+        if(interceptor != address(0)) {
+            ITransferInterceptor(interceptor).nftMint(to, tokenId);
+        }
     }
 
 
-    function burn(uint256 tokenId)
-        external
-        override
-        onlyRegistry
-    {
-        _requireMinted(tokenId);
+    /**
+     * @dev amend the open zeppelin transferFrom function by an interceptor call if such an interceptor is defined for the nft token id
+     * this allows distribution, product and pool components to be notified when distributors, policies and bundles are transferred.
+     */
+    function transferFrom(address from, address to, uint256 tokenId) public override (ERC721, IERC721) {
+        super.transferFrom(from, to, tokenId);
+
+        if (_interceptor[tokenId] != address(0)) {
+            ITransferInterceptor(_interceptor[tokenId]).nftTransferFrom(from, to, tokenId);
+        }
+    }
+
+
+    function burn(uint256 tokenId) external onlyRegistry {
+        _requireOwned(tokenId);
         _burn(tokenId);
         delete _uri[tokenId];
     }
 
+    function setURI(
+        uint256 tokenId,
+        string memory uri
+    ) external onlyRegistry {
+        if (bytes(uri).length == 0) { revert ErrorChainNftUriEmpty(); }
+        if (bytes(_uri[tokenId]).length > 0) { revert ErrorChainNftUriAlreadySet(); }
 
-    function setURI(uint256 tokenId, string memory uri)
-        external
-        override
-        onlyRegistry
-    {
-        require(bytes(uri).length > 0, "ERROR:CRG-011:URI_EMPTY");
-
-        _requireMinted(tokenId);
+        _requireOwned(tokenId);
         _uri[tokenId] = uri;
     }
 
-
-    function exists(uint256 tokenId)
-        external
-        view
-        override
-        returns(bool)
-    {
-        return _exists(tokenId);
+    function exists(uint256 tokenId) external view returns (bool) {
+        return _ownerOf(tokenId) != address(0);
     }
 
-
-    function tokenURI(uint256 tokenId)
-        public
-        view
-        override 
-        returns(string memory)
-    {
-        _requireMinted(tokenId);
+    function tokenURI(
+        uint256 tokenId
+    ) public view override returns (string memory) {
+        // gif generally does not revert for view functions
+        // this is an exception to keep the openzeppelin nft semantics
+        _requireOwned(tokenId);
         return _uri[tokenId];
     }
 
+    function getInterceptor(uint256 tokenId) external view returns (address) {
+        return _interceptor[tokenId];
+    }
 
-    function getRegistryAddress()
-        external
-        view
-        override
-        returns(address)
-    {
+    function getRegistryAddress() external view returns (address) {
         return _registry;
     }
 
-    function totalMinted() external override view returns(uint256) {
+    function totalMinted() external view returns (uint256) {
         return _totalMinted;
     }
 
-    // requirement: each chain registry produces token ids that
-    // are guaranteed to not collide with any token id genereated
-    // on a different chain
-    //
-    // format concat(counter,chainid,2 digits for len-of-chain-id)
-    // restriction chainid up to 99 digits
-    // decode: from right to left:
-    // - 2 right most digits encode length of chainid
-    // - move number of digits to left as determined above (-> chainid)
-    // - the reminder to the left is the counter
-    // examples
-    // 1101
-    // ^^ ^
-    // || +- 1-digit chain id
-    // |+-- chain id = 1 (mainnet)
-    // +-- 1st token id on mainnet
-    // (1 * 10 ** 1 + 1) * 100 + 1
-    // 42987654321010
-    // ^ ^          ^
-    // | |          +- 10-digit chain id
-    // | +-- chain id = 9876543210 (hypothetical chainid)
-    // +-- 42nd token id on this chain
-    // (42 * 10 ** 10 + 9876543210) * 100 + 10
-    // (index * 10 ** digits + chainid) * 100 + digits (1 < digits < 100)
-
-    function _getNextTokenId() private returns(uint256 id) {
-        id = (_idNext * _chainIdMultiplier + _chainIdInt) * 100 + _chainIdDigits;
-        _idNext++;
+    /**
+    * @dev token id calculation based on an index value that is supposed
+    * to increase with every minted token
+    *
+    * requirement: each chain registry produces token ids that
+    * are guaranteed to not collide with any token id genereated
+    * on a different chain
+    *
+    * format concat(counter,chainid,2 digits for len-of-chain-id)
+    * restriction chainid up to 99 digits
+    * decode: from right to left:
+    * - 2 right most digits encode length of chainid
+    * - move number of digits to left as determined above (-> chainid)
+    * - the reminder to the left is the counter
+    *
+    * special cases
+    * 1101 -> decentralized insurance protocol
+    * 2102 -> global registry
+    * 2xxxxx -> chain registry, where xxxxx = <chain-part> 
+    *
+    * examples
+    * 1101
+    * ^^ ^
+    * || +- 1-digit chain id
+    * |+-- chain id = 1 (mainnet)
+    * +-- 1st token id on mainnet
+    * (1 * 10 ** 1 + 1) * 100 + 1
+    * 42987654321010
+    * ^ ^          ^
+    * | |          +- 10-digit chain id
+    * | +-- chain id = 9876543210 (hypothetical chainid)
+    * +-- 42nd token id on this chain
+    * (42 * 10 ** 10 + 9876543210) * 100 + 10
+    * (index * 10 ** digits + chainid) * 100 + digits (1 < digits < 100)
+    */
+    // TODO consider situation when chainId = 2^256
+    function calculateTokenId(uint256 idIndex, uint chainId) public view returns (uint256 id) {
+        uint256 chainIdDigits = _chainIdDigits(chainId);
+        id =
+            (idIndex * (10 ** chainIdDigits) + chainId) *
+            100 +
+            chainIdDigits;
+    }
+
+    function calculateTokenId(uint256 idIndex) public view returns (uint256 id) {
+        id = calculateTokenId(idIndex, block.chainid);
     }
 
+    function getNextTokenId() external view returns (uint256) {
+        return calculateTokenId(_idNext);
+    }
+
+    function _getNextTokenId() private returns (uint256 id) {
+        id = calculateTokenId(_idNext);
+        _idNext++;
+    }
 
-    function _countDigits(uint256 num)
-        private 
-        pure 
-        returns (uint256 count)
-    {
-        count = 0;
+    function _chainIdDigits(uint chainId) internal view returns (uint256) {
+        uint256 num = chainId;
+        uint256 digits = 0;
         while (num != 0) {
-            count++;
+            digits++;
             num /= 10;
         }
+        return digits;
     }
 }

package/contracts/registry/GlobalRegistry.sol

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: Apache-2.0
+pragma solidity ^0.8.20;
+
+import {EnumerableSet} from "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
+
+import {NftId, NftIdLib} from "../type/NftId.sol";
+import {VersionPart} from "../type/Version.sol";
+import {ObjectType, REGISTRY} from "../type/ObjectType.sol";
+
+import {IGlobalRegistry} from "./IGlobalRegistry.sol";
+import {Registry} from "./Registry.sol";
+import {RegistryAdmin} from "./RegistryAdmin.sol";
+import {MainnetContract} from "../shared/MainnetId.sol";
+
+contract GlobalRegistry is
+    MainnetContract, 
+    Registry,
+    IGlobalRegistry
+{
+    using EnumerableSet for EnumerableSet.AddressSet;
+
+    error ErrorGlobalRegistryDeploymentNotOnMainnet(uint chainId);
+    error ErrorGlobalRegistryChainRegistryAlreadyRegistered(uint chainId, address chainRegistry);
+    error ErrorGlobalRegistryChainRegistryAddressInvalid(uint chainId, address chainRegistry);
+
+    mapping(uint chanId => address registry) _registryAddressByChainId;
+    uint256[] _chainId;
+
+    constructor(RegistryAdmin admin) Registry(admin, address(this)) 
+    {}
+
+    /// @dev registers a registry contract for a specified chain
+    //  only one chain registry per chain
+    //  each chain registry have unique address (sort of share same address space)
+    function registerChainRegistry(uint chainId, address chainRegistryAddress)
+        external
+        restricted
+        returns (NftId chainRegistryNftId)
+    {
+        // TODO allow for the same address to be registered on multiple chains
+        if(_nftIdByAddress[chainRegistryAddress] != NftIdLib.zero()) {
+            revert ErrorGlobalRegistryChainRegistryAddressInvalid(chainId, chainRegistryAddress);
+        }
+        // redundant -> chainRegistryId is chainId dependent, chainNft will revert if chainRegistryId is already minted
+        if(_registryAddressByChainId[chainId] != address(0)) {
+            revert ErrorGlobalRegistryChainRegistryAlreadyRegistered(chainId, _registryAddressByChainId[chainId]);
+        }
+
+        // calculate chain registry token id
+        uint chainRegistryId = _chainNft.calculateTokenId(REGISTRY_TOKEN_SEQUENCE_ID, chainId);
+        chainRegistryNftId = NftIdLib.toNftId(chainRegistryId);
+
+        _info[chainRegistryNftId] = ObjectInfo({
+            nftId: chainRegistryNftId,
+            parentNftId: _registryNftId,
+            objectType: REGISTRY(),
+            isInterceptor: false,
+            objectAddress: chainRegistryAddress, // TODO consider "chainId:address" format
+            initialOwner: NFT_LOCK_ADDRESS,
+            data: ""  
+        });
+
+        _nftIdByAddress[chainRegistryAddress] = chainRegistryNftId;
+        _registryAddressByChainId[chainId] = chainRegistryAddress;
+        _chainId.push(chainId);
+
+        _chainNft.mint(NFT_LOCK_ADDRESS, chainRegistryId);
+    }
+
+    //------------- public view functions -------------//
+    function getChainRegistryAddress(uint chainId) public view returns (address) {
+        return _registryAddressByChainId[chainId];
+    }
+
+    function getChainId(uint idx) public view returns (uint) {
+        return _chainId[idx];
+    }
+
+    function chainIds() public view returns (uint) {
+        return _chainId.length;
+    }
+
+    // Internals
+
+    /// @dev global registry already registered, register specifics only
+    function _registerRegistry() 
+        internal
+        virtual
+        override
+        returns (NftId)
+    {
+        _registryAddressByChainId[MAINNET_CHAIN_ID] = address(this);
+        return _globalRegistryNftId;
+    }
+}

package/contracts/registry/GlobalRegistryAdmin.sol

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.20;
+
+import {GIF_ADMIN_ROLE} from "../type/RoleId.sol";
+
+import {IGlobalRegistry} from "./IGlobalRegistry.sol";
+import {RegistryAdmin} from "./RegistryAdmin.sol";
+import {MainnetContract} from "../shared/MainnetId.sol";
+
+
+contract GlobalRegistryAdmin is
+    MainnetContract,
+    RegistryAdmin
+{
+    error ErrorGlobalRegistryAdminDeploymentNotOnMainnet();
+
+    constructor() RegistryAdmin() 
+    { 
+        if(block.chainid != 1) {
+            revert ErrorGlobalRegistryAdminDeploymentNotOnMainnet();
+        }
+    }
+
+    function _setupRegistry()
+        internal
+        override
+        onlyInitializing()
+    {
+        super._setupRegistry();
+
+        // global registry function authorization for gif admin role
+        FunctionInfo[] memory functions;
+        functions = new FunctionInfo[](1);
+        functions[0] = toFunction(IGlobalRegistry.registerChainRegistry.selector, "registerChainRegistry");
+
+        _authorizeTargetFunctions(_registry, GIF_ADMIN_ROLE(), functions);
+    }
+}

package/contracts/registry/IGlobalRegistry.sol

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: Apache-2.0
+pragma solidity ^0.8.20;
+
+import {NftId} from "../type/NftId.sol";
+
+import {IRegistry} from "./IRegistry.sol";
+
+interface IGlobalRegistry is IRegistry {
+
+    function registerChainRegistry(uint chainId, address chainRegistryAddress) external returns (NftId chainRegistryNftId);
+
+    function getChainRegistryAddress(uint chainId) external returns (address); 
+
+    function getChainId(uint idx) external view returns (uint);
+
+    function chainIds() external view returns (uint);
+}

package/contracts/registry/IRegistry.sol

@@ -1,70 +1,133 @@
 // SPDX-License-Identifier: Apache-2.0
-pragma solidity ^0.8.19;
+pragma solidity ^0.8.20;
 
-import {NftId} from "../types/NftId.sol";
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 
-interface IOwnable {
-    function getOwner() external view returns(address owner);
-}
+import {NftId} from "../type/NftId.sol";
+import {ObjectType} from "../type/ObjectType.sol";
+import {VersionPart} from "../type/Version.sol";
+import {Timestamp} from "../type/Timestamp.sol";
 
-interface IRegistryLinked {
+/// @title Chain Registry interface.
+/// A chain registry holds all protocol relevant objects with basic metadata.
+/// Registered objects include services, instances, products, pools, policies, bundles, stakes and more.
+/// Registered objects are represented by NFTs.
+interface IRegistry is IERC165 {
 
-    event LogDebug(uint256 idx, address module, string comment);
+    event LogRegistration(NftId nftId, NftId parentNftId, ObjectType objectType, bool isInterceptor, address objectAddress, address initialOwner);
+    event LogServiceRegistration(VersionPart majorVersion, ObjectType domain);
 
-    function getRegistry() external view returns(IRegistry registry);
-}
+    // initialize
+    error ErrorRegistryCallerNotDeployer();
 
-interface IRegisterable is 
-    IOwnable,
-    IRegistryLinked
-{
+    // registerService()
+    error ErrorRegistryCallerNotReleaseRegistry();
+    error ErrorRegistryServiceAddressZero(); 
+    error ErrorRegistryServiceVersionZero(); 
+    error ErrorRegistryNotService(address service, ObjectType objectType);
+    error ErrorRegistryServiceParentNotRegistry(NftId parentNftId);
+    error ErrorRegistryDomainZero(address service);
+    error ErrorRegistryDomainAlreadyRegistered(address service, VersionPart version, ObjectType domain);
 
-    function register() external returns(NftId nftId);
-    
-    function getNftId() external view returns(NftId nftId);
-    function getParentNftId() external view returns(NftId parentNftId);
-    function getType() external view returns(uint256 objectType);
-    function getData() external view returns(bytes memory data);
-    function isRegisterable() external pure returns(bool);
-    function getInitialOwner() external view returns(address initialOwner);
+    // registerWithCustomTypes()
+    error ErrorRegistryCoreTypeRegistration();
 
-    function isRegistered() external view returns(bool);
-}
+    // _register()
+    error ErrorRegistryParentAddressZero();
+    error ErrorRegistryTypesCombinationInvalid(ObjectType objectType, ObjectType parentType);
+    error ErrorRegistryContractAlreadyRegistered(address objectAddress);
 
-
-interface IRegistry {
-
-    struct RegistryInfo {
+    struct ObjectInfo {
         NftId nftId;
         NftId parentNftId;
-        uint256 objectType;
+        ObjectType objectType;
+        bool isInterceptor;
         address objectAddress;
         address initialOwner;
+        bytes data;
+    }
+
+    struct ReleaseInfo {
+        VersionPart version;
+        bytes32 salt;
+        address[] addresses;
+        string[] names;
+        ObjectType[] domains;
+        Timestamp activatedAt;
+        Timestamp disabledAt;
     }
 
-    function TOKEN() external pure returns(uint256);
-    function INSTANCE() external pure returns(uint256);
-    function PRODUCT() external pure returns(uint256);
-    function ORACLE() external pure returns(uint256);
-    function POOL() external pure returns(uint256);
-    function POLICY() external pure returns(uint256);
-    function BUNDLE() external pure returns(uint256);
+    /// @dev Register an object with a known core type.
+    /// The function returns a newly minted object NFT ID.
+    /// May not be used to register services.
+    function register(ObjectInfo memory info) external returns (NftId nftId);
+
+    /// @dev Register a service with using the provided domain and version.
+    /// The function returns a newly minted service NFT ID.
+    /// May only be used to register services.
+    function registerService(
+        ObjectInfo memory serviceInfo, 
+        VersionPart serviceVersion, 
+        ObjectType serviceDomain
+    ) external returns(NftId nftId);
+
+    /// @dev Register an object with a custom type.
+    /// The function returns a newly minted object NFT ID.
+    /// This function is reserved for GIF releases > 3.
+    /// May not be used to register known core types.
+    function registerWithCustomType(ObjectInfo memory info) external returns (NftId nftId);
+
+    function getInitialVersion() external view returns (VersionPart);
+
+    function getNextVersion() external view returns (VersionPart);
+
+    function getLatestVersion() external view returns (VersionPart);
+
+    function getReleaseInfo(VersionPart version) external view returns (ReleaseInfo memory);
+
+    function getObjectCount() external view returns (uint256);
+
+    function getNftId(address objectAddress) external view returns (NftId nftId);
+
+    function ownerOf(NftId nftId) external view returns (address);
+
+    function ownerOf(address contractAddress) external view returns (address);
+
+    function getObjectInfo(NftId nftId) external view returns (ObjectInfo memory info);
+
+    function getObjectInfo(address object) external view returns (ObjectInfo memory info);
+
+    function isRegistered(NftId nftId) external view returns (bool);
+
+    function isRegistered(address contractAddress) external view returns (bool);
+
+    function isRegisteredService(address contractAddress) external view returns (bool);
+
+    function isRegisteredComponent(address object) external view returns (bool);
+
+    function isActiveRelease(VersionPart version) external view returns (bool);
+
+    function getServiceAddress(
+        ObjectType serviceDomain, 
+        VersionPart releaseVersion
+    ) external view returns (address serviceAddress);
+
+    function getProtocolNftId() external view returns (NftId protocolNftId);
+
+    function getNftId() external view returns (NftId nftId);
+
+    function getOwner() external view returns (address);
+
+    // TODO refactor the address getters below to contract getters
+    function getChainNftAddress() external view returns (address);
 
-    function register(address objectAddress) external returns(NftId nftId);
-    function registerObjectForInstance(
-        NftId parentNftid,
-        uint256 objectType,
-        address initialOwner
-    )
-        external returns(NftId nftId);
+    function getReleaseRegistryAddress() external view returns (address);
 
-    function getObjectCount() external view returns(uint256);
+    function getStakingAddress() external view returns (address);
 
-    function getNftId(address objectAddress) external view returns(NftId nftId);
-    function getInfo(NftId nftId) external view returns(RegistryInfo memory info);
-    function getOwner(NftId nftId) external view returns(address ownerAddress);
+    function getTokenRegistryAddress() external view returns (address);
 
-    function isRegistered(address objectAddress) external view returns(bool);
+    function getRegistryAdminAddress() external view returns (address);
 
-    function getNftAddress() external view returns(address nft);
-}
+    function getAuthority() external view returns (address);
+}