feat: reef chain bootstrap #415

anukulpandey · 2025-10-03T07:17:14Z

Added Reef chain node to dokploy template for setting up a cluster

Can read more about reef chain here - https://reef.io

🌊 Reef Cluster – Dokploy Deployment Guide

A Reef validator cluster can be deployed in two different ways on Dokploy:

🟢 Method 1: Single Template (Full Cluster Setup) [RECOMMENDED]

A single deployment handles bootnode + all validators + RPC.

🔵 Method 2: Multiple Templates (Bootstrap + Individual Validators)

You deploy bootstrap + validators separately for more control.

📑 Table of Contents

Method 1 – Single Template
Method 2 – Multiple Templates

🟢 Method 1: Single Template – Full Cluster Setup

Step 1: Generate Validator Keys

Go to Create Service
Select Template from the menu.

Add template repo URL at the top-right:

https://d1633d6c.templates-70k.pages.dev/

Search for “Reef”
Click Create on Reef Chain – Keys Generator, then confirm.
Deploy the service.
Visit the port http://reef.host:48765 or your IP address / hostname at port 48765
Copy all address + seed pairs, they will be needed later.

Step 2: Deploy Custom Spec Generator

Go to Templates and search for:

Reef Chain – Custom Spec Generator

Deploy it.
It runs on port 8000 by default:
```
http://reef.host:8000
```
You can change the port in environment variables if needed.

This service is used by the validators to automatically fetch the custom chain spec.

Step 3: Deploy the Complete Cluster

From templates, search for:

Reef Chain – Dev Cluster

Open the environment tab and paste your seeds & addresses you have copied in step 1:

You may configure:
- specgenurl → URL of your custom spec generator
- default: http://reef.host:8000
Deploy the service.
Logs should show successful bootnode + 3 validators starting:

🎉 The cluster is now running!

Adding More Validators

Generate more validators using Reef Chain – Keys Generator.

Fill in the new keys → Deploy.

Deploy Ethereum RPC

Search template:

Reef Chain – ETH RPC

Deploy → It will use the default substrate RPC:

http://reef.host:9944

ETH RPC runs at:

http://reef.host:8545

🎉 Your full cluster (bootnode + validators + RPC + ETH RPC) is now live.

🔵 Method 2: Multiple Templates – Bootstrap & Validators

Step 1: Generate Validator Keys (Same as Method 1)

👉 Jump to: Generate Validator Keys

Step 2: Deploy Bootnode Validator

Create service → choose template:

Reef Chain – Bootnode Validator

Fill in:

v1sec, v2sec, v3sec
v1addr, v2addr, v3addr
PORT=8000 → exposes custom spec
P2P_PORT=30335 → bootnode peer port

Bootnode starts → no peers yet (expected).

Step 3: Deploy Additional Validators

Use:

Reef Chain – Validator

Deploy 2 or more validators → finalize blocks.

Deploy ETH RPC (Method 2)

Same template:

Reef Chain – ETH RPC

ETH RPC default port:

http://reef.host:8545

github-actions · 2025-10-03T07:18:06Z

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
templates	✅ Ready (View Log)	Visit Preview	`7469a84`

blueprints/reef-rpc/template.toml

blueprints/reef-bootnode/template.toml

Harikrishnan1367709 · 2025-10-07T15:40:06Z

Copilot

Pull request overview

This PR adds comprehensive support for deploying Reef Chain blockchain infrastructure through Dokploy templates. Reef is an EVM-compatible blockchain platform, and this implementation enables users to set up complete validator clusters with various deployment options.

Key Changes:

Added 7 new Reef Chain templates covering the complete deployment lifecycle (keys generation, spec generation, validators, RPC nodes, and ETH RPC)
Implemented two deployment methodologies: single full-cluster setup and modular bootstrap + individual validator approach
Integrated Docker-based deployment using custom Reef Chain node images with runtime script fetching

Reviewed changes

