BLE gateway/proxy pattern for py-libp2p (application-layer handoff)

[acul71]

This discussion captures the maintainer stance on combining Bluetooth with py-libp2p without native BLE inside the stack. It continues the thread from the former tracking issue #1290.

Summary (scope: proxy / gateway)

Recommended integration: use a BLE gateway/proxy in front of py-libp2p — not native BLE inside the stack.

• BLE edge (phone, sensor, peripheral) ↔ gateway process (Python or other; e.g. BLE via bleak)
• Gateway ↔ py-libp2p host over existing transports (TCP / QUIC / WebSocket)

After handoff, negotiation, Noise/TLS, and streams use the normal libp2p path. The gateway forwards bootstrap/session material (e.g. multiaddr, peer info, short-lived tokens) to the local host.

Explicit non-goal here: first-class BLE transport inside py-libp2p (dial/listen on BLE as a libp2p transport). That is optional future research — open a separate discussion/issue if pursued.

Why

Proximity and constrained-edge connectivity matter for offline-adjacent scenarios. A gateway keeps BLE in the application/OS layer where stacks and permissions are well-supported, while py-libp2p stays on mature transports.

Prior art (lightweight)

• js-libp2p docs note proximity-style discovery (e.g. bluetooth) as not currently implemented in that productized sense.
• References to Bluetooth in other libp2p codebases are often illustrative (e.g. gating), not a portable BLE transport to mirror.

Maintainer stance

The gateway/proxy pattern is reasonable and supported as the near-term way to combine BLE with py-libp2p.

Optional follow-up (project priorities): add a short docs pointer or example sketch in this repo or in an application repo: “BLE handoff → host.connect / open stream using an existing multiaddr”.

Reference implementation

Application-level examples (mock + optional bleak on Raspberry Pi) and docs live in the libp2pxfilecoin project (separate repo), not in py-libp2p core.

---

Former issue: #1290 (closed; content preserved here.)

[acul71]

Reference implementation (BLE handoff JSON → py-libp2p dial over TCP/QUIC/WebSocket): acul71/libp2pxfilecoin — includes src/gateway/, arena-ble-gateway CLI, and docs/ble_gateway_examples.md.