feat(its): allow its owner to manually migrate tokens

contracts/InterchainTokenService.sol

@@ -20,6 +20,7 @@ import { IInterchainTokenExecutable } from './interfaces/IInterchainTokenExecuta
 import { IInterchainTokenExpressExecutable } from './interfaces/IInterchainTokenExpressExecutable.sol';
 import { ITokenManager } from './interfaces/ITokenManager.sol';
 import { IGatewayCaller } from './interfaces/IGatewayCaller.sol';
+import { IMinter } from './interfaces/IMinter.sol';
 import { Create3AddressFixed } from './utils/Create3AddressFixed.sol';
 import { Operator } from './utils/Operator.sol';
 
@@ -643,6 +644,16 @@ contract InterchainTokenService is
         }
     }
 
+    /**
+     * @notice Allows the owner to migrate minter of native interchain tokens from ITS to the corresponding token manager.
+     * @param tokenId the tokenId of the registered token.
+     */
+    function migrateInterchainToken(bytes32 tokenId) external onlyOwner {
+        ITokenManager tokenManager_ = deployedTokenManager(tokenId);
+        address tokenAddress = tokenManager_.tokenAddress();
+        IMinter(tokenAddress).transferMintership(address(tokenManager_));
+    }
+
     /****************\
     INTERNAL FUNCTIONS
     \****************/

contracts/interfaces/IInterchainTokenService.sol

@@ -274,4 +274,10 @@ interface IInterchainTokenService is
      * @param paused whether to pause or unpause.
      */
     function setPauseStatus(bool paused) external;
+
+    /**
+     * @notice Allows the owner to migrate legacy tokens that cannot be migrated automatically.
+     * @param tokenId the tokenId of the registered token.
+     */
+    function migrateInterchainToken(bytes32 tokenId) external;
 }

test/InterchainTokenService.js

@@ -30,6 +30,7 @@ const {
     ITS_HUB_CHAIN_NAME,
     ITS_HUB_ROUTING_IDENTIFIER,
     ITS_HUB_ADDRESS,
+    MINTER_ROLE,
 } = require('./constants');
 
 const reportGas = gasReporter('Interchain Token Service');
@@ -3235,6 +3236,80 @@ describe('Interchain Token Service', () => {
         });
     });
 
+    describe('Interchain Token Migration', () => {
+        it('Should migrate a token succesfully', async () => {
+            const salt = getRandomBytes32();
+            const name = 'migrated token';
+            const symbol = 'MT';
+            const decimals = 53;
+            const tokenId = await service.interchainTokenId(wallet.address, salt);
+            const tokenManagerAddress = await service.tokenManagerAddress(tokenId);
+
+            await interchainTokenDeployer
+                .deployInterchainToken(salt, tokenId, service.address, name, symbol, decimals)
+                .then((tx) => tx.wait);
+            const tokenAddress = await interchainTokenDeployer.deployedAddress(salt);
+            const token = await getContractAt('InterchainToken', tokenAddress, wallet);
+
+            const params = defaultAbiCoder.encode(['bytes', 'address'], [wallet.address, tokenAddress]);
+
+            await service.deployTokenManager(salt, '', MINT_BURN, params, 0).then((tx) => tx.wait);
+
+            await expect(service.migrateInterchainToken(tokenId))
+                .to.emit(token, 'RolesRemoved')
+                .withArgs(service.address, 1 << MINTER_ROLE)
+                .to.emit(token, 'RolesAdded')
+                .withArgs(tokenManagerAddress, 1 << MINTER_ROLE);
+        });
+
+        it('Should not be able to migrate a token twice', async () => {
+            const salt = getRandomBytes32();
+            const name = 'migrated token';
+            const symbol = 'MT';
+            const decimals = 53;
+            const tokenId = await service.interchainTokenId(wallet.address, salt);
+            const tokenManagerAddress = await service.tokenManagerAddress(tokenId);
+
+            await interchainTokenDeployer
+                .deployInterchainToken(salt, tokenId, service.address, name, symbol, decimals)
+                .then((tx) => tx.wait);
+            const tokenAddress = await interchainTokenDeployer.deployedAddress(salt);
+            const token = await getContractAt('InterchainToken', tokenAddress, wallet);
+
+            const params = defaultAbiCoder.encode(['bytes', 'address'], [wallet.address, tokenAddress]);
+
+            await service.deployTokenManager(salt, '', MINT_BURN, params, 0).then((tx) => tx.wait);
+
+            await expect(service.migrateInterchainToken(tokenId))
+                .to.emit(token, 'RolesRemoved')
+                .withArgs(service.address, 1 << MINTER_ROLE)
+                .to.emit(token, 'RolesAdded')
+                .withArgs(tokenManagerAddress, 1 << MINTER_ROLE);
+
+            await expectRevert((gasOptions) => service.migrateInterchainToken(tokenId, { gasOptions }), token, 'MissingRole', [
+                service.address,
+                MINTER_ROLE,
+            ]);
+        });
+
+        it('Should not be able to migrate a token deployed after this upgrade', async () => {
+            const salt = getRandomBytes32();
+            const name = 'migrated token';
+            const symbol = 'MT';
+            const decimals = 53;
+            const tokenId = await service.interchainTokenId(wallet.address, salt);
+
+            await service.deployInterchainToken(salt, '', name, symbol, decimals, AddressZero, 0).then((tx) => tx.wait);
+            const tokenAddress = await service.interchainTokenAddress(tokenId);
+            const token = await getContractAt('InterchainToken', tokenAddress, wallet);
+
+            await expectRevert((gasOptions) => service.migrateInterchainToken(tokenId, { gasOptions }), token, 'MissingRole', [
+                service.address,
+                MINTER_ROLE,
+            ]);
+        });
+    });
+
     describe('Bytecode checks [ @skip-on-coverage ]', () => {
         it('Should preserve the same proxy bytecode for each EVM', async () => {
             const proxyFactory = await ethers.getContractFactory('InterchainProxy', wallet);