> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peaq.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Example Scripts

> Run guided scripts that exercise ROS 2 services, storage bridge, and event streaming end to end.

The examples package ships Python scripts that call into ROS 2 services and topics. They are great starting points for automated tests or operator tooling.

## `create_identity.py`

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
ros2 run peaq_ros2_examples create_identity
```

* Prompts for optional metadata and creates a DID via `/identity/create`
* Streams transaction updates until finalized
* Prints the resulting DID document when available

## `send_store_add_data.py`

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
ros2 run peaq_ros2_examples send_store_add_data
```

* Requests a key, payload, and confirmation mode interactively
* Publishes telemetry through the storage bridge and waits for completion
* Reads the stored data back to verify the flow

Embed the client class (`StorageClient`) in your own scripts to reuse retry handling and logging.

## `emit_intent.py`

Even without humanoid adapters, this script is useful for broadcasting structured events and verifying event streaming:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
ros2 run peaq_ros2_examples emit_intent
```

* Provides menus for locomotion, posture, and gesture intents
* Publishes events onto `peaq/events` so you can observe payloads and transaction status updates

## `user_quickstart.py`

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
ros2 run peaq_ros2_examples user_quickstart
```

* Chains identity creation, storage operations, and access control into a single guided flow
* Ideal for validating that wallet funding and configuration are correct before deploying robots

## Utilities

* `inspect_sdk.py`: prints the active configuration and SDK status
* `print_wallet_addr.py`: displays the wallet address associated with the current keystore
* `retry_failed_storage.py`: replays failed storage submissions recorded by the storage bridge

All scripts expect the workspace to be sourced and the relevant nodes running. Combine them with the [example launches](/peaqchain/sdk-reference/robotics-sdk/ros2/examples/overview) to exercise complete robotics pipelines without writing additional code and to showcase ROS 2 support as a first-class citizen of the peaq robotics platform.