Skip to content

Commit

Permalink
Release 15-07-2024 (#170)
Browse files Browse the repository at this point in the history
### What was the problem?

This release includes

- #42 
- #154
  • Loading branch information
Tschakki authored Jul 15, 2024
2 parents 0097f67 + 91ed62f commit 66f8449
Show file tree
Hide file tree
Showing 10 changed files with 144 additions and 0 deletions.
97 changes: 97 additions & 0 deletions docs/docs-user/claiming.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: How to claim LSK
sidebar_position: 1
slug: /user/claiming
description: 'How to claim LSK tokens on Lisk L2.'
keywords:
[
'Lisk claiming',
'Lisk migration',
'Lisk L2',
'LSK Lisk L2',
'LSK claiming',
'Claim Lisk',
'Claim LSK',
]
---

import claim from '../../static/img/docs/claiming/1-claim-tokens.png';
import walletConnect from '../../static/img/docs/claiming/2-connect-wallet.png';
import walletPrompt from '../../static/img/docs/claiming/3-connect-prompt.png';
import claimReview from '../../static/img/docs/claiming/4-claim-review.png';
import signMessage from '../../static/img/docs/claiming/5-sign-message.png';
import signPrompt from '../../static/img/docs/claiming/6-sign-prompt.png';
import claimSubmit from '../../static/img/docs/claiming/8-submit-claim.png';

# Claiming LSK tokens

Everyone who held tokens on the Lisk L1 chain is entitled to claim the exact same amount of LSK on Lisk L2.
This guide explains step-by-step, how to complete the claiming process.

:::info
Lisk token holders have a **2-year window starting May 21st, 2024** to claim and migrate their tokens to Lisk L2.
:::

## Requirements

To claim your LSK tokens on Lisk L2, you need the following:

1. An account on the Lisk L1 legacy chain, with some LSK tokens.
The account must hold some LSK tokens at the snapshot height `24,823,618`.
The amount of LSK tokens you can claim on Lisk L2 is the same as the amount you held on Lisk L1 at the snapshot height.
2. Latest version of the [Lisk Migration Wallet](https://lisk.com/wallet) installed (3.0.3)
3. An account on Lisk L2 with a small amount of ETH, to pay for the gas fees.
If you need to bridge ETH tokens from Ethereum to Lisk, please refer to one of the available [bridges](/lisk-tools/bridges).
4. If you have a Ledger hardware wallet, you need the latest version of the Lisk app installed (Lisk legacy 4.0.0).

## Claiming process step-by-step

:::note
This guide is for regular accounts.
If you have a multisignature account, please refer to the [multisignature claiming guide](https://lisk.com/blog/posts/claiming-your-lsk-tokens-with-multisig-accounts-step-by-step-guide).
:::

1. Open the [Claim Tokens page on the Lisk Portal](https://portal.lisk.com/claim/regular-account) in the browser. <br />
<img src={claim} title="Claiming page on the Lisk Portal"/> <br />
If you haven't already, connect your wallet with the portal on the top right corner.
2. On the **Claim Tokens page**, click the `Connect Lisk account` button.
This will open a WalletConnect prompt.
3. Copy the connection URI by clicking the button next to `Connect your wallet`.
4. Open the [Lisk Migration Wallet](https://lisk.com/wallet) and sign in with the account you intend to migrate.
Make sure you have the latest version of the Lisk Migration Wallet installed (3.0.3).
You can verify the version by clicking on the `Lisk`>`About` button in the wallet menu.
5. Go to the `Applications` page and click on the `Wallet connections` tab.
6. Now, click the `Connect Wallet` button.<br/>
<img src={walletConnect} width="60%"/>
7. Paste the connection URI you just copied in step 3 and press `Connect`.
This will open a prompt showing all your available accounts.<br/>
<img src={walletPrompt} width="40%"/><br/>
8. Select the account you wish to migrate the LSK tokens from and click the `Connect` button.
9. Now go back to the [Lisk Portal](https://portal.lisk.com/claim/regular-account), you will see it shows the amount of LSK from your L1 account you selected in step 8, ready to be claimed.<br/>
<img src={claimReview} width="60%"/><br/>
10. Click the `Sign message` button, which will take you back to **Lisk Migration Wallet**, where you need to sign the migration message on Lisk L1.<br/>
<img src={signMessage} width="90%"/><br/>
Click the `Continue` button twice and confirm by entering your password, to sign the migration message on Lisk L1.<br/>
<img src={signPrompt} width="40%"/><br/>
When you see the transaction receipt in the window, close it to complete the process.<br/>
:::warning
You will need a small amount of **ETH** on Lisk L2 to pay the **gas fees** for the claiming transaction in the next step.
To bridge ETH from Ethereum to Lisk, you can use one of the available [bridges](/lisk-tools/bridges).
:::
11. Go back to the [Lisk Portal](https://portal.lisk.com/claim/regular-account).
You will see that the `Sign message` button has changed to `Submit Claim`.
Click the button to finalize the claiming process on Lisk L2.<br/>
<img src={claimSubmit} width="90%"/><br/>
This will open a wallet prompt, where you can verify the claim you intend to make.
Click `Confirm` to complete the claiming of your LSK tokens.

That's it! 🎉 You have now successfully claimed your Lisk L1 LSK tokens on Lisk L2.

After you complete the claiming process, you can check the **transaction receipt** on the claiming page in the Lisk Portal, to verify that the claiming of the LSK tokens was executed successfully.

To see your newly migrated LSK token balance on Lisk L2, you can check your account balance on [BlockScout](https://blockscout.lisk.com/) by entering your account address and clicking on the `Tokens` tab.

:::tip
If you wish to see your LSK token balance in MetaMask directly, it is possible to [import the LSK token to MetaMask](using-lisk/import-lsk.mdx).
:::

45 changes: 45 additions & 0 deletions docs/lisk-tools/faucets.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
title: Faucets
slug: /lisk-tools/faucets
description: Summary of available ETH and LSK faucets on the Lisk Seolia Testnet. Get free testnet tokens on Lisk Sepolia.
keywords:
[
Lisk Sepolia,
Lisk Sepolia Testnet,
Lisk faucet,
LSK faucet,
ETH faucet,
Testnet LSK,
Testnet Lisk,
Testnet ETH,
Testnet tokens,
Free testnet tokens
]
---

# Faucets
Faucets enable you to get free testnet tokens on Lisk Sepolia.
Find a list of faucets for the Lisk Sepolia testnet below.

## Lisk Sepolia Faucet
Grants test **LSK** on Lisk Sepolia.

The Lisk Sepolia faucet is available here: https://sepolia-faucet.lisk.com/:

Enter your account address or ENS name to receive 1 test LSK per request.


## Superchain Faucet
Grants test **ETH** on Lisk Sepolia.

The Superchain faucet is available here: https://app.optimism.io/faucet

There are two different options to acquire free Testnet ETH:

1. **Verify your onchain identity:**
Get up to 1 test ETH/week on Lisk Sepolia by identifying onchain via Optimist NFT, Gitcoin Passport, Coinbase Verification, World ID, or attestations.
2. **Verify via GitHub:**
Get up to 0.05 test ETH/week on Lisk Sepolia by identifying via your GitHub account.



2 changes: 2 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@ const sidebars = {
items: [
'lisk-tools/api-providers',
'lisk-tools/bridges',
'lisk-tools/faucets',
'lisk-tools/oracles',
'lisk-tools/utilities',
'lisk-tools/indexers'
Expand All @@ -124,6 +125,7 @@ const sidebars = {
'docs-user/connecting-to-a-wallet',
'docs-user/using-lisk/import-lsk',
'docs-user/exchanges',
'docs-user/claiming',
],
},
{
Expand Down
Binary file added static/img/docs/claiming/1-claim-tokens.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/2-connect-wallet.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/3-connect-prompt.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/4-claim-review.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/5-sign-message.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/6-sign-prompt.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/claiming/8-submit-claim.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 66f8449

Please sign in to comment.