relay-cli

Overview ¶

Command relay-cli is the operator-facing CLI for the Frame-to-Frame relay (interchange). Subcommands:

init <nexus-id> [-store DIR] [-dh P-256|X25519]
    Generate a casket Channel with persistent keys.

token -endpoint URL [-store DIR]
    Print our PairingToken (JSON) for OOB exchange with a peer.

pair -target ID -relay URL [-endpoint URL] [-store DIR]
    Requester side: submit a signed pair half, poll until decided.

pending -tailnet URL
    Owner side: list pending pair requests on our relay.

approve <request-id> -tailnet URL [-as ID] [-store DIR]
    Owner side: build + sign owner half, POST approve.

deny <request-id> -tailnet URL
    Owner side: deny a pending request (no signed half required).

Identity persistence: a tiny file-backed ChannelStorage rooted at -store (default ./relay-state). One subdir per nexus-id.