Skip to content

Latest commit

 

History

History
103 lines (85 loc) · 3.51 KB

README.md

File metadata and controls

103 lines (85 loc) · 3.51 KB
Raw

0L Genesis Ceremony Guide

Coordinator: sirouk

⚠️ Important: Only proceed with asynchronous steps after the coordinator confirms the previous sequential blocking steps as completed.

Genesis Ceremony Steps

1. Cleanup

  • Delete any previous forked release-v6.9.0-rc.0-genesis-2 in your GitHub organization.
  • Previous clones and testnets leave data in the .libra directory, so you need to clean up: 
    rm -Rf ~/libra-framework
rm -Rf ~/.libra/data && rm -Rf ~/.libra/genesis && rm -Rf ~/.libra/secure-data.json
  • Retrieve Validator Address: 
    grep 'account_address' ~/.libra/public-keys.yaml
  • Fetch Static IP
curl -s ipinfo.io | jq .ip

Enter your Validator Address, Operator Name, and Static IP in the Genesis Worksheet.

2. Fetch source & verify commit hash

cd ~
git clone https://github.com/0LNetworkCommunity/libra-framework
cd ~/libra-framework
git fetch --all && git checkout main
git log -n 1 --pretty=format:"%H"

Note: Provide git hash in the Genesis Worksheet. Only proceed with the following async steps after the coordinator provides the git hash and your results match.

3. Build libra-framework packages

cd ~/libra-framework
cargo build --release -p libra -p libra-genesis-tools -p libra-txs -p diem-db-tool
  • Confirm with "done" in the Genesis Worksheet.

4. Prepare .libra directory and add GitHub PAT (use classic with repo privileges)

mkdir ~/.libra/
nano ~/.libra/github_token.txt
  • Confirm with "done" in the Genesis Worksheet.

5. Pre-Genesis Registration

  • Ensure you delete any forked version of release-v6.9.0-rc.0-genesis-2 in your home org before registering.
cd ~/libra-framework
./target/release/libra-genesis-tools register  --org-github 0LNetworkCommunity --name-github release-v6.9.0-rc.0-genesis-7
  • Confirm with "done" in the Genesis Worksheet.

6. PR Received

(coordinator)

7. PR Merged

(coordinator)

8. Build JSON_Legacy

### Fetch Ancestry Data and Snapshot
mkdir -p ~/libra-recovery
wget https://github.com/0LNetworkCommunity/epoch-archive/raw/main/667.tar.gz -O ~/libra-recovery/667.tar.gz
cd ~/libra-recovery && tar -xvzf 667.tar.gz
wget https://raw.githubusercontent.com/sirouk/ol-data-extraction/v-6.9.x-ready/assets/data.json -O ~/libra-recovery/v5_ancestry.json

### Use v5.2 codebase and snapshot to generate recovery.json for seeding v6.9.x state
sudo rm -Rf ~/libra-legacy-v6
cd ~ && git clone -b v6 https://github.com/0LNetworkCommunity/libra-legacy-v6
cd ~/libra-legacy-v6/ol/genesis-tools
cargo r -p ol-genesis-tools -- --export-json ~/libra-recovery/v5_recovery.json --snapshot-path ~/libra-recovery/667/state_ver* --ancestry-file ~/libra-recovery/v5_ancestry.json
md5sum ~/libra-recovery/v5_recovery.json
  • Confirm v5_recovery.json md5 hash in the Genesis Worksheet.

9. All nodes added to layout.yaml users key

(coordinator)

⚠️ Note: Pre-genesis set closes here. Wait for coordinator.

10. Pull from genesis repo and build

# pull and build genesis
cd ~/libra-framework/tools/genesis
GIT_ORG=0LNetworkCommunity GIT_REPO=release-v6.9.0-rc.0-genesis-7 RECOVERY_FILE=~/libra-recovery/v5_recovery.json make genesis
  • Confirm with "done" in the Genesis Worksheet.

⚠️ Note: All set. Wait for the coordinator before the next step.

11. Start nodes!

Wait for the coordinator, say a prayer, then start!

~/libra-framework/target/release/libra node --config-path ~/.libra/validator.yaml

End of Ceremony Steps