TWIX TDAP SDK v0.2.0
====================

Reference clients:
- twix-meter-agent.php  : PHP CLI, Sodium + cURL
- twix-meter-agent.mjs  : Node.js 18+ built-in crypto + fetch
- twix_meter_agent.py   : Python, PyNaCl + requests

The client private key remains local. Register only the printed Ed25519 public key
in validator.twixchain.com/admin.php.

Production adapters must verify the real meter protocol, scaling, units, device
clock, authentication and calibration requirements. Example Modbus/MQTT files are
integration skeletons, not universal meter register maps.

Self-test before integration:
  php twix-meter-agent.php self-test
  node twix-meter-agent.mjs self-test
  python3 twix_meter_agent.py self-test

If the source meter supplies its own timestamp, pass --measured-at=<ISO-8601>.
Otherwise the reference client uses the gateway's current UTC time.

Python meter-protocol examples have optional dependencies listed in
requirements-examples.txt. Register maps and scale factors remain meter-specific.
