feat: Multi-node connectivity via hero_proxy over Mycelium #84

Merged

mahmoud merged 6 commits from development_hero_proxy_multinode into development 2026-04-09 12:54:53 +00:00

Conversation 0 Commits 6 Files changed 12 +345 -795

mahmoud commented 2026-04-08 13:01:31 +00:00

Owner

Copy link

Summary

• Rename all hero_router references to hero_proxy for cross-node traffic (port 9998 to 9997)
• Add auto-configuration of hero_proxy Mycelium listener on master/worker start
• Add hero_router + hero_proxy to install/uninstall scripts
• Update all documentation

Changes

Area	Files	What
SDK	lib.rs	HERO_PROXY_PORT=9997, proxy_*_url() functions
CLI	main.rs	Mycelium listener auto-setup, write_env() updates
Heartbeat	heartbeat_sender.rs	proxy_* references
Explorer	proxy.rs	proxy_* doc updates
Install	install.sh, uninstall.sh	hero_router + hero_proxy steps
Docs	setup, arch, config, .env	Hero Proxy for multi-node

Test plan

• cargo build --workspace passes
• cargo test --workspace — 13 suites, 0 failures
• make lint passes
• Multi-node test: master + worker over Mycelium

Closes #83

## Summary - Rename all hero_router references to hero_proxy for cross-node traffic (port 9998 to 9997) - Add auto-configuration of hero_proxy Mycelium listener on master/worker start - Add hero_router + hero_proxy to install/uninstall scripts - Update all documentation ## Changes | Area | Files | What | |------|-------|------| | SDK | `lib.rs` | HERO_PROXY_PORT=9997, proxy_*_url() functions | | CLI | `main.rs` | Mycelium listener auto-setup, write_env() updates | | Heartbeat | `heartbeat_sender.rs` | proxy_* references | | Explorer | `proxy.rs` | proxy_* doc updates | | Install | `install.sh`, `uninstall.sh` | hero_router + hero_proxy steps | | Docs | setup, arch, config, .env | Hero Proxy for multi-node | ## Test plan - [x] `cargo build --workspace` passes - [x] `cargo test --workspace` — 13 suites, 0 failures - [x] `make lint` passes - [x] Multi-node test: master + worker over Mycelium Closes #83

mahmoud added 1 commit 2026-04-08 13:01:31 +00:00

feat: multi-node connectivity via hero_proxy over Mycelium ... c6aeeb48d7

Replace hero_router references with hero_proxy for cross-node traffic.
hero_router stays localhost-only (socket discovery). hero_proxy handles
external Mycelium IPv6 connections.

SDK:
- Rename HERO_ROUTER_PORT to HERO_PROXY_PORT (9997)
- Rename router_*_url() to proxy_*_url()
- Rename ROUTER_*_PREFIX to PROXY_*_PREFIX

CLI:
- Add setup_hero_proxy_mycelium_listener() — auto-configures hero_proxy
  Mycelium listener on master/worker start via mycelium.info + listener.add
- Update write_env() and detect_outbound_ip() for new port

Install script:
- Add hero_router and hero_proxy download/install/start steps
- Read versions from central config (hero_compute_config)
- Start hero_router and hero_proxy via hero_proc
- Update uninstall.sh with cleanup

Docs:
- Update all references from Hero Router to Hero Proxy for multi-node
- Update port 9998 to 9997

#83

mahmoud added 1 commit 2026-04-09 09:03:22 +00:00

merge: development into hero_proxy_multinode — resolve script conflicts with clean rewrites 13d36c4122

mahmoud added 1 commit 2026-04-09 11:20:08 +00:00

fix: wrap IPv6 addresses in brackets for URLs, use MYCELIUM_IP for worker advertise ... 837a2e85fe

- proxy_server_rpc_url/proxy_explorer_rpc_url now wrap IPv6 in brackets
  (e.g. http://[5ed:...]:9997/... instead of http://5ed:...:9997/...)
- Worker mode uses MYCELIUM_IP env var for advertise address instead of
  detect_outbound_ip which finds the IPv4 route

mahmoud added 1 commit 2026-04-09 11:58:18 +00:00

chore: clean up branch for merge ... e74968707a

- Remove hero_install.nu (now in hero_scripts repo)
- Rewrite docs/architecture.md — full multi-node architecture with
  hero_proxy -> hero_router -> socket chain, component roles, deployment modes
- Rewrite docs/setup.md — multi-node setup guide with Mycelium configuration
- Update .env.example — correct IPv6 URL examples with brackets
- Build passes, lint passes, all 13 test suites pass

mahmoud added 1 commit 2026-04-09 12:14:12 +00:00

feat: install script starts hero_router, hero_proxy, configures Mycelium ... 9ef09e1964

Install script now fully automates multi-node setup:
1. Install nushell + all binaries (via hero_scripts)
2. System packages + kernel
3. Start hero_proc_server
4. Start mycelium
5. Start hero_router (socket discovery)
6. Start hero_proxy (network gateway)
7. Create hero_proxy [::]:9997 dual-stack listener
8. Detect Mycelium IPv6 and save MYCELIUM_IP to env file

After install, user only needs:
  hero_compute --start --mode master
  hero_compute --start --mode worker --master-ip <mycelium-ipv6>

Summary now shows all 4 services + Mycelium IP.

mahmoud added 1 commit 2026-04-09 12:52:38 +00:00

Merge branch 'development' into development_hero_proxy_multinode 9208524297

mahmoud merged commit f404f80218 into development 2026-04-09 12:54:53 +00:00

mahmoud referenced this pull request from a commit 2026-04-09 12:54:55 +00:00

feat: Multi-node connectivity via hero_proxy over Mycelium (#84)

mahmoud deleted branch development_hero_proxy_multinode 2026-04-09 12:54:58 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

prio_critical

  

prio_low

  

type_bug

  

type_contact

  

type_issue

  

type_lead

  

type_question

  

type_story

  

type_task

No labels

prio_critical

prio_low

type_bug

type_contact

type_issue

type_lead

type_question

type_story

type_task

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

lhumina_code/hero_compute!84

No description provided.