更多

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

7 分钟阅读以 Markdown 格式查看 ↗

使用 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)。

开始之前

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

Shell
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 被替换。
  • 席位只有在验证者调整权重时才有收益,并按您的分数而非排名分配。 所有入选的设备群共享一个通道:第 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 会拒绝运行。请下载该文档并检查其哈希:

Shell
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。如果不是,请停下来并联系支持团队。新的链运行时需要新的文档。设备群授权与恢复约定说明了它涵盖的内容。

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

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

Shell
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,请创建一个:

Shell
btcli wallet new-hotkey

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

Shell
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:

Shell
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> 添加。要再次输出清单及其承诺:

Shell
provider fleet manifest --manifest=fleet-manifest.json

3. 从 hotkey 发布清单

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

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

Shell
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 个纪元:

Shell
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。请先试运行。

Shell
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[@]}"

检查和撤销

Shell
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 被替换

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

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