修正RPC响应失败
This commit is contained in:
1 parent
1e79e836e8
commit
911a3634ee
5 files changed
+124
-21
No files matched your search
@@ -6,15 +6,16 @@
|
||||
|
||||
## 1. 实现范围与可信前提
|
||||
|
||||
普通 HTTP RPC 不支持任意历史高度的完整账户/全网资源状态。内置实现采用“实时确认状态采集 + 完整区块事件归档 + 地址对重放”,从启用时开始积累可用的历史证据,不是完整 TRON 归档节点,也不能凭空恢复上线前的历史资源参数。
|
||||
普通 HTTP RPC 不支持任意历史高度的完整账户/全网资源状态。内置实现采用“FullNode实时状态采样、等待确认 + 完整区块事件归档 + 地址对重放”,从启用时开始积累可用的历史证据,不是完整 TRON 归档节点,也不能凭空恢复上线前的历史资源参数。
|
||||
|
||||
采集必须使用**由运营信任、状态一致的固定 RPC 节点**。`walletsolidity` 读的是最后确认状态,不能用 `wallet` 当前状态替代。公共负载均衡服务即使前后两次确认头相同,也无法证明中间请求一定落在同一后端;生产应使用自己的固定节点或有一致性保证的服务。需要支持以下 POST 接口:
|
||||
采集必须使用**由运营信任、状态一致的固定 RPC 节点**。Nile公共服务没有`/walletsolidity/getaccountresource`,不能用该路径,也不能把最新参数标记为当前确认头参数。当前实现先用最新头夹读绑定采样高度,待该高度进入确认链并核对哈希后才归档。公共负载均衡服务即使前后两次头相同,也不能证明中间请求来自同一后端;生产应使用自己的固定节点或有一致性保证的服务。需要支持以下 POST 接口:
|
||||
|
||||
| 接口 | 用途 |
|
||||
| --- | --- |
|
||||
| `/walletsolidity/getnowblock` | 获取确认头高度、区块哈希 |
|
||||
| `/walletsolidity/getaccountresource` | 获取该确认状态的能量/带宽全网额度和权重 |
|
||||
| `/walletsolidity/getdelegatedresourcev2` | 读取指定地址对的锁定、非锁定 Stake 2.0 本金 |
|
||||
| `/wallet/getnowblock` | FullNode最新头,夹读以绑定实时采样高度 |
|
||||
| `/wallet/getaccountresource` | 该最新高度的能量/带宽全网额度和权重 |
|
||||
| `/wallet/getdelegatedresourcev2` | 该最新高度指定地址对的 Stake 2.0 本金 |
|
||||
| `/walletsolidity/getblockbynum` | 按高度读取确认区块及按序交易、执行回执 |
|
||||
|
||||
示例RPC地址仅表示接口来源,不能据此认为公共服务已通过生产验收。不支持某接口、返回参数不完整或限流时,采集会失败,不用空值伪造成功。
|
||||
@@ -23,11 +24,11 @@
|
||||
|
||||
## 2. 业务流程
|
||||
|
||||
1. 采集器读取确认头 H1,读取全网资源参数,再次读取确认头 H2。只有高度和哈希均一致才把参数绑定到该区块。变化时最多重试3次,仍不稳定则放弃这次采样。
|
||||
1. 采集器读取FullNode最新头 H1,读取全网资源参数及所需关系,再次读取最新头 H2。仅高度和哈希一致才绑定该高度。最多尝试3次。不立即写入历史证据;内存保留最多10000份、最长10分钟的未确认采样,每轮继续采集后续高度。确认头到达采样高度后,使用确认区块查询核对原采样哈希,再归档。分叉、超时或重启丢失的采样不补造。
|
||||
2. 首次采集从当前确认头开始;已有派单前基线时,从最早基线的下一高度开始。以后从数据库游标下一高度补采确认区块。
|
||||
3. 每个区块按原交易顺序解析成功的 `DelegateResourceContract` 和 `UnDelegateResourceContract`,保存全网委托/回收事件。相关交易没有完整回执时整个区块不推进。
|
||||
4. 写入区块事件、标记区块完整和推进游标在同一事务中完成;父哈希不连续、重复高度哈希不同、同高度参数冲突时拒绝覆盖。
|
||||
5. 平台派单前对候选供应钱包/接收地址/资源类型采集确认关系基线,同样使用确认头夹读。锁定与非锁定本金合计必须为0,失败时订单仍等待派单,不先发送任务再补证据。原有当前关系检查继续保留。
|
||||
5. 平台派单前对候选供应钱包/接收地址/资源类型采集关系基线,同样使用最新头夹读并等待对应区块确认。锁定与非锁定本金合计必须为0,等待确认时订单仍等待派单,后续调度重试,不先发送任务再补证据。原有当前关系检查继续保留。首次启动需要等待确认预热;不要因此关闭确认校验。
|
||||
6. 本地 Agent 按原流程执行,云端原有核验继续检查真实交易、owner/receiver、网络、资源类型、非锁定、SUN、回执、确认深度及当前关系。
|
||||
7. 内置服务查找目标交易之前最近的关系基线,验证从基线到交易区块的所有区块连续且事件完整,按区块高度和交易序号重放本金变化。目标交易必须真实存在于归档,不能用请求的本金代替事件。
|
||||
8. 从目标区块读取当时保存的额度和权重,返回目标交易前后本金及资源参数。云端以原有精确整数公式换算资源,达标且租期未结束时才扣款、记供应商收入。
|
||||
@@ -78,7 +79,7 @@
|
||||
| events_complete | TINYINT | 1表示本块全部相关成功事件已完整归档 |
|
||||
| energy_limit / energy_weight | BIGINT,可空 | 该区块确认状态的全网能量参数 |
|
||||
| bandwidth_limit / bandwidth_weight | BIGINT,可空 | 该区块确认状态的全网带宽参数 |
|
||||
| parameters_at | DATETIME(3),可空 | 实时夹读参数成功的UTC时间 |
|
||||
| parameters_at | DATETIME(3),可空 | 实时夹读采样经确认哈希校验后入库的UTC时间;区块高度仍是原采样高度 |
|
||||
| created_at | DATETIME(3) | 首次记录UTC时间 |
|
||||
|
||||
唯一索引 `(network, block_id)` 防止同哈希被绑定不同高度。参数全部为空且 `parameters_at` 为空表示**该高度资源参数漏采**,即使区块交易成功补齐也不能把后来参数填入该行。
|
||||
@@ -210,7 +211,7 @@ RENT_RPC_KEY=按所用RPC要求提供
|
||||
|
||||
| 文件 | 职责 |
|
||||
| --- | --- |
|
||||
| `ruoyi-system/.../rental/RentalHistoryService.java` | 确认状态夹读、不可变入库、网络租约、区块解析、关系重放、证明 |
|
||||
| `ruoyi-system/.../rental/RentalHistoryService.java` | 最新状态夹读、暂存等待确认、哈希核对、不可变入库、网络租约、区块解析、关系重放、证明 |
|
||||
| `ruoyi-system/.../rental/RentalHistoryCollector.java` | 独立后台线程、分网络轮询、关闭 |
|
||||
| `ruoyi-system/.../rental/RentalHistoryController.java` | 受保护的状态/证明查询 |
|
||||
| `RentalChain.java` | 内置/外部证明选择,原链上核验保留 |
|
||||
|
||||
Reference in new issue
Block a user