功能简介#
白名单用于集中管理经过团队确认的外部地址，并通过分组、标签与转账限制控制地址的使用范围。白名单积累的是地址的身份信息——这个地址属于谁、用于什么业务。处置逻辑由策略引擎决定：白名单可以作为策略的目标账户条件，例如要求非白名单地址的转账必须经过审批。此外，白名单还可以配合转账限制，直接约束转账时可选的收款地址。将地址加入白名单并不代表 DeepSafe 对该地址的真实性或安全性作出保证。 提交前仍需 通过独立、可信的渠道核验地址、链类型与归属方。本篇以 App 为例说明。Web Console 的字段与审批规则相同，从左侧导航栏进入白名单。使用前准备#
不同成员可见与可执行的操作由权限决定。若页面中没有添加、编辑、删除或转账限制的入口，通常是当前角色没有对应权限，请联系团队管理员检查权限配置。进入白名单#
在 App 底部导航栏点击「工作台」，然后点击「白名单」。列表展示每条记录的名称、链类型、地址、状态、分组与标签。顶部可进入转账限制，右上角可创建白名单。查找与筛选#
搜索：在列表顶部输入白名单名称或地址，系统实时显示匹配结果。筛选：点击搜索框右侧的筛选按钮，可按以下条件组合筛选。| 条件 | 可选项 |
|---|
| 链类型 | EVM、Bitcoin、Bitcoin Testnet3、Tron、Solana |
| 状态 | 已生效、待审批 |
| 分组 | 客户、内部钱包、供应商 |
| 标签 | 团队自定义的标签 |
选择后点击「确认」，清除已选条件点击「重置」。实际可选的分组与标签以团队当前配置为准。创建白名单#
在列表右上角点击添加按钮，填写以下信息后提交审批。| 字段 | 说明 |
|---|
| 名称 | 最多 30 个字符。建议填写可识别的业务名称，而非仅填平台名称 |
| 链类型 | 选择地址实际所属的网络。选择 EVM 时，适用于所有 EVM 兼容链的主网与测试网 |
| 地址 | 可手动输入或扫码录入 |
| 分组 | 按业务对象归类，如客户、内部钱包、供应商 |
| 标签 | 最多 3 个，可选择常用标签或新增标签 |
| 备注 | 最多 100 个字符。建议说明地址用途、归属方与核验方式 |
提交前请再次核对链类型与完整地址。提交后记录状态显示为「添加审批中」，审批通过 后转为「已生效」，地址才正式进入白名单。系统会校验地址格式是否与所选链类型匹配，并阻止重复添加已存在的地址。填写示例#
| 字段 | 示例 | 填写建议 |
|---|
| 名称 | 交易所入金账户 | 使用团队成员容易识别的名称 |
| 链类型 | EVM | 必须与地址实际网络一致 |
| 地址 | 0x28C6…1d60 | 提交前核对完整地址，不要只核对首尾字符 |
| 分组 | 客户 | 用于策略引用与列表筛选 |
| 标签 | 高频转账 | 补充业务属性，最多 3 个 |
| 备注 | 用于入金与流动性调拨 | 说明地址用途与适用场景 |
分组的用途不止于归类。 策略的目标账户条件可以按白名单分组配置，此后新加入该分组的地址会自动纳入对应策略的范围。合理规划分组可以显著减少策略的维护工作。查看详情#
基础信息：名称、链类型、地址、状态、分组、标签、备注、创建时间、更新时间与创建来源。创建来源标明该条目是在 App 还是 Web Console 中创建的。操作记录：已审批通过的创建与修改记录，以及修改前后的字段差异。处于「添加审批中」的记录尚未生效，暂不能进入详情页。修改白名单#
在列表中向左滑动目标记录，点击编辑按钮，修改名称、分组、标签或备注，提交审批并在确认弹窗中再次确认。提交后状态显示为「修改审批中」。审批通过后新内容生效；审批被拒绝时保留原有内容。链类型与地址创建后不可修改。 这两个字段共同确定链上目标，为避免同一地址在不同网络之间被错误复用，创建后即锁定。若填写错误，请删除原记录并重新创建。删除白名单#
在列表中向左滑动目标记录，点击删除按钮，阅读提示后提交审批。提交后状态显示为「删除审批中」。审批通过后，该地址从白名单中移除，并同步从交易策略引用的白名单范围中移除；审批被拒绝时，地址继续保留。删除前请确认没有正在执行或即将执行的交易依赖该地址。删除白名单不会删除该地址已有的历史交易记录。审批白名单变更#
白名单的新增、修改与删除均需按团队配置的决策模式完成审批。在 App 底部导航栏点击「审批」，进入「待处理」，选择「其他审批」，打开对应的申请。创建申请核对名称、链类型、完整地址、分组、标签与备注。申请人可在「审批 > 我发起的」中查看审批进度。对于仍在审批中的添加申请，也可在列表中左滑该记录取消申请，取消后该记录不会进入白名单。配置转账限制#
转账限制分为人工转账限制与 API 转账限制，两项独立设置、互不影响。人工转账限制开启后，通过 App 或 Web Console 人工创建转账时，只能选择已生效且网络匹配的白名单地址。API 转账限制开启后，通过 API 发起转账时，只能向已生效且网络匹配的白名单地址转账。开启与关闭的规则不对称#
开启：在转账限制页面开启对应开关，确认后立即生效。关闭：关闭对应开关后需提交审批，页面显示「关闭审批中」。审批通过前原有限制仍保持开启，审批通过后才允许向非白名单地址提交对应类型的转账。这一设计使收紧限制可以随时执行，放松限制则必须经过团队同意。某项限制处于审批中时，不能再次调整该项开关。在转账中使用白名单地址#
人工转账限制开启后，创建转账并选择接收地址时，进入白名单地址列表，可按名称、地址、分组或标签查找，选择与当前转账网络匹配且状态为「已生效」的地址，返回后核对地址、网络与金额再提交。处于「添加审批中」「修改审批中」「删除审批中」的记录不应作为有效地址的选择依据。若交易提交后接收地址被删除、分组发生变化或白名单限制发生变化，审批详情会提示当前状态与提交时状态的差异。 审批人应重新核验后再决定是否继续。 状态说明#
| 状态 | 含义 | 是否已按申请内容生效 |
|---|
| 已生效 | 地址已通过审批并进入白名单 | 是 |
| 添加审批中 | 新地址正在等待审批 | 否 |
| 修改审批中 | 修改正在等待审批 | 否，审批通过后更新 |
| 删除审批中 | 删除正在等待审批 | 否，审批通过后移除 |
| 关闭审批中 | 转账限制关闭申请正在等待审批 | 否，审批通过前仍保持开启 |
注意事项#
务必通过独立、可信的渠道核对完整地址，避免仅核对首尾字符；
链类型与地址必须匹配，相同资产在不同网络上的地址不可混用；
白名单仅代表团队允许使用该地址，不代表该地址不存在欺诈、制裁或其他链上风险；
分组会被交易策略引用，修改分组或删除地址前应先确认对现有策略的影响；
由于策略引擎采用默认拒绝，白名单覆盖范围收缩可能导致原本放行的交易被拦截；
只有「已生效」的记录才可作为稳定的白名单使用依据；
人工转账限制与 API 转账限制相互独立，请分别检查两项状态；
开启转账限制前，请确认日常业务涉及的收款地址都已加入白名单并审批通过。
Modified at 2026-08-25 08:03:19
