Merged
fix(a4p): 添加校验,调整成员名保持与java一致 #374
fix(a4p): 添加校验,调整成员名保持与java一致 #374
Merged
wangweizhenAdd on 19 days ago
wangweizhenCollaborators
19 days ago

Paired: GitHub #176 ↔ GitCode !374

What type of PR is this?

/kind

Self-checklist:(请自检,在[ ]内打上x,我们将检视你的完成情况,否则会导致pr无法合入)

likedislike
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for wangweizhen's contribution.)
atomgit-bot
atomgit-bot
19 days ago Comments:

变更摘要

本 PR 围绕 A4P ArkTS SDK 的意图生命周期时间校验与字段命名一致性展开:将 StructuredIntent 中的 resource 字段重命名为 resources,以与 Java 侧保持一致;并在签名、激活、撤销、完成、取消等环节补齐时间戳合法性校验,使链上与执行账本的时间戳保持单调,异常时间统一通过 A4pErrorCode 中的 3002/3003 报错。

主要改动

  • StructuredIntent.resource 重命名为 resources:models/intent.ts 中接口字段改为 resources,同步调整 validation.ts 的 validateShoppingItems、validateStructuredIntent 以及 a4p.ts 中 enforceWhitelistScope、enforceTemplateMatch 的取值路径,保证序列化后的线上字段名与 Java 一致。
  • signIntent 新增有效期上限校验:当签名时间戳晚于 constraints.validUntil 时抛出 A4P_TIMESTAMP_EXPIRED(3002),避免生成永远无法执行的 L3 授权,并在接口注释中补充该异常说明。
  • activateIntent 新增有效期上限校验:激活时刻晚于 validUntil 时同样抛出 A4P_TIMESTAMP_EXPIRED,防止返回无法再预留额度的执行上下文;尚未到达 validFrom 的情况仍允许激活。
  • revokeIntent 新增可选 now 参数与时间下限校验:新增入参经 validateNow 校验,并要求不早于 context.activatedTime,否则抛出 A4P_TIMESTAMP_TOO_EARLY(3003);撤销不判断有效期窗口,已过期意图仍可被撤销。
  • completeExecution/cancelExecution 与反序列化校验增强:两者均拒绝早于 record.reservedAt 的完成/取消时间,validateExecutionRecord 对 completedAt、canceledAt 早于 reservedAt 的持久化记录判定为损坏数据并返回相同错误码。

配套测试在 A4p.test.ets、A4pCodec.test.ets、A4pHttp.test.ets 与 TestDataFactory.ets 中同步更新了字段名,并新增上述边界场景的用例。

likedislike
Incorrect?
atomgit-bot
atomgit-bot
19 days ago Comments:

代码审查

审查结论

本 PR 的方向(改名对齐 Java、补齐时间单调校验)实现质量较高:新增校验的顺序正确(先校验、后改状态,cancelExecution 正是把状态翻转挪到检查之后),测试与实现同步更新,未发现逻辑/边界错误,也未发现安全漏洞。

按优先级统计

  • P1 × 1:resource → resources 改名未同步混淆保留名单(obfuscation-rules.txt / consumer-rules.txt),release 构建会把 wire key 混淆,破坏与 Java/服务端的互操作与验签。
  • P2 × 1:revokeIntent 用默认墙钟对 activatedTime 做下限校验,而该瞬间并不落库——时钟回拨/跨时钟域时 kill-switch 会被 3003 卡住。
  • P3 × 2:revokeIntent 新签名与新错误码未同步 README/README_zh 的 API 表;restore 路径新抛的 3003 未登记在 A4pCodec.deserializeIntentExecutionContext 的契约中。

逐文件复核

  • src/main/ets/api/a4p.ts:已复核(signIntent/activateIntent 的 validUntil 上界、revokeIntent 新参数与下限、complete/cancel 的 reservedAt 下限、resource→resources 引用、constraints 声明位置调整)——见 2 条 P2/P3 发现。
  • src/main/ets/internal/validation.ts:已复核(validateShoppingItems 参数改名、validateStructuredIntent 字段改名、validateExecutionRecord 新增两条单调校验的位置与前置 isNonNegativeInteger 保障)——见 1 条 P3 发现。
  • src/main/ets/models/common.ts:仅注释更新,与枚举语义一致——no issues。
  • src/main/ets/models/intent.ts:字段改名本身与全仓引用一致,问题在混淆名单未同步——见 P1 发现。
  • src/main/ets/models/product.ts:仅注释更新——no issues。
  • src/ohosTest/ets/test/A4p.test.ets:已逐条核对新增/调整用例(signIntent、activateIntent、revokeIntent、complete/cancel 的时钟用例与 createExecution_fails_whenAfterValidUntil 的新窗口设定,均与 FIXED_NOW 及默认时钟语义自洽)——no issues。
  • src/ohosTest/ets/test/A4pCodec.test.ets:新用例的状态绑定前置检查顺序正确(COMPLETED 记录才能命中 3003 分支),"resource": 负向断言不会误伤 "resources":——no issues。
  • src/ohosTest/ets/test/A4pHttp.test.ets:仅字段改名——no issues。
  • src/ohosTest/ets/test/mock/TestDataFactory.ets:仅字段改名——no issues。

整体风险判断:中等偏低。 代码逻辑与测试一致、可合入;但 P1 的混淆保留名单遗漏必须在合入前修复,否则 release 包的线上 JSON/签名会静默错位(该问题只在开启属性混淆的 release 构建暴露,debug 与本地 UT 全绿)。

类型 数量
🔴 阻塞 1
🟡 建议 3

⛔ 需要修改

likedislike
Incorrect?
OopenJiuwen-botCollaborators
19 days ago Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
atomgit-bot
19 days ago Comments:

AtomGit AI 助手使用指南

在 PR 评论中使用命令即可触发。支持在普通评论和代码行评论中使用。

功能 命令 说明
代码审查 /ai review 检查代码质量、潜在问题、安全风险
PR 摘要 /ai summary 生成 PR 变更内容的结构化摘要
代码解释 /ai explain 解释代码变更的逻辑和意图
自由提问 @atomgit-bot <问题> 询问关于本 PR 的任何问题
帮助 /ai help 显示此帮助信息

免责声明

AI 助手可能存在误判,请结合自身判断。可以对评论点 👍 或 👎 帮助我们改进。

likedislike
Incorrect?
OopenJiuwen-botCollaborators
19 days ago Added label: sig/sig-agent-protocol
46 messages are collapsed here。 See more
maoqiming
maoqimingCollaborators
18 days ago Comments:

/lgtm
/approve

likedislike
OopenJiuwen-botCollaborators
18 days ago Added label: approvedlgtm-mingo007
openJiuwen-botCollaborators
18 days ago Comments:

Review Code Feedback

  • The label lgtm-mingo007, approved was added to this pull request. It means that mingo007 reviewed the code changes. 👋
Tips
  • If this pull request is not merged while all conditions are met, comment /check-pr to try again. 😄
likedislike
OopenJiuwen-botCollaborators
18 days ago Merged pull request
OopenJiuwen-botCollaborators
18 days ago Removed label: ci-successful