Unichain Docs

Set Up A Node

Learn how to set up a Unichain node

Overview

Unichain (including Unichain Sepolia Testnet) runs on the OP Stack as part of the Superchain. The Optimism team has produced extensive docs on how to run Superchain nodes, we highly recommend you familiarize yourself with them before proceeding.

Running a Unichain Sepolia Testnet Node

Check out the Unichain Node Repository

for an easy to use node setup. This correctly configures op-node and op-geth for unichain-sepolia.

Manually Running Unichain Sepolia Nodes

If you would like to manually run op-node & op-geth, you can do so normally with the following chain config & L2 Genesis:

For op-node, do not set --network and instead set --rollup.config=<PATH_TO_ROLLUP.JSON>

For op-geth, do not set --op-network and instead run geth init --datadir <PATH_TO_DATADIR> genesis-l2.json

Uniswap Labs provides the following bootnodes on unichain-sepolia:

geth:
enode://9e138a8ec4291c4f2fe5851aaee44fc73ae67da87fb26b75e3b94183c7ffc15b2795afc816b0aa084151b95b3a3553f1cd0d1e9dd134dcf059a84d4e0b429afc@3.146.117.118:30303
enode://34d87d649e5c58a17a43c1d59900a2020bd82d5b12ea39467c3366bee2946aaa9c759c77ede61089624691291fb2129eeb2a47687b50e2463188c78e1f738cf2@52.15.54.8:30303
enode://c2405194166fe2c0e6c61ee469745fed1a6802f51c8fc39e1c78c21c9a6a15a7c55304f09ee37e430da9a1ce8117ca085263c6b0f474f6946811e398347611ef@3.146.213.65:30303

