Create and Read

Create an identity document and read it back from the chain with the Python Robotics SDK. Covers default DID fields and decoded response data.

This model has been absorbed into peaqOS. See peaqID for the current identity model.

Create an identity document and read it back from chain.

from peaq_robot import PeaqRobot

sdk = PeaqRobot()

# Defaults id and controller to did:peaq:<your address>
try:
    tx = sdk.id.create_identity()
    print(tx)
except Exception as e:
    # Fails if the DID already exists or the account cannot pay the fee
    print("create_identity failed:", e)

doc = sdk.id.read_identity()
print(doc.get("decoded_data"))  # None if no DID exists

Response example:

{
  "exists": true,
  "read_status": "success",
  "did_account": "5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
  "name": "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
  "value": "0a3f...",
  "decoded_data": {
    "id": "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
    "controller": "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
    "verificationMethods": [
      {
        "id": "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8#keys-1",
        "type": "Sr25519VerificationKey2020",
        "controller": "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
        "publicKeyMultibase": "6c97e334e9199cd21944c6882f6222a1b8f5be2ff3b860021f4a074ad4d8d802"
      }
    ],
    "authentications": [
      "did:peaq:5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8#keys-1"
    ],
    "services": [],
    "signature": {
      "type": "Sr25519VerificationKey2020",
      "issuer": "5EX69aaLFLyDxNcbxVd3Y4FVxjyHTCXtLDx9scg3uQSXF3r8",
      "hash": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a"
    }
  },
  "validity": 4294967295,
  "created": 1758223110000
}

Fields:

• did_account, exists, read_status
• name, value (decoded string, or the raw hex if decoding fails)
• decoded_data with id, controller, verificationMethods, authentications, services, signature
• validity, created (validity and creation time as returned by the chain)