Skip to content

Commit

Permalink
feat: Added Staking dApp tutorial and playground (#277)
Browse files Browse the repository at this point in the history
* Expense Tracker Tutorial (#223)

* Prepared Expense Tracker Doc page

* Updated Images according new Frontend UI

* feat: Added step 1-3 documentation for expense tracker dapp

* fix: documentation fixes

---------

Co-authored-by: mohit6b <[email protected]>

* docs: update aetherlink docs

* docs: update oracle

* docs: remove ccip

* fix: Updated content for expense tracker

* fix: Removed old video link

* update discord links

* feat: Embedded Expense Tracker Video

* Feature: Staking dapp tutorial (#262)

* feat: Added Single Pool Staking documentation

* Added Frontend Documentation for Staking dApp

* Updated content of Frontend Documentation for Staking dApp

* Updated the Step no in Staking frontend dapp

* fix: Reviewed and updated the staking dApp tutorial

* Updated Images of Staking dApp

---------

Co-authored-by: RutvikGhaskataEalf <[email protected]>

* fix: Updated _setup.md with latest dotnet version for tutorials

* fix: Updated stking tutorial with token reference

* feat: Added aelf-playground with new features (#271)

* Feat: Added tutorials, deployments and command line options to aelf playground (#273)

* feat: Added aelf-playground with new features

* feat: Added tutorials, deployment and command line options

---------

Co-authored-by: RutvikGhaskataEalf <[email protected]>
Co-authored-by: mohit6b <[email protected]>
Co-authored-by: yongen.loong <[email protected]>
  • Loading branch information
4 people authored Oct 7, 2024
1 parent 2e25b64 commit 188e294
Show file tree
Hide file tree
Showing 53 changed files with 3,182 additions and 16 deletions.
113 changes: 113 additions & 0 deletions docs/quick-start/developers/_deploy_single_pool_staking.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
#### Create A Wallet

To send transactions on the aelf blockchain, you must have a wallet.

- Run this command to create aelf wallet.

```bash title="Terminal"
aelf-command create
```

![result](/img/create_wallet_output.png)

- You will be prompted to save your account, please do **save** your account as shown below:

```bash title="Terminal"
? Save account info into a file? (Y/n) Y
```

**Make sure to choose Y to save your account information.**

:::tip
ℹ️ Note: If you do not save your account information (by selecting n or N), do not export the wallet password. Only **proceed to the next** step if you have saved your account information.
:::

- Next, enter and confirm your password. Then export your wallet password as shown below:

```bash title="Terminal"
export WALLET_PASSWORD="YOUR_WALLET_PASSWORD"
```

#### Acquire Testnet Tokens (Faucet) for Development

To deploy smart contracts or execute on-chain transactions on aelf, you'll require testnet ELF tokens.

**Get ELF Tokens**

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

<Tabs>
<TabItem value="cli" label="CLI" default>

**1. Get Testnet ELF Tokens:**

To receive testnet ELF tokens, run this command after replacing `$WALLET_ADDRESS` and `$WALLET_PASSWORD` with your wallet details:

```bash title="Terminal"
export WALLET_ADDRESS="YOUR_WALLET_ADDRESS"
curl -X POST "https://faucet.aelf.dev/api/claim?walletAddress=$WALLET_ADDRESS" -H "accept: application/json" -d ""
```

**2. Check ELF Balance:**

To check your ELF balance, use:

```bash title="Terminal"
aelf-command call ASh2Wt7nSEmYqnGxPPzp4pnVDU4uhj1XW9Se5VeZcX2UDdyjx -a $WALLET_ADDRESS -p $WALLET_PASSWORD -e https://tdvw-test-node.aelf.io GetBalance
```

You will be prompted for the following:

```sh title="Terminal"
Enter the required param <symbol>: ELF
Enter the required param <owner>: **$WALLET_ADDRESS**
```

You should see the result displaying your wallet's ELF balance.

</TabItem>
<TabItem value="web" label="Web" default>

Go to https://faucet-ui.aelf.dev Enter your address and click `Get Tokens`.

![result](/img/get-token-ui.png)

</TabItem>
</Tabs>

**Deploy Smart Contract:**

The smart contract needs to be deployed on the chain before users can interact with it.

Run the following command to deploy a contract. Remember to export the path of SinglePoolStaking.dll.patched to CONTRACT_PATH.

```bash title="Terminal"
export CONTRACT_PATH=$(find ~+ . -path "*patched*" | head -n 1)
```

```bash title="Terminal"
aelf-deploy -a $WALLET_ADDRESS -p $WALLET_PASSWORD -c $CONTRACT_PATH -e https://tdvw-test-node.aelf.io/
```

- Please wait for approximately 1 to 2 minutes. If the deployment is successful, it will provide you with the contract address.
![result](/img/deploy-result.png)

- Copy the smart contract address from the `address` field
![result](/img/Contract_Address.png)

- Export your smart contract address:

```bash title="Terminal"
export CONTRACT_ADDRESS="YOUR_SMART_CONTRACT_ADDRESS e.g. 2LUmicHyH4RXrMjG4beDwuDsiWJESyLkgkwPdGTR8kahRzq5XS"
```

:::tip
ℹ️ Note: You are to copy the smart contract address as we will be referencing it in the next steps!
:::

:::info
🎉 You have successfully deployed your Single Pool Staking dApp smart contract on the aelf testnet! In the next steps, we will be building the frontend components that allow us to interact with our deployed smart contract!
:::


2 changes: 1 addition & 1 deletion docs/quick-start/developers/_setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem';

**Install Required Packages**

- [Install dotnet 6.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
- [Install dotnet 8.0.x SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- Install aelf contract templates

```bash title="Terminal"
Expand Down
Loading

0 comments on commit 188e294

Please sign in to comment.