> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/developers/zh/shang-jia-ni-de-api-jin-jie/staking-and-penalties.md).
# 链上质押与处罚
了解付费调用背后的质押、如何提取，以及罚没会扣除什么。
质押是你在 Robinhood Chain 上存入的 USDG，用于为付费工具提供担保。它为你的数据质量承诺兜底。如果已验证的失败率超出你声明的失败率，且达到违约标准，Assay 可以针对这笔质押提出罚没。
## 需要质押多少
在 **Stake** 查看工具需要的金额。付费上架条目的标准计算取质押底线和调用价格倍数中的较大值。配置默认值为 50 USDG 和调用价格的 1,000 倍，但更高的链上最低值或约定的提供方金额可能改变要求。请以账户显示金额为准。
例如，在这些默认值且无覆盖设置时，0.10 USDG 的调用需要 100 USDG 质押。多个上架条目共享质押：要求取各条目中的最高值，而非相加。免费条目无需质押；同时提供付费调用的条目则需要。
## 添加质押
1. 登录并打开 **Stake**。连接将用于 Robinhood Chain 质押的钱包。
2. 选择 **Add stake**，输入 USDG 金额。
3. 按钱包步骤操作：如需证明所有权或批准代币支出，则先完成，再存入质押。
4. 等待确认，并检查更新后的质押金额。
## 解锁和提取
1. 打开 **Stake**，选择 **Withdraw stake**。
2. 输入金额，在钱包中发起提取。
3. 等到显示的解锁时间，再返回，将可用金额提取到钱包。
发起提取会将质押移入称为解绑中余额的等待余额。用于判断付费调用资格的已绑定质押会立即减少。等待余额在提取前仍可能被罚没。再次请求解除质押，会重新开始整个解绑中余额的等待计时。
等待期可配置为 11 至 30 天。提取使用当前等待期，因此参数变更可能改变现有解锁时间。待处理罚没可能在等待期结束后仍预留部分余额。合约暂停或账户被阻止，也可能导致无法存入和提取质押。
## 什么会触发罚没
Assay 在质量窗口内衡量你声明的失败率。只有 `PASS` 和 `FAIL` 质量观测计入已验证样本。窗口在达到最低样本量或最长期限时关闭。低于最低样本量的窗口不会判定 SLA 罚没；每个窗口的最低样本量显示在 **Quality** 中。
样本足够大时，实际失败率必须超过声明值加统计容差。违约会产生拟议罚没，不会立即扣款。声明值和计算设置在窗口开启时冻结，因此修改承诺不会改写该窗口的规则。
映射缺陷或未作判定的响应不会自动成为质量失败。决定如何处理前，请在 **Penalties → Why this penalty?** 查看失败调用和计算过程。
## 扣除什么，资金去哪里
罚没会先在链上预留质押。在争议窗口内，你可以用质押钱包提出争议。默认链上延迟为 72 小时，但应以每条记录的截止时间为准。
罚没执行时，合约将客户份额转给指定受损客户，将平台份额转入 Assay 金库。剩余份额保留在质押中。应用显示的分配为客户 60%、Assay 30%、10% 永不扣除。按此比例全额应用 10 USDG 罚没时，质押减少 9 USDG：6 给客户，3 给 Assay，1 仍属于你。
实际转账使用执行时的链上分配比例。提出罚没时，上限或已预留质押可能降低预留金额。执行时，整个预留金额必须符合滚动限额，否则继续等待。请查看已执行金额来确认最终扣款，不要将最初拟议金额视为已经损失的资金。
## 确认是否成功
存入后，核对已确认的已绑定质押和所需金额。请求提取后，核对等待余额和解锁日期。发生罚没后，检查是待处理、争议中、已取消还是已执行，并确认是否实际扣款。
可选：复现 SLA 计算
使用窗口冻结的值，令 `p` 为声明失败率、`n` 为已验证样本量、`r` 为实际失败率：
```
tolerance = 2.58 × sqrt(p × (1 - p) / n)
breach requires n >= n_min and r > p + tolerance
penalty = total call amount × max(0, r - p) × 2
```
`n_min` 和 z 值在窗口上冻结，并显示在 **Why this penalty? → Show derivation** 中。
容差决定是否违约。一旦违约，罚没按超过声明值的部分计算。后端将乘以系数后的超额失败率按 1,000,000 的精度四舍五入，再将所得金额向下取整到最小货币单位。随后按定价失败调用的比例，在受损客户间分配受上限约束的罚没。不再额外除以验证采样率。
可选：阅读质押合约
`AssayStake` 接受 `depositStake`、`requestUnstake` 和 `withdrawStake`。提供方是拥有质押的钱包；`depositStakeFor` 允许其他账户为该钱包的质押注资。提取款项支付给质押所有者。
`withdrawableOf` 取已到期解绑中余额与“承担风险的总质押减去待处理预留金额”中的较小值。已绑定和解绑中余额都仍承担风险。执行时先从解绑中余额扣除实际转账金额，再扣已绑定质押。
提出罚没时，预留金额受签名罚没金额、按风险质押和 `slashCapBps` 计算的提供方额度，以及尚未预留的质押约束。每份证明也必须符合 `penaltyAmount`。执行时会检查提供方滚动限额和 `verifierDailyCap`；两者都按应用的罚没总额计量。这些限额并不永久限制你可能损失的总额。
实时的 `slashAgentBps` 和 `slashPlatformBps` 决定每笔转账，并按整数向下取整。余款归你保留。未执行的待处理记录可在 `executableAt` 七天后作过期处理；若验证方密钥不可用，也可更早处理。过期会释放预留，不会转账。
## 错误
| 情况 | 处理方式 |
| ----------------- | ----------------------------- |
| 质押低于要求 | 依赖付费调用资格前，先补足显示的缺口。 |
| 已过解锁日期，但并非全部质押都可用 | 检查待处理预留和当前等待期。 |
| 钱包操作被拒绝 | 检查质押所有者钱包、余额、网络、暂停状态和账户是否被阻止。 |
| 拟议罚没有误 | 打开记录，在争议截止时间前处理。 |
## 延伸阅读
* [将你的 API 映射到工具契约](/developers/zh/shang-jia-ni-de-api-jin-jie/map-your-api.md)。
* 上架你的 API（可选）：[质押与罚没](https://docs.goassay.ai/list-your-api/zh/manage-your-stake)。
## 下一步
* [在链上申诉质押处罚](/developers/zh/shang-jia-ni-de-api-jin-jie/dispute-a-stake-penalty.md)。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.goassay.ai/developers/zh/shang-jia-ni-de-api-jin-jie/staking-and-penalties.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.