Files
zeekay ea21a57505 zaptransport: intra-Lux operator-plane transport over luxfi/zap
Adds pkg/zaptransport — a thin facade over github.com/luxfi/zap for
operator-to-operator pre-commit gossip of SignedReceipts. The package
is purely transport: it carries opaque JSON receipt bytes and never
runs signature math. Verification stays gated by pkg/profile.

Reserved relay-plane ZAP message types (encoded as msgType<<8 in the
ZAP flags field, per upstream convention):

  0x48  MsgRelayHello              (handshake)
  0x49  MsgRelayMessageBroadcast   (JSON SignedReceipt bytes)
  0x4A  MsgRelayStatusPing         (liveness)

Service tag: "_luxd-relay._tcp".

pkg/server wires the ZAP listener alongside the HTTP server, exposing
/v1/zap/peers for operator introspection. relayd gains --zap-port and
RELAYD_ZAP_PORT (default 7710; 0 disables).

External-chain RPC (Bitcoin / Ethereum / OP_NET) remains on its
native transport — this package does not touch it.

2 end-to-end tests round-trip a real JSON receipt between two ZAP
nodes over loopback with NoDiscovery.
2026-05-19 08:36:47 -07:00
..