Feat/integrate faucet into documentation (#83)

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

Author: Le-Caignec

.vitepress/sidebar.ts

@@ -92,6 +92,10 @@ export function getSidebar() {
             text: 'RLC Bridge',
             link: '/get-started/tooling-and-explorers/bridge',
           },
+          {
+            text: 'RLC Faucet',
+            link: '/get-started/tooling-and-explorers/faucet',
+          },
           {
             text: 'Subgraph Explorer',
             link: '/get-started/tooling-and-explorers/subgraph-explorer',

src/assets/tooling-&-explorers/faucet/faucet.png

@@ -20,7 +20,7 @@ create, test and deploy iApp with just a few commands.
 </Banner>
 
 If you wanna explore and deep dive in the command-line tool. You can check the
-[iApp Generator ](https://github.com/iExecBlockchainComputing/iapp/tree/main/cli)
+[iApp Generator](https://github.com/iExecBlockchainComputing/iapp/tree/main/cli)
 GitHub repository. Follow the instructions carefully for a smooth development
 experience.
 
@@ -401,6 +401,24 @@ If you set the wrong Docker username, you can change it by editing the
 
 :::
 
+### 💰 Getting RLC Tokens
+
+To deploy and run your iApp, you'll need RLC tokens to pay for:
+
+- **Workerpool execution costs** for running your iApp on decentralized compute
+  resources
+- **Protected Data access fees** if your iApp requires confidential datasets
+  (and you're not the data provider)
+- **iApp execution costs** if you're not the owner of the iApp you're running
+
+**Getting RLC tokens:**
+
+- **For Testing**: Get free RLC tokens on Arbitrum Sepolia testnet using the
+  [iExec RLC Faucet](https://explorer.iex.ec/arbitrum-sepolia-testnet/faucet)
+- **For Production**: Purchase RLC from [exchanges](/get-started/overview/rlc)
+  or bridge from Ethereum using the
+  [RLC Bridge](/get-started/tooling-and-explorers/bridge)
+
 ## 🏃 Run your iApp
 
 Now you can run your application:

src/get-started/helloWorld/3-buildIApp.md

@@ -111,16 +111,16 @@ You can acquire RLC tokens through several methods:
     title="Decentralized Exchanges"
     :features="[
       { text: 'ETH: RLC/ETH on Uniswap', link: 'https://app.uniswap.org/explore/pools/ethereum/0x56Ea002B411FD5887E55329852D5777EcB170713' },
-      'ARB: RLC/ETH (coming soon)',
+        { text: 'ARB: RLC/WETH on Uniswap', link: 'https://app.uniswap.org/explore/pools/arbitrum/0x0EB43B37539a4261Aa1860f9476094Bb2C00A894' },
       'High liquidity DEX trading'
     ]"
   />
 
   <FeatureCard
     title="Cross-Chain Bridging"
     :features="[
-      'Bellecour Bridge',
-      'Stargate Bridge (Arbitrum)',
+      { text: 'Bellecour Bridge', link: 'https://bridge-bellecour.iex.ec/' },
+      { text: 'Stargate Bridge (Arbitrum)', link: 'https://stargate.finance/bridge' }
     ]"
   />
 

src/get-started/overview/rlc.md

@@ -98,7 +98,9 @@ learning and prototyping.
    React/Vue options
 2. **Experiment**: Try the interactive sandboxes to understand core concepts
 3. **Build**: Integrate the features you need into your application
-4. **Deploy**: Use our deployment guides for production-ready applications
+4. **Get RLC Tokens**: Use the
+   [iExec RLC Faucet](https://explorer.iex.ec/arbitrum-sepolia-testnet/faucet)
+5. **Deploy**: Use our deployment guides for production-ready applications
 
 <script setup>
 import CardGrid from '@/components/CardGrid.vue';

src/get-started/quick-start.md

@@ -14,6 +14,16 @@ the iExec confidential computing network.
 This guide helps you bridge RLC tokens to **Bellecour** (becoming xRLC) and
 **Arbitrum** networks using the Bellecour Bridge and Stargate Bridge.
 
+::: tip 🧪 Testing on Arbitrum Sepolia
+
+For development and testing purposes, you can get free RLC tokens on **Arbitrum
+Sepolia testnet** using the
+[iExec RLC Faucet](https://explorer.iex.ec/arbitrum-sepolia-testnet/faucet).
+This allows you to test your iApps, pay for workerpool executions, and access
+protected datasets without spending real tokens.
+
+:::
+
 ## 🗂️ Available Bridges
 
 iExec provides officially supported bridges for seamless token transfer across

src/get-started/tooling-and-explorers/bridge.md

@@ -0,0 +1,68 @@
+---
+title: RLC Faucet
+description:
+  Get free RLC tokens on Arbitrum Sepolia testnet for testing your iApps,
+  workerpools, and protected datasets without spending real tokens.
+---
+
+# 🚰 RLC Faucet
+
+Get free RLC tokens on **Arbitrum Sepolia testnet** to test your iApps, pay for
+workerpool executions, and access protected datasets without spending real
+tokens.
+
+## What are RLC Tokens Used For?
+
+In the iExec ecosystem, RLC tokens are used to pay for various services:
+
+- **Pay Workerpools** - Compensate computational resources for executing your
+  iApps
+- **Pay Protected Data Providers** - Access and use protected datasets in your
+  applications
+- **Pay iApp Providers** - Use decentralized applications deployed on the
+  network
+
+These testnet RLC tokens allow you to test all these payment flows without
+spending real tokens.
+
+## Eligibility Requirements
+
+To be eligible for RLC claims, builders must meet these criteria:
+
+- **GitHub or Google login** required for verification
+- **Maximum 1 RLC** in your wallet to claim (prevents abuse and ensures fair
+  distribution)
+- **One claim per 24 hours** per authenticated account
+
+## 💰 Claim Details
+
+<UseCaseCard
+  title="🚰 iExec RLC Faucet"
+  description="Get 5 RLC tokens per claim on Arbitrum Sepolia testnet for testing your iExec applications and services."
+  :image-url="faucetImage"
+  image-alt="iExec RLC Faucet Interface"
+  :features="[
+    '5 RLC per claim',
+    'GitHub/Google authentication',
+    '24-hour cooldown period',
+    'Balance verification (max 1 RLC)',
+    'Arbitrum Sepolia testnet only'
+  ]"
+  demo-url="https://explorer.iex.ec/arbitrum-sepolia-testnet/faucet"
+  demo-icon="mdi:water"
+  demo-label="Access Faucet"
+/>
+
+::: tip 💡 Development Workflow
+
+Use the RLC Faucet for development and testing, then bridge real RLC tokens when
+ready for production deployment on Arbitrum mainnet.
+
+:::
+
+<script setup>
+import UseCaseCard from '@/components/UseCaseCard.vue';
+
+// Assets
+import faucetImage from '@/assets/tooling-&-explorers/faucet/faucet.png';
+</script>

src/get-started/tooling-and-explorers/faucet.md

@@ -10,6 +10,28 @@ description:
 It's time to run your iApp! After building and testing, you'll need to deploy it
 to a supported network and then execute it.
 
+## Prerequisites
+
+Before deploying and running your iApp, ensure you have sufficient RLC tokens to
+cover:
+
+- **Workerpool execution costs** for running your iApp on decentralized compute
+  resources
+- **Protected Data access fees** if your iApp requires confidential datasets
+  (and you're not the data provider)
+- **iApp execution costs** if you're not the owner of the iApp you're running
+
+**Getting RLC tokens:**
+
+- **Arbitrum Mainnet**: Purchase RLC from [exchanges](/get-started/overview/rlc)
+  or bridge from Ethereum using the
+  [RLC Bridge](/get-started/tooling-and-explorers/bridge)
+- **Arbitrum Sepolia Testnet**: Get free RLC tokens from the
+  [iExec RLC Faucet](https://explorer.iex.ec/arbitrum-sepolia-testnet/faucet)
+  for testing purposes
+- **Bellecour**: Bridge RLC from Ethereum using the
+  [RLC Bridge](/get-started/tooling-and-explorers/bridge)
+
 ## Deploy your iApp
 
 After your tests pass and the package is built, you can deploy your iApp to a

src/guides/build-iapp/deploy-&-run.md

@@ -58,7 +58,7 @@ const logout = async () => {
 
 watch(
   async () => isConnected.value,
-  async (newIsConnected) => {
+  async () => {
     if (status.value === 'connected') {
       const provider = await connector.value?.getProvider();
       emit('connected', provider);

src/modules/helloWorld/ReownButton.vue

@@ -37,6 +37,13 @@ Before using the iApp Generator, make sure you have:
     </div>
     <a target="_blank" href="https://hub.docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Sign Up →</a>
   </div>
+  
+  <div class="flex items-center gap-4 text-left">
+    <div class="flex items-center gap-1 flex-1 text-sm font-medium">
+      💰 RLC Tokens
+    </div>
+    <a href="/get-started/overview/rlc" class="no-underline! text-sm ml-auto hover:underline!">Learn More →</a>
+  </div>
 </div>
 
 ::: tip 🔍 Verify Docker Compatibility