Expand description
qualia-cli mesh-probe — a two-machine SocialWebNet reachability probe.
Cross-host counterpart to the in-process loopback tests: userspace WireGuard over
real UDP. This is the labelled internet transition path, not Native Independent
Ethernet. Barriers, NAT class, and the grok-bot listen job are in
docs/manuals/standards/qualia-decentralized-network-fabric/qdnf-imp/internet-two-host.md.
§Zero key-copying: keys derive from a shared passphrase + role
secret(role) = SHA-256("qualia-mesh-probe:v1:" || role || ":" || passphrase)Listen is role a; connect is role b.
§Internet procedure (one side must be a reachable UDP listener)
Listener (public IP or port-forward — typically grok-bot / desktop / VPS):
qualia-cli mesh-probe observe --port 51820
qualia-cli mesh-probe listen --pass PHRASE --port 51820 --seconds 300Connector (Cursor cloud agent on address-dependent SNAT — connect-only):
qualia-cli mesh-probe connect --pass PHRASE --peer LISTENER_IP:51820 --qdnfSTUN-learned addresses from an address-dependent NAT must not be given to the peer
as a listen locator. Cursor cloud ports forwards TCP to the operator desktop; it
is not a public WireGuard UDP endpoint.
Enums§
Constants§
Functions§
- derive_
secret 🔒 - Derive a deterministic 32-byte WireGuard secret from
(role, passphrase). - hex_
lower 🔒 - print_
report 🔒 - print_
stun_ 🔒on_ socket - resolve_
ipv4 🔒 - run
- Runs the command.
- run_
connect 🔒 - run_
listen 🔒 - run_
observe 🔒