SendingNetwork
  • OVERVIEW
    • Getting Started
    • FAQs
  • Network Instructional Articles
    • Basics
      • Introducing the Edge, WatchDog, and Guardian Nodes
      • Overview
      • Messaging Solution
      • Privacy Solution
      • Rich Communication Solution
      • Multi-Platform Solution
      • Decentralized Identity
      • Multiple Chat Modes
      • How It Works
      • Token Utility
      • The Team
    • Key Concepts
      • Decentralized Identity
      • Social Graphs
      • Edge Node
  • SDK Documentation
    • Glossary
    • JavaScript client SDK
      • DID
      • User
      • Message
      • Room
      • Contact
      • Social Graph
    • iOS client SDK
      • Push
      • DID
      • User
      • Message
      • Room
      • Contact
    • Android client SDK
      • User
      • Room
    • Java SDK
      • DID
      • Room
      • Message
    • Node.js SDK
      • DID
      • Room
      • Message
    • Unreal SDK
      • DID
      • User
      • Message
      • Room
    • Unity SDK
      • DID
      • Room
      • Message
    • Website chat widget SDK
      • Customization
      • DID
      • User
      • Room
      • Message
      • Other
    • Bot SDKs
      • Golang Bot SDK
        • DID
        • User
        • Room
        • Message
    • Extensible Message Interface
    • Push Notifications
    • Flutter SDK
      • DID
      • User
      • Message
      • Room
    • PHP SDK
      • DID
      • Room
      • User
    • Developer Key
  • Acquisition Kit
    • Social Boost Development Instructions
  • WatchDog Agent
    • WatchDog Agent Guide
    • WatchDog Agent Deployment Tutorial
      • Linux Deployment Tutorial
    • One-Click Deployment
  • Edge Node
    • Edge Node Deployment Tutorial
    • VPS Setup Guide
      • Google Cloud Platform (GCP)
      • Amazon Web Services (AWS)
      • Contabo
    • Check Node Stats with Auto-Reply Bot in SendingMe App
    • Alpha-3 Testnet FAQs
  • delegation node
    • Delegation Node Deployment Tutorial
  • Private Delegation Node
  • Use Cases
    • Wallet-to-Wallet Messaging
    • Dapp Notifications
    • Identity Verification
    • Gamer Acquisition
    • Cross-platform Trading
Powered by GitBook
On this page
  • Minimum System Requirements
  • WatchDog Agent Deployment
  • Next Steps
  • Troubleshooting
  • Error: Unable to start WatchDog agent
  1. WatchDog Agent

WatchDog Agent Deployment Tutorial

PreviousWatchDog Agent GuideNextLinux Deployment Tutorial

Last updated 19 days ago

In this guide, we'll walk you through the process of setting up your own SendingNetwork WatchDog agent. act as supportive validators that produce evidence for . This is crucial for assessing the relay availability of within the network. Operating as ordinary messaging clients, WatchDog agents randomly select Edge nodes to relay challenge messages and earn rewards based on their challenge activities. Your SendingNetwork Experience Points (SXP) will be linked to your wallet address that contains the WatchDog license NFT.

For more information about the agents and network architecture, please refer to .

Minimum System Requirements

Before diving into the setup process, let's make sure your system meets the necessary requirements to run a WatchDog agent efficiently. Here's what you'll need:

  • Hardware:

    • CPU: A CPU with ARM or x86-64 architecture is required. While a dual-core processor is the minimum, we recommend a quad-core or higher for the best performance.

    • Memory: At least 4GB of RAM.

    • Storage: A minimum of 100GB of free space. SSDs are preferred over HDDs for faster data access and better performance.

  • Operating System:

    • Recommended: Linux (Ubuntu 20.04 LTS)

    • Optional: MacOS 12.0 or above

  • Network:

    • Always-on 100 Mbps internet with a minimum 100 GB monthly data plan.

WatchDog Agent Deployment

WatchDog agents function like ordinary messaging clients that send and receive messages, so they do not require a public IP address like Edge nodes do. While they can be run on a laptop or PC, we recommend setting it up on a VPS for better stability.

Next Steps


Troubleshooting

Error: Unable to start WatchDog agent

There are several reasons why you might encounter this error:

  1. No WatchDog License NFT detected.:

    • Log Message:

      Unable to start WatchDog agent.
      Please use a wallet address that contains the license NFT.
    • Solution: Ensure you are using the correct wallet address that purchased the WatchDog license NFT.

  2. Restricted Area Deployment:

    • Log Message:

      Unable to start WatchDog agent.
      Agent services are not supported in your country or region.
    • Solution: Mining is not supported in mainland China and some places. Please make sure you are deploying the agent from a supported location.

  3. Node Count Exceeds NFT Quantity:

    • Log Message:

      Unable to start WatchDog agent.
      Only one WatchDog agent can be run per WatchDog license NFT.
    • Solution: Only one active agent is allowed at a time per license NFT. If you run a second agent in a new location while the original one is still active, you will see this error. To run a new node in another location (such as a different directory or machine), follow these steps:

      1. Stop the current agent according to the stop agent instructions.

      2. Wait for 10 minutes.

      3. Start the new agent in the desired location.

      4. This will create a new agent ID, and points will be accrued with this new ID. Previous points will remain valid under the original agent ID.

  4. Running the installation script with sudo:

    • Log Message:

      Please input your wallet address: ./watchdog_mac.sh: line 17: read: read error: 0: Input/output error
      your wallet: 
      Killed: 9
      ...
      Watchdog agent failed to start. Please do not run the script with 'sudo'.
    • Solution: If you are running the script directly, please do NOT run it with sudo as it will impact the agent daemon process. Instead, you can run it under a common user account, or by using sudo su or the root account.

      For Linux, run the script with the following command:

      ./watchdog_linux.sh

      For macOS, run the script with the following command:

      ./watchdog_mac.sh

You may deploy the agent on a Virtual Private Server (VPS) with a Linux operating system. For details about setting up the VPS, see . You don't need to configure any specific firewall policy for any ports for running watchdog agent.

Please refer to our tutorials below for deploying WatchDog agents. Should you encounter any issues or have questions, refer to the section at the end of this tutorial or seek support from the SendingNetwork . Check our docs for common questions.

After finishing the installation, interact with our auto-reply bot on the SendingMe app to check your agent's stats. SendingMe is an all-in-one web3 instant messaging app built on top of SendingNetwork. Refer to for instructions on utilizing the bot to monitor your agent's performance.

Should you encounter any issues or have questions, don't hesitate to seek support from the SendingNetwork .

VPS setup guide
Linux Deployment Tutorial
Check Node Stats with Auto-Reply Bot in SendingMe
community
community
FAQ
troubleshooting
Introducing the Edge, WatchDog, and Guardian Nodes
WatchDog agents
proof of availability
Edge nodes