op-node:
enr:-J24QIHsjbBldFkaVUTEkEdwYa51AeCOAWd8bJbUOqGqsWDhScaPGnPERVfRgcCJbK2X8vI-9eB-VTDDNRl7S4e1zPyGAZKhaRjagmlkgnY0gmlwhAOSdXaHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQI0_WNHeARGz-kjyK_s7MjZkTf5xYSHrm7nL4C5LwbyJ4N0Y3CCJAaDdWRwgiQG
enr:-J24QH_0BbED1p4R8lZe0Wk6V9pFonqXMw48X_IVKQhbNsekdWlDkKUUaDWV4FHqWVQpfGPI5IjeqKOaIrTBnup8Ro2GAZKhZyO6gmlkgnY0gmlwhDQPNgiHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQOKqwdtPsP4czpXIFwx56PmThevWwxQJ78gY0QaQxNdU4N0Y3CCJAaDdWRwgiQG
enr:-J24QKCDaIQdjhYZAvhLp__sApHypx1zgiKaFAiSP55klZCpVpiFLvaR8LKSICO0sc_xE3SL-rW2JBbQrtXg9yGcFQuGAZKhaBnzgmlkgnY0gmlwhAOS1UGHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQL0xHUDIhXHIn_8yAKupnuK3c2TbqDdhRIn-IiYV2Wxe4N0Y3CCJAaDdWRwgiQG```

On op-node, use the following environment variable or flag:

OP_NODE_P2P_BOOTNODES=enr:-J24QIHsjbBldFkaVUTEkEdwYa51AeCOAWd8bJbUOqGqsWDhScaPGnPERVfRgcCJbK2X8vI-9eB-VTDDNRl7S4e1zPyGAZKhaRjagmlkgnY0gmlwhAOSdXaHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQI0_WNHeARGz-kjyK_s7MjZkTf5xYSHrm7nL4C5LwbyJ4N0Y3CCJAaDdWRwgiQG,enr:-J24QH_0BbED1p4R8lZe0Wk6V9pFonqXMw48X_IVKQhbNsekdWlDkKUUaDWV4FHqWVQpfGPI5IjeqKOaIrTBnup8Ro2GAZKhZyO6gmlkgnY0gmlwhDQPNgiHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQOKqwdtPsP4czpXIFwx56PmThevWwxQJ78gY0QaQxNdU4N0Y3CCJAaDdWRwgiQG,enr:-J24QKCDaIQdjhYZAvhLp__sApHypx1zgiKaFAiSP55klZCpVpiFLvaR8LKSICO0sc_xE3SL-rW2JBbQrtXg9yGcFQuGAZKhaBnzgmlkgnY0gmlwhAOS1UGHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQL0xHUDIhXHIn_8yAKupnuK3c2TbqDdhRIn-IiYV2Wxe4N0Y3CCJAaDdWRwgiQG
--p2p.bootnodes=enr:-J24QIHsjbBldFkaVUTEkEdwYa51AeCOAWd8bJbUOqGqsWDhScaPGnPERVfRgcCJbK2X8vI-9eB-VTDDNRl7S4e1zPyGAZKhaRjagmlkgnY0gmlwhAOSdXaHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQI0_WNHeARGz-kjyK_s7MjZkTf5xYSHrm7nL4C5LwbyJ4N0Y3CCJAaDdWRwgiQG,enr:-J24QH_0BbED1p4R8lZe0Wk6V9pFonqXMw48X_IVKQhbNsekdWlDkKUUaDWV4FHqWVQpfGPI5IjeqKOaIrTBnup8Ro2GAZKhZyO6gmlkgnY0gmlwhDQPNgiHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQOKqwdtPsP4czpXIFwx56PmThevWwxQJ78gY0QaQxNdU4N0Y3CCJAaDdWRwgiQG,enr:-J24QKCDaIQdjhYZAvhLp__sApHypx1zgiKaFAiSP55klZCpVpiFLvaR8LKSICO0sc_xE3SL-rW2JBbQrtXg9yGcFQuGAZKhaBnzgmlkgnY0gmlwhAOS1UGHb3BzdGFja4OVCgCJc2VjcDI1NmsxoQL0xHUDIhXHIn_8yAKupnuK3c2TbqDdhRIn-IiYV2Wxe4N0Y3CCJAaDdWRwgiQG

On op-geth, use the following environment variable or flag:

GETH_BOOTNODES=enode://9e138a8ec4291c4f2fe5851aaee44fc73ae67da87fb26b75e3b94183c7ffc15b2795afc816b0aa084151b95b3a3553f1cd0d1e9dd134dcf059a84d4e0b429afc@3.146.117.118:30303,enode://34d87d649e5c58a17a43c1d59900a2020bd82d5b12ea39467c3366bee2946aaa9c759c77ede61089624691291fb2129eeb2a47687b50e2463188c78e1f738cf2@52.15.54.8:30303,enode://c2405194166fe2c0e6c61ee469745fed1a6802f51c8fc39e1c78c21c9a6a15a7c55304f09ee37e430da9a1ce8117ca085263c6b0f474f6946811e398347611ef@3.146.213.65:30303
--bootnodes=enode://9e138a8ec4291c4f2fe5851aaee44fc73ae67da87fb26b75e3b94183c7ffc15b2795afc816b0aa084151b95b3a3553f1cd0d1e9dd134dcf059a84d4e0b429afc@3.146.117.118:30303,enode://34d87d649e5c58a17a43c1d59900a2020bd82d5b12ea39467c3366bee2946aaa9c759c77ede61089624691291fb2129eeb2a47687b50e2463188c78e1f738cf2@52.15.54.8:30303,enode://c2405194166fe2c0e6c61ee469745fed1a6802f51c8fc39e1c78c21c9a6a15a7c55304f09ee37e430da9a1ce8117ca085263c6b0f474f6946811e398347611ef@3.146.213.65:30303

Set the tx ingress to be GETH_ROLLUP_SEQUENCERHTTP=https://sepolia-sequencer.unichain.org

Last updated on

On this page