Copilot reviewed 15 out of 22 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
meta.json	Added 7 new template entries for Reef Chain services (bootnode, dev-cluster, eth-rpc, keygen, rpc, spec-gen, validator)
blueprints/reef-validator/*	Individual validator node template with configurable network parameters
blueprints/reef-spec-gen/*	Spec generator service that creates blockchain configuration files
blueprints/reef-rpc/*	RPC node template for blockchain query interface
blueprints/reef-keygen/*	Key generation service producing validator credentials
blueprints/reef-eth-rpc/*	Ethereum-compatible RPC adapter for EVM interactions
blueprints/reef-dev-cluster/*	All-in-one development cluster with bootnode and multiple validators
blueprints/reef-bootnode/*	Bootstrap node template serving as network entry point

Copilot · 2026-01-07T18:17:21Z

blueprints/reef-validator/template.toml

+SPEC_URL = "http://reef.host:8000/local-chain-spec-raw.json"
+BOOTNODE_NODE_KEY="http://reef.host:8000/bootnode_node_key.txt"
+
+BOOTNODE_IP="72.60.35.83"


The hardcoded IP address '72.60.35.83' should not be a default value in a template. This exposes a specific external IP address and prevents proper customization. Users should provide their own bootnode IP through the variable system (e.g., using ${bootnode_ip} variable).

Copilot · 2026-01-07T18:17:21Z

blueprints/reef-validator/docker-compose.yml

+    ports:
+      - "${P2P_PORT}:${P2P_PORT}"


According to project conventions, ports should be omitted from docker-compose.yml as Dokploy handles port mapping and service isolation via internal networks. The port exposure is already configured in template.toml through config.domains.

Copilot · 2026-01-07T18:17:22Z

blueprints/reef-rpc/template.toml

+SPEC_URL = "http://reef.host:8001/local-chain-spec-raw.json"
+BOOTNODE_NODE_KEY="http://reef.host:8001/bootnode_node_key.txt"


Port 8001 is inconsistent with other templates which use port 8000 for the spec generator (e.g., reef-spec-gen uses 8000, reef-validator uses 8000, reef-dev-cluster uses 8000). This inconsistency will cause the RPC node to fail when trying to fetch the spec file.

Copilot · 2026-01-07T18:17:22Z

blueprints/reef-rpc/template.toml

+SPEC_URL = "http://reef.host:8001/local-chain-spec-raw.json"
+BOOTNODE_NODE_KEY="http://reef.host:8001/bootnode_node_key.txt"
+
+BOOTNODE_IP="72.60.35.83"


The hardcoded IP address '72.60.35.83' should not be a default value. This should be replaced with a configurable variable (e.g., ${bootnode_ip}) to allow users to specify their own bootnode address.

Copilot · 2026-01-07T18:17:22Z

blueprints/reef-rpc/docker-compose.yml

+    ports:
+      - "${P2P_PORT}:${P2P_PORT}"
+      - "${RPC_PORT}:${RPC_PORT}"


According to project conventions, ports should be omitted from docker-compose.yml as Dokploy handles port mapping through template.toml config.domains. Remove the ports section since these are already properly configured in template.toml.

Copilot · 2026-01-07T18:17:23Z

blueprints/reef-eth-rpc/docker-compose.yml

+    ports:
+      - "${PORT}:${PORT}"


According to project conventions, ports should be omitted from docker-compose.yml as Dokploy handles port mapping via template.toml config.domains.

Copilot · 2026-01-07T18:17:23Z

blueprints/reef-dev-cluster/docker-compose.yml

+    ports:
+      - "30335"
+      - "30333"
+      - "30334"
+      - "30336"
+      - "8001"
+      - "9944"


According to project conventions, ports should be omitted from docker-compose.yml as Dokploy handles port exposure through template.toml config.domains. All these ports are already properly configured in template.toml.

Copilot · 2026-01-07T18:17:24Z

blueprints/reef-bootnode/docker-compose.yml

+    ports:
+      - "${PORT}:${PORT}"
+      - "${P2P_PORT}:${P2P_PORT}"


According to project conventions, ports should be omitted from docker-compose.yml since Dokploy manages port mapping through template.toml config.domains configuration.

Copilot · 2026-01-07T18:17:24Z

meta.json

+      "reef-chain",
+      "eth-rpc",
+      "self-hosted",
+      "keys"


The tag 'keys' appears inconsistent with the tagging pattern used throughout the repository. For reef-eth-rpc, this should likely be 'evm' to match the service's purpose of providing EVM layer RPC functionality, similar to other Reef Chain entries.

Suggested change

"keys"

"evm"

Copilot · 2026-01-07T18:17:24Z

blueprints/reef-rpc/template.toml

+
+[[config.domains]]
+serviceName = "reef-rpc"
+port = 30339
+host = "${domain}"
+path = "/"
+
+[[config.domains]]
+serviceName = "reef-rpc"
+port = 9994
+host = "${domain}"


Both domain configurations use the same ${domain} host, which will cause a conflict as two different ports cannot be mapped to the same domain without path differentiation. Consider using different domain variables (e.g., ${p2p_domain} and ${rpc_domain}) or adding subdomain differentiation.

Suggested change

[[config.domains]]

serviceName = "reef-rpc"

port = 30339

host = "${domain}"

path = "/"

[[config.domains]]

serviceName = "reef-rpc"

port = 9994

host = "${domain}"

p2p_domain = "${p2p_domain}"

rpc_domain = "${rpc_domain}"

[[config.domains]]

serviceName = "reef-rpc"

port = 30339

host = "${p2p_domain}"

path = "/"

[[config.domains]]

serviceName = "reef-rpc"

port = 9994

host = "${rpc_domain}"

feat: reef chain bootstrap

50cc1bc

github-actions bot deployed to Preview October 3, 2025 07:18 View deployment

fix: missing doc field

f5949cb

github-actions bot deployed to Preview October 3, 2025 07:20 View deployment

feat: reef rpc

91653cd

github-actions bot deployed to Preview October 3, 2025 07:26 View deployment

fix: meta

41920f4

github-actions bot deployed to Preview October 3, 2025 07:29 View deployment

feat: toml changes

72b2109

github-actions bot deployed to Preview October 3, 2025 07:43 View deployment

fix: var in rpc

8869a34

github-actions bot deployed to Preview October 3, 2025 07:45 View deployment

feat: minimal rpc

35bfe1c

github-actions bot deployed to Preview October 3, 2025 07:49 View deployment

feat: default envs

bba1445

github-actions bot deployed to Preview October 3, 2025 07:52 View deployment

bootnode toml

f63563f

github-actions bot deployed to Preview October 3, 2025 08:06 View deployment

feat: icon

2971695

github-actions bot deployed to Preview October 3, 2025 08:10 View deployment

feat: icon

3e19c09

github-actions bot deployed to Preview October 3, 2025 08:16 View deployment

feat: old icons

61bab62

github-actions bot deployed to Preview October 3, 2025 08:24 View deployment

Siumauricio requested changes Oct 5, 2025

View reviewed changes

blueprints/reef-rpc/template.toml Outdated Show resolved Hide resolved

blueprints/reef-bootnode/template.toml Outdated Show resolved Hide resolved

anukulpandey added 2 commits October 6, 2025 12:55

Update template.toml

d915a3e

Update template.toml

0c600c6

github-actions bot deployed to Preview October 6, 2025 07:26 View deployment

feat: removed version from docker-compose bootstrap

49fcc4e

github-actions bot deployed to Preview December 15, 2025 09:52 View deployment

feat: expose 9944 for dev cluster

67828bf

github-actions bot deployed to Preview December 15, 2025 10:06 View deployment

fix: start-rpc script

4de4fcb

github-actions bot deployed to Preview December 15, 2025 10:08 View deployment

feat: eth-rpc rpc host

4cdff52

github-actions bot deployed to Preview December 18, 2025 12:43 View deployment

fix: flag for eth-rpc external rpc connections

0afec75

github-actions bot deployed to Preview December 18, 2025 12:45 View deployment

feat: cors for all

1d42a67

github-actions bot deployed to Preview December 18, 2025 12:50 View deployment

Merge branch 'canary' into reef-chain

247ca6a

github-actions bot deployed to Preview December 26, 2025 07:51 View deployment

anukulpandey requested a review from Siumauricio December 26, 2025 07:52

fix: meta.json missing ]

c296fa0

github-actions bot deployed to Preview December 26, 2025 07:59 View deployment

feat:process meta

05ea5ba

github-actions bot deployed to Preview December 26, 2025 08:03 View deployment

feat: removed container_name from docker-compose

5beccb1

github-actions bot deployed to Preview December 26, 2025 08:09 View deployment

feat: port and p2p port must be string for bootnode

14d369f

github-actions bot deployed to Preview December 26, 2025 08:12 View deployment

anukulpandey added 2 commits December 26, 2025 13:42

feat: ports for reef dev cluster

d0fed69

fix: ports for reef-dev-cluster

e991677

github-actions bot deployed to Preview December 26, 2025 08:13 View deployment

feat: all ports to strings

7469a84

github-actions bot deployed to Preview December 26, 2025 08:16 View deployment

Siumauricio requested a review from Copilot January 7, 2026 18:10

Copilot AI reviewed Jan 7, 2026

View reviewed changes

		SPEC_URL = "http://reef.host:8001/local-chain-spec-raw.json"
		BOOTNODE_NODE_KEY="http://reef.host:8001/bootnode_node_key.txt"

feat: reef chain bootstrap #415

Are you sure you want to change the base?

feat: reef chain bootstrap #415

Uh oh!

Conversation

anukulpandey commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🌊 Reef Cluster – Dokploy Deployment Guide

🟢 Method 1: Single Template (Full Cluster Setup) [RECOMMENDED]

🔵 Method 2: Multiple Templates (Bootstrap + Individual Validators)

📑 Table of Contents

🟢 Method 1: Single Template – Full Cluster Setup

Step 1: Generate Validator Keys

Step 2: Deploy Custom Spec Generator

Reef Chain – Custom Spec Generator

Step 3: Deploy the Complete Cluster

Reef Chain – Dev Cluster

Adding More Validators

Deploy Ethereum RPC

Reef Chain – ETH RPC

🔵 Method 2: Multiple Templates – Bootstrap & Validators

Step 1: Generate Validator Keys (Same as Method 1)

Step 2: Deploy Bootnode Validator

Reef Chain – Bootnode Validator

Step 3: Deploy Additional Validators

Reef Chain – Validator

Deploy ETH RPC (Method 2)

Reef Chain – ETH RPC

Uh oh!

github-actions bot commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Uh oh!

Uh oh!

Uh oh!

Harikrishnan1367709 commented Oct 7, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

anukulpandey commented Oct 3, 2025 •

edited

Loading

github-actions bot commented Oct 3, 2025 •

edited

Loading