Skip to content
This repository has been archived by the owner on Jun 20, 2024. It is now read-only.

Commit

Permalink
update: Add instructions for getting SEPOLIA tokens
Browse files Browse the repository at this point in the history
  • Loading branch information
machuwey committed Jan 12, 2024
1 parent 9595c0d commit d2eb299
Show file tree
Hide file tree
Showing 5 changed files with 45 additions and 1 deletion.
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
- [Scarb: The Package Manager](ch02-03-scarb.md)
- [Katana: A Local Node](ch02-04-katana.md)
- [Testnet Deployment](ch02-05-testnet-deployment.md)
- [How to get SEPOLIA tokens](ch02-05-01-start-with-sepolia.md)
- [Starkli: Querying Starknet](ch02-06-starkli.md)
- [Example - Beginner: Connection Script](ch02-06-01-connection-script.md)
- [Starknet Devnet](ch02-07-starknet-devnet.md)
Expand Down
43 changes: 43 additions & 0 deletions src/ch02-05-01-start-with-sepolia.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Acquiring SEPOLIA Tokens

## Overview

Currently, there are no active Sepolia faucets in Starknet. Therefore, the process of acquiring SEPOLIA tokens involves obtaining them on the **Ethereum** Sepolia testnet and then transferring them to the Starknet Sepolia testnet.

## Step 1: Obtain SEPOLIA Tokens on the Ethereum Sepolia Testnet

To acquire $ETH on the Ethereum Sepolia testnet, you can use:

1. [Alchemy's Sepolia Faucet](https://sepoliafaucet.com/).
2. [Infura's Sepolia Faucet](https://www.infura.io/faucet/sepolia).

The process is simple: log in, paste your Ethereum Sepolia testnet address, and click the "Send me $ETH" button.

## Step 2: Transfer Your $ETH to the Starknet Sepolia Testnet

This step is slightly more complex. You will need to navigate to the [Bridge Contract](https://sepolia.etherscan.io/address/0x8453FC6Cd1bCfE8D4dFC069C400B433054d47bDc#writeProxyContract).

<img alt="Activate the Starknet Plugin" src="img/ch02-05-01-bridge-sepolia.png" class="center" style="width: 100%;" />

Connect the wallet containing your $ETH and then open function number 4 `deposit (0xe2bbb158)`.

### Parameter Specification

For the fields, specify:

- `deposit`: The amount of ETH to deposit **plus** a small amount for gas. For example, `x + 0.001 ETH`. (Ex: 0.031)
- `amount`: The amount of $ETH you want to transfer to Starknet in **uint256** format. In this case, `0.03 ETH` would be `30000000000000000` (16 decimals).

```bash
1 ETH = 1000000000000000000 (18 decimals)
```

- `l2Recipient`: The address of your Starknet Sepolia testnet account.

<img alt="Activate the Starknet Plugin" src="img/ch02-05-01-deposit-bridge-starknet.png" class="center" style="width: 100%;" />

Click the "Write" button and confirm the transaction in your wallet.

## [Optional] Wallet Deployment

If this is your first time using your wallet on the Starknet Sepolia testnet, go to your ArgentX or Braavos wallet and send some of the ETH you transferred to **another starknet wallet**. This will automatically deploy your wallet.
2 changes: 1 addition & 1 deletion src/ch02-05-testnet-deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,7 +217,7 @@ Note: If you don't specify the rpc provider, Starkli will use Goerli, which will
>
> #### 🟩 Solution:
>
> It means you probably just created a new wallet and it has **not been deployed yet**. To accomplish this you have to fund your wallet with tokens and **transfer tokens** to a **different** wallet address.
> It means you probably just created a new wallet and it has **not been deployed yet**. To accomplish this you have to fund your wallet with tokens and **transfer tokens** to a **different** wallet address. Detailed intructons can be found in the [Get Seplia Tokens](./ch02-05-01-start-with-sepolia.md) section.
>
> **Still doesn't work?**
>
Expand Down
Binary file added src/img/ch02-05-01-bridge-sepolia.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 src/img/ch02-05-01-deposit-bridge-starknet.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 d2eb299

Please sign in to comment.