Skip to main content
Use this service to transfer USDT from a locally-managed wallet address to any recipient address. The service is address-only:
  • from_address identifies which local wallet to use for signing (mnemonic loaded from the local registry)
  • to_address is the destination address

​
Service Reference

ServiceTypePurpose
/peaq_tether_node/usdt/transferpeaq_ros2_interfaces/srv/TetherTransferUsdtTransfer USDT from a local wallet address to a recipient address

​
Launch Prerequisites

Start peaq_tether_node once, then call services as needed.
  • 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)

Use dry_run: true to estimate and validate the transfer without broadcasting: 
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.