# 通过命令行获取前 200 名席位

使用 `btcli` 和 `provider` 在 SN25 上注册 hotkey，从它发布您的设备群清单，并把您的设备绑定到它。位于 ur.io/app/account/top200 的前 200 名页面走的是相同的步骤。请先阅读这些限制：销毁（burn）的费用不可退还，已绑定的设备会离开资金池。

命令最后检查于 `2026-11-17, provider 2026.11.16-1100466640 (register, publish and bind on mainnet)`。

## 开始之前

检查席位申领是否已开放：

```sh
curl -s https://api.bringyour.com/sn/top | python3 -c 'import json,sys; print(json.load(sys.stdin)["snapshot"]["binding_open"])'
```

如果输出 `False`，请到此为止。您还无法完成申领，而销毁的费用不可退还。

这里不会向您索要恢复短语，也没有任何步骤会把密钥发送到任何地方。您的密钥留在您自己的机器上。切勿把恢复短语粘贴到网站、表单或聊天中。

## 先了解这些限制

- **销毁要花费 TAO，且不可退还。** 费用由您的 coldkey 支付。每次注册都会让它上涨约四分之一，而它大约每 72 分钟减半，最低降到 0.0005 TAO。请在付款前查看：`btcli subnets burn-cost 25`。如果费用偏高，请等待。
- **绑定需要 gas。** 每台设备约 263,640 gas，按 5 gwei 计算为 0.0013 TAO，从您的 EVM 钱包支付。
- **请在绑定生效的纪元开始前 3 天内注册。** 绑定最早从下一个为期 7 天的结算纪元开始；而没有释放的 UID 在免疫期结束后（注册后约 3 天，即 21,600 个区块）可能被替换。前 200 名页面会显示下一个纪元的开始时间。请留出发布和绑定的时间：在该纪元第一个区块之后才上链的绑定，只能等到再下一个纪元。
- **子网已满时，总会有人被替换。** SN25 有 256 个 UID。每次注册都会替换不处于免疫期且释放最低的 UID，释放相同时替换注册最早的。在其设备群被测量并入选之前，或者验证者没有调整权重时，UID 没有释放。想要回来，就得再次支付销毁费用并重新绑定：请参阅[如果您的 UID 被替换](#if-your-uid-is-replaced)。
- **席位只有在验证者调整权重时才有收益，并按您的分数而非排名分配。** 所有入选的设备群共享一个通道：第 8 个纪元之前为矿工释放量的 3%，从第 8 个纪元起为 5%。排名在第 201 名或之后的已申领设备群在头部层级没有任何收益。
- **最多绑定 7 台设备，除非其他设备已在接受测量。** 验证者只测量验证队列（verify cohort）中的提供者。已申领设备群的活跃成员优先进入，上限为每个设备群的份额，不活跃的成员会被轮换出去腾出位置（`server controller/sn_fleet_binding.go`、`model/verify_cohort_model.go`）。份额等于队列大小除以 200 个席位，队列为 1,500 时即 7 台设备。队列之外的已绑定设备没有头部分数，也已离开资金池，因此没有任何收益。
- **已绑定的设备会离开资金池。** 只要设备的绑定在某个纪元的任一边界处于活动状态，无论设备群是否有收益，它都得不到资金池份额：它的记录行会被标记为 `head_excluded`，账本会跳过它（`sn protocol/ledger_allocation.go`、`server controller/st_head_exclusion.go`）。一台设备同一时间只在一个层级获得收益。coldkey 保留其资金池账户中已累积的金额。
- **超过 14 天的承诺无法绑定新设备。** 即 100,800 个区块。以后要添加设备，请先重新发布。如果您之前已发布过，可能需要重新发布：旧格式的承诺不会被镜像，`provider fleet status` 会提示您重新发布。
- **一次绑定最多持续 12 个纪元。** 请在它的最后一个纪元之前重新绑定。
- **只有当前 200 名页面或应用显示您的网络可被测量并提示您申领时，才进行绑定。**

## 您需要什么

- 一台装有 `btcli` 的计算机，以及一个有足够可用 TAO 支付销毁和手续费的 coldkey。`pip install bittensor` 会安装当前的 `btcli`。
- 这个设备群专用的 hotkey，它不是您的 coldkey。
- 设备群中某台设备上的 `provider`。它的客户端密钥位于 `~/.urnetwork/.provider.key`。
- 一个位于链 964 上的 EVM 钱包，里面有少量 TAO 用作 gas，供最后一步使用。
- 下文的授权文档和存储声明。

在命令中，`<ws_url>` 是 Subtensor websocket，例如 `wss://lite.chain.opentensor.ai:443`；`<rpc_url>` 是链 964 的 JSON-RPC，例如 `https://lite.chain.opentensor.ai`。

## 授权文档和持久存储

在主网上，没有经过审查的设备群运行时授权文档，`provider fleet register`、`publish`、`bind`、`status` 和 `revoke` 会拒绝运行。请下载该文档并检查其哈希：

```sh
curl -fsSL -o fleet-runtime-authority.json https://raw.githubusercontent.com/urfoundation/sn/main/mainnet/fleet-runtime-authority/runtime-491.json
shasum -a 256 fleet-runtime-authority.json
```

第二条命令必须输出 `0d16e120c0b3575e1daf6c221374f12d3fc6de85f03b12693e3f1a42243b0df3`。如果不是，请停下来并联系支持团队。新的链运行时需要新的文档。[设备群授权与恢复约定](https://github.com/urfoundation/sn/blob/main/miner/FLEET-MAINNET-RUNTIME.md)说明了它涵盖的内容。

`register`、`publish`、`bind` 和 `revoke` 还需要一份声明，说明保存其恢复记录的持久存储。只用 `provider` 就能准备这份声明：在将要运行这些命令的那一台 Linux 或 macOS 机器上，依次运行 `provider fleet storage request`、`plan` 和 `apply`，具体见[为主网写入准备存储](https://github.com/urfoundation/sn/blob/main/miner/FLEET-MAINNET-RUNTIME.md#preparing-storage-for-mainnet-writes)。`apply` 会输出 `declaration.path` 和 `declaration.sha256`：它们就是 `--durable-volumes` 和 `--durable-volumes-sha256` 的值，而且该哈希已经以 `sha256:` 开头。这些步骤以及之后每一次设备群写入操作都要使用同一个 `URNETWORK_STATE_DIR`（如果您没有设置，就是 `~/.urnetwork`），并且切勿从备份中恢复该目录。

请在 shell 中保留这两项，供下面的命令使用。这些数组在 bash 和 zsh 中都可用：

```sh
AUTHORITY=(--mainnet-runtime-authority="$PWD/fleet-runtime-authority.json" --mainnet-runtime-authority-sha256=0d16e120c0b3575e1daf6c221374f12d3fc6de85f03b12693e3f1a42243b0df3)
DURABLE=(--durable-volumes=<declaration_path> --durable-volumes-sha256=<declaration_sha256>)
```

## 1. 在子网上注册 hotkey

如果还没有 hotkey，请创建一个：

```sh
btcli wallet new-hotkey
```

查看费用，然后注册。btcli 会询问钱包和 hotkey，并在花费之前显示销毁费用。

```sh
btcli subnets burn-cost 25
btcli subnets register --netuid 25
```

不同版本的 `btcli` 对钱包参数的命名不同，所以这条命令不指定任何钱包参数。

`provider fleet register` 是另一种注册方式，除非加上 `--apply`，否则只是试运行。它需要您 coldkey 的原始种子文件，所以请使用 btcli。

## 2. 生成设备群清单

在一台提供者设备上，使用 `GET /sn/head` 中的 coordinator 和 netuid（前 200 名页面会自动填入）、您 hotkey 的地址以及这台设备的客户端 ID：

```sh
provider fleet init --chain_id=964 --coordinator=<0xcoordinator> --netuid=25 --hotkey=<hotkey ss58> --client_seed_file=$HOME/.urnetwork/.provider.key --client_id=<client_id> | head -n 1 > fleet-manifest.json
```

其他每台设备用 `--member=<client_id>:<client_key>` 添加。要再次输出清单及其承诺：

```sh
provider fleet manifest --manifest=fleet-manifest.json
```

## 3. 从 hotkey 发布清单

```sh
provider fleet publish --manifest=fleet-manifest.json --substrate=<ws_url> --hotkey_seed_file=<path> "${AUTHORITY[@]}" "${DURABLE[@]}"
```

`--hotkey_seed_file` 是 hotkey 的 32 字节原始种子，保存在只有您能读取的文件中，并留在这台机器上。btcli 以 JSON 保存 hotkey，所以请从中写出一次原始种子，不要把它打印出来：

```sh
python3 -c 'import json,os,sys; d=json.load(open(sys.argv[1])); fd=os.open(sys.argv[2], os.O_WRONLY|os.O_CREAT|os.O_EXCL, 0o600); os.write(fd, bytes.fromhex(d["secretSeed"][2:])); os.close(fd)' "$HOME/.bittensor/wallets/<wallet>/hotkeys/<hotkey>" hotkey.seed
```

这只读取您的 hotkey 文件，绝不读取 coldkey 文件，也不会向任何地方发送内容。把路径 `hotkey.seed` 作为 `--hotkey_seed_file` 使用。

之后，承诺预言机会在您的承诺最终确定后，自动把它镜像到链 964。在此之前，绑定会以 `StaleCommitment()` 回退。

## 4. 为每台设备的绑定签名

在每台设备上，或在保存 hotkey 种子的地方，以纪元为单位指定有效期。第一个纪元必须晚于当前纪元，一次绑定最多跨 12 个纪元：

```sh
provider fleet sign --manifest=fleet-manifest.json --client_id=<client_id> --client_seed_file=$HOME/.urnetwork/.provider.key --hotkey_seed_file=<path> --valid_from_epoch=<first epoch> --valid_to_epoch=<last epoch>
```

它会输出绑定摘要、hotkey 的签名，以及要粘贴到前 200 名页面的载荷。在手机上，请改用应用：收益 › 前 200 名 › 签署设备群绑定（Earnings › Top 200 › Sign fleet binding）。

## 5. hotkey 签名

当您传入 `--hotkey_seed_file` 时，第 4 步的载荷已包含它。如果 hotkey 种子在另一台机器上，请在那里用设备的 `--client_id` 和 `--hotkey_seed_file` 运行 `provider fleet sign`，然后把输出的 `0x` 签名粘贴到前 200 名页面。

**btcli 无法生成这个签名。** hotkey 签署的是绑定摘要的 32 个字节。`btcli wallet sign --use-hotkey --message` 签署的是您提供的文本，所以以十六进制输入的摘要是另一些字节，签名将无法通过验证。

## 6. 提交

把每份载荷粘贴到位于 ur.io/app/account/top200 的前 200 名页面。它会返回该设备的 calldata。请从您自己的 EVM 钱包在链 964 上发送。URnetwork 绝不会代您发送交易。

`provider fleet bind` 则一步完成签名和提交。它接受 `--relayer_key_file`（支付 gas 的 EVM 密钥）和 `--dry-run`。请先试运行。

```sh
provider fleet bind --manifest=fleet-manifest.json --client_id=<client_id> --client_seed_file=$HOME/.urnetwork/.provider.key --hotkey_seed_file=<path> --valid_from_epoch=<first epoch> --valid_to_epoch=<last epoch> --rpc=<rpc_url> --relayer_key_file=<path> --dry-run "${AUTHORITY[@]}" "${DURABLE[@]}"
```

## 检查和撤销

```sh
provider fleet status --manifest=fleet-manifest.json --client_id=<client_id> --substrate=<ws_url> --rpc=<rpc_url> "${AUTHORITY[@]}"
provider fleet revoke --manifest=fleet-manifest.json --client_id=<client_id> --client_seed_file=$HOME/.urnetwork/.provider.key --effective_epoch=<epoch> --rpc=<rpc_url> --relayer_key_file=<path> --dry-run "${AUTHORITY[@]}" "${DURABLE[@]}"
```

## 如果您的 UID 被替换 {#if-your-uid-is-replaced}

一旦 hotkey 没有 UID，您设备的绑定就不再生效，设备会从下一个纪元边界起重新在其运营方的资金池中获得收益。要重新申领：

1. 再次注册 hotkey（第 1 步）。这是一次新的销毁和一个新的 UID。
2. 用 `provider fleet revoke` 从下一个纪元起撤销每台设备的旧绑定。
3. 用更高的 `--generation` 生成新清单（第 2 步），发布它（第 3 步），然后从该纪元起为每台设备的绑定签名并提交（第 4 到 6 步）。
