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

Document "Connect your wallet" for asset hub smart contracts #300

Open
wants to merge 23 commits into
base: staging-ah-smart-contracts
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 18 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
f9f0904
fix: wip
nhussein11 Jan 7, 2025
01b7afc
fix: connect your metamask
nhussein11 Jan 7, 2025
86160c3
Merge branch 'master' into 277-document-how-to-connect-metamask-to-we…
nhussein11 Jan 7, 2025
23d8dda
Update develop/smart-contracts/evm/connect-your-wallet.md
nhussein11 Jan 7, 2025
83827d1
Update develop/smart-contracts/evm/connect-your-wallet.md
nhussein11 Jan 7, 2025
0373180
fix: desc
nhussein11 Jan 7, 2025
0f25935
Update develop/smart-contracts/evm/connect-your-wallet.md
nhussein11 Jan 7, 2025
d68dde9
Update develop/smart-contracts/evm/connect-your-wallet.md
nhussein11 Jan 7, 2025
874e00d
fix: wording
nhussein11 Jan 7, 2025
7303cd5
fix: ia
nhussein11 Jan 7, 2025
5fc8345
Update develop/smart-contracts/evm-toolkit/connect-your-wallet.md
nhussein11 Jan 14, 2025
1131da6
Update develop/smart-contracts/evm-toolkit/connect-your-wallet.md
nhussein11 Jan 14, 2025
47ef44e
fix: adding rpc urls
nhussein11 Jan 14, 2025
8dee80b
Update develop/smart-contracts/evm-toolkit/connect-your-wallet.md
nhussein11 Jan 16, 2025
9d0848f
Update develop/smart-contracts/evm-toolkit/connect-your-wallet.md
nhussein11 Jan 16, 2025
2d8306f
fix: wording
nhussein11 Jan 16, 2025
75a00c3
fix: wording
nhussein11 Jan 17, 2025
2e6ca36
fix: update image syntax to add `browser-extension` css class to them
nhussein11 Jan 17, 2025
1108a21
Apply suggestions from code review
nhussein11 Jan 20, 2025
3e936c6
Merge branch 'staging-ah-smart-contracts' into 277-document-how-to-co…
nhussein11 Jan 20, 2025
ae2e3ff
applies SEO description suggestion from review
dawnkelly09 Jan 22, 2025
29575f2
Revert "applies SEO description suggestion from review"
dawnkelly09 Jan 22, 2025
b760a6a
Apply suggestions from code review
nhussein11 Jan 23, 2025
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
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,14 @@ pallet-balances = { workspace = true, default-features = false }
[features]
default = ["std"]
std = [
"codec/std",
"frame-support/std",
"frame-system/std",
"scale-info/std",
"sp-runtime/std",
"sp-core/std",
"sp-io/std",
"pallet-balances/std",
"codec/std",
"frame-support/std",
"frame-system/std",
"scale-info/std",
"sp-runtime/std",
"sp-core/std",
"sp-io/std",
"pallet-balances/std",
]

[lints]
Expand Down
4 changes: 3 additions & 1 deletion develop/smart-contracts/.pages
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,6 @@ nav:
- index.md
- 'Overview': overview.md
- 'Wasm (ink!)': wasm-ink.md
- evm
- 'Native EVM Contracts': native-evm-contracts.md
- 'Parachain Contracts': parachain-contracts.md
- 'EVM Toolkit': evm-toolkit
4 changes: 4 additions & 0 deletions develop/smart-contracts/evm-toolkit/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
title: EVM Toolkit
nav:
- index.md
- 'Connect Your Wallet': connect-your-wallet.md
100 changes: 100 additions & 0 deletions develop/smart-contracts/evm-toolkit/connect-your-wallet.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
---
title: Connect your Wallet
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved
description: Learn to connect MetaMask to the Asset Hub blockchain. Set up your wallet, switch networks, and request test tokens for development.
---

# Connect your Wallet
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

## Connect to Asset Hub Using MetaMask

MetaMask is a popular wallet for interacting with EVM-compatible chains, allowing users to connect to test networks that support Ethereum-based smart contracts. This article provides guidance on setting up MetaMask, connecting to the contracts deployed on the EVM-compatible test network, the Westend Asset Hub, and requesting test tokens for development purposes.
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

It’s important to emphasize that MetaMask primarily facilitates interactions with smart contracts, giving you access to various functionalities available on the chain.
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

## Prerequisites

To get started with MetaMask, you need to install the [MetaMask extension](https://metamask.io/download/){target=\_blank} and add it to the browser. Once you install MetaMask, you can set up a new wallet and securely store your seed phrase. This phrase is crucial for recovery in case you lose access.

## Connect to the Asset Hub Westend TestNet

To connect to the Westend Asset Hub TestNet via MetaMask, you need to follow these steps:

1. Open the MetaMask extension and click on the network icon to switch to the Asset Hub Westend TestNet

![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-1.webp){: .browser-extension}

2. Click on the **Add a custom network** button

![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-2.webp){: .browser-extension}

3. Fill in the required fields with the following parameters and click the **Save** button

=== "Network Details"
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

**Network name** - `Asset-Hub Westend TestNet`

---

**Currency symbol** - `WND`

---

**Chain ID** - ```420420421```

---

**Block explorer URL** - ```https://assethub-westend.subscan.io```

---
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

=== "RPC Endpoints"
Dwellir
```
wss://westend-asset-hub-eth-rpc.polkadot.io
```
---
Dwellir Tunisia
```
wss://westmint-rpc.polkadot.io
```
---
IBP1
```
wss://rpc.ibp.network/asset-hub-westend
```
---
IBP2
```
wss://asset-hub-westend.dotters.network
```
---
Parity
```
wss://westend-asset-hub-rpc.polkadot.io
```


![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-3.webp){: .browser-extension}

4. Click on the **Asset-Hub Westend TestNet** to switch the network
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-4.webp){: .browser-extension}


## Request Test Tokens

To start conducting transactions and interacting with smart contracts on the Asset Hub Westend TestNet, you'll need test WND tokens. Here's how to get them:
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

1. Navigate to the [Westend Asset Hub Faucet](https://faucet.polkadot.io/westend?parachain=1000){target=\_blank}

2. Copy your MetaMask address linked to the Westend Asset Hub and paste it into the designated field

![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-5.webp)

3. Click the **Get Some WND** button to request free test WND tokens. These tokens will be sent to your MetaMask wallet shortly

![](/images/develop/smart-contracts/evm-toolkit/connect-your-wallet/connect-your-wallet-6.webp)

## Conclusion
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved

Congratulations! You have successfully connected to the Westend Asset Hub using MetaMask and acquired test tokens. This setup allows you to experiment with the network’s functionalities without using real ether or encountering financial risks. Remember to keep your MetaMask credentials secure and never share your wallet’s private key or seed phrase with anyone.
nhussein11 marked this conversation as resolved.
Show resolved Hide resolved
Empty file.
6 changes: 0 additions & 6 deletions develop/smart-contracts/evm/.pages

This file was deleted.

52 changes: 0 additions & 52 deletions develop/smart-contracts/evm/index.md

This file was deleted.

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.