跳到主要内容

传递地址余额过滤器

传递地址余额过滤器用于对交易中涉及的传递账号（Accounts）所持有的原生资产余额进行风控判断，以防止资产通过交易间接流出。

一、过滤器定位​

该过滤器是资产过滤体系中用于控制交易中传递账号的本币余额的安全机制。
它可以限制交易过程中，非钱包直接持有账户的资产变动，防止通过传递账号绕过钱包余额过滤器的风险。

  • 解决的问题：交易中间接账户可能带走资产
  • 与钱包余额过滤器的区别：钱包余额过滤器只控制直接钱包余额，传递地址余额过滤器控制间接账户余额

二、作用对象​

  • 交易中涉及的传递账号列表（Accounts）
  • 这些账号的原生资产余额（如 SOL）

注意：只关注本币余额，不涉及 Token 资产（Token 由传递账号 Token 过滤器控制）。

三、参数说明​

传递账号过滤器支持基于账户白名单或黑名单的风控匹配策略，用于决定交易中哪些传递账号需要纳入后续风控计算。

  • 白名单模式（InList）

    • 仅将列表中的传递账号纳入后续风控计算
    • 不在列表中的账号将被排除在本过滤器对应的风控范围之外

  • 黑名单模式（NotInList）

    • 列表中的传递账号将被排除在后续风控计算之外
    • 不在列表中的账号将进入后续风控计算

账户列表以链上账户公钥（Pubkey）进行配置。

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

四、经典使用场景​

  • 防止交易中间接账户（非钱包本身）携带大量资产进行交易
  • 结合钱包余额过滤器使用，形成全维度本币资产约束
  • 在多签、程序调用等复杂交易中，确保传递账号的余额不会绕过风控规则

五、说明​

  • 过滤器本身不决定交易是否成功，只决定传递账号是否纳入后续风控计算
  • 通常与传递账号 Token 过滤器配合使用，以保证本币与代币资产都被有效控制