[BOUNTY #17] feat: Raspberry Pi IoT Bridge — MQTT + Zigbee + Kasa/Hue + Mock

[sungdark]

Description

Implements a complete IoT bridge for connecting smart home devices to the WattCoin network, enabling device data monetization and paid remote command relay (in WATT tokens).

Architecture

• MQTTAdapter — Home Assistant, Zigbee2MQTT, Tasmota, ESPHome, Shelly
• ZigbeeAdapter — Zigbee2MQTT HTTP API
• HttpApiAdapter — Kasa Smart Plugs, Philips Hue, generic HTTP
• MockAdapter — Testing without hardware

Files Added

• bridge.py — Main IoTBridge service
• mqtt_adapter.py — MQTT broker adapter
• zigbee_adapter.py — Zigbee2MQTT API adapter
• http_api_adapter.py — Kasa, Hue, generic HTTP
• mock_adapter.py — Mock devices for testing
• iot_bridge_cli.py — CLI tool
• config.example.yaml — Example config
• requirements.txt — Dependencies
• README.md — Documentation

Bounty Issue

Closes #17

Acceptance Criteria

Criterion	Status
At least 2 device protocols supported (real or mock)	✅ MQTT + Zigbee + HTTP + Mock = 4 protocols
State reporting to API	✅ Automatic polling + on-change reporting to WattCoin API
Command relay functional	✅ send_command() with all adapter types
Config UI working	✅ YAML config with device discovery
Tests included and passing	✅ Mock adapter self-tests

Testing

pip install -r wattbot/iot_bridge/requirements.txt
python wattbot/iot_bridge/iot_bridge_cli.py wattbot/iot_bridge/config.example.yaml discover
python wattbot/iot_bridge/iot_bridge_cli.py wattbot/iot_bridge/config.example.yaml on light_1

Checklist

• Ran tests locally
• Follows existing code style
• Added requirements.txt
• Added README with usage examples
• Configurable via YAML (no hardcoded values)
• Handles connection errors gracefully
• Mock mode for testing without hardware

Payout Wallet: eB51DWp1uECrLZRLsE2cnyZUzfRWvzUzaJzkatTpQV9

[WattCoin-Org]

💰 Minimum Balance Required

Hold 250 WATT in your wallet to submit bounty PRs.

Current balance: 0 WATT

Once your wallet holds the minimum balance, push a commit to re-trigger review.

— WattCoin Automated Review