Add and Read Data

Write compact JSON data and read it back with the Python Robotics SDK. Covers decoded responses, data type limits, and serialized data size.

Write compact JSON data and read it back.

from peaq_robot import PeaqRobot

sdk = PeaqRobot()

# Write
tx = sdk.store.add_data("TELEMETRY_001", {"battery": 87.3})
print(tx)

# Read
res = sdk.store.read_data("TELEMETRY_001")
print(res["data"])   # decoded JSON if possible

Response example (read):

{
  "exists": true,
  "read_status": "success",
  "account": "5F...abc",
  "data_type": "TELEMETRY_001",
  "raw": "{\"battery\":87.3}",
  "data": {
    "battery": 87.3
  }
}

Limits:

• data_type ≤ 64 characters
• serialized data ≤ 256 characters

The SDK counts characters; the chain limit is 64 and 256 bytes, so multibyte text can pass the SDK check and still fail on chain.

Each key can be written once per account. add_data submits PeaqStorage.add_item, which fails with ItemTypeAlreadyExists if the key already exists, and the SDK has no update call. Use a new key for every write (for example, append a timestamp or counter), including with add_telemetry and add_configuration, which use the fixed keys TELEMETRY_<robot_id> and CONFIG_<robot_id>.