> For the complete documentation index, see [llms.txt](https://docs.onyx.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onyx.org/onyx-defi/onyx-app/migrate.md).

# Migrate to Onyx

The [Migrate page](https://app.onyx.org/en/migrate) guides eligible users through the Ethereum-to-Onyx flow:

1. approve any required Ethereum XCN allowance;
2. withdraw or unstake from the legacy Ethereum staking position;
3. bridge the available XCN to Onyx;
4. optionally deliver it into Onyx liquid staking.

Each wallet prompt is a separate authorization. Read the chain, contract, amount, and allowance before signing, and keep the page open while it waits for receipts and refreshes balances.

## Truthful fallback

Auto-staking is an optional destination action, not a condition for preserving the bridge delivery. If the staking leg cannot complete, the system can deliver native XCN instead and record the staking error. The user can then stake manually through the Onyx App. Check the final asset balance and bridge status; do not infer stXCN delivery merely because the source bridge transaction succeeded.

Bridge limits and health are dynamic. The app should prevent a transfer below the live minimum, but users should still review the final quote and status before proceeding.


---

# 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.onyx.org/onyx-defi/onyx-app/migrate.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.