Skip to content

docs: add error code 30030 (token suspended) to WaaS 2.0 error code reference#363

Open
rcsh1 wants to merge 1 commit into
CoboGlobal:masterfrom
rcsh1:playbook/run-run_40747dafa840
Open

docs: add error code 30030 (token suspended) to WaaS 2.0 error code reference#363
rcsh1 wants to merge 1 commit into
CoboGlobal:masterfrom
rcsh1:playbook/run-run_40747dafa840

Conversation

@rcsh1

@rcsh1 rcsh1 commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Intent

Ticket 1176739834628673585 (暂停充提币的报错码需要更新在API中): Error code 30030 for suspended deposit/withdrawal operations is missing from the API error code reference. Add the suspended-operation error codes (including 30030) to
v2/guides/overview/error-codes.mdx.

Summary

Add error code 30030 (token deposit/withdrawal suspended) to the EN and CN error-code reference tables. Also fixes a pre-existing autosweep navigation slug typo in docs.json.

Changed files

  • snippets/error-codes.mdx — inserted 30030 row in numeric order
  • snippets/error-codes-cn.mdx — CN mirror of the above
  • docs.json — corrected autosweep slug cancel-auto-sweep-task-by-idcancel-auto-sweep-task

| 30013 | 余额不足以支付所需的交易费用。 | 确保源地址有足够的余额支付交易费用。 |
| 30014 | 目标地址无效。 | 提供有效的目标地址。 |
| 30023 | (此错误仅适用于交易所钱包)交易账户类型无效。 | 提供有效的交易账户类型。 |
| 30030 | 该代币当前处于暂停状态,无法执行充币或提币操作。 | 这是 Cobo 侧的临时暂停,您无法直接更改。订阅 `token.suspended.deposit` 和 `token.suspended.withdraw` [Webhook 事件](/v2_cn/guides/webhooks-callbacks/webhook-event-type) 以跟踪被暂停的代币,并在暂停解除后重试该操作。 |

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个时候用户应该怎么做?是不是要联系 cobo?

@cobosteven

Copy link
Copy Markdown
Collaborator

🤖 自动化文档 Review — doc-pr-review playbook

doc-pr-review playbook 生成(codex 引擎),对照 custody / cobo-libs 源码做了双向事实核验。非阻塞评论,仅供参考。

Verdict: REQUEST_CHANGES

事实核验:30030 ✅ 真实且文档准确

源码正向确认(非仅"未发现问题"):

  • 定义 waas2/base/exceptions/transfer.py:38,消息 :120-122("Withdrawal and deposit services for this token are temporarily unavailable")
  • 触发点:waas2/transfer/managers/custodial/asset/utils.py:146-147 / 212-213SuspendCoinManager.can_withdraw() 为假时)、mpc/processors/mpc.py:2088-2089web3/processors/transaction.py:168-169
  • 暂停判定:custody/coin/managers/coin.py:949-954can_deposit 检查 asset_coin not in SUSPENDED...
  • 码值/消息与 EN、CN 三方一致,无伪造/错误。

Must-fix

  • 30030(EN + CN)solution 不可执行:当前只说"订阅 token.suspended.deposit / token.suspended.withdraw",缺确切 Cobo Portal 点击路径完整 API/curl(端点、方法、必需 headers/占位符、含两个事件类型的 request body、预期确认)。请把 EN 与 CN 的 Solution 单元格都补成可直接执行的订阅动作。

Should-fix

  • 30030 description 只说"被暂停"现象,未解释 WHY:建议补充底层机制——Cobo 侧暂停了该代币的充币/提币处理,因此平台会拒绝相关操作,直至暂停解除。

Nit

  • related links 为相对内链,standards 维度判定可接受,无需改(除非项目偏好绝对公开 URL)。

⚠️ 覆盖盲区

本次 review 聚焦错误码事实核验,未覆盖 docs.json 的 nav slug 改动(cancel-auto-sweep-task-by-idcancel-auto-sweep-task)。合并前请人工确认该 slug 对应页面确实存在,避免导航 404。

事实核验为单引擎(codex)运行结果,建议合并前人工复核 must-fix 项。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants