USDT Balance

​

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}"

​

Check Balance

export ROS_DOMAIN_ID="${ROS_DOMAIN_ID:-94}"
ros2 service call /peaq_tether_node/usdt/balance \
  peaq_ros2_interfaces/srv/TetherGetUsdtBalance \
  "{address: '0x...'}"

• balance_raw: base-10 string (uint256)
• balance_formatted: formatted using configured decimals (default 6 for peaq USDT)

​

Tips

• If you hit provider rate limits, retry after a short delay or use a higher-throughput RPC endpoint.
• Keep the USDT contract address in config in quotes (YAML) to avoid type parsing issues.