Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Conduit node

Conduit provides fully-managed, production-grade rollups on Ethereum.

It currently supports Optimism’s open-source OP Stack.

This repository contains the relevant Docker builds to run your own node on the specific Conduit network.

Hardware requirements

We recommend you have this configuration to run a node:

at least 16 GB RAM
an SSD drive with at least 200 GB free

Troubleshooting

If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:

Supported networks

Ethereum Network	Status	Slug
Zora Sepolia	✅	zora-sepolia-0thyhxtf5e
Zora Mainnet	✅	zora-mainnet-0
PGN Sepolia	✅	pgn-sepolia-i4td3ji6i0

Usage

Download the network you want to run by using download-config.py. You will need to know the slug of the network. You can find this in the Conduit console. For example: ./download-config.py zora-sepolia-0thyhxtf5e. Note: The external nodes feature must be enabled on the network for this to work.
Select the network you want to run (it should exist in the networks folder) and set CONDUIT_NETWORK env variable. Example:

# for Zora Sepolia
export CONDUIT_NETWORK=zora-sepolia-0thyhxtf5e

Ensure you have an Ethereum L1 full node RPC available (not Conduit), and copy .env.example to .env setting OP_NODE_L1_ETH_RPC. If running your own L1 node, it needs to be synced before the specific Conduit network will be able to fully sync.
Run:

docker compose up --build

You should now be able to curl your Conduit node:

curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545

Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc when starting op-node (add it in op-node-entrypoint and rebuild the docker image with docker compose build.) Do not do this unless you fully trust the L1 node provider.

You can map a local data directory for op-geth by adding a volume mapping to the docker-compose.yaml:

services:
geth: # this is Optimism's geth client...volumes:
- ./geth-data:/data

Snapshots

TBD

Syncing

Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus RPC on the op-node container. Example:

command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes

Name		Name	Last commit message	Last commit date
.dockerignore		.dockerignore
.env.default		.env.default
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
download-config.py		download-config.py
geth-entrypoint		geth-entrypoint
logo.png		logo.png
op-node-entrypoint		op-node-entrypoint

Name		Name	Last commit message	Last commit date
.dockerignore		.dockerignore
.env.default		.env.default
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
download-config.py		download-config.py
geth-entrypoint		geth-entrypoint
logo.png		logo.png
op-node-entrypoint		op-node-entrypoint

Name		Name	Last commit message	Last commit date
.dockerignore		.dockerignore
.env.default		.env.default
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
download-config.py		download-config.py
geth-entrypoint		geth-entrypoint
logo.png		logo.png
op-node-entrypoint		op-node-entrypoint

Name		Name	Last commit message	Last commit date
.dockerignore		.dockerignore
.env.default		.env.default
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
download-config.py		download-config.py
geth-entrypoint		geth-entrypoint
logo.png		logo.png
op-node-entrypoint		op-node-entrypoint

Name		Name	Last commit message	Last commit date
.dockerignore		.dockerignore
.env.default		.env.default
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
download-config.py		download-config.py
geth-entrypoint		geth-entrypoint
logo.png		logo.png
op-node-entrypoint		op-node-entrypoint

Latest commit

History

Folders and files

Repository files navigation

Conduit node

Hardware requirements

Troubleshooting

Supported networks

Usage

Snapshots

Syncing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Conduit node

Hardware requirements

Troubleshooting

Supported networks

Usage

Snapshots

Syncing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Conduit node

Hardware requirements

Troubleshooting

Supported networks

Usage

Snapshots

Syncing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Conduit node

Hardware requirements

Troubleshooting

Supported networks

Usage

Snapshots

Syncing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages