USDT Transfer

• from_address identifies which local wallet to use for signing (mnemonic loaded from the local registry)
• to_address is the destination address

​

Service Reference

​

Launch Prerequisites

• To start/stop the node (tmux + background options), follow the steps in Service Index.
• In any new terminal where you run ros2 commands, make sure you’ve sourced your ROS/workspace environment and set the same ROS_DOMAIN_ID as the node:

# source /opt/ros/<your_ros_distro>/setup.bash
# source <path to your peaq-robotics-ros2 clone>/install/setup.bash
export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"

​

Dry-run (Quote Only)

export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"
ros2 service call /peaq_tether_node/usdt/transfer \
  peaq_ros2_interfaces/srv/TetherTransferUsdt \
  "{from_address: '0xFROM', to_address: '0xTO', amount: '0.05', dry_run: true}"

​

Real Transfer (Broadcast)

export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"
ros2 service call /peaq_tether_node/usdt/transfer \
  peaq_ros2_interfaces/srv/TetherTransferUsdt \
  "{from_address: '0xFROM', to_address: '0xTO', amount: '0.05', dry_run: false}"

​

Common Failure Modes

• INSUFFICIENT_FUNDS: the from_address lacks native token for gas (even if USDT amount is 0).
• Unknown address: the from_address is not present in the local registry (no mnemonic available for signing).
• Provider rate limits: retry after a short delay, or use a higher-throughput RPC provider.