76 lines
7.1 KiB
Markdown
76 lines
7.1 KiB
Markdown
# 归集与代付资源租赁
|
|
|
|
## 启用与兼容
|
|
|
|
默认关闭:`USDT_RESOURCE_RENTAL_ENABLED=false`。关闭时保留原转账通道、燃烧预算、审核和账务结算行为,不查询新增资源表。此功能仅用于归集、代付,普通钱包操作不自动购买资源。
|
|
|
|
部署前备份数据库,依次执行 `sql/chain_executor.sql`、`sql/resource_rental.sql`。均为增量建表,不删除旧数据。后端与执行器必须共享同一数据库;远程模式还需按 [执行器说明](chain-executor.md) 部署执行器。不要在生产数据库上运行测试脚本。
|
|
|
|
支付后端外部配置:
|
|
|
|
```yaml
|
|
usdt:
|
|
resource-rental:
|
|
enabled: true
|
|
provider: INTERNAL # INTERNAL 或 DUIYA,仅影响尚未授权的新准备记录
|
|
arrival-timeout-seconds: 300
|
|
rental:
|
|
master-key: ${RENT_MASTER_KEY} # 外部注入的Base64编码32字节随机密钥
|
|
```
|
|
|
|
也可使用已接入的环境变量 `USDT_RESOURCE_RENTAL_ENABLED`、`USDT_RESOURCE_RENTAL_PROVIDER`、`USDT_RESOURCE_ARRIVAL_TIMEOUT_SECONDS`。所有支付实例的密钥必须一致;不要随意更换,原订单查询仍需要解密原配置。执行器只核验资源和签名,不需要平台API密钥或租赁加密密钥。
|
|
|
|
## 保存平台配置
|
|
|
|
管理员可在 `USDTmanage/usdtConfig` 全局配置页的“资源租赁平台”页签管理连接、租赁策略与费用上限,查看当前部署启用状态和最近100条版本记录。修改保存为新版本;API Key和Secret均不回显,修改时留空沿用原凭据。新增平台/网络必须填写完整凭据。页面操作沿用 `system:usdtConfig:edit` 权限。
|
|
|
|
使用已登录管理员的 `system:usdtConfig:edit` 权限调用 `POST /system/chain-resources/config`。凭据为只写字段,后端加密入库;每次保存新增配置版本,原订单始终使用其 `config_id`,切换平台不会重购原单。不要把实际密钥写入文档、命令行或日志。
|
|
|
|
自有平台请求示例(占位符须在受控配置客户端中替换):
|
|
|
|
```json
|
|
{
|
|
"provider": "INTERNAL",
|
|
"network": "NILE",
|
|
"baseUrl": "https://rental.example.com",
|
|
"apiKey": "<API Key>",
|
|
"apiSecret": "<API Secret>",
|
|
"durationSeconds": 3600,
|
|
"energyStep": 30000,
|
|
"bandwidthStep": 100,
|
|
"maxOrderCost": 10,
|
|
"maxExecutionCost": 20
|
|
}
|
|
```
|
|
|
|
`baseUrl` 为HTTPS站点根地址,自有平台适配器自动拼接 `/api/rental/v1`。自有租赁账户需要启用应用及API凭据、绑定当前网络的能量/带宽默认套餐并准备可用余额。`energyStep`、`bandwidthStep`、`durationSeconds` 必须匹配对应默认套餐的数量和周期倍数;不传 `package_id`。费用单位为USDT。
|
|
|
|
兑呀使用 `provider=DUIYA`、`network=MAINNET`、`baseUrl=https://weidubot.cc/api/v2`,按需设置 `energyPeriod`(默认`1h`)、`bandwidthPeriod`(默认`1day`)。费用单位为TRX;能量最低30000、带宽最低100,按配置步长向上取整。使用资源订单 `buy_energy/buy_net`,不调用速充接口。公开文档未确认测试网支持,DUIYA的NILE请求会被拒绝。
|
|
|
|
每类资源检查 `maxOrderCost`,每个业务准备检查 `maxExecutionCost`;人工额外受页面确认的报价上限限制。归集各地址独立计费。这里没有每日总费用额度,部署时按业务量设置单笔上限和平台余额。兑呀创建接口未提供锁价字段,预估费用无法替代平台最终扣费,首次上线需小额核对实际计价。
|
|
|
|
## 操作流程
|
|
|
|
人工执行:在归集/代付页面选择“手动输入配置密码”,点击执行后先展示实时资源和报价。可选择租赁,或沿用原转账规则。确认租赁仅购买缺口;页面只读轮询,支付后端独立查询链上,必须能量、带宽均足额才显示密码输入。输入密码并确认广播后,签名前再次核验。资源已足额时不购买。密码不持久化、不交给资源Worker,关闭弹窗不会自动转账。
|
|
|
|
远程执行:提交业务后保持原执行中状态;支付后端资源Worker为远程排队指令自动准备资源。执行器资源未就绪时仍保持QUEUED,不解锁钱包,不签名;就绪后复检、构造并签名一次,持久化后广播。等待期间的状态和错误显示在“最近执行记录”中。原转账授权有效期仍为10分钟,资源等待不会无限延长授权。
|
|
|
|
链上查询失败不是资源为零,不会因此付费。租赁平台返回成功或交付成功均不能证明可用资源满足,只有支付系统读取指定网络的实时 `limit-used` 并重新估算本次操作,才会置为READY。估算失败拒绝购买,不使用页面的默认能量兜底值。
|
|
|
|
## 防重复与恢复
|
|
|
|
- 同一业务唯一准备记录;同一次准备每类资源唯一订单。本地CREATED→SUBMITTING的数据库CAS是实际付费调用屏障,浏览器、多个后端实例、进程重启均复用原单。
|
|
- 创建请求禁止HTTP自动重试和重定向。超时/响应丢失/进程中断保留SUBMIT_UNKNOWN,不回到CREATED。自有平台可按原商户单号只读核对;兑呀未文档化商户幂等号,结果未知必须人工核对平台账单,不能自动重下。
|
|
- 等待超时显示TIMEOUT,可点“继续检查原单”;此操作只延长到账检测,不新建租赁订单、不更换平台、不延长转账授权。关闭页面后服务仍继续检查,重新打开复用原记录。
|
|
- REVIEW阻止转账,即使地址后来资源足额也不会绕过未知/失败租赁订单;需运维核实原单。当前版本不提供自动补租第二轮或清除未知订单的按钮,避免重复扣费。已确定交付但资源仍不足时,可继续原单检测或由管理员从其他渠道补充资源,不自动再购买。
|
|
- 同网络同发送钱包独占准备,主钱包代付按地址串行。签名后占用不按超时回收,只有链上收据确认资源已消耗才释放。已明确链上失败的原交易可复用原租赁资源重新预检,不自动重租。
|
|
- 已租赁但尚未执行的准备保留地址占用,关闭弹窗不释放,也不撤销已付费订单。管理员应完成原操作或核对异常后处理;不要直接删除准备/订单/地址占用表记录。
|
|
|
|
业务审核、代付冻结与最终链上确认结算沿用原实现。租赁费用由平台账户支付,不混入商户USDT本金结算。一个归集地址失败不终止其他地址的后端准备,但人工批次需全部资源就绪才允许输入密码;可先取消尚未执行且无需继续的明细,再预检剩余明细。
|
|
|
|
## 验证范围
|
|
|
|
隔离H2测试使用真实增量SQL和可控链上/平台替身,覆盖并发唯一订单、延迟到账、两类资源分别到账、签名前回落、未知结果不重下、超时续查、原平台配置引用、费用上限和同地址互斥。既有链上执行与独立执行器启动测试继续运行。前端使用实际Vue/Element组件的模拟接口检查桌面1200px和窄屏390px,验证刷新不重复购买、到账前不展示密码、确认后才执行。
|
|
|
|
未进行真实钱包签名、真实平台扣费或生产数据库升级。上线需先配置自有平台NILE环境进行受控联调;DUIYA需在主网小额核对凭据、周期、扣费和代理到账。
|