Skip to content
Merged
Show file tree
Hide file tree
Changes from 20 commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
de45e5d
Update NODE_RUNNING.md with requirements for different profiles
max-sanchez Apr 2, 2025
cd9f26e
Add images for localnode running
max-sanchez Apr 2, 2025
b4fc904
Docker profile information
max-sanchez Apr 2, 2025
89708c2
Update images for localnode running
max-sanchez Apr 2, 2025
1e90514
Update images for localnode running to PNG
max-sanchez Apr 2, 2025
09067e6
Update images for localnode
max-sanchez Apr 2, 2025
5b608e3
Update links and other misc. documentation
max-sanchez Apr 2, 2025
f79fc64
Add image for overall Hemi network components
max-sanchez Apr 2, 2025
68fd276
Add image of overall Hemi network daemon stack
max-sanchez Apr 2, 2025
eaeacc7
Replace png with svg
max-sanchez Apr 2, 2025
5f70cd7
png -> svg
max-sanchez Apr 2, 2025
7d77535
Add l1 profile information + image
max-sanchez Apr 2, 2025
98e9731
Lots of doc updates
max-sanchez Apr 2, 2025
e3d89a9
Add hemi-min Docker profile and update `op-node` command line arguments
max-sanchez Apr 2, 2025
9c376db
Update bring your own l1 instructions
max-sanchez Apr 2, 2025
dd99486
Update op-node images
max-sanchez Apr 2, 2025
ca92c9e
Added quickstart summary
max-sanchez Apr 2, 2025
0a2f073
Update Table of Contents
max-sanchez Apr 2, 2025
bef98b5
sh -> bash in gen-files.sh
max-sanchez Apr 2, 2025
f26b07f
Formatting fix
max-sanchez Apr 2, 2025
667bc2e
Update op-node images
max-sanchez Apr 2, 2025
7ceb52b
Update op-geth images after merging hVM snap sync behavior
max-sanchez Apr 2, 2025
eac52ad
localnode: reformat node running docs
joshuasing Apr 2, 2025
debd0e5
localnode: add recommendation to monitor disk
joshuasing Apr 2, 2025
1a2a51b
localnode: split http/ssh clone
joshuasing Apr 2, 2025
cdd80d6
localnode: grammatical edits for components/profiles sections
joshuasing Apr 2, 2025
c878f15
localnode: edits for docker profiles last tip/notes
joshuasing Apr 2, 2025
b2d3bb5
localnode: make security warning a CAUTION alert
joshuasing Apr 2, 2025
2e570a0
localnode: fix typo and edit node sync type notes
joshuasing Apr 2, 2025
0ef56fb
localnode: make title capitalisation consistent
joshuasing Apr 2, 2025
b5cf65e
localnode: make gen-files.sh POSIX compatible and use /bin/sh
joshuasing Apr 2, 2025
d1650c5
localnode: make heminode.sh POSIX compatible
joshuasing Apr 2, 2025
d902ad6
Minor edits and fixes
max-sanchez Apr 3, 2025
9ea7071
Add mainnet static nodes
max-sanchez Apr 3, 2025
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
263 changes: 219 additions & 44 deletions localnode/NODE_RUNNING.md

Large diffs are not rendered by default.

15 changes: 9 additions & 6 deletions localnode/docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ services:
build:
dockerfile: "./docker/bssd/Dockerfile"
context: "./.."
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
environment:
BSS_BFG_URL: "ws://bfgd:8080/v1/ws/private"
BSS_LOG_LEVEL: "INFO"
Expand Down Expand Up @@ -167,7 +167,7 @@ services:
image: "ghcr.io/hemilabs/op-geth:8147886@sha256:95ceee4cdcf7376bf5e2063f960a74d73cce3406e5f6c72f928713fe52508a1c"
platform: linux/amd64
# XXX does geth need to be fully synced
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
depends_on:
op-geth-l2-init:
condition: "service_completed_successfully"
Expand Down Expand Up @@ -210,7 +210,7 @@ services:
op-geth-l2-init:
# yamllint disable-line rule:line-length
image: "alpine@sha256:a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c" # 3.21.3
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
volumes:
- op-geth_data:/tmp/datadir
command:
Expand All @@ -223,7 +223,7 @@ services:
op-geth-l2-init-tbc:
# yamllint disable-line rule:line-length
image: "alpine@sha256:a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c" # 3.21.3
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
volumes:
- tbc_data:/tbcdata
command:
Expand All @@ -235,9 +235,9 @@ services:
# Hemi op-node
op-node:
# yamllint disable-line rule:line-length
image: "ghcr.io/hemilabs/op-node:ee580dd@sha256:c3c2bcabb0da02e6aca462a2756ef78d8a40e569281de1f4dac9a9eb8fa80359"
image: "ghcr.io/hemilabs/op-node:e79d444@sha256:c2757007112d81c2db1f0ad52cf12e1a3f2bf8313df434d9533abbf29b8b9d04"
Copy link
Copy Markdown
Contributor

