> For the complete documentation index, see [llms.txt](https://docs.stacks.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stacks.co/learn/zh/bitcoin-staking.md).

# 比特币质押

PoX-5 下的比特币质押：什么是协议债券、如何开始、奖励从何而来，以及你的 PoX-4 stack 发生了什么。

比特币质押是 PoX-5 对转移证明（Proof of Transfer）的演进。参与者在 BTC 仍由自己在比特币 L1 上自托管，或作为 sBTC 持有在配对路径和池路径中时，赚取以 BTC 计价的收益。

协议债券一句话概括：一个 12 个周期的承诺，大约六个月，将 L1 上的 BTC 时间锁与 L2 上的 STX 锁定配对起来。其关联是密码学上的：比特币锁定是一个 P2WSH 脚本，承诺到你的 Stacks 主体哈希，而 pox-5 会在注册你之前验证该承诺、锁定金额以及交易的 Merkle 证明。两边都必须在债券的 Day 0 截止前锁定，而且注册必须至少早于那一时间 100 个比特币区块，因为紧邻 Day 0 之前的准备阶段会拒绝它。L1 锁定必须先进行，因为正是注册证明了这一点。

参与分四个阶段进行：加入白名单并完成接入、开仓、领取奖励，然后续期或退出。

## 选择一条路径

每个钱包的路径彼此互斥：

* **原生 BTC 债券。** BTC 在时间锁下仍由你自己保管。仅限个人。不提供原生 BTC 这一路径的池模式。需白名单。
* **sBTC 债券，可直接进行或通过池进行。** 锁定的是 sBTC，而不是原生时间锁。这是唯一带有池选项的路径。
* **仅 STX 质押。** 没有比特币一侧。见 [质押到现有签名者管理器](https://docs.stacks.co/operate/staking-stx/stack-with-a-pool).

每个主体只能有一个仓位：一个钱包不能同时持有一个债券和一个条款重叠的仅 STX 质押，也不能持有两个彼此重叠的债券。合约实际拒绝的是重叠，而不是顺序衔接：允许一个仓位在下一个仓位开始之前或正好结束，这就是为什么可以从一个债券无缝滚动到下一个而无需解锁再重来。

## 加入白名单

从这里开始，而且要尽早开始。PoX-5 中的原生债券参与需要白名单，而加入某个债券的白名单是与 Stacks Endowment 的链下沟通，不是 API 调用。随后 Endowment 会在债券开启前把白名单和债券参数发布到链上。

时机比看上去更重要。债券参数大约在 Day 0 前 7 天发布，而白名单在 `setup-bond`时固定。那一刻不在名单上的质押者完全无法加入该债券；下一次机会只能等下一个债券。预计之后更晚推出、无需许可的协议版本 PoX-6 将移除此人工步骤。

## 如何开始

在任何流程之前：连接钱包，如果你走的是原生 BTC 路径，则完成白名单沟通，关联一个签名者管理器，满足适用的比例要求，并先完成 L1 锁定再进行 L2 锁定。

两个前提：

* **支持 SegWit 的比特币钱包。** 锁定输出是 P2WSH。不能向其付款的钱包就无法为债券提供资金。
* **一个签名者管理器。** 每位参与者，无论是债券参与者还是仅 STX 参与者，都必须关联一个签名者管理器，可以是自己运行的，或是自己质押到的那一个。不存在单独的独立路径。

你不需要设置奖励地址。没有 `pox-addr` 参数在 `register-for-bond`；奖励路由已移出协议，现在由签名者管理器负责，并作为不透明的 `signer-calldata`.

注册会在准备阶段被拒绝，而准备阶段是每个周期最后 100 个比特币区块。不要计划在周期边界启动仓位。

面向机构合作伙伴预期遵循的端到端流程，已有带截图的逐步指南； [联系支持](mailto:support@stackslabs.com?subject=Help%20wanted%20with%20bitcoin%20staking%20end-to-end%20steps%20to%20take) 我们会指引你找到合适的那个。预计之后会推出流动质押选项，并可能由第三方提供。例如，StackingDAO 已表示将提供 stBTC，一种流动质押的 sBTC 代币。当前没有此类产品可用。

## 债券时间线

<div data-with-frame="true"><figure><img src="https://2842511454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH74xqoobupBWwBsVMJhK%2Fuploads%2FG660xt3cld5Hh0RkGykm%2Fstaking-bond-timeline_v2.png?alt=media&#x26;token=f0cb4501-14e4-44c6-a8a4-4340f01e953e" alt="A timeline of a single protocol bond. Day 0 marks the deadline for both legs to be locked, with a prepare phase of one hundred Bitcoin blocks immediately before it during which registration is rejected. The bond then runs for twelve reward cycles. Day 175 marks the Bitcoin timelock&#x27;s minimum unlock height, one thousand and fifty blocks before the end. Day 182 marks the end of the bonding period on Stacks. Six overlapping bonds are shown, each starting two reward cycles after the last."><figcaption><p>单个债券的生命周期。注册必须至少在 Day 0 前 100 个比特币区块完成。L1 时间锁在 Day 175 开启，距离 L2 期限在 Day 182 结束还有 1,050 个区块。</p></figcaption></figure></div>

三个标记描述一个债券：

* **Day 0。** 到这个高度时，两边都必须已锁定。注册必须至少更早 100 个比特币区块，因为紧挨 Day 0 之前的准备阶段会拒绝它。
* **Day 175。** L1 时间锁的最小解锁高度，距离 L2 结束前 1,050 个比特币区块，大约 7 天。
* **Day 182。** 质押期在 L2 上结束。你的 STX 会在下一个周期边界解锁。

围绕任一债券的是更大的时间安排。每 2 个奖励周期开启一个新债券，也就是 4,200 个比特币区块，而每个债券持续 12 个奖励周期，即 25,200 个比特币区块。任意时刻有 6 个债券处于生效状态，而债券 *n* 在债券 *n+6* 开始的区块处结束，这种对齐方式使直接滚动续接成为可能。奖励会在债券生命周期内分 24 次发放，每 1,050 个比特币区块发放一次。

重新锁定窗口为 1,050 个比特币区块，其中只有前 950 个可用；最后 100 个是准备阶段。

有一个值得有意牢记的注意事项：25,200 个区块按每天 144 个区块计算是 175 天，但 L2 期限却在标记为 Day 182 的位置结束。这里的天数是白皮书中的日历标签，不是从区块数学推导出来的数值。在需要精确时，请使用区块数，并将天数视为路标。

## 收益从哪里来

债券首先由每个周期按矿工收入形成的资金池支付。协议债券部分会完整拿到其目标收益，剩余部分在仅 STX 质押部分和储备基金部分之间分配。关于瀑布分配、各部分、覆盖率和储备的完整说明在 [协议债券与奖励机制](/learn/zh/bitcoin-staking/rewards-and-tranches.md).

默认情况下，奖励会通过自动桥接以 sBTC 形式支付。原生 BTC-L1 支付是一种可选择退出的设置，通过签名者管理器层的 `signer-calldata`，而不是一个 `register-for-bond` 参数。

## 结束或更改仓位

债券是一个 12 个周期的承诺，但有两条退出路径，你使用哪一条取决于你的比特币是如何被锁定的。

如果你是 L1 锁定，则通过调用 `announce-l1-early-exit`在 Stacks 上宣布退出，然后通过锁定脚本的提前退出分支花费比特币。如果你是 sBTC 锁定，则调用 `unstake-sbtc`，它可以全部或部分提取仓位。这两个调用都会在准备阶段被拒绝。

两者都不会在期限结束前释放你的 STX。你也可以在期限中途切换到不同的签名者管理器，或者在旧债券的比特币一侧解锁后，直接滚入新的债券或仅 STX 质押。

## 如果你曾在 PoX-4 下进行 stacking

PoX-5 在 Epoch 4.0 时彻底取代了 PoX-4，该 Epoch 在比特币区块 960,230 处激活。所有 PoX-4 锁定都已释放，不过在分叉时已进行中的一个周期仍然完成了支付。

没有自动迁移。每位前任 stacking 参与者都必须主动选择一条新路径：协议债券或仅 STX 质押。如果你还没有这么做，你的 STX 已解锁且不再产生收益。

PoX-5 下的仅 STX 质押每次锁定最多 96 个周期。没有无限期选项。

## 合约参考

部署的合约是参考版本： [`SP000000000000000000002Q6VF78.pox-5`](https://explorer.hiro.so/txid/SP000000000000000000002Q6VF78.pox-5?chain=mainnet\&tab=sourceCode)。若要按行阅读，源代码固定在发布标签 [4.0.1](https://github.com/stacks-network/stacks-core/blob/4.0.1/stackslib/src/chainstate/stacks/boot/pox-5.clar).

## 相关阅读

* [比特币质押术语表](/learn/zh/bitcoin-staking/glossary.md)
* [协议债券与奖励机制](/learn/zh/bitcoin-staking/rewards-and-tranches.md)
* [Stacking](https://docs.stacks.co/learn/block-production/staking)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.stacks.co/learn/zh/bitcoin-staking.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
