Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Claim CLI document #73

Merged
merged 4 commits into from
Sep 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ This repository is a monorepo for essential non-contract services for the LSK To
- [Packages](#packages)
- [Tree Builder](#tree-builder)
- [Token Claim Backend](#claim-backend)
- [Token Claim CLI](#claim-cli)
- [Setup and Installation](#setup-and-installation)
- [Docker](#docker)
- [Contributing](#contributing)
Expand All @@ -26,6 +27,10 @@ Perform as a backend server, compatible with JSON RPC 2.0 Standard.

The database is using PostgreSQL.

### [Claim CLI](packages/claim-cli)

A command-line tool to claim LSK token by submitting transaction directly on-chain.

## Setup and Installation

gkoumout marked this conversation as resolved.
Show resolved Hide resolved
The Node version for this project is 18. Make sure you have the correct version installed. If you are using `nvm`, run `nvm use 18`.
Expand Down Expand Up @@ -69,6 +74,10 @@ docker build -t lisk-claim-backend -f ./docker/claim-backend/Dockerfile .
- Lisk Token Migration
- Migration Airdrop

- [Detailed Guide to Claim CLI Tool](./documentation/Detailed_Claim_CLI.md) - A detailed documentation for:
- Claiming Lisk tokens without the need for UI
- Detailed steps of the claim process using CLI

## Contributing

If you find any issues or have suggestions for improvements,
Expand Down
19 changes: 19 additions & 0 deletions documentation/Detailed_Claim_CLI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Detailed Guide to Claim CLI Tool

1. Follow [Run](../packages/claim-cli/README.md) in Claim CLI Readme to start Claim CLI
2. Select `Submit a Claim`
![img.png](Detailed_Claim_CLI/img.png)
3. Select `Private Key` or `Mnemonic` as Type for Lisk v4 Wallet.
![img_1.png](Detailed_Claim_CLI/img_1.png)
4. Paste `Private Key` or `Mnemonic` from Lisk Desktop or other Wallet App (e.g. Exodus).
![img_2.png](Detailed_Claim_CLI/img_2.png)
5. Select the LSK Account you wanted to claim.
![img_3.png](Detailed_Claim_CLI/img_3.png)
6. Choose and enter mnemonic or private key for Lisk L2.
![img_4.png](Detailed_Claim_CLI/img_4.png)
7. If data is inputted correctly, the CLI will show Lisk L2 address, which can also be the destination address of the Claim.
![img_5.png](Detailed_Claim_CLI/img_5.png)
8. Verify details and network fee before submitting the transaction. Network fee can be adjusted or using the amount suggested by the network.
![img_6.png](Detailed_Claim_CLI/img_6.png)
9. Success, the transaction can be viewed on explorer by using the transaction hash.
![img_7.png](Detailed_Claim_CLI/img_7.png)
Binary file added documentation/Detailed_Claim_CLI/img.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 documentation/Detailed_Claim_CLI/img_1.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 documentation/Detailed_Claim_CLI/img_2.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 documentation/Detailed_Claim_CLI/img_3.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 documentation/Detailed_Claim_CLI/img_4.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 documentation/Detailed_Claim_CLI/img_5.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 documentation/Detailed_Claim_CLI/img_6.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 documentation/Detailed_Claim_CLI/img_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 6 additions & 2 deletions packages/claim-cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,16 @@ cd packages/claim-cli
yarn && yarn build

# Start Claim CLI on mainnet
./bin/run.js start
gkoumout marked this conversation as resolved.
Show resolved Hide resolved
./bin/run.js

# Or start Claim CLI on testnet
# ./bin/run.js start --network testnet
# ./bin/run.js --network testnet
```

## Usage

Detailed guide to Claim CLI is located in [Detailed Guide to Claim CLI Tool](../../documentation/Detailed_Claim_CLI.md).

## Workflow

### Check Eligibility
Expand Down
Loading