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

# App Tutorial

Welcome to Escher.finance! This tutorial will guide you through using the app step by step.

App: [Escher.finance](https://www.escher.finance/)

### 1. Connect Your Wallet

Escher.finance currently operates on EVM chains, with this demo running on Berachain. We support two popular wallets:

* [MetaMask](https://metamask.io/faqs/)
* [Rabby](https://medium.com/@rabby_io/rabby-wallet-easy-onboarding-for-new-users-6fb1ab26ef40)

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FxASO3snbGwAABjLFY6kE%2FScreenshot%202024-09-22%20at%206.03.25%E2%80%AFPM.png?alt=media&amp;token=5837077e-ab7e-48ec-9351-65c61ac8b763" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FjlssZME9C6aMVubPkWv2%2FScreenshot%202024-09-22%20at%206.05.43%E2%80%AFPM.png?alt=media&amp;token=e2cba849-684b-4dc2-8031-a47427929e22" alt=""><figcaption></figcaption></figure>

More wallet options will be added soon.

### 2. Obtain Tokens

After connecting your wallet, you'll need to acquire two types of tokens:

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FnmYRCfYVakIiV0wdz0yF%2FScreenshot%202024-09-22%20at%206.08.35%E2%80%AFPM.png?alt=media&amp;token=f7b3efea-906e-424b-b28b-ec68cd6a9244" alt=""><figcaption></figcaption></figure>

1. **Bera Tokens**: Used for paying gas fees on Berachain.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2F8s5bBmtxIsubz2CKwPG9%2FScreenshot%202024-09-22%20at%206.10.44%E2%80%AFPM.png?alt=media&amp;token=d5980dff-9f6f-4801-94be-64a40ffc5123" alt=""><figcaption></figcaption></figure>

2. **Union Tokens**: ERC20 version of the Union chain token, used for staking to secure and earn rewards on the Union chain.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FEucJiq4tvOiUAUzkve64%2FScreenshot%202024-09-22%20at%206.12.42%E2%80%AFPM.png?alt=media&amp;token=b3e7fa2f-192e-4f11-a0b6-e7a104dee8af" alt=""><figcaption></figcaption></figure>

### 3. Claim Your ICA Controller

Now that you have gas tokens (Bera), you can claim your ICA controller. The ICA controller serves as a gateway for interacting with the Union Chain and the ICA on Union.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FVHZy1GOdMCGa7siLm3Dw%2FScreenshot%202024-09-22%20at%206.20.36%E2%80%AFPM.png?alt=media&amp;token=3a89fba5-64ee-4ebc-b314-953de8b7777d" alt=""><figcaption></figcaption></figure>

### 4. Stake Tokens

Sending and staking tokens happen together:

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FxgdEv1W5VL3MIjwmA12A%2FScreenshot%202024-09-22%20at%206.25.53%E2%80%AFPM.png?alt=media&amp;token=9bdeeb3b-3d8a-424a-aea2-f2ffaf41b35a" alt=""><figcaption></figcaption></figure>

1. Select the amount of Union tokens you want to stake.
2. Send the tokens.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FoTnKjD5wferNm3oMy01J%2FScreenshot%202024-09-22%20at%206.27.02%E2%80%AFPM.png?alt=media&amp;token=b9c0e89e-8fbe-4dc6-8fe4-5f32e7fd1ba1" alt=""><figcaption></figcaption></figure>

3. The authz contract will automatically stake them for you.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FdePQPsj1iF6livXakSN0%2FScreenshot%202024-09-22%20at%206.30.24%E2%80%AFPM.png?alt=media&amp;token=931b36bf-125e-405f-9820-5020f070409b" alt=""><figcaption></figcaption></figure>

and than:<br>

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FEUjZ7LS6UoEimfZ6zv3K%2FScreenshot%202024-09-22%20at%206.32.50%E2%80%AFPM.png?alt=media&amp;token=e258dffc-0b08-49ee-8a4e-88070d07c768" alt=""><figcaption></figcaption></figure>

Note: This process can take up to 15 minutes.

### 5. Manual Staking Option

If the Authz contract is down for any reason, you can use the manual operation to stake:

1. Go to the manual operations section.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FzAfYyniCRIsiLFMcVA7G%2FScreenshot%202024-09-22%20at%206.35.07%E2%80%AFPM.png?alt=media&amp;token=14719166-52f6-4b77-8a4e-2c63536f0ec8" alt=""><figcaption></figcaption></figure>

2. Send a message to stake your tokens.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FNbJT8K3gbrQbI1NPHYwC%2FScreenshot%202024-09-22%20at%206.36.37%E2%80%AFPM.png?alt=media&amp;token=ca52c5a8-8862-4f8f-918e-11c66cebc8ec" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FyHijj7M85viQDuvX0Fy1%2FScreenshot%202024-09-22%20at%206.27.02%E2%80%AFPM.png?alt=media&amp;token=e3c53aa7-6e9b-4188-bfd7-f7d89fa812e2" alt=""><figcaption></figcaption></figure>

### 6. Withdraw Rewards

You can withdraw your rewards directly to your EVM wallet with one click:

1. Click the "Withdraw" button.
2. This action will withdraw all of your available rewards.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2F6PiHjMzyZTVfKTwagqO3%2FScreenshot%202024-09-22%20at%206.40.42%E2%80%AFPM.png?alt=media&amp;token=3c92aca1-91fe-4581-a560-547dd507524e" alt=""><figcaption></figcaption></figure>

### 7. Restake (Compound) Rewards

To compound your rewards:

1. Click the "Restake" button.
2. This will automatically restake your rewards, increasing your total staked amount.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FBXuPVKXbuTRtrvqpI5Gx%2FScreenshot%202024-09-22%20at%206.47.02%E2%80%AFPM.png?alt=media&amp;token=8d5c8e13-daf3-4706-b232-c8262abca8d5" alt=""><figcaption></figcaption></figure>

### 8. Unbond Tokens

Unbonding tokens is a process that takes 21 days (a mechanism of the Cosmos SDK):

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2Fad4PviaO5Hcm38Hi2V2j%2FScreenshot%202024-09-22%20at%206.48.55%E2%80%AFPM.png?alt=media&amp;token=ac2e762f-248d-448e-933d-c7a1fb9ce520" alt=""><figcaption></figcaption></figure>

1. Initiate the unbonding process.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2FePHvFbcdGIgeVnK8QCFv%2FScreenshot%202024-09-22%20at%206.50.34%E2%80%AFPM.png?alt=media&amp;token=d7822c02-e686-451a-a976-670b29a6a7de" alt=""><figcaption></figcaption></figure>

2. Wait for the 21-day period to complete.

<figure><img src="https://2987168474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeXDm9CDAsd1OqWE1fQtf%2Fuploads%2Fc3QfeJC3vuJSdbHB4Jsz%2FScreenshot%202024-09-22%20at%206.52.33%E2%80%AFPM.png?alt=media&amp;token=8f4a4683-37f1-42c3-9cc1-90e70c09d98e" alt=""><figcaption></figcaption></figure>

3. Once unbonded, go to the manual operations section.
4. Send your tokens to your EVM address.

***

Congratulations! You now know how to use the main features of the Escher.finance app. If you have any questions or encounter any issues, please don't hesitate to contact our support team.

Happy staking!


---

# 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.escher.finance/app-tutorial.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.