# Value Bot 监控

### Value Bot 监控是什么？

Value Bot 监控是针对数值变化而设计的一种监控类型。主要功能是监控某个对象的数值变化，当数值变化达到预设的阈值时，将会触发报警。

### Value Bot 监控典型场景

1. 监控 Token 余额变化
2. 监控 Curve 稳定币占比百分比的变化

#### 支持的数据源

| 数据源           | 类型       | 稳定性 |
| ------------- | -------- | --- |
| Ethereum      | on chain | 极高  |
| BSC           | on chain | 高   |
| Avalanche     | on chain | 高   |
| Polygon Pos   | on chain | 高   |
| Arbitrum      | on chain | 高   |
| Optimism      | on chain | 高   |
| Polygon zkEVM | on chain | 高   |
| ZkSync Era    | on chain | 高   |
| Base          | on chain | 高   |
| Scroll        | on chain | 高   |
| Manta         | on chain | 高   |
| ZKFair        | on chain | 高   |
| Blast         | on chain | 高   |
| Linea         | on chain | 高   |
| B2            | on chain | 高   |
| Merlin        | on chain | 高   |

### 如何配置 Value Bot 监控？

登录 ChainBot 平台后，右上角 "Create Bot" -> "Value Monitor"。

<figure><img src="https://269759277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoG8PqN7GJCejgjqG74o%2Fuploads%2FGy2IQya1DIXlNXmHqoT6%2Fcreate-value-monitor.png?alt=media&#x26;token=e31f0eb2-b1d4-4848-80ca-f3919ed3ca91" alt=""><figcaption><p>Create a Value Bot</p></figcaption></figure>

**Info 说明**

<table><thead><tr><th width="183.33333333333331">字段名</th><th width="280">说明</th><th>是否必填</th></tr></thead><tbody><tr><td>Name</td><td>Bot 监控名</td><td>是</td></tr><tr><td>Chain</td><td>选定的 Chain</td><td>是</td></tr><tr><td>Contract</td><td>选定的智能合约地址</td><td>是</td></tr><tr><td>Function</td><td>选定的智能合约的方法</td><td>是</td></tr><tr><td>Interval</td><td>数据打点间隔，即每隔 interval 的时间，拉取一次配置的数据源的数据</td><td>是</td></tr><tr><td>Baseline Trigger</td><td>若勾选此项，则触发条件作为基线，当数值达到基线，后续满足条件也不会重复触发。只有离开基线后再次回归，才会再次触发。</td><td>是</td></tr><tr><td>Fields</td><td>需要处理的数值字段</td><td>是</td></tr><tr><td>Tags</td><td>Bot 监控 tags，利于搜索</td><td>是</td></tr></tbody></table>

#### Fields 说明

> 由多个 Field 字段组成，单独的 Field 是个对象，包含 field, formater 的类型。其中 formater 是
>
> 一段 js 代码，用户需要自己定义格式化最终数值的代码。

#### 内置的函数

<table><thead><tr><th width="305">Function Name</th><th>说明</th></tr></thead><tbody><tr><td>tokenPrice(symbol)</td><td>获取 token 的U本位价格，例如 tokenPrice('weth')</td></tr><tr><td>bot(botId)</td><td>引用特定的 Bot 的内容，例如 bot('1')</td></tr><tr><td>add(x,y)</td><td>x+y</td></tr><tr><td>sub(x,y)</td><td>x-y</td></tr><tr><td>mul(x,y)</td><td>x*y</td></tr><tr><td>div(x,y)</td><td>x/y &#x26;&#x26; y != 0</td></tr><tr><td>pow(x,y)</td><td>x^y</td></tr></tbody></table>

#### 支持的 U 计价的币种

> 自动获取 token U 本位价格，数据源来自链上流动性最高的交易对，后续将会支持更多的Token。

| Token  | Pool                                                                                      |
| ------ | ----------------------------------------------------------------------------------------- |
| WBTC   | [WBTC/BUSD](https://bscscan.com/address/0xF45cd219aEF8618A92BAa7aD848364a158a24F33)       |
| WETH   | [WETH/USDT](https://etherscan.io/address/0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852)      |
| WBNB   | [WBNB/BUSD](https://bscscan.com/address/0x58F876857a02D6762E0101bb5C46A8c1ED44Dc16)       |
| WMATIC | [WMATIC/USDC](https://polygonscan.com/address/0x6e7a5FAFcec6BB1e78bAE2A1F0B612012BF14827) |
| WAVAX  | [WAVAX/USDC](https://snowtrace.io/address/0xf4003F4efBE8691B60249E6afbD307aBE7758adb)     |
| WFTM   | [WFTM/USDC](https://ftmscan.com/address/0x2b4c76d0dc16be1c31d4c1dc53bf9b45987fc75c)       |
| CAKE   | [CAKE/USDC](https://bscscan.com/address/0xa39af17ce4a8eb807e076805da1e2b8ea7d0755b)       |

**Conditions 说明**

conditions 中的字段解析是动态的，会跟随配置的 Fields 的内容变化。其中 Condition 的 Key 为 Field 的内容，二者保持一致。condition 中的 value 为用户设置的阈值，最后比较的时候会使用 Field formater 后的 value 和 condition 中的 value 比较，因此用户在配置时，需要注意单位换算。

**模板变量说明**

| $subscription.name | 订阅名称，一般和 Bot 监控同名                     |
| ------------------ | ------------------------------------- |
| $block.height      | 区块高度                                  |
| $value.{}          | formater 后的数值，为动态解析，比如 $value.balance |
| $condition         | 所有 condition 内容专为字符串                  |
| $alert.time        | 区块时间                                  |

#### 默认告警模板

```
[{$bot.name}]
Block: {$block.height}
Values:{$value.values.ltv}
Condition: {$value.condition}
Time: {$alert.time}
```

[了解告警通知模板？](https://docs.chainbot.io/zh/advanced-features/alarm-notification-template)

#### 通知消息示例

> \[ENS Governance ETH Balance > 35000 ETH]
>
> Block: 16046035
>
> Balance: 35335.915888
>
> Condition: (5m) balance last > 35000
>
> Time: 2022-11-25T17:14:30+08:00
>
> Created By [ChainBot.io](https://www.chainbot.io)

#### Value Bot 监控案例

[value-bot-demo](https://docs.chainbot.io/zh/bot-case/value-bot-demo "mention")