钱包代币过滤器

钱包余额过滤器用于选定链上钱包的代币余额，作为交易风控的约束对象，对钱包代币资产的流出行为进行控制。

---

一、过滤器定位

钱包代币过滤器用于对链上钱包所持有的代币资产进行风控约束。

与钱包余额过滤器仅控制原生资产不同，钱包代币过滤器专门作用于代币资产，用于限制代币的转出、授权或通过程序调用产生的资产变动。

该过滤器用于防止代币资产在不消耗本币余额的情况下被异常转移，是对钱包余额过滤器的重要补充，构成代币资产维度的核心安全控制。

---

二、作用对象

• 当前链上钱包所关联的所有代币账户（Token Account）
• 包括钱包直接持有或可控制的代币资产

---

三、参数说明

钱包代币过滤器支持基于代币白名单或黑名单的风控匹配策略，用于决定哪些代币资产需要纳入后续风控规则计算。

• 白名单模式（InList）

  • 当交易涉及的代币在配置列表中时，该代币资产将进入后续风控计算
  • 不在列表中的代币将被排除在本过滤器对应的风控范围之外

• 黑名单模式（NotInList）

  • 当交易涉及的代币在配置列表中时，该代币资产将被排除在后续风控计算之外
  • 列表之外的代币将进入后续风控计算

代币列表以代币 Mint 地址进行配置。

黑白名单模式不能同时生效。只能选定白名单模式（InList）或者黑名单模式（NotInList）

---

四、经典使用场景

• 限制单笔交易中代币资产的风控纳入范围
  • 例如：只有指定代币（白名单）才需要计算交易额限制
• 防止通过未授权代币绕过风控规则
  • 例如：黑名单代币不会进入风控计算，从而避免误判

---