铸境 NFT 市场 v1.8.1 发布说明（发布日期：2025-12-02）

更新概览

本次为安全升级版本，重点增强链上与签名安全、订单抗重放与结算稳健性，并在前端交互中引入风险提示与保护机制。主要更新包括：上架与竞拍风险评估面板、硬件/移动钱包签名校验引导、批量操作费用上限与取消保护、敏感操作二次确认与冷却期、自助申诉与资产冻结解除流程；合约层移除可重入点并加入重入保护、采用拉取式结算避免外部回调、支持 EIP-1271 合约账户签名校验、订单哈希加入链 ID 与截止时间以防重放；上链前模拟执行与 Gas 上限校验；安全 CI 集成 Slither/Mythril/Foundry fuzz；核心合约经第三方审计已修复全部高危项。

新增功能

• 风险评估面板（上架/竞拍）

  • 内容：在上架与竞拍流程中展示合约风险与地址风险的评估结果，提示可疑合约与黑名单地址。
  • 用途：帮助用户识别潜在风险源，降低与恶意合约或高风险地址交互的概率。
  • 说明：评估基于链上数据与维护的风险清单，具体结果以界面提示为准。

• 硬件与移动钱包签名校验引导

  • 内容：针对硬件钱包与移动钱包的签名流程提供逐步引导与校验提示。
  • 用途：减少签名误操作与格式不兼容导致的失败，提升签名成功率与可验证性。
  • 说明：在签名弹窗中展示钱包类型识别与必要的校验步骤。

• 批量转移与空投的费用上限与取消保护

  • 内容：为批量转移/空投操作设置费用上限（Fee Cap），并在费用异常时提供取消保护。
  • 用途：避免网络拥堵或参数异常导致的超额费用支出，用户可在达上限前安全取消。
  • 说明：费用上限与取消路径在交互界面中明确展示。

• 敏感操作的二次确认与冷却期（默认启用）

  • 内容：上架、取消订单、批量转移等敏感操作新增二次确认与冷却期。
  • 用途：降低误操作与重复提交的风险。
  • 说明：冷却期时长与具体适用操作以实际界面提示为准。

• 自助申诉入口与资产冻结解除流程

  • 内容：在检测到异常或资产冻结的情况下，提供自助申诉入口与标准化的解除流程。
  • 用途：提高处理效率与透明度，便于用户在链上安全策略触发后快速恢复正常使用。
  • 说明：申诉材料与流程要求在入口处明确说明。

功能优化

• 上架/竞拍流程融入风险提示与签名引导，交互信息更清晰，减少不必要的链上回滚。
• 批量操作的提示与边界条件说明更明确，降低执行失败概率。
• 敏感操作的确认文案与状态反馈优化，提升用户理解与操作可控性。

问题修复

• 合约层消除已识别的可重入点，并加入系统化的重入保护（Reentrancy Guard）。
• 经第三方审计，核心合约已修复审计报告列出的全部高危项（详细内容以审计报告为准）。
• 通过为订单哈希加入链 ID 与截止时间，缓解跨链或过期订单的重放风险。
• 采用拉取式结算避免外部合约回调引起的结算不确定性与潜在攻击面。
• 引入签名流程的前端校验与链上验证一致性，减少因签名格式问题导致的失败。

技术变更

• 合约层
  • 移除可重入点并统一使用重入保护机制。
  • 市场结算逻辑改为拉取式（Pull-based），交易参与方在安全前提下主动提取收益，避免外部回调。
  • 支持 EIP-1271：对合约账户的签名进行链上校验，提高对多签/合约钱包的兼容性。
  • 订单哈希结构扩展：加入 chainId 与 deadline 字段以防重放与过期签名风险。
  • 上链前执行模拟（dry-run）与 Gas 上限校验，减少因参数或网络波动导致的失败。
• 安全与工程
  • 安全 CI 集成 Slither（静态分析）、Mythril（字节码安全分析）与 Foundry fuzz（模糊测试），提升持续集成阶段的漏洞覆盖。
  • 核心合约通过第三方审计并完成高危项修复，相关报告可用于合规与集成评估。
• 客户端/集成影响
  • 新版订单生成需包含 chainId 与截止时间（deadline），并采用更新后的哈希与签名流程。
  • 对合约账户（如多签）应支持 EIP-1271 验证路径；对 EOA 保持原有签名路径。
  • 结算流程适配拉取式模型，第三方集成需据此更新收益提取与状态轮询逻辑。

升级指南

• 终端用户
  • 更新至最新前端版本后，按界面指引完成上架/竞拍。风险评估面板可用于识别可疑合约与黑名单地址。
  • 硬件/移动钱包签名：按照签名弹窗的步骤与校验提示完成签名；如提示签名不兼容，更新钱包至最新版本后重试。
  • 批量转移/空投：确认费用上限设置与取消保护提示，必要时在达到上限前取消操作。
  • 敏感操作：遵循二次确认与冷却期的提示，避免短时间内重复提交。
  • 申诉与解冻：在自助入口提交所需材料，按流程完成资产冻结解除。
