Skip to content
This repository was archived by the owner on May 27, 2025. It is now read-only.

Commit 78fa1ba

Browse files
authored
Merge pull request #3 from base/add-readme
chore: add readme
2 parents 6ffe679 + c7f5bef commit 78fa1ba

File tree

1 file changed

+36
-1
lines changed

1 file changed

+36
-1
lines changed

README.md

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,37 @@
1-
## Flashblocks Websocket Proxy
1+
# Flashblocks Websocket Proxy
2+
3+
## Overview
4+
The Flashblocks Websocket Proxy is a service that subscribes to new Flashblocks from
5+
[rollup-boost](https://github.com/flashbots/rollup-boost) on the sequencer. Then broadcasts them out to any downstream
6+
RPC nodes. Minimizing the number of connections to the sequencer and restricting access.
7+
8+
> ⚠️ **Warning**
9+
>
10+
> This is currently alpha software -- deploy at your own risk!
11+
>
12+
> Currently, this project is a one-directional generic websocket proxy. It doesn't inspect any data or validate clients.
13+
> This may not always be the case.
14+
15+
## For Developers
16+
17+
### Contributing
18+
19+
### Building & Testing
20+
You can build and test the project using [Cargo](https://doc.rust-lang.org/cargo/). Some useful commands are:
21+
```
22+
# Build the project
23+
cargo build
24+
25+
# Run all the tests
26+
cargo test --all-features
27+
```
28+
29+
### Deployment
30+
Builds of the websocket proxy [are provided](https://github.com/base/flashblocks-websocket-proxy/pkgs/container/flashblocks-websocket-proxy).
31+
The only configuration required is the rollup-boost URL to proxy. You can set this via an env var `UPSTREAM_WS` or a flag `--upstream-ws`.
32+
33+
34+
You can see a full list of parameters by running:
35+
36+
`docker run ghcr.io/base/flashblocks-websocket-proxy:master --help`
237

0 commit comments

Comments
 (0)