every.channel/evolution/proposals/ECP-0021-relay-mode-toggle.md
2026-02-15 16:17:27 -05:00

636 B

ECP-0021: relay mode environment toggle

Status

Draft

Context

Local testing (and some restricted networks) fail when iroh relays are unreachable. We need a simple way to disable relays without changing code, especially for self-tests.

Decision

Add EVERY_CHANNEL_IROH_RELAY to select relay mode when building endpoints. Supported values: default (current behavior) and disabled (no relay use).

Details

  • The endpoint builder reads EVERY_CHANNEL_IROH_RELAY.
  • Invalid values fail fast with a clear error.

Consequences

  • Local testing can run without relay connectivity.
  • Default behavior remains unchanged.