Skip to content

Commit 7d87615

Browse files
committed
some intiial docs pages
1 parent 1fd2c75 commit 7d87615

File tree

4 files changed

+92
-3
lines changed

4 files changed

+92
-3
lines changed

docs-site/docs/intro.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,26 @@
22
sidebar_position: 1
33
---
44

5-
# Intentionally Blank
5+
# Getting Started
6+
7+
## Blobs
8+
9+
The Blobs project exposes the **data availability** capabilities of [Polkadot](https://polkadot.network) and [Kusama](https://kusama.network) for general use. Use-cases include rollups and inscriptions.
10+
11+
The Blobs codebase is located at https://github.com/thrumdev/blobs. There is a live parachain on Kusama with Parachain ID 3338 running the Blobs runtime.
12+
13+
Blobs enables users to submit arbitrary data to the chain and receive guarantees about the availability of that data. Namely:
14+
1. The data can be fetched from the Polkadot/Kusama validator set for up to 24 hours after submission and cannot be withheld.
15+
2. A commitment to the data's availability is stored within the blobchain and used as a proof of guarantee (1) to computer programs, such as smart contracts or Zero-Knowledge circuits.
16+
17+
Data Availability is a key component of Layer-2 scaling approaches, and is already part of Polkadot and Kusama for use in securing Parachains. Blobs will bring this capability out to much broader markets.
18+
19+
Blobs makes a **relay-chain token utility commitment** now and forever. Submitting blobs will always make use of the DOT token on Polkadot and the KSM token on Kusama, as this is the approach with the least user friction.
20+
21+
## Integrations
22+
23+
Blobs supports a variety of rollup SDKs out of the box.
24+
- [x] Rollkit
25+
- [x] Sovereign SDK
26+
- [ ] OP Stack
27+
- [ ] Polygon ZK-EVM
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
sidebar_position: 2
3+
title: Node Operators
4+
---
5+
6+
## Releases
7+
8+
At the moment, there are no downloadable binary releases available of the Blobs node. We recommend building a binary from source.
9+
10+
## Node Architecture
11+
12+
Blobs is a standard Polkadot-SDK parachain node, which means that it actually runs two nodes:
13+
1. A node for the Parachain (Blobs) on Polkadot or Kusama
14+
2. A node for the Relay Chain, Polkadot or Kusama.
15+
16+
You can pass arguments to each one of these underlying nodes with the following approach:
17+
18+
```sh
19+
./sugondat-node --arg-for-blobs --arg2-for-blobs -- --arg-for-relay --arg2-for-relay
20+
```
21+
22+
## Blobs and Storage Usage
23+
24+
Blobs can potentially use enormous amounts of disk space under heavy usage. This is because all historical blobs are stored within the blobchain's history. While the Polkadot and Kusama expunge ancient blobs after 24 hours, any full node of the blobchain will have all the blobs going back to the genesis, as well as all of the other block data.
25+
26+
To avoid this issue, run with `--blocks-pruning <number>`, where `number` is some relatively small value such as `1000` to avoid keeping all historical blobs.
27+
28+
However, there is still a need for archival nodes. The main reason is that many rollup SDKs do not have any form of p2p and their nodes synchronize by downloading ancient blobs from the data availability layer's p2p network. Without someone keeping all ancient blocks, those SDKs
29+
would unfortunately stop working.
30+
31+
## Hardware Requirements
32+
33+
For full nodes, we currently recommend:
34+
- 4 vCPUs
35+
- 8GB RAM
36+
- 512G Free Disk Space (1TB preferred)
37+
- Stable and fast internet connection. For collators, we recommend 500mbps.
38+
39+
The disk space requirements can be reduced by
40+
1. Running with `--blocks-pruning` on both
41+
42+
## Building From Source
43+
44+
Building from source requires some familiarity with the terminal and your system's package manager.
45+
46+
First, ensure you have an up-to-date Rust installation. If not, visit https://rustup.rs .
47+
48+
Building from source requires a few packages to be installed on your system. On Debian or Ubuntu, these are:
49+
50+
```sh
51+
apt install libssl-dev protobuf-compiler cmake make pkg-config llvm clang
52+
```
53+
54+
On other linux distros or Mac, use your package manager's equivalents.
55+
56+
57+
Building the node:
58+
```bash
59+
git clone https://github.com/thrumdev/blobs
60+
cd blobs
61+
cargo build --release -p sugondat-node
62+
```
63+
64+
Running the node:
65+
```bash
66+
target/release/sugondat-node --chain sugondat-kusama
67+
```

docs-site/docusaurus.config.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ const config = {
8383
style: 'dark',
8484
links: [
8585
{
86-
title: 'Docs',
86+
title: 'Learn',
8787
items: [
8888
{
8989
label: 'Documentation',

docs-site/src/pages/index.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ function HomepageHeader() {
2020
<Link
2121
className="button button--secondary button--lg"
2222
to="/docs/intro">
23-
Enter
23+
Get Started
2424
</Link>
2525
</div>
2626
</div>

0 commit comments

Comments
 (0)