Evidence Box 状态机制

Evidence Box 状态机详解

enum Status(
  Storing,
  Selling,
  Auctioning,
  Paid,
  Refunding,
  Delaying,
  Published,
  Blacklisted
)

一个 Evidence Box 会经历以下状态，全部由合约严格定义：

1. Storing：create方法铸造后的初始状态。
2. Selling：一口价出售中。
3. Auctioning：拍卖中，每次出价会延长deadline。
4. Paid：买家已支付，进入退款申请期。
5. Refunding：退款仲裁期，Minter/DAO 可处理退款。
6. Delaying：交易完成后进入延迟披露期，可支付时间费用延长。
7. Published：内容公开，任何人可读取机密数据。
8. Blacklisted：DAO 封禁状态，交易冻结并触发退款/销毁。

状态流程图

1. 铸造时可选择 Store（默认）或直接 Publish。
2. 只有 Storing 状态的 Box 可以 Sell 或 Auction。
3. Selling/Auctioning 无人购买，deadline到期自动转为Published；
4. Selling状态下，有买家购买，就会进入 Paid； Auctioning状态下，需要等待deadline截止才会转为Paid。
5. Paid 状态下，如果买家申请退款，就进入Refunding，或者完成订单进入Delaying。
6. Delaying状态就是我们说的延期披露状态，这个状态需要持续支付延时费用；
7. 如果没有支付延时费用，deadline到期自动转为 Published。

状态期限

1. Storing：初始 365 天，仅可在到期前 30 天内可以执行延长操作，单次最多 365 天。
2. Selling：固定 365 天上架周期。
3. Auctioning：初始 30 天，每次出价重置为 30 天。
4. Request Refund Period：默认 7 天，超时则无法申请。
5. Refund Review Period：默认 30 天，超时后任何人都可以执行同意退款。
6. Delaying：初始 365 天，每次支付时间费用可延长 365 天。

主网/测试网对比

参数	Oasis sapphire	Oasis sapphire testnet
Storing 初始保护期	365 天	15 天
可延长窗口	30 天内	3 天内
单次可延长	365 天	15 天
Selling	365 天	15 天
Auctioning	30 天	3 天
Delaying	365 天	15 天
Request Refund Period	7–15 天	7 天
Refund Review Period	15–60 天	15 天

部分参数可以通过DAO治理进行调整。