mirror of
https://github.com/hl-archive-node/nanoreth.git
synced 2025-12-06 10:59:55 +00:00
58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# 🚀 S3Sync Runner
|
|
|
|
Fastest way to pull down evm block files from s3
|
|
|
|
This script automates syncing **massive S3 object stores** in a **safe, resumable, and time-tracked way**. The traditional `s3 sync` is just wayy to slow.
|
|
|
|
## Features
|
|
|
|
- ✅ Auto-installs [nidor1998/s3sync](https://github.com/nidor1998/s3sync) (latest release) into `~/.local/bin`
|
|
- ✅ Sequential per-prefix syncs (e.g., `21000000/`, `22000000/`, …)
|
|
- ✅ Per-prefix timing: `22000000 took 12 minutes!`
|
|
- ✅ Total runtime summary at the end
|
|
- ✅ Designed for **tiny files at scale** (EVM block archives)
|
|
- ✅ Zero-config bootstrap — just run the script
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
chmod +x s3sync-runner.sh
|
|
./s3sync-runner.sh
|
|
```
|
|
|
|
> Skipping to relevant block section
|
|
```bash
|
|
./s3sync-runner.sh --start-at 30000000
|
|
```
|
|
|
|
The script will:
|
|
* Install or update s3sync into ~/.local/bin
|
|
* Discover top-level prefixes in your S3 bucket
|
|
* Sync them one at a time, printing elapsed minutes
|
|
|
|
## Configuration
|
|
|
|
Edit the top of s3sync-runner.sh if needed:
|
|
```bash
|
|
BUCKET="hl-testnet-evm-blocks" # could be hl-mainnet-evm-blocks
|
|
REGION="ap-northeast-1" # hardcoded bucket region
|
|
DEST="$HOME/evm-blocks-testnet" # local target directory (this is what nanoreth will look at)
|
|
WORKERS=512 # worker threads per sync (lotsa workers needs lotsa RAM)
|
|
```
|
|
|
|
## Example Output
|
|
```bash
|
|
[2025-08-20 20:01:02] START 21000000
|
|
[2025-08-20 20:13:15] 21000000 took 12 minutes!
|
|
[2025-08-20 20:13:15] START 22000000
|
|
[2025-08-20 20:26:40] 22000000 took 13 minutes!
|
|
[2025-08-20 20:26:40] ALL DONE in 25 minutes.
|
|
```
|
|
|
|
## Hackathon Context
|
|
|
|
This runner was built as part of the Hyperliquid DEX Hackathon to accelerate:
|
|
* ⛓️ Blockchain archive node ingestion
|
|
* 📂 EVM block dataset replication
|
|
* 🧩 DEX ecosystem data pipelines
|