@ClaytonNorthey92 ClaytonNorthey92 Apr 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's use the latest op-node,

ghcr.io/hemilabs/op-node:9dc3004@sha256:fbbed98c8d9f8b1de1eb426b84b38c5df4fe2e04e9c757f4734dc1009d253b3e

platform: linux/amd64
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
depends_on:
op-geth-l2:
condition: "service_healthy"
Expand Down Expand Up @@ -269,6 +269,9 @@ services:
- "--rpc.port=8547"
- "--p2p.static=/ip4/34.147.95.117/tcp/9003/p2p/16Uiu2HAmFtpk79F9M1TdC2cnq8c1pJy59yrb5AWeM1qH6d13Fbi2"
- "--p2p.no-discovery"
- "--p2p.ban.peers=false"
- "--p2p.ban.duration=1s"
- "--p2p.ban.threshold=-10000000000"
- "--log.level=info"
- "--syncmode=${OPSYNCMODE:-execution-layer}"
deploy:
Expand Down
16 changes: 10 additions & 6 deletions localnode/docker-compose_mainnet.yml
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ services:
build:
dockerfile: "./docker/bssd/Dockerfile"
context: "./.."
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
environment:
BSS_BFG_URL: "ws://bfgd:8080/v1/ws/private"
BSS_LOG_LEVEL: "INFO"
Expand Down Expand Up @@ -164,7 +164,7 @@ services:
image: "ghcr.io/hemilabs/op-geth:8147886@sha256:95ceee4cdcf7376bf5e2063f960a74d73cce3406e5f6c72f928713fe52508a1c"
platform: linux/amd64
# XXX does geth need to be fully synced
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
depends_on:
op-geth-l2-init:
condition: "service_completed_successfully"
Expand Down Expand Up @@ -208,7 +208,7 @@ services:
op-geth-l2-init:
# yamllint disable-line rule:line-length
image: "alpine@sha256:a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c" # 3.21.3
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
volumes:
- op-geth_data:/tmp/datadir
command:
Expand All @@ -221,7 +221,7 @@ services:
op-geth-l2-init-tbc:
# yamllint disable-line rule:line-length
image: "alpine@sha256:a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c" # 3.21.3
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
volumes:
- tbc_data:/tbcdata
command:
Expand All @@ -233,9 +233,9 @@ services:
# Hemi op-node
op-node:
# yamllint disable-line rule:line-length
image: "ghcr.io/hemilabs/op-node:84b895e@sha256:df29c59680c33cdda616f67662c9e75bdeea60f79d91937ee0b60bf0d0f48243"
image: "ghcr.io/hemilabs/op-node:e79d444@sha256:c2757007112d81c2db1f0ad52cf12e1a3f2bf8313df434d9533abbf29b8b9d04"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as other comment,

ghcr.io/hemilabs/op-node:9dc3004@sha256:fbbed98c8d9f8b1de1eb426b84b38c5df4fe2e04e9c757f4734dc1009d253b3e

