Files
usdt/docs/wallet-address-management.md
T

22 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 地址管理统计与商户只读详情
管理员和商户地址列表提供总地址、启用地址、USDT/TRX余额及可用能量、带宽汇总。统计使用数据库最新快照,不表示查询时刻的链上余额;用户可在钱包详情点击“刷新链上数据”更新对应快照。
## 管理端统计接口
- 管理员:`GET /system/address/statistics`,权限 `system:address:list`。
- 商户:`GET /system/address/user/statistics`,权限 `system:address:user-list`,服务端强制使用当前用户ID。
- 入参复用地址列表的筛选字段,包括 `token`、`status`、`appId`、`userId`、`walletUserName`。商户传入的 `userId` 不生效。
- 响应 `data`:`total`、`enabled`、`usdtBalance`、`trxBalance`、`energy`、`bandwidth`。余额和资源合计返回字符串以保留精度。
- 列表和统计共享 SQL 条件,排除软删除记录,并保持既有的已分配钱包范围(`wallet_user_name is not null`),不包含未分配地址池。
## 操作与权限
两个列表移除修改、删除按钮及对应页面处理方法;已有新增入口和管理员导出保留。此页面调整不移除其他内部模块使用的服务方法,也不删除历史记录。
商户详情继续展示余额、账户、质押和代理信息,仅保留链上快照刷新操作,不显示资源估算、转账、质押、取消质押、代理、取消代理和广播。
上述资金及资源操作接口和估算接口要求独立 `system:address:operate` 权限;普通商户 `system:address:user-query` 不再授权这些接口。管理员操作角色如需执行,必须已有该权限。链上查询和代理详情继续允许查看权限,并执行钱包归属校验。
无需数据库结构或菜单迁移脚本。部署需同步更新前后端。