> For the complete documentation index, see [llms.txt](https://doc.sec3.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.sec3.dev/sec3-watchtower/quick-start.md).

# Quick Start

{% hint style="info" %}
**WatchTower is an in-situ security threat monitoring service for smart contracts to detect and alert security attacks in near real-time.**

**WatchTower deploys "bots" to extract and analyze real time on-chain data to screen suspicious transactions that may expose security risks or prelude hacks.**

**WatchTower is brought to you by Sec3, a security and research firm providing bespoke audits and cutting edge tools to Web3 projects.**
{% endhint %}

**WatchTower offers a number of features:**

* A user interface for users to add, customize, deploy, stop bots, and examine alerts in a dashboard.
* A set of built-in "bots", based on security analysis logic and domain knowledge to help detect specific signs of security risks, such as abnormal token transfers, abnormal payloads, etc.

## Getting Started

### 1. Create Project

On the sidebar of the dashboard, click "**WatchTower**".

<figure><img src="/files/2PyrwlI2zEyl8F2IoJeH" alt=""><figcaption></figcaption></figure>

Click "**Add a new project**", and give your project a name.

<figure><img src="/files/wIS2cOxfRPxtdzYTWCCa" alt=""><figcaption><p>Add a new project</p></figcaption></figure>

Click "**Add an address**"

<figure><img src="/files/hkp1fKfCkwvuADe3Mw5A" alt=""><figcaption><p>Add an address</p></figcaption></figure>

Then, add the address(es) of your smart contract.

<figure><img src="/files/ScRbPfXcntNGoQ3L1WEi" alt=""><figcaption><p>Add an address</p></figcaption></figure>

### **2. Add bots**

After an address is added, the address will appear on the **Projects** sidebar.

To add a bot, click "**Add Bot**" in the address config menu or "**New Bot**" button on the dashboard

<figure><img src="/files/XDVnpouTYZmPCzV2Edip" alt=""><figcaption><p>Add a bot</p></figcaption></figure>

Next, choose a bot from the list of bots, for example, solana\_abnormal\_transfer\_sol, which is designed to watch and alert abnormal size transactions in SOL.

<figure><img src="/files/SsuT1u6lwT7aJkGx8kUc" alt=""><figcaption><p>Choose bot type</p></figcaption></figure>

Next, customize the bot:

<figure><img src="/files/CXiMFEAGoHfb6CGUAjbM" alt=""><figcaption><p>Config the bot</p></figcaption></figure>

#### 1) Name the bot (mandatory)

A human-friendly name for the bot.

#### 2) Target Address(es) to be monitored (mandatory)

This is usually the address for a smart contract or an account.

#### 3) Severity level (mandatory)

Each bot has a default severity level (*medium* in this case), but the user can configure a different severity level.

#### 4) Alert destinations (optional)

Select the ways you wish the alert to be sent. For details about setting up alert destinations, see

{% content-ref url="/pages/x9CGpbiZYjKa8wj00RlX" %}
[Alert Destinations](/sec3-watchtower/alert-destinations.md)
{% endcontent-ref %}

#### 5) Bot specific parameters (optional)

In this case, an alert threshold for the transfer (optional, default 100 for the solana\_abnormal\_transfer\_sol bot).

For the complete list of bot types and their parameters, see&#x20;

{% content-ref url="/pages/JSMQZtMSgpjnEqf7us9g" %}
[Bots](/sec3-watchtower/bots.md)
{% endcontent-ref %}

After the setup is completed, click "**Create bot**". Now the bot is created and running!

Note: If your bot continuously generates many alerts, it may be forced to stop. Too many alerts bring down the signal-to-noise ratio and make the monitoring less efficient. You will need to tune your bot parameters and try again.

### 3. View Alerts

On the **Alerts** tab in the dashboard, you can view the alerts generated by the bots. The detail of the alert can be expanded by clicking the alert.

<figure><img src="/files/w6F8oudOMSxGnwfzt4tc" alt=""><figcaption><p>Alerts</p></figcaption></figure>

Clicking an alert will expand the alert's details.

<figure><img src="/files/r2fx2uauXFh94dmZqEQB" alt=""><figcaption><p>Alert Details</p></figcaption></figure>

### 4. Manage Projects & Bots

To manage a project, click the [⚙️](https://prod.emojipedia.org/gear/) icon next to the project name. You can edit the project name, add address or delete the project. Managing an address is similar.

<figure><img src="/files/xeC9Vp4qIxLgvnVs4hPC" alt=""><figcaption><p>Manage project</p></figcaption></figure>

To manage a bot, navigate to the Bots panel, where you can check and change the status of the bot. Clicking a bot opens the editing box.

<figure><img src="/files/8SBDWZ1mItkZv4eHk0fN" alt=""><figcaption><p>Manage bots</p></figcaption></figure>