platform: linux/amd64
profiles: ["hemi", "full"]
profiles: ["hemi", "hemi-min", "full"]
depends_on:
op-geth-l2:
condition: "service_healthy"
Expand Down Expand Up @@ -266,6 +266,10 @@ services:
- "--rpc.addr=0.0.0.0"
- "--rpc.port=8547"
- "--p2p.bootnodes=enr:-J64QACnJ0giPmPXowNCHP-FDleMMbDqYg5nuLABYfJeYbP9OA6_fZtvCsTbAwvlPD8_C6ZSXEk1-XPabDBwD8UTyNCGAZMxdy4tgmlkgnY0gmlwhCINopiHb3BzdGFja4Tn0AIAiXNlY3AyNTZrMaED22EOmUryrNnFOwq6Ve1Hpw5CMFz_TnhIkVS4Sq8JhkmDdGNwgiMrg3VkcIKjLg,enr:-J64QA20VNMfLMtbSuHYmQH2I-xaqT4-9g7lqO-VHr0fFvtSB7QybJ_7W5fuEjLAa6kh82fGLjRUdZE0hW0pfVBcxP6GAZMxdwfngmlkgnY0gmlwhCJaFfaHb3BzdGFja4Tn0AIAiXNlY3AyNTZrMaEDjt3C-gv87B5rWa5M52WUFGy16mjQvFsC7OgPkqu-rn-DdGNwgiMrg3VkcIKRXQ,enr:-J64QLQyh3lXjQLzfCbfNw0DUb4A0OEcTLmVGexMbK-2jjCtHOIlRnDqLuedQ0orNHt7zmsILELYi4ozg-0bQzc34F-GAZMxdxNogmlkgnY0gmlwhCINq4uHb3BzdGFja4Tn0AIAiXNlY3AyNTZrMaED1NV9w0EmnMXBNRnDWj6kdqzE6_4HigHopeu3ewQTwouDdGNwgiMrg3VkcIK1Iw,enr:-J64QNPfOEViWkN7U_ul5Zhw_mc5_Hta92eUufrgu6oTqSMzRsqCje-P0vPrOQ9XjVIk4VP7mmFVP6qoTrtkIwvwUV2GAZMxdv4zgmlkgnY0gmlwhCJb2HmHb3BzdGFja4Tn0AIAiXNlY3AyNTZrMaEDYAidV8rzABKrKAL9jwP1aoi3wj-GtuML4FKtUDOgzCGDdGNwgiMrg3VkcILijg,enr:-J64QFalFr9Y4r9v8Svh7XFwerJeLTRnfTixfCy_NZw3OTMVZL_dSAvcZ6JIeK0JAZf6-PU3YknV9m9Jd5V5WlnqHKWGAZMxdxT4gmlkgnY0gmlwhCKNlBOHb3BzdGFja4Tn0AIAiXNlY3AyNTZrMaECI1jqAzkQ0JRkwL-UBP2TBUfUdLyTaqAXtey82CTysdCDdGNwgiMrg3VkcILOyg"
- "--p2p.static=/ip4/34.90.21.246/tcp/9003/p2p/16Uiu2HAmNGgNTgiFBAqH58aCT3iXWMnetYMtQgH21Ydjq2R7QRbt"
- "--p2p.ban.peers=false"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does this mean that we never ban peers in mainnet? is that what we want? 🤔

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess a user could always change this....

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

op-node does some aggressive node pruning and generates a lot of false positives, this is something I'd like to remove eventually after we improve this logic.

- "--p2p.ban.duration=1s"
- "--p2p.ban.threshold=-10000000000"
- "--log.level=info"
- "--syncmode=${OPSYNCMODE:-execution-layer}"
deploy:
Expand Down
2 changes: 1 addition & 1 deletion localnode/gen-files.sh
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#!/bin/sh
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally, I think it would be best if we could continue using /bin/sh and make the script POSIX compliant for compatibility on as many platforms as possible. I can do this if you want.

#!/bin/bash
# Copyright (c) 2025 Hemi Labs, Inc.
# Use of this source code is governed by the MIT License,
# which can be found in the LICENSE file.
Expand Down
1 change: 1 addition & 0 deletions localnode/images/hemi-network-components-v2.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions localnode/images/hemi-network-docker-profile-full-v2.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions localnode/images/hemi-network-docker-profile-hemi-v2.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions localnode/images/hemi-network-docker-profile-l1-v2.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.