Skip to content

Commit 451e707

Browse files
JustinaPetrJustinaPetr
authored
Merge pull request #345 from lavanet/add-arbitrum
Add arbitrum endpoints
2 parents 18bc786 + 3e8fa61 commit 451e707

File tree

5 files changed

+488
-0
lines changed

5 files changed

+488
-0
lines changed

‎docs/chains/arbitrum-chain/arbitrum-dev.md

+290
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,290 @@
1+
---
2+
slug: /arbitrum-dev
3+
title: Getting Arbitrum RPC
4+
---
5+
6+
import Tabs from '@theme/Tabs';
7+
import TabItem from '@theme/TabItem';
8+
9+
# Getting Arbitrum RPC
10+
11+
12+
## Arbitrum ipRPC 🪙
13+
14+
Lava🌋 now offers [incentivized public RPC](https://pools.lavanet.xyz/) for Arbitrum. Developers can get free, public endpoints for all.
15+
16+
### Mainnet (Arbitrum One) 🌐
17+
18+
| Service 🔌 | URL 🔗 |
19+
| ----------------------------- | ---------------------------------------------- |
20+
| 🟢 json-rpc | https://arbitrum.lava.build |
21+
22+
23+
24+
### Testnet (Arbitrum Nova) 🧪
25+
26+
| Service 🔌 | URL 🔗 |
27+
| ----------------------------- | --------------------------------------------- |
28+
| 🟢 json-rpc | https://arbn.lava.build |
29+
30+
31+
32+
### Testnet (Arbitrum Sepolia) 🧪
33+
34+
| Service 🔌 | URL 🔗 |
35+
| ----------------------------- | --------------------------------------------- |
36+
| 🟢 json-rpc | https://arbitrums.lava.build |
37+
38+
39+
40+
41+
42+
43+
## API Reference
44+
45+
<Tabs>
46+
<TabItems value="JSONRPC/HTTP" label="JSONRPC/HTTP">
47+
<Tabs>
48+
<TabItems value="cURL" label="cURL">
49+
50+
```shell
51+
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer e04c14f2-7735-4034-a458-dd1a39e75b39" https://g.w.lavanet.xyz:443/gateway/arb1/rpc-http/3dc655f970c930f1d3e78ee71beece18 --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
52+
```
53+
54+
</TabItems>
55+
<TabItems value="Python" label="Python">
56+
57+
```python
58+
# pip install requests
59+
import requests
60+
import json
61+
62+
# URL for the Ethereum RPC HTTP endpoint
63+
url = "https://g.w.lavanet.xyz:443/gateway/arb1/rpc-http/3dc655f970c930f1d3e78ee71beece18"
64+
# JSON-RPC request payload
65+
request_payload = {
66+
"jsonrpc": "2.0",
67+
"method": "eth_blockNumber",
68+
"params": [],
69+
"id": 1,
70+
}
71+
72+
try:
73+
# HTTP headers
74+
headers = {"Content-Type": "application/json"}
75+
# Sending POST request
76+
response = requests.post(url, headers=headers, data=json.dumps(request_payload))
77+
response.raise_for_status() # Check if the request was successful
78+
# Parsing JSON response
79+
data = response.json()
80+
print("Block Number Response:", data)
81+
except requests.exceptions.RequestException as e:
82+
print(f"Error fetching block number: {e}")
83+
```
84+
85+
</TabItems>
86+
<TabItems value="NodeJS" label="NodeJS">
87+
88+
```jsx
89+
//npm i axios
90+
const axios = require("axios");
91+
92+
// URL for the Ethereum RPC HTTP endpoint
93+
const url =
94+
"https://g.w.lavanet.xyz:443/gateway/arb1/rpc-http/3dc655f970c930f1d3e78ee71beece18";
95+
// JSON-RPC request payload
96+
const requestPayload = {
97+
jsonrpc: "2.0",
98+
method: "eth_blockNumber",
99+
params: [],
100+
id: 1,
101+
};
102+
103+
async function fetchBlockNumber() {
104+
try {
105+
// Sending POST request
106+
const response = await axios.post(url, requestPayload, {
107+
headers: {
108+
"Content-Type": "application/json",
109+
},
110+
});
111+
// Logging the response
112+
console.log("Block Number Response:", response.data);
113+
} catch (error) {
114+
console.error("Error fetching block number:", error.message);
115+
}
116+
}
117+
118+
fetchBlockNumber();
119+
```
120+
121+
</TabItems>
122+
123+
</Tabs>
124+
</TabItems>
125+
<TabItems value="JSONRPC/WEBSOCKET" label="JSONRPC/WEBSOCKET">
126+
<Tabs>
127+
<TabItems value="WSCAT" label="WSCAT">
128+
129+
```shell
130+
wscat -c wss://g.w.lavanet.xyz:443/gateway/arb1/rpc/3dc655f970c930f1d3e78ee71beece18?secret=null -x '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
131+
```
132+
133+
</TabItems>
134+
<TabItems value="Python" label="Python">
135+
136+
```python
137+
# pip install asyncio websockets
138+
import asyncio
139+
import websockets
140+
import json
141+
142+
# WebSocket URL and JSON-RPC request payload
143+
url = "wss://g.w.lavanet.xyz:443/gateway/arb1/rpc/3dc655f970c930f1d3e78ee71beece18?secret=null"
144+
request_payload = {
145+
"jsonrpc": "2.0",
146+
"method": "eth_blockNumber",
147+
"params": [],
148+
"id": 1,
149+
}
150+
151+
async def fetch_block_number():
152+
try:
153+
async with websockets.connect(url) as websocket:
154+
print("WebSocket connection opened.")
155+
# Send the JSON-RPC request payload
156+
await websocket.send(json.dumps(request_payload))
157+
158+
# Receive the response
159+
response = await websocket.recv()
160+
print("Received response:", response)
161+
except Exception as e:
162+
print("Error:", e)
163+
164+
# Run the async function
165+
asyncio.run(fetch_block_number())
166+
```
167+
168+
</TabItems>
169+
<TabItems value="NodeJS" label="NodeJS">
170+
171+
```jsx
172+
//npm i ws
173+
const WebSocket = require("ws");
174+
175+
// WebSocket URL and JSON-RPC request payload
176+
const url =
177+
"wss://g.w.lavanet.xyz:443/gateway/arb1/rpc/3dc655f970c930f1d3e78ee71beece18?secret=null";
178+
const requestPayload = {
179+
jsonrpc: "2.0",
180+
method: "eth_blockNumber",
181+
params: [],
182+
id: 1,
183+
};
184+
185+
const ws = new WebSocket(url);
186+
187+
// Open the WebSocket connection
188+
ws.on("open", () => {
189+
console.log("WebSocket connection opened.");
190+
// Send the JSON-RPC request
191+
ws.send(JSON.stringify(requestPayload));
192+
});
193+
194+
// Listen for the response message
195+
ws.on("message", (message) => {
196+
console.log("Received response:", message.toString());
197+
ws.close();
198+
});
199+
200+
// Handle WebSocket errors
201+
ws.on("error", (error) => {
202+
console.error("WebSocket error:", error.message);
203+
});
204+
205+
// Handle connection closure
206+
ws.on("close", () => {
207+
console.log("WebSocket connection closed.");
208+
});
209+
```
210+
211+
</TabItems>
212+
213+
</Tabs></TabItems>
214+
215+
</Tabs>
216+
217+
<hr/>
218+
219+
## [Gateway](https://gateway.lavanet.xyz/?utm_source=ethereum-dev&utm_medium=docs&utm_campaign=docs-to-gateway)
220+
221+
To learn more about using the Lava Gateway visit the [Getting Started guide](https://docs.lavanet.xyz/gateway-getting-started?utm_source=ethereum-dev&utm_medium=docs&utm_campaign=docs-to-docs)
222+
223+
<hr />
224+
<br />
225+
226+
## SDK
227+
228+
### Input 📥
229+
230+
<Tabs>
231+
<TabItem value="backend" label="BackEnd">
232+
233+
```jsx
234+
// Install lavaSDK with the following command:
235+
// npm i @lavanet/lava-sdk
236+
const { LavaSDK } = require("@lavanet/lava-sdk");
237+
238+
async function useEthereumMainnet() {
239+
const ethereumMainnet = await LavaSDK.create({
240+
privateKey: process.env.PRIVATE_KEY, //hide your private key in an environmental variable
241+
chainIds: "ARB1",
242+
});
243+
244+
const ethereumBlockResponse = await ethereumMainnet.sendRelay({
245+
method: "eth_blockNumber",
246+
params: [],
247+
});
248+
249+
console.log(ethereumBlockResponse);
250+
}
251+
252+
(async () => {
253+
await useEthereumMainnet();
254+
})();
255+
```
256+
257+
</TabItem>
258+
<TabItem value="frontend" label="FrontEnd">
259+
260+
```jsx
261+
// Install lavaSDK with the following command:
262+
// npm i @lavanet/lava-sdk
263+
const { LavaSDK } = require("@lavanet/lava-sdk");
264+
265+
async function useEthereumMainnet() {
266+
const ethereumMainnet = await LavaSDK.create({
267+
badge: {
268+
badgeServerAddress: "https://badges.lavanet.xyz", // Or your own Badge-Server URL
269+
projectId: "enter_your_project_id_here",
270+
},
271+
chainIds: "ARB1",
272+
});
273+
274+
const ethereumBlockResponse = await ethereumMainnet.sendRelay({
275+
method: "eth_blockNumber",
276+
params: [],
277+
});
278+
279+
console.log(ethereumBlockResponse);
280+
}
281+
282+
(async () => {
283+
await useEthereumMainnet();
284+
})();
285+
```
286+
287+
</TabItem>
288+
</Tabs>
289+
290+
<hr />

‎docs/chains/arbitrum-chain/arbitrum-node.md

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
slug: /arbitrum-node
3+
title: Running an Arbitrum RPC Node
4+
---
5+
6+
import Tabs from '@theme/Tabs';
7+
import TabItem from '@theme/TabItem';
8+
9+
# Running an Arbitrum RPC Node
10+
11+
Configure and run your Arbitrum node by following the [official guilde](https://docs.arbitrum.io/run-arbitrum-node/run-full-node) on Arbitrum documentation.
12+
13+
14+
## Setup your Provider on Lava Network 🌋
15+
16+
Once your node is up and running set up your provider on the Lava Network, you can refer to the [provider setup documentation](https://docs.lavanet.xyz/provider-setup?utm_source=running-a-ethereum-rpc-node&utm_medium=docs&utm_campaign=ethereum-pre-grant) available elsewhere in our docs. This should provide you with the necessary information to configure and operate your provider node.

0 commit comments

Comments
 (0)