# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.sec3.dev/sec3-watchtower/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.