explaingit

jpoon/bootnode-registrar

Analysis updated 2026-07-17 · repo last pushed 2021-03-12

★ 9GoAudience · ops devopsComplexity · 3/5DormantSetup · hard

TLDR

A Go tool that resolves a DNS name into a live list of Ethereum bootnode addresses, so new nodes on a private network can find peers automatically.

Mindmap

mindmap
  root((bootnode-registrar))
    What it does
      Resolves bootnode DNS
      Serves node address list
      Auto updates list
    Tech stack
      Go
      Kubernetes
      Ethereum
    Use cases
      Private Ethereum network setup
      Kubernetes bootnode discovery
      Dev and test blockchain networks
    Audience
      Blockchain operators
      DevOps engineers
    How it works
      Headless Kubernetes service
      HTTP endpoint on 9898
      Curl returns node list

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically discover all active bootnode addresses for a private Ethereum network running on Kubernetes.

USE CASE 2

Feed a live bootnode list into geth's --bootnodes flag without manually tracking IPs.

USE CASE 3

Keep bootnode configuration current when nodes are frequently spun up and torn down in dev/test environments.

USE CASE 4

Query a single HTTP endpoint to get a comma-separated list of every active bootnode.

What is it built with?

GoKubernetesEthereum

How does it compare?

jpoon/bootnode-registraraaklon/akinatorkelseyhightower/github-webhook
Stars999
LanguageGoGoGo
Last pushed2021-03-12—2018-02-23
MaintenanceDormant—Dormant
Setup difficultyhardmoderatemoderate
Complexity3/53/52/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Kubernetes cluster with bootnode pods and a headless service already configured.

Copy-paste prompts

Prompt 1
Show me how to deploy this bootnode-registrar alongside a headless Kubernetes service for my Ethereum bootnodes.
Prompt 2
Write a curl command to fetch the current bootnode list from this registrar's HTTP endpoint on port 9898.
Prompt 3
How do I configure geth to use the bootnode list returned by this registrar's DNS lookup?
Prompt 4
Walk me through setting up bootnode containers in Kubernetes that expose their address for this registrar to discover.

Frequently asked questions

What is bootnode-registrar?

A Go tool that resolves a DNS name into a live list of Ethereum bootnode addresses, so new nodes on a private network can find peers automatically.

What language is bootnode-registrar written in?

Mainly Go. The stack also includes Go, Kubernetes, Ethereum.

Is bootnode-registrar actively maintained?

Dormant — no commits in 2+ years (last push 2021-03-12).

How hard is bootnode-registrar to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is bootnode-registrar for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos