edged

edged is the Edge capability daemon.

Synopsis

edged --config /path/to/config.yaml
edged --config /path/to/config.yaml --control-socket /run/edged/ctl.sock
edged validate --config /path/to/config.yaml
edged precheck --config /path/to/config.yaml
edged version

Global Flags (edged --help)

Flag

Description

--config

path to config file (required)

--control-socket

unix socket path for local RPC API

--log-level

override log level (debug|info|warn|error)

--prometheus-addr

optional HTTP address for /metrics

Subcommands

validate

Runs config-load and deterministic check summary.

Output format starts with:

  • VALIDATION PASS (...)

  • or VALIDATION FAIL (...)

precheck

Runs OS-survival preflight gate and returns explicit exit codes.

  • 0: clean path

  • 1: config parse/validate failure

  • 2: state-root failure

  • 3: cert/CA readability or cert-expiry gate failure

  • 5: reconstruction path failure

Runtime Wiring (implemented)

runDaemon initializes:

  • config + startup validation

  • local store/index/quota/retry/scheduler

  • mTLS transport listener

  • local RPC server on unix socket

  • inbound relay accept loop

  • outbound relay executor workers (when relay + state_root configured)

Verification

GOWORK=off go run ./edge/cmd/edged --help
GOWORK=off go run ./edge/cmd/edged validate --config ./edge/config/testdata/valid_full.yaml
GOWORK=off go run ./edge/cmd/edged precheck --config ./edge/config/testdata/valid_full.yaml

Evidence

Code:

  • edge/cmd/edged/main.go

  • edge/rpcv1/socket.go

  • edge/relay/executor.go

Tests:

  • edge/cmd/edged/main_integration_test.go

  • edge/cmd/edged/precheck_test.go

Captured outputs:

  • docs/_generated/test-outputs/edged-help.txt

  • docs/_generated/test-outputs/edged-integration.txt

See Also