Skip to main content

Module mesh

Module mesh 

Source
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 300

Connector (Cursor cloud agent on address-dependent SNAT — connect-only):

  qualia-cli mesh-probe connect --pass PHRASE --peer LISTENER_IP:51820 --qdnf

STUN-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§

MeshAction

Constants§

STUN_A 🔒
STUN_B 🔒

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 🔒