From 5d3041b10d5567b8acc1b0bc1d5a6d8d8e44c267 Mon Sep 17 00:00:00 2001 From: Nicholas Wehr <33910651+wwwehr@users.noreply.github.com> Date: Thu, 21 Aug 2025 16:24:25 -0700 Subject: [PATCH 1/4] Update README.md --- README.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index eac81548e..1ffc8c00d 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,19 @@ Building NanoReth from source requires Rust and Cargo to be installed: ## How to run (mainnet) -1) `$ aws s3 sync s3://hl-mainnet-evm-blocks/ ~/evm-blocks --request-payer requester # one-time` - this will backfill the existing blocks from HyperLiquid's EVM S3 bucket. +The current state of the block files comprise of millions of small objects totalling over 20 Gigs and counting. The "requester pays" option means you will need a configured aws environment, and you could incur charges which varies according to destination (ec2 versus local). + +1) this will backfill the existing blocks from HyperLiquid's EVM S3 bucket: + + ```shell + aws s3 sync s3://hl-mainnet-evm-blocks/ ~/evm-blocks \ + --request-payer requester \ + --exact-timestamps \ + --size-only \ + --page-size 1000 \ + --only-show-errors + ``` + > consider using this [rust based s3 tool wrapper](https://github.com/wwwehr/hl-evm-block-sync) alternative to optimize your download experience 2) `$ make install` - this will install the NanoReth binary. @@ -65,12 +77,25 @@ $ reth node --http --http.addr 0.0.0.0 --http.api eth,ots,net,web3 \ Testnet is supported since block 21304281. +> [!NOTE] +> To run testnet locally, you will need: +> - [ ] [git lfs](https://git-lfs.com/) +> - [ ] [rust toolchain](https://rustup.rs/) + ```sh # Get testnet genesis at block 21304281 $ cd ~ $ git clone https://github.com/sprites0/hl-testnet-genesis +$ git lfs pull $ zstd --rm -d ~/hl-testnet-genesis/*.zst +# Now return to where you have cloned this project to continue +$ cd - + +# prepare your rust toolchain +$ rustup install 1.82 # (this corresponds with rust version in our Cargo.toml) +$ rustup default 1.82 + # Init node $ make install $ reth init-state --without-evm --chain testnet --header ~/hl-testnet-genesis/21304281.rlp \ From 8c6ea1ae7a19e4c50c5293c1e2e2f3c5881c8f4b Mon Sep 17 00:00:00 2001 From: Nicholas Wehr <33910651+wwwehr@users.noreply.github.com> Date: Tue, 26 Aug 2025 19:01:41 -0700 Subject: [PATCH 2/4] Update README.md Co-authored-by: sprites0 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1ffc8c00d..13a4aa6f4 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,7 @@ Testnet is supported since block 21304281. # Get testnet genesis at block 21304281 $ cd ~ $ git clone https://github.com/sprites0/hl-testnet-genesis -$ git lfs pull +$ git -C hl-testnet-genesis lfs pull $ zstd --rm -d ~/hl-testnet-genesis/*.zst # Now return to where you have cloned this project to continue From 21e7c718eaa65f998cb7e50123e0b9cfe3563e83 Mon Sep 17 00:00:00 2001 From: Nicholas Wehr <33910651+wwwehr@users.noreply.github.com> Date: Tue, 26 Aug 2025 19:02:19 -0700 Subject: [PATCH 3/4] Update README.md Co-authored-by: sprites0 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 13a4aa6f4..09cf61cfe 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ Building NanoReth from source requires Rust and Cargo to be installed: The current state of the block files comprise of millions of small objects totalling over 20 Gigs and counting. The "requester pays" option means you will need a configured aws environment, and you could incur charges which varies according to destination (ec2 versus local). -1) this will backfill the existing blocks from HyperLiquid's EVM S3 bucket: +1) this will backfill the existing blocks from Hyperliquid's EVM S3 bucket: ```shell aws s3 sync s3://hl-mainnet-evm-blocks/ ~/evm-blocks \ From e9dcff401568e0fded54a46bd847d5ad7a38fbc9 Mon Sep 17 00:00:00 2001 From: Nicholas Wehr Date: Tue, 26 Aug 2025 19:04:18 -0700 Subject: [PATCH 4/4] readme nits --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 09cf61cfe..b0ffae45e 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,6 @@ The current state of the block files comprise of millions of small objects total --request-payer requester \ --exact-timestamps \ --size-only \ - --page-size 1000 \ --only-show-errors ``` > consider using this [rust based s3 tool wrapper](https://github.com/wwwehr/hl-evm-block-sync) alternative to optimize your download experience