Skip to content

Commit 9f58919

Browse files
committed
feat: add RLC Bridge documentation and images for Bellecour and Stargate bridges
1 parent b785a33 commit 9f58919

File tree

5 files changed

+202
-0
lines changed

5 files changed

+202
-0
lines changed

.vitepress/sidebar.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,10 @@ export function getSidebar() {
5555
text: 'Builder Dashboard',
5656
link: '/overview/tooling-and-explorers/builder-dashboard',
5757
},
58+
{
59+
text: 'Bridge',
60+
link: '/overview/tooling-and-explorers/bridge',
61+
},
5862
{
5963
text: 'Subgraph Explorer',
6064
link: '/overview/tooling-and-explorers/subgraph-explorer',

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,3 +169,4 @@ Fork this repository and ensure you're working on the `main` branch:
169169
- Add Dune dashboard
170170
- Add a Development workflow
171171
- Update context7 when doc will be deployed
172+
- Add section iexec-explorer.md file to talk about: available chain + SRLC/RLC feature of the protocol
244 KB
Loading
55.6 KB
Loading
Lines changed: 197 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
---
2+
title: RLC Bridge
3+
description:
4+
Bridge RLC tokens between networks to interact with the iExec protocol.
5+
Transfer RLC to Bellecour (xRLC) and Arbitrum networks using dedicated bridges
6+
---
7+
8+
# 🌉 RLC Bridge
9+
10+
**RLC** (RLC Token) is the essential cryptocurrency for interacting with the iExec protocol. Whether you are executing tasks, accessing protected data, or participating in the iExec decentralized confidential computing network, you will need RLC tokens on the appropriate network.
11+
12+
This guide helps you bridge RLC tokens to **Bellecour** (becoming xRLC) and **Arbitrum** networks using dedicated bridge solutions.
13+
14+
## 🎯 Why Bridge RLC?
15+
16+
RLC tokens are required for various iExec protocol interactions:
17+
18+
- **Task Execution**: Pay for confidential computing tasks
19+
- **Data Access**: Purchase access to protected datasets
20+
- **Protocol Participation**: Stake tokens for workerpool operations
21+
- **Application Usage**: Pay for iApp executions
22+
- **Data Protection**: Cover costs for data encryption and storage
23+
24+
### Network-Specific Requirements
25+
26+
- **Bellecour Network**: Uses **xRLC** (bridged RLC) for gasless transactions
27+
- **Arbitrum Network**: Uses **RLC** for mainnet operations with lower gas fees
28+
29+
## 🗂️ Available Bridges
30+
31+
iExec provides dedicated bridge solutions for seamless token transfers across networks:
32+
33+
<CardGrid>
34+
<ProjectCard
35+
title="Bellecour Bridge"
36+
description="Bridge RLC from Ethereum mainnet to Bellecour sidechain (xRLC) for gasless transactions and protocol interactions"
37+
icon-image="/assets/icons/iexec-logo.png"
38+
status="available"
39+
status-label="Live"
40+
button-label="Access Bridge"
41+
button-icon="mdi:bridge"
42+
button-href="https://bridge-bellecour.iex.ec/"
43+
button-target="_blank"
44+
button-rel="noreferrer"
45+
/>
46+
47+
<ProjectCard
48+
title="Stargate Bridge"
49+
description="Bridge RLC to Arbitrum mainnet using LayerZero's Stargate protocol for cross-chain transfers"
50+
icon-image="/assets/icons/arbitrum-logo.png"
51+
status="available"
52+
status-label="Live"
53+
button-label="Access Bridge"
54+
button-icon="mdi:bridge"
55+
button-href="https://stargateprotocol.com/"
56+
button-target="_blank"
57+
button-rel="noreferrer"
58+
/>
59+
</CardGrid>
60+
61+
## 🔄 Bellecour Bridge (RLC → xRLC)
62+
63+
The **Bellecour Bridge** enables seamless transfer of RLC tokens from Ethereum mainnet to the Bellecour sidechain, where they become **xRLC** tokens.
64+
65+
### Key Features
66+
67+
- **Gasless Transactions**: Bellecour is a gasless blockchain
68+
- **Instant Transfers**: Quick bridge operations with minimal waiting time
69+
- **Native Integration**: Fully integrated with iExec protocol
70+
- **User-Friendly Interface**: Simple and intuitive bridge interface
71+
72+
### How to Bridge to Bellecour
73+
74+
1. **Connect Wallet**: Visit [Bellecour Bridge](https://bridge-bellecour.iex.ec/) and connect your wallet
75+
2. **Select Amount**: Choose the amount of RLC you want to bridge
76+
3. **Confirm Transaction**: Approve the bridge transaction on Ethereum mainnet
77+
4. **Receive xRLC**: Your xRLC tokens will be available on Bellecour network
78+
79+
<ImageViewer
80+
image-url-dark="/assets/tooling-&-explorers/bridge/bellecour-bridge.png"
81+
image-alt="Bellecour Bridge Process"
82+
link-url="https://bridge-bellecour.iex.ec/"
83+
caption="🔗 Start Bridging to Bellecour"
84+
/>
85+
86+
### Bridge Process Details
87+
88+
The Bellecour bridge operates on a **lock & mint / burn & unlock** principle:
89+
90+
- **Ethereum → Bellecour**: RLC tokens are locked on Ethereum mainnet, and equivalent xRLC tokens are minted on Bellecour
91+
- **Bellecour → Ethereum**: xRLC tokens are burned on Bellecour, and equivalent RLC tokens are unlocked on Ethereum mainnet
92+
93+
### Using xRLC on Bellecour
94+
95+
Once you have xRLC on Bellecour, you can:
96+
97+
```javascript
98+
// Deposit xRLC into your iExec account
99+
iexec.account.deposit(xRLC_amount);
100+
101+
// Check your sRLC balance
102+
iexec.account.show();
103+
104+
// Use sRLC for task execution
105+
// Your tasks will automatically use sRLC for payments
106+
```
107+
108+
## 🌉 Stargate Bridge (RLC → Arbitrum)
109+
110+
The **Stargate Bridge** powered by LayerZero enables cross-chain transfers of RLC tokens to Arbitrum mainnet.
111+
112+
### Key Features
113+
114+
- **Cross-Chain Protocol**: Powered by LayerZero's Stargate protocol
115+
- **Arbitrum Integration**: Native support for Arbitrum mainnet
116+
- **Fast Transfers**: Optimized for cross-chain efficiency
117+
- **Security**: Audited and secure bridge infrastructure
118+
119+
### How to Bridge to Arbitrum
120+
121+
1. **Visit Stargate**: Go to [Stargate Protocol](https://stargateprotocol.com/)
122+
2. **Connect Wallet**: Connect your wallet to the Stargate interface
123+
3. **Select Networks**: Choose Ethereum as source and Arbitrum as destination
124+
4. **Select Token**: Choose RLC as the token to bridge
125+
5. **Enter Amount**: Specify the amount of RLC to transfer
126+
6. **Confirm Transaction**: Approve the bridge transaction
127+
128+
<ImageViewer
129+
image-url-dark="/assets/tooling-&-explorers/bridge/stargate-bridge.png"
130+
image-alt="Stargate Bridge Interface"
131+
link-url="https://stargateprotocol.com/"
132+
caption="🔗 Access Stargate Bridge"
133+
/>
134+
135+
### Bridge Process Details
136+
137+
Stargate uses LayerZero's cross-chain messaging protocol:
138+
139+
- **Source Chain**: RLC tokens are locked/burned on the source chain
140+
- **Cross-Chain Message**: LayerZero relays the transfer message
141+
- **Destination Chain**: Equivalent RLC tokens are minted/unlocked on Arbitrum
142+
143+
## 💡 Bridge Comparison
144+
145+
| Feature | Bellecour Bridge | Stargate Bridge |
146+
|---------|------------------|-----------------|
147+
| **Destination** | Bellecour Sidechain | Arbitrum Mainnet |
148+
| **Token** | RLC → xRLC | RLC → RLC |
149+
| **Gas Fees** | Gasless | Low gas fees |
150+
| **Speed** | Fast | Fast |
151+
| **Use Case** | Protocol interactions | Mainnet operations |
152+
| **Integration** | Native iExec | Third-party |
153+
154+
## 🚀 Getting Started
155+
156+
### Prerequisites
157+
158+
1. **RLC Tokens**: Ensure you have RLC tokens on Ethereum mainnet
159+
2. **Wallet**: MetaMask or compatible Web3 wallet
160+
3. **Network Support**: Ensure your wallet supports the target network
161+
162+
### Step-by-Step Guide
163+
164+
#### For Bellecour (Recommended for Development)
165+
166+
1. **Acquire RLC**: Purchase RLC from supported exchanges
167+
2. **Bridge to Bellecour**: Use [Bellecour Bridge](https://bridge-bellecour.iex.ec/)
168+
3. **Deposit xRLC**: Deposit xRLC into your iExec account
169+
4. **Start Building**: Begin interacting with the iExec protocol
170+
171+
#### For Arbitrum (Production)
172+
173+
1. **Acquire RLC**: Purchase RLC from supported exchanges
174+
2. **Bridge to Arbitrum**: Use [Stargate Bridge](https://stargateprotocol.com/)
175+
3. **Connect to Protocol**: Use RLC directly on Arbitrum mainnet
176+
4. **Deploy Production**: Launch your applications on Arbitrum
177+
178+
## 🔗 Additional Resources
179+
180+
- [Bellecour Bridge](https://bridge-bellecour.iex.ec/) - Official Bellecour bridge interface
181+
- [Stargate Protocol](https://stargateprotocol.com/) - Cross-chain bridge solution
182+
- [iExec Explorer](https://explorer.iex.ec/) - Monitor transactions and balances
183+
- [RLC Token Information](https://iex.ec/rlc) - Learn more about RLC token
184+
- [Bellecour Network](https://chainlist.org/?search=bellecour) - Network configuration
185+
186+
---
187+
188+
<div class="bg-gradient-to-r from-yellow-400/10 to-orange-400/5 rounded-[6px] p-6 border-l-4 border-yellow-700 mb-6">
189+
<h4 class="!mt-0 !mb-2">💡 Pro Tip</h4>
190+
<p class="!mb-0">Use <strong>Bellecour</strong> for development and testing (gasless), then bridge to <strong>Arbitrum</strong> for production deployments. This approach saves on gas costs during development while ensuring your applications are ready for mainnet.</p>
191+
</div>
192+
193+
<script setup>
194+
import ImageViewer from '../../components/ImageViewer.vue';
195+
import CardGrid from '../../components/CardGrid.vue';
196+
import ProjectCard from '../../components/ProjectCard.vue';
197+
</script>

0 commit comments

Comments
 (0)