0lnetworkcommunity / documentation

0L Network Documentation

This is the source for the documentation hosted here:

👇👇👇👇👇👇👇👇👇👇

https://0lnetwork.dev/

👆👆👆👆👆👆👆👆👆👆

alternatively here: https://0lnetworkcommunity.github.io/documentation/

Maintainers

This website is built using Docusaurus 2, a modern static website generator.

Installation

$ yarn

Local Development

$ yarn start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

$ yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

documentation's Issues

Documentation issues

Those are the problem I encountered during the validator/VFN setup:

1. libra config fullnode-init doesn't work

Issue

The documentation, states to run libra config fullnode-init. This command fails with the following error: Error: unable to parse HashValue

Solution

Solution was found on discord.

You can ignore that error and grab the genesis blob and waypoint from the repo direct: https://github.com/0LNetworkCommunity/epoch-archive-mainnet/tree/main/upgrades/v6.9.0

2. epoch-archive-mainnet make bins fails

Issue

The documentation, states to run make bins. This command fails with the following error: sudo: command not found

Solution

I do not have sudo because I'm using docker. I edited the Makefile to remove all references to sudo.

3. jq and bc not found

Issue

Running make bins fails if jq and bc are not installed (which is the case in docker)

Solution

apt install -y jq bc

4. make restore-all fails

Issue

make restore-all fails with:

rm -rf ~/.libra/data/db
if [  -eq 0 ]; then \
	make restore-init; \
fi
bash: line 1: [: -eq: unary operator expected

Solution

 restore-all: sync-repo wipe-db
-       if [ $(SKIP_INIT) -eq 0 ]; then \
-               make restore-init; \
-       fi
+       # if [ $(SKIP_INIT) -eq 0 ]; then
+       #       make restore-init;
+       # fi
        make restore-genesis

5. make restore-all fails again

Issue

cd ~/epoch-archive-mainnet/snapshots/
diem-db-tool restore bootstrap-db --target-db-dir ~/.libra/data/db --metadata-cache-dir ~/epoch-archive-mainnet/metacache --command-adapter-config ~/epoch-archive-mainnet/epoch-archive.yaml

Fails with:

2023-12-28T12:14:55.129869Z [main] ERROR /usr/local/cargo/git/checkouts/diem-7dee55d666bb1ba0/db1137b/storage/backup/backup-cli/src/coordinators/restore.rs:79 Restore coordinator failed. {"error":"epoch history restore failed: epoch ending restore failed: Invalid bitvec from the multi-signature"}
Error: epoch history restore failed: epoch ending restore failed: Invalid bitvec from the multi-signature
make: *** [Makefile:220: restore-all] Error 1

Solution

no solution yet

Theme config issue

Description

By default, the Prism syntax highlighting theme we use is Palenight. You can change this to another theme by passing the theme field in prism as themeConfig in your docusaurus.config.js Currently, we're using the dracula` theme, but it does not work

Potential solution
The idea would be to play with the config in the docusaurus.config.js file, a doc is provided to fix the problem.
https://docusaurus.io/fr/docs/3.0.1/markdown-features/code-blocks

Versions

    "@docsearch/js": "3"
    "@docusaurus/core": "3.0.0"
    "@docusaurus/preset-classic": "3.0.0"

Create CI workflow for branch preview environments.

When a developer creates a branch, it should be deployed to a preview env.
branch-name.`0lnetwork.dev
Deploys on every push.
Killed when PR is merged or closed.