固定转入 1 TRX,费用为“本金折价 USDT + 固定服务费”。
下单冻结资金,链上独立确认后扣款并记录供应商收入。 支持 NILE、主网独立配置;未知交易不退款、不重复构建。 已补充清晰注释、分阶段脱敏日志和已确认交易哈希展示。
This commit is contained in:
1 parent
1286f0df81
commit
fbc72b5b57
24 files changed
+851
-27
No files matched your search
+22
-14
@@ -7,6 +7,8 @@
|
||||
-- 采用逻辑外键,应用负责父记录归属、网络、金额非负、状态机及同事务一致性;MySQL5.7不强制CHECK。
|
||||
-- 钱包按ENERGY/BANDWIDTH分别维护SUN额度、保留量和预留;同类型任务预留同事务,禁止跨类型挪用。
|
||||
-- resource_type无默认值且必须显式校验:ENERGY数量单位Energy、BANDWIDTH数量单位bytes;链上类型分别1和0。
|
||||
-- 地址上链扩展:order_type=ADDRESS_ONCHAIN,任务TRANSFER_TRX,分类TRX,不走资源换算或回收。
|
||||
-- 地址上链固定1TRX,USDT本金折价及服务费按网络配置并锁定快照;旧库执行rent_address_onchain_migration.sql。
|
||||
-- 委托接口只提交质押等值本金SUN,不直接提交Energy/bytes;请求量加正冗余后按当前全网参数换算,TRX向上取整。
|
||||
-- 不使用DROP/ALTER,不是旧版53表升级脚本;IF NOT EXISTS不能将旧表升级成V2。
|
||||
-- 业务规则及流程图详见docs/rental/schema-design.md,简化范围为本版设计选择,未执行数据库变更。
|
||||
@@ -63,6 +65,7 @@ CREATE TABLE IF NOT EXISTS `rent_nonce` (
|
||||
|
||||
-- 供应商本地Agent节点;供应商直接关联共享用户,不另建成员表
|
||||
CREATE TABLE IF NOT EXISTS `rent_node` (
|
||||
`transfer_enabled` TINYINT NOT NULL DEFAULT 0 COMMENT '认证Agent同步的固定1TRX转账能力及本地授权;旧Agent默认为关闭',
|
||||
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
|
||||
`user_id` BIGINT NOT NULL COMMENT '供应商sys_user.user_id',
|
||||
`node_no` VARCHAR(64) NOT NULL COMMENT '节点全局编号',
|
||||
@@ -207,19 +210,24 @@ CREATE TABLE IF NOT EXISTS `rent_order` (
|
||||
`app_id` BIGINT NOT NULL COMMENT 'rent_app.id',
|
||||
`merchant_order_no` VARCHAR(64) NOT NULL COMMENT '商户订单号,兼作业务幂等键',
|
||||
`request_hash` VARCHAR(64) NOT NULL COMMENT '原请求规范化摘要,同编号不同内容拒绝',
|
||||
`package_id` BIGINT NOT NULL COMMENT 'rent_package.id',
|
||||
`package_id` BIGINT NULL COMMENT '资源订单关联rent_package.id;地址上链为空',
|
||||
`order_type` VARCHAR(24) NOT NULL DEFAULT 'RESOURCE_RENTAL' COMMENT 'RESOURCE_RENTAL资源租赁、ADDRESS_ONCHAIN固定1TRX转账',
|
||||
`transfer_sun` BIGINT NULL COMMENT '地址上链固定1000000 SUN;资源租赁为空',
|
||||
`trx_price_usdt` DECIMAL(30,12) NULL COMMENT '1TRX兑换USDT的配置汇率快照',
|
||||
`principal_usdt` DECIMAL(30,6) NULL COMMENT 'TRX本金折价USDT,向上取6位',
|
||||
`service_fee_usdt` DECIMAL(30,6) NULL COMMENT '当前网络固定服务费USDT快照',
|
||||
`billing_mode` VARCHAR(16) NOT NULL DEFAULT 'DURATION' COMMENT '计费模式快照:DURATION或PER_ORDER',
|
||||
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
|
||||
`receiver_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '资源接收者,TRON Base58Check地址',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT '套餐资源类型快照:ENERGY能量、BANDWIDTH带宽,订单创建后不可修改',
|
||||
`resource_quantity` BIGINT NOT NULL COMMENT '套餐资源数量快照:ENERGY单位Energy、BANDWIDTH单位bytes,必须大于零',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT 'ENERGY能量、BANDWIDTH带宽;地址上链分类TRX,创建后不可修改',
|
||||
`resource_quantity` BIGINT NOT NULL COMMENT '资源订单数量必须大于零;地址上链为0,转账金额见transfer_sun',
|
||||
`redundancy_percent` DECIMAL(10,4) NOT NULL COMMENT '订单锁定冗余百分数,必须大于0,不能被套餐后续改价或调参覆盖',
|
||||
`target_resource_quantity` BIGINT NOT NULL COMMENT '含冗余最低交付目标max(请求量+1,ceil(请求量乘以(1+冗余百分数/100))),严格大于resource_quantity',
|
||||
`duration_seconds` INT NOT NULL COMMENT '租期秒快照',
|
||||
`duration_seconds` INT NOT NULL COMMENT '资源租期秒快照;地址上链为0无租期',
|
||||
`sale_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT 'USDT售价快照',
|
||||
`supplier_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '供应商扣费前毛收入USDT快照,不能因费率变更被覆盖',
|
||||
`supplier_fee_percent` DECIMAL(7,4) NOT NULL COMMENT '订单锁定供应商手续费百分数,必须大于0小于100',
|
||||
`supplier_fee_amount` DECIMAL(30,6) NOT NULL COMMENT '平台手续费USDT快照=毛收入乘费率除100,按6位小数HALF_UP;必须大于0且小于毛收入',
|
||||
`supplier_fee_percent` DECIMAL(7,4) NOT NULL COMMENT '平台分成百分数快照;资源订单按毛收入,地址上链按服务费且允许0至100',
|
||||
`supplier_fee_amount` DECIMAL(30,6) NOT NULL COMMENT '平台收入USDT快照=计费基数乘百分比除100保留6位;地址上链以service_fee_usdt为基数,本金不分成',
|
||||
`supplier_net_amount` DECIMAL(30,6) NOT NULL COMMENT '供应商净应收USDT快照=供应商毛收入减平台手续费,必须大于0,结算以此为基数',
|
||||
`supplier_reversed_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '已冲正供应商净应收USDT累计,不超过supplier_net_amount,按审核退款规则追加流水',
|
||||
`supplier_fee_reversed_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '已退回或冲正平台手续费USDT累计,不超过supplier_fee_amount,不因退款自动推定全退',
|
||||
@@ -236,7 +244,7 @@ CREATE TABLE IF NOT EXISTS `rent_order` (
|
||||
`dispatch_deadline` DATETIME(3) NOT NULL COMMENT '创建时锁定的最晚新任务执行时间UTC;WAITING超时取消,已投递不能仅凭过期判未执行',
|
||||
`service_started_at` DATETIME(3) NULL COMMENT '已独立核验委托交易所在区块的UTC时间,不使用核验完成时间延长租期',
|
||||
`service_expires_at` DATETIME(3) NULL COMMENT '业务租期结束,不等于自动回收,UTC',
|
||||
`reclaim_status` VARCHAR(24) NOT NULL COMMENT '回收:NOT_STARTED、WAITING、RUNNING、RECOVERING、DONE、MANUAL_REVIEW',
|
||||
`reclaim_status` VARCHAR(24) NOT NULL COMMENT '回收:NOT_STARTED、WAITING、RUNNING、RECOVERING、DONE、MANUAL_REVIEW;地址上链NOT_REQUIRED',
|
||||
`next_reclaim_at` DATETIME(3) NULL COMMENT '下次到期或资源恢复核对,UTC',
|
||||
`notify_url` VARCHAR(512) NULL COMMENT '该单回调URL快照,允许为空',
|
||||
`error_code` VARCHAR(64) NULL COMMENT '稳定错误码',
|
||||
@@ -266,18 +274,18 @@ CREATE TABLE IF NOT EXISTS `rent_task` (
|
||||
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '与订单钱包及实际链上交易一致的网络,纳入HMAC',
|
||||
`source_transaction_id` BIGINT NULL COMMENT 'RECLAIM必须指向原已确认DELEGATE的rent_transaction.id;DELEGATE为空,不允许回收任务引用回收交易',
|
||||
`wallet_execution_slot` TINYINT NULL DEFAULT 1 COMMENT '同钱包同资源类型最多一个在途链上操作;未知保留1,终结且写入快照屏障后置NULL;与订单地址对占位独立',
|
||||
`task_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM回收,不支持转账',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT '资源类型:ENERGY或BANDWIDTH,必须与订单及链上交易一致并纳入HMAC',
|
||||
`task_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM回收、TRANSFER_TRX固定1TRX转账',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT 'ENERGY或BANDWIDTH;TRANSFER_TRX为TRX,必须与订单及链上交易一致并纳入HMAC',
|
||||
`resource_quantity` BIGINT NOT NULL COMMENT '本任务资源数量快照:ENERGY单位Energy、BANDWIDTH单位bytes,不得跨类型换算',
|
||||
`target_resource_quantity` BIGINT NOT NULL COMMENT '原订单含冗余目标快照;委托必须覆盖该量,回收任务仅用于追溯原委托目标',
|
||||
`conversion_total_limit` BIGINT NOT NULL COMMENT '换算时该资源全网总额度:ENERGY为Energy,BANDWIDTH为质押带宽bytes,必须大于0',
|
||||
`conversion_total_weight` BIGINT NOT NULL COMMENT '换算时该资源全网总权重,单位为协议TRX权重,不能当作SUN;必须大于0',
|
||||
`conversion_total_limit` BIGINT NOT NULL COMMENT '资源换算全网总额度必须大于0;TRANSFER_TRX为0,不进行资源换算',
|
||||
`conversion_total_weight` BIGINT NOT NULL COMMENT '资源换算全网TRX权重必须大于0;TRANSFER_TRX为0,不进行资源换算',
|
||||
`conversion_block_height` BIGINT NOT NULL COMMENT '可信换算查询对应区块高度,结合时间检查快照有效期',
|
||||
`conversion_at` DATETIME(3) NOT NULL COMMENT '本次换算参数查询UTC时间,Agent签名前必须重新检查参数及额度',
|
||||
`estimated_resource_quantity` BIGINT NOT NULL COMMENT '按本次换算参数和delegate_sun向下计算的资源量,委托任务必须不小于target_resource_quantity',
|
||||
`attempt_no` INT NOT NULL COMMENT '同订单同类型的尝试序号',
|
||||
`active_slot` TINYINT NULL DEFAULT 1 COMMENT '有效或已成功取1,仅明确未执行失败可置NULL;UNKNOWN不得释放',
|
||||
`delegate_sun` BIGINT NOT NULL COMMENT '委托本金SUN=ceil(目标资源量乘全网权重除全网额度)乘1000000,TRX向上取整;回收取原确认本金,禁止重新按资源量换算',
|
||||
`delegate_sun` BIGINT NOT NULL COMMENT '原生操作本金SUN;委托按目标资源换算、回收取原确认本金;TRANSFER_TRX固定1000000',
|
||||
`fee_limit_sun` BIGINT NOT NULL COMMENT '本地操作费用预算SUN;按当前网络费用、签名权限及资源评估,不作为协议fee_limit硬上限',
|
||||
`credential_id` BIGINT NOT NULL COMMENT '目标节点rent_credential.id',
|
||||
`nonce` VARCHAR(64) NOT NULL COMMENT '任务防重放随机数',
|
||||
@@ -318,8 +326,8 @@ CREATE TABLE IF NOT EXISTS `rent_transaction` (
|
||||
`tx_id` VARCHAR(64) NOT NULL COMMENT '链上交易哈希',
|
||||
`owner_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '实际资源owner,TRON Base58Check地址',
|
||||
`receiver_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '实际receiver,TRON Base58Check地址',
|
||||
`transaction_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM撤销',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT '实际链上资源类型:ENERGY对应resource_code=1、BANDWIDTH对应resource_code=0,独立核验',
|
||||
`transaction_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM撤销、TRANSFER_TRX原生固定1TRX转账',
|
||||
`resource_type` VARCHAR(16) NOT NULL COMMENT 'ENERGY对应resource_code=1、BANDWIDTH对应resource_code=0;原生转账分类TRX无资源码',
|
||||
`amount_sun` BIGINT NOT NULL COMMENT '链上实际本金SUN',
|
||||
`verified_total_limit` BIGINT NULL COMMENT '独立核验区块该资源全网额度,确认前可空,确认委托时必须有有效正值',
|
||||
`verified_total_weight` BIGINT NULL COMMENT '独立核验区块该资源全网TRX权重,确认前可空,不能与SUN混用',
|
||||
|
||||
Reference in new issue
Block a user