> For the complete documentation index, see [llms.txt](https://docs.ramper.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ramper.xyz/ramper-wallet/user-guides/how-to-migrate-accounts-from-old-version-to-new-version.md).

# How to migrate accounts from Old version to New version

{% hint style="info" %}
Ramper Mobile Wallet has upgraded to the key management system V2 since **Version 2.0.0**. For users with existing accounts in the Old version (V1 system), migration to the New version (V2 system) before **December 31, 2024** is a must.

About Ramper V2 - Embedded Multi-Party Computation (EMPC), read more [HERE](https://ramper.link/ramper-v2-embedded-multi-party-computation-empc).
{% endhint %}

## How to migrate accounts

**Step 1:** Make sure your Ramper Wallet application is from **Version 2.0.0 or higher**

**Step 2:** Log out the account in **Old version**

* Click the card representing your account from Wallet home screen
* Click **Log out this account**

<figure><img src="https://github.com/user-attachments/assets/88273e72-a398-46e3-9e7d-748e5b222b65" alt="" width="563"><figcaption></figcaption></figure>

**Step 3:** Re-log in the same account

* Click the wallet icon at top right corner of home screen
* Click **Add wallet**
* Input the Email or choose Gmail/Facebook/Apple account as desired. Then authenticate to migrate -> All done!

<figure><img src="/files/E2Gcb6GT2jBKtTw8YJuP" alt=""><figcaption></figcaption></figure>

* From **Wallet management** session or from the card at home screen, if your account is **without the label "Old version"**, this means you have successfully migrated your account to **New version**.

<figure><img src="https://github.com/user-attachments/assets/1cbc25e2-944d-4f51-b854-fb10759c7ef5" alt="" width="563"><figcaption></figcaption></figure>

**Step 4:** Operate with accounts in **New version** from now on.

{% hint style="warning" %}
For users who have initially logged in to Ramper SDK V1's clients (Cosmo, Paras, MusicFeast, etc), **with the same account, their NEAR wallet addresses in New version (V2 system) and in Old version (V1 system) will be different.**

Therefore, when logging in to Ramper Wallet:

* Firstly, they need to migrate their accounts by logging in choosing **New version**.
* Secondly, they **need to transfer their funds (if any) from Old-version Near wallet address to New-version one**. Ramper cannot transfer funds on behalf of users as we don't have access to their accounts or funds.
  {% endhint %}

<figure><img src="/files/BG1vUjebkG2cQ4hFMsL3" alt=""><figcaption><p>Log in choosing <strong>New version</strong> to migrate accounts</p></figcaption></figure>

<figure><img src="/files/1oFE00H0NKO6gNezR3a3" alt=""><figcaption><p>Send assets in Old-version NEAR wallet address to New-version one</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ramper.xyz/ramper-wallet/user-guides/how-to-migrate-accounts-from-old-version-to-new-version.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
