MigratorV2: Your $BIT to $MNT Guide
09/18/233 min read
by Mantle
Mantle
Tutorials
Summary
- MigratorV2 is available at: https://migratebit.mantle.xyz/
- MigratorV2 features and request handling policies are authorized by MIP-27.
- It may take up to 24 hours between your request and migration ($MNT to your wallet).
- While your request is pending you retain full control of your $BIT, and you can revoke the request, modify the request, or move your $BIT at any time.
Steps for using the official UI (recommended)
Request Migration
- Go to https://migratebit.mantle.xyz/
- Connect your wallet holding $BIT
- Input the quantity of $BIT you request to migrate (recommended: MAX / Available Balance)
- Click Request
- Confirm in your wallet. Note: For additional security you can check the following details: (Interaction contract: 0x1A4b46696b2bB4794Eb3D4c26f1c55F9170fa4C5; Method Id: 0x095ea7b3; Spender address: (MigratorV2) 0x95cE6D5D5FD2063Fd9a10f7f8f81F9e3193Ca53F)*
- It may take up to 24 hours to review and approve the migration request. Some requests will not be approved in line with the MIP-27 policy.
View Status of your Request
- Click Account
- Go to MigratorV2 tab
- "Amount": is the quantity of $BIT you have requested to Migrate
- "Transaction 1": is your Request txid
- "Transaction 2": is the txid of a successful Migration
- "Status":
- Will show "pending" while the request is being reviewed
- Will show "cancelled by user" if you cancelled or modified your request. Upon modification, a new request record will be shown.
Steps for using Etherscan (advanced users)
Request Migration Note: this is the same process as approving allowance to your $BIT
- Go to https://etherscan.io/token/0x1a4b46696b2bb4794eb3d4c26f1c55f9170fa4c5#writeContract
- Connect your wallet holding $BIT
- Go to 2. Approve (0x095ea7b3)
- Fill in:
- Spender address: 0x95cE6D5D5FD2063Fd9a10f7f8f81F9e3193Ca53F
- Amount: the amount of $BIT you request to migrate
- Click Write
- It may take up to 24 hours to review and approve the migration request. Some requests will not be approved in line with the MIP-27 policy.
View Status of your Request See previous section
Key Features
Two-step process
- Step 1: Users (holders of $BIT) make a Request via the
[BIT.Approve()](https://etherscan.io/token/0x1a4b46696b2bb4794eb3d4c26f1c55f9170fa4c5#writeContract)
function - Step 2: Another Role reviews the requests and approves the migration - via
[Migratorv2.approveMigrationRequest()](https://etherscan.io/address/0x95cE6D5D5FD2063Fd9a10f7f8f81F9e3193Ca53F#writeContract)
function. - For MigratorV1, both steps were completed by the user. For MigratorV2 there is a separation of roles to enforce the MIP-27 policy. As it will take time to review Step 2, end-to-end migration may take up to 24 hours to complete.
Users retain control of their $BIT while requests are pending
- "Step 1: Request" does not transfer $BIT. The $BIT will remain in the user's wallet under their control. Users can revoke the request, modify the amount (considered a new request) or move the $BIT at any time.
- "Step 2: Migrate" is handled by a smart contract. The MigratorV2 contract will receive $BIT from the user's wallet and the same quantity of $MNT to the user's wallet. Both legs will either execute successfully or both will fail. The reviewer / approver does not hold user $BIT at any time.
Policy against partial migration
- If the amount of $BIT in the user wallet is not sufficient to cover the requested migration quantity, the migration will not occur.
- We recommend users do not move their $BIT while the Request is pending.