• 开发者与集成方
  • 更新 SDK/后端逻辑以生成包含 chainId 与 deadline 的订单数据，并按新哈希规则进行签名与验证。
  • 对合约账户接入 EIP-1271 校验路径；确保后端或中间件正确识别并调用 isValidSignature。
  • 结算改造：将原先依赖外部回调的结算流程迁移为用户/服务端触发的拉取式提取，并更新相应的状态处理与失败重试逻辑。
  • 部署前在测试网或仿真环境进行交易模拟与 Gas 上限校验，验证主要场景（上架、竞拍、取消、批量操作）。
  • 安全检查：在 CI 中加入或对齐 Slither/Mythril/Foundry fuzz，保持与核心仓库一致的安全阈值与报告审阅流程。
• 兼容性说明
  • 新创建订单必须包含 chainId 与 deadline；历史订单的兼容与处理请参考后续公告或支持渠道说明。
  • 合约账户签名需由对应钱包/合约正确实现 EIP-1271；未实现的合约账户将无法通过签名验证。

已知问题

• 风险评估面板基于现有数据源与策略，存在误报或漏报的可能；黑名单覆盖范围以维护进度为准。
• EIP-1271 校验依赖合约账户正确实现规范；部分多签/合约钱包版本较旧时可能无法通过验证。
• 硬件/移动钱包在不同设备与版本上的签名体验存在差异，需以各钱包最新版本为准。
• 在网络极度拥堵情况下，批量操作可能触发费用上限保护导致交易回退；需在网络缓和后重试或调整批次规模。
• 冷却期的适用范围与时长以实际界面提示为准，不同操作可能存在差异。
• 关于历史订单在新哈希结构下的处理与迁移策略，将另行公告说明。

云荒远征 链游 v2.0.0 发布说明（2025-12-02）

更新概览

本次 v2.0.0 为“架构调整”级别更新，围绕可升级性、跨服扩展和经济系统治理进行全面重构，核心变化包括：

• 引入赛季制与跨服排名
• 道具与装备拆分为独立 NFT 系列，支持升级与熔炼
• 开放链上公会据点与共享仓库
• 新增离线挂机收益与活跃度任务
• 市场从角色直售调整为订单簿交易，手续费分配给质押者
• 推出战斗回放与观战功能
• 技术栈升级：合约模块化 + 代理可升级、事件总线与任务队列的异步结算、ERC-2771 元交易与签名中继、Subgraph v2 分区索引与 Bloom 过滤、前端 GraphQL 网关 + CDN 边缘缓存、完善灰度与回滚策略

新增功能

• 赛季制与跨服排名

  • 按赛季进行进度与排名统计，面向全区服的统一竞榜。
  • 赛季结算将根据赛季内的有效战斗与活跃度数据进行统计，奖励与结算规则以游戏内说明为准。
  • 排名数据跨服聚合，减少区服割裂带来的竞争壁垒。

• 独立 NFT 系列：道具与装备（支持升级/熔炼）

  • 将原有资产拆分为独立的“道具 NFT 系列”和“装备 NFT 系列”，便于清晰管理与扩展稀有度、套装等属性。
  • 升级：在满足条件时可对指定 NFT 进行升级，提升数值或解锁特性。
  • 熔炼：将符合条件的 NFT 熔炼为材料或通证，以便回收或再利用。
  • 资产生命周期在链上可追溯，关键状态变化以事件记录。

• 链上公会据点与共享仓库

  • 公会据点对应链上实体，具备基础的成员、权限与资产管理能力。
  • 共享仓库支持公会成员按权限进行捐献/提取操作，策略与阈值以公会设定为准。
  • 核心操作产生事件，便于审计与第三方工具集成。

• 离线挂机收益与活跃度任务

  • 角色在离线时产出一定收益（限额与周期以游戏内显示为准）。
  • 新增活跃度任务面板，支持按日/周维度统计并发放奖励。
  • 异步结算机制降低拥堵期的链上操作压力，数据以最终一致为准。

• 订单簿市场与质押分成

  • 交易从“角色直售”升级为“订单簿模式”，支持挂单、部分成交与取消。
  • 交易手续费将按协议参数分配给质押者，具体分配周期与比例以官方文档和前端展示为准。
  • 提供撮合事件，方便数据服务与量化策略读取。

• 战斗回放与观战

  • 新增战斗回放：对已结束的战斗进行步骤级回放。
  • 新增观战：可在部分玩法中实时围观战斗过程。
  • 回放元数据与校验信息在链上/子图可查询，用于一致性检查。

功能优化

• 对战与经济系统分层解耦，降低模块间耦合度，便于后续扩展与维护。
• 前端采用 GraphQL 网关与 CDN 边缘缓存，常用查询与列表加载延时显著降低（以实际网络环境为准）。
• 资产清单、筛选与排序能力增强，支持按系列、稀有度与可升级状态筛选。
• 钱包与签名体验优化：新增元交易开关与签名中继通道，降低新手上手成本。
• 排行榜与赛季面板交互优化，数据刷新与状态提示更明确。

问题修复

• 修复战斗结算在极端网络条件下可能出现的重复提交导致的积分统计异常。
• 修复订单在取消/部分成交的边界情况下，状态刷新不同步的问题。
• 缓解大规模铸造后子图数据刷新延迟的问题，提高列表一致性。
• 修复部分移动端浏览器的渲染异常与白屏问题。
• 统一若干事件字段与枚举取值，减少第三方解析歧义。
• 处理在低带宽网络下的重试策略，降低偶发的请求超时率。

注：上述修复与改进以实际部署为准，详细变更请参考最新 ABI、子图 Schema 与前端变更日志。

技术变更

• 合约架构

  • 采用模块化与代理可升级模式，战斗、经济、道具等子系统分层解耦。
  • 关键状态与操作以事件为边界，提升可观测性与可回滚能力。
  • 权限与访问控制优化，敏感操作引入更细粒度的角色与校验。

• 异步结算

  • 引入事件总线与任务队列处理高频操作（如下单撮合、奖励结算等）。
  • 通过幂等与重试策略在失败情况下确保最终一致性，减少对主链的直接写入频率。
  • UI 层提供“处理中/已确认”双态提示，避免误解为实时落链。

• 低门槛交互

  • 集成 ERC-2771 元交易与签名中继，用户可在部分操作中免 Gas 完成授权与提交。
  • 强调签名域隔离与回放保护，前端提示“仅用于本应用”的签名用途与范围。

• 数据与查询

  • Subgraph v2 启用分区索引与 Bloom 过滤，加速海量事件下的筛选与分页。
  • 调整实体与关系设计，减少跨实体联表查询，提升列表/排行榜查询性能。

• 前端与网络

  • 切换至 GraphQL 网关统一聚合数据源，配合 CDN 边缘缓存降低延迟。
  • 静态资源与通用查询启用分层缓存策略，支持失效与刷新提示。
  • 完善灰度与回滚策略：特性开关与配额控制，必要时可在不更换合约地址的情况下回滚前端与服务。

• 兼容性与潜在不兼容

  • 市场模块接口由“直售”变为“订单簿”，相关前端与集成需要适配“挂单/撮合/取消”流程。
  • 道具与装备迁移为独立 NFT 系列，依赖旧合约地址或 TokenID 的集成方需更新白名单与解析逻辑。
  • 排行榜查询接口迁移至 GraphQL，原有 REST/旧子图字段将逐步弃用。

升级指南

• 面向普通玩家

  1. 更新到 v2.0.0 客户端/前端，清理浏览器缓存后重新登录。
  2. 连接钱包后，可在“设置-签名与费用”中开启元交易（可选），部分操作可由签名中继代付 Gas。
  3. 资产检查：在“背包/仓库”页面查看道具与装备的新系列展示与状态。如需迁移或授权，前端会给出明确提示与一键操作入口，请按指引执行。
  4. 市场交易：首次挂单需对对应 NFT 系列进行授权；下单、取消与修改均可在“我的订单”中查看实时状态。
  5. 公会功能：在“公会”面板中完成加入或创建，合理设置成员权限后再进行共享仓库的捐献/提取操作。
  6. 赛季玩法：赛季入口位于“赛季”面板，完成基础任务可提升赛季积分；结算与奖励以游戏内计时与规则说明为准。
  7. 战斗回放/观战：在“战报”或“竞技”入口查看回放列表，选择对局即可播放；观战根据房间与模式提供入口。

• 面向集成方/开发者

  • 合约与地址：请以官方文档公布的 v2.0.0 合约地址与 ABI 为准，完成依赖更新与部署检查。
  • 事件与子图：迁移到新的 Subgraph v2 端点与 Schema，更新对市场、道具升级/熔炼、公会仓库与战斗结算相关事件的解析。
  • API 接口：将原 REST/旧 Graph 查询迁移到 GraphQL 网关；分页、过滤与排序参数请根据新 Schema 适配。
  • 权限与授权：注意新的授权粒度（按 NFT 系列或具体模块），避免使用过期的通配授权。
  • 上线节奏：建议先在测试环境完成回归验证，再逐步切换生产流量；启用特性开关进行灰度发布。

• 面向质押者

  • 交易手续费将按协议参数分配给质押者，发放周期与领取方式以质押页面与官方文档为准。
  • 建议在更新后核对收益面板与快照时间，留意结算周期提示。

已知问题

• 异步结算机制下，链上最终状态与前端显示可能存在短暂偏差；如遇延时，请以区块确认与子图最终状态为准。
• 战斗回放仅适用于 v2.0.0 之后产生的对局；旧版本对局不保证回放完整性。
• 跨服排行榜在高并发时刷新间隔可能延长，前端将显示最新同步时间戳。
• 部分钱包对 ERC-2771 类签名的提示文案较为简略，请在确认签名前核对域名与用途。
• CDN 边缘缓存可能导致短时数据延后，手动刷新或切换过滤条件可触发最新拉取。
• 离线挂机收益设有周期与上限控制，具体数值以游戏内面板与公告为准。

如需更详细的接口、事件与合约说明，请参考官方文档与最新 ABI/Schema。此版本为架构级更新，建议相关集成与脚本在上线前完成全面回归测试。