# V2.0.0 Upgrading Timeline Highlight **URL:** \ **Category:** Market\ **Created:** [June 26, 2019, 1:49pm UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348 "2019-06-26T13:49:14Z")\ **Posts on this page:** 7\ **Page:** 1
**Author:** ![gary](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/gary/32/174_2.png) [@gary](https://forum.grin.mw/u/gary)\ **Post date:** [June 26, 2019, 1:49pm UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/1 "2019-06-26T13:49:14Z")
## Important Notes about v2.0.0 Upgrading Timeline As we see at the [mid-of-July hardfork plan](https://forum.grin.mw/t/grin-first-hard-fork-mid-july/5148), the official `v2.0.0` release binaries will be ready at **1st July**. And as you already know, in this hardfork release, there’s a designed **incompatibility between `v1.x.y` wallet and `v2.0.0` wallet**. (for detail, refer to [addressing recent transaction difficulties](https://forum.grin.mw/t/addressing-recent-transaction-difficulties/5339)), please understand this incompatibility behavior and it’s already been heavily discussed and settled down. Once the `v2.0.0` binaries has been released at **1st July** , I want to remind that **ALL** the **users / pools / exchanges** should upgrade to this `v2.0.0` **ASAP** , to avoid the Wallet Incompatibility between old version (`v1.x.y`) and this new version `v2.0.0`. **Especially for Pools / Exchanges.** It’s definitely not good for the users of these pools / exchanges if confused about what exact the wallet version they should use! And also it’s boring for pools / exchanges if got too many failure reports for user when deposit / withdraw the Grin, just because of the incompatible version. **To be simple, after `1st July`, any good Grin wallet should be at version `v2.0.0` (or later version if have).** I want to highlight this **v2.0.0 Upgrading Timeline** , since now just `4` or `5` days before the official `v2.0.0` release and this global upgrading. ## For Pools / Exchanges 1. Lock both the Grin deposit and withdraw at the day of upgrading ( **1st July** proposed), and upgrade the production environment’s Grin Servers and Wallets to `v2.0.0`, and the necessary test of course. 2. After the upgrading, show an explicit reminding message before user start to deposit or withdraw, ask user upgrading their Grin Wallet to version `v2.0.0` (or higher version if have), otherwise any deposit or withdraw will just fail. ## For All Users Upgrading Grin wallet to `v2.0.0` at `1st July`, to avoid any incompatible failure with Pools / Exchanges 's Grin wallet. ## For Grin Community Wallet Developers To be inline with this **upgrading timeline** , release corresponding `v2` wallet version at same date (`1st July`). Or if can’t catch up this date, at least write a reminding message on their old binaries to tell users NOT use those old versions any more. ---
**Author:** ![gary](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/gary/32/174_2.png) [@gary](https://forum.grin.mw/u/gary)\ **Post date:** [June 27, 2019, 7:33am UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/2 "2019-06-27T07:33:55Z")
Today, some people ask me where’s the Grin Wallet v2.0.0 API documentation. The simple answer is it’s not published yet, since the official release is planned at `1st July`. But please **DO NOT** use [https://docs.rs/grin\_wallet\_api/1.1.0/grin\_wallet\_api/](https://docs.rs/grin_wallet_api/1.1.0/grin_wallet_api/) for this upgrading, since it’s obvious that’s for `v1.1.0` only. A simple workaround for reading the `v2.0.0` Wallet API documentations: ```auto git clone --single-branch --branch milestone/2.0.0 https://github.com/mimblewimble/grin-wallet.git cd grin-wallet cargo doc --no-deps --package grin_wallet_api --package grin_wallet_libwallet --package grin_wallet_impls --package grin_wallet_controller --package grin_wallet_config --package grin_wallet_util ``` But remember to check from time to time if there’s anything updated in the next few days, just use the following commands to ensure it’s always updated: ```auto git pull origin milestone/2.0.0 cargo doc --no-deps --package grin_wallet_api --package grin_wallet_libwallet --package grin_wallet_impls --package grin_wallet_controller --package grin_wallet_config --package grin_wallet_util ``` ### To read the self built docs, use **Chrome** to open this link: `file://{change-to-your-own-dir}/grin-wallet/target/doc/grin_wallet_api/index.html` ---
**Author:** ![Chronos](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/chronos/32/153_2.png) [@Chronos](https://forum.grin.mw/u/Chronos)\ **Post date:** [June 27, 2019, 4:00pm UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/3 "2019-06-27T16:00:30Z")
Thanks. Has anyone posted these “draft” v2 documentations? ---
**Author:** ![rodarmor](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/rodarmor/32/13_2.png) [@rodarmor](https://forum.grin.mw/u/rodarmor)\ **Post date:** [June 27, 2019, 11:21pm UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/4 "2019-06-27T23:21:14Z")
Is the supported migration path for a wallet with coins from v1._._ to v2._._ to restore it from the seed? ---
**Author:** ![gary](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/gary/32/174_2.png) [@gary](https://forum.grin.mw/u/gary)\ **Post date:** [June 28, 2019, 12:52am UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/5 "2019-06-28T00:52:02Z")
The answer is **Yes**. - The upgrading on an existing Grin Wallet has no impact on the wallet data. - Recover from the **mnemonic phrases** or restore from the **seed** with the v2 Grin Wallet will get all your coins, no matter it was received before **Hard Fork 1 Block Height** **262,080** or after, if and only if it’s unspent. ---
**Author:** ![rodarmor](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/rodarmor/32/13_2.png) [@rodarmor](https://forum.grin.mw/u/rodarmor)\ **Post date:** [June 28, 2019, 4:55am UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/6 "2019-06-28T04:55:43Z")
Great, thank you! So just to clarify: - Leaving the grin wallet data directory in place and upgrading the grin-wallet binary will work - Deleting the grin wallet data directory, upgrading the grin-wallet binary, and restoring from a seed will also work Is one of these methods preferable over the other? ---
**Author:** ![jaspervdm](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.grin.mw/jaspervdm/32/3095_2.png) [@jaspervdm](https://forum.grin.mw/u/jaspervdm)\ **Post date:** [June 28, 2019, 11:08am UTC](https://forum.grin.mw/t/v2-0-0-upgrading-timeline-highlight/5348/7 "2019-06-28T11:08:43Z")
They will both work. The former method might be favorable, just because you get to keep your tx history that way