Merged
fix(a4p): 添加校验,调整成员名保持与java一致 #374
wangweizhenAdd on 19 days ago
fix(a4p): 添加校验,调整成员名保持与java一致 #374
Merged
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for wangweizhen's contribution.)atomgit-bot
19 days ago Comments:
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 中同步更新了字段名,并新增上述边界场景的用例。


Incorrect?
atomgit-bot
19 days ago Comments:
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 |
⛔ 需要修改


Incorrect?
19 days ago Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
19 days ago Comments:
19 days ago Comments:
19 days ago Added label: sig/sig-agent-protocol
46 messages are collapsed here。 See more
maoqiming
18 days ago Comments:
18 days ago Comments:
/lgtm
/approve


18 days ago Added label: approvedlgtm-mingo007
openJiuwen-bot
18 days ago Comments:
18 days ago Comments:
18 days ago Merged pull request
18 days ago Removed label: ci-successful
Paired: GitHub #176 ↔ GitCode !374
What type of PR is this?
/kind
Self-checklist:(请自检,在[ ]内打上x,我们将检视你的完成情况,否则会导致pr无法合入)