Skip to content

Commit 52eb595

Browse files
authored
Update index.md
1 parent 27d1d1c commit 52eb595

File tree

1 file changed

+302
-2
lines changed

1 file changed

+302
-2
lines changed

docs/blob-archiver-rs-docs/index.md

+302-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,24 @@
11
# blob-archiver-rs
22
This is a Rust implementation of
3-
the [Beacon Chain blob archiver](https://github.com/base-org/blob-archiver)
3+
the [Beacon Chain blob archiver](https://github.com/base/blob-archiver)
4+
5+
The Blob Archiver is a service to archive and allow querying of all historical blobs from the beacon chain. It consists
6+
of two components:
7+
8+
* **Archiver** - Tracks the beacon chain and writes blobs to a storage backend
9+
* **API** - Implements the blob sidecars [API](https://ethereum.github.io/beacon-APIs/#/Beacon/getBlobSidecars), which
10+
allows clients to retrieve blobs from the storage backend
11+
12+
### Storage
13+
There are currently two supported storage options:
14+
15+
* On-disk storage - Blobs are written to disk in a directory
16+
* S3 storage - Blobs are written to an S3 bucket (or compatible service)
17+
18+
You can control which storage backend is used by setting the `STORAGE_TYPE` to
19+
either `file` or `s3`.
20+
21+
The `s3` backend will also work with (for example) Google Cloud Storage buckets (instructions [here](https://medium.com/google-cloud/using-google-cloud-storage-with-minio-object-storage-c994fe4aab6b)).
422

523
### Development
624
```sh
@@ -21,4 +39,286 @@ to your beacon client and storage backend of choice. Then you can run the projec
2139

2240
```sh
2341
docker compose up
24-
```
42+
```
43+
44+
## Options
45+
46+
### `verbose`
47+
48+
<Tabs>
49+
<TabItem value="Syntax" label="Syntax" default>
50+
51+
```shell
52+
--verbose=<VERBOSE>
53+
```
54+
55+
</TabItem>
56+
57+
<TabItem value="Example" label="Example">
58+
59+
```shell
60+
--verbose=2
61+
```
62+
63+
</TabItem>
64+
</Tabs>
65+
66+
### `log_dir`
67+
68+
<Tabs>
69+
<TabItem value="Syntax" label="Syntax" default>
70+
71+
```shell
72+
--log_dir=<LOG_DIR>
73+
```
74+
75+
</TabItem>
76+
77+
<TabItem value="Example" label="Example">
78+
79+
```shell
80+
--log_dir=/var/log/blob-archiver
81+
```
82+
83+
</TabItem>
84+
</Tabs>
85+
86+
### `log_rotation`
87+
88+
<Tabs>
89+
<TabItem value="Syntax" label="Syntax" default>
90+
91+
```shell
92+
--log_rotation=<LOG_ROTATION>
93+
```
94+
95+
</TabItem>
96+
97+
<TabItem value="Example" label="Example">
98+
99+
```shell
100+
--log_rotation=DAILY
101+
```
102+
103+
</TabItem>
104+
</Tabs>
105+
106+
### `beacon_endpoint`
107+
108+
<Tabs>
109+
<TabItem value="Syntax" label="Syntax" default>
110+
111+
```shell
112+
--beacon_endpoint=<BEACON_ENDPOINT>
113+
```
114+
115+
</TabItem>
116+
117+
<TabItem value="Example" label="Example">
118+
119+
```shell
120+
--beacon_endpoint=http://localhost:5052
121+
```
122+
123+
</TabItem>
124+
</Tabs>
125+
126+
### `beacon_client_timeout`
127+
128+
<Tabs>
129+
<TabItem value="Syntax" label="Syntax" default>
130+
131+
```shell
132+
--beacon_client_timeout=<BEACON_CLIENT_TIMEOUT>
133+
```
134+
135+
</TabItem>
136+
137+
<TabItem value="Example" label="Example">
138+
139+
```shell
140+
--beacon_client_timeout=10
141+
```
142+
143+
</TabItem>
144+
</Tabs>
145+
146+
### `poll_interval`
147+
148+
<Tabs>
149+
<TabItem value="Syntax" label="Syntax" default>
150+
151+
```shell
152+
--poll_interval=<POLL_INTERVAL>
153+
```
154+
155+
</TabItem>
156+
157+
<TabItem value="Example" label="Example">
158+
159+
```shell
160+
--poll_interval=6
161+
```
162+
163+
</TabItem>
164+
</Tabs>
165+
166+
### `listen_addr`
167+
168+
<Tabs>
169+
<TabItem value="Syntax" label="Syntax" default>
170+
171+
```shell
172+
--listen_addr=<LISTEN_ADDR>
173+
```
174+
175+
</TabItem>
176+
177+
<TabItem value="Example" label="Example">
178+
179+
```shell
180+
--listen_addr=0.0.0.0:8000
181+
```
182+
183+
</TabItem>
184+
</Tabs>
185+
186+
### `origin_block`
187+
188+
<Tabs>
189+
<TabItem value="Syntax" label="Syntax" default>
190+
191+
```shell
192+
--origin_block=<ORIGIN_BLOCK>
193+
```
194+
195+
</TabItem>
196+
197+
<TabItem value="Example" label="Example">
198+
199+
```shell
200+
--origin_block="0x0"
201+
```
202+
203+
</TabItem>
204+
</Tabs>
205+
206+
### `storage_type`
207+
208+
<Tabs>
209+
<TabItem value="Syntax" label="Syntax" default>
210+
211+
```shell
212+
--storage_type=<STORAGE_TYPE>
213+
```
214+
215+
</TabItem>
216+
217+
<TabItem value="Example" label="Example">
218+
219+
```shell
220+
--storage_type="s3"
221+
```
222+
223+
</TabItem>
224+
</Tabs>
225+
226+
### `s3_endpoint`
227+
228+
<Tabs>
229+
<TabItem value="Syntax" label="Syntax" default>
230+
231+
```shell
232+
--s3_endpoint=<S3_ENDPOINT>
233+
```
234+
235+
</TabItem>
236+
237+
<TabItem value="Example" label="Example">
238+
239+
```shell
240+
--s3_endpoint="http://localhost:9000"
241+
```
242+
243+
</TabItem>
244+
</Tabs>
245+
246+
### `s3_bucket`
247+
248+
<Tabs>
249+
<TabItem value="Syntax" label="Syntax" default>
250+
251+
```shell
252+
--s3_bucket=<S3_BUCKET>
253+
```
254+
255+
</TabItem>
256+
257+
<TabItem value="Example" label="Example">
258+
259+
```shell
260+
--s3_bucket="blobs"
261+
```
262+
263+
</TabItem>
264+
</Tabs>
265+
266+
### `s3_path`
267+
268+
<Tabs>
269+
<TabItem value="Syntax" label="Syntax" default>
270+
271+
```shell
272+
--s3_path=<S3_PATH>
273+
```
274+
275+
</TabItem>
276+
277+
<TabItem value="Example" label="Example">
278+
279+
```shell
280+
--s3_path=/blobs
281+
```
282+
283+
</TabItem>
284+
</Tabs>
285+
286+
### `s3_compress`
287+
288+
<Tabs>
289+
<TabItem value="Syntax" label="Syntax" default>
290+
291+
```shell
292+
--s3_compress=<S3_COMPRESS>
293+
```
294+
295+
</TabItem>
296+
297+
<TabItem value="Example" label="Example">
298+
299+
```shell
300+
--s3_compress=false
301+
```
302+
303+
</TabItem>
304+
</Tabs>
305+
306+
### `fs_dir`
307+
308+
<Tabs>
309+
<TabItem value="Syntax" label="Syntax" default>
310+
311+
```shell
312+
--fs_dir=<FS_DIR>
313+
```
314+
315+
</TabItem>
316+
317+
<TabItem value="Example" label="Example">
318+
319+
```shell
320+
--fs_dir=/blobs
321+
```
322+
323+
</TabItem>
324+
</Tabs>

0 commit comments

Comments
 (0)