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

Open

mahmoud wants to merge 1 commit from development_hero_proxy_multinode into development

mahmoud commented

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

Owner

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 - [ ] 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

Test / test (push) Successful in 1m25s

Details

Test / test (pull_request) Successful in 1m28s

Details

Test Install Script / test-install-ubuntu (pull_request) Successful in 1m38s

Details

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

Test / test (push) Successful in 1m25s

Details

Test / test (pull_request) Successful in 1m28s

Details

Test Install Script / test-install-ubuntu (pull_request) Successful in 1m38s

Details

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin development_hero_proxy_multinode:development_hero_proxy_multinode

git switch development_hero_proxy_multinode

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch development

git merge --no-ff development_hero_proxy_multinode

git switch development_hero_proxy_multinode

git rebase development

git switch development

git merge --ff-only development_hero_proxy_multinode

git switch development_hero_proxy_multinode

git rebase development

git switch development

git merge --no-ff development_hero_proxy_multinode

git switch development

git merge --squash development_hero_proxy_multinode