Skip to content

Update register.md #120

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
codilion merged 1 commit into from
Mar 21, 2025
Merged

Update register.md #120

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 4 additions & 92 deletions docs/validators/register.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,63 +1,12 @@
---
sidebar_position: 6
sidebar_label: 'Post-Genesis Ceremony Registration'
sidebar_label: 'Validator registration'
description: 'Register a Validator on the 0L Network'
---

# Register a Validator on the 0L Network

Welcome!

## Quick outline of all the steps
``` bash
# Checkout the source
git clone https://github.com/0LNetworkCommunity/libra-framework

# Install dependencies and Rust lang
cd ~/libra-framework
bash ./util/dev_setup.sh -t

# restart your bash instance to pickup the cargo paths
source ~/.bashrc

# build and install the binary
cd ~/libra-framework
cargo build --release -p libra

# Make the release path global and persistent
sudo cp -f ~/libra-framework/target/release/libra* ~/.cargo/bin/

# Check libra execution and version
libra --version

# -----------------------
# Using libra CLI to generate a new account and register

# create account keys
libra wallet keygen

# create the validator config files on your node
# you will need to update vfn values to match validator values. see script below
# you will also need to set the libra.yaml to point to testnet
libra config validator-init

# Set your client `libra.yaml` with the rpc-load-balancer upstream node
libra config fix --force-url https://rpc.openlibra.space:8080

# a friend will onboard the account if it doesn't yet exist on chain. It is done by sending coins to an account
libra txs transfer --to-account <YOUR ADDRESS> --amount 1

# send validator info
libra txs validator register

# get vouches from existing validators (just ask)
libra txs validator vouch --vouch-for <YOUR ADDRESS>

# submit a bid to be in the validator set
libra txs validator pof --net-reward <NET REWARD> --bid-pct <PERCENT YOU PAY> --expiry <WHEN EXPIRES>

# run as a fullnode and switch to the validator mode once entered the set, check the detailed instructions below the page.
```
Welcome! This documentation covers validator registration. Start with **Setting up a validator** documentation if needed.

## Detailed instructions

Expand All @@ -68,42 +17,6 @@ If you don't already have an account, you will need a mnemonic (seed), to genera
libra wallet keygen
```

### Initialize validator files

Follow the prompts here. Your node needs to have keys generated using a mnemonic from step #1.

``` bash
libra config validator-init
```


- You will need to use this script to make the VFN match your validator node values.
``` bash
cat << 'EOF' > fix_vfn_values.sh
#!/bin/bash

# Extract the value from validator_network_public_key
validator_key=$(sed -n 's/^validator_network_public_key: "\(.*\)"/\1/p' ~/.libra/operator.yaml)

# Use the extracted value to replace full_node_network_public_key
sed -i "s/^full_node_network_public_key: .*/full_node_network_public_key: \"$validator_key\"/" ~/.libra/operator.yaml

# File path
file="$HOME/.libra/operator.yaml"

# Extract the host and port from validator_host
host=$(awk '/^ host:/{print $0}' "$file")
port=$(awk '/^ port:/{print $0}' "$file")

# Replace full_node_host: ~ with full_node_host: and add host and port
sed -i "/^full_node_host: ~/c\\
full_node_host:\\n$host\\n$port" "$file"
EOF

chmod +x fix_vfn_values.sh
./fix_vfn_values.sh
```

### Get the account on chain
Someone needs to create that account onchain first.
Ask someone to deposit a coin to your account from step #1
Expand Down Expand Up @@ -142,12 +55,11 @@ libra txs validator vouch --vouch-for <YOUR ADDRESS>
### Bid to be in the validator set
0L Network uses Proof-of-Fee for sybil resistance, instead of Proof-of-Stake. You don't need any stake to join, but you just need to be able to bid on how much you are willing to pay to be in the validator set. The cheapest bid proposed by validators will be actually what all validators pay (uniform price auction).
``` bash
libra txs validator pof --net-reward <NET REWARD> --bid-pct <PERCENT YOU PAY> --expiry <WHEN EXPIRES>
libra txs validator pof --net-reward <NET REWARD> --bid-pct <PERCENT YOU PAY> --epoch-expiry <WHEN EXPIRES>
```

### Run the node as fullnode and then validator mode
- Once your validator enters the set you will need to stop running as a fullnode and run as a validator. Until then, you can:
- use the following instructions to: sync database to the current state (TODO: link) and run as a fullnode.
- Once your validator enters the set you will need to stop running as a fullnode and run as a validator.
- When your node is in the active set, it is time to change your node config path to point to the `validator.yaml`.
- Stop your node and run in the validator mode:
``` bash
Expand Down