通过命令行获取前 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)。
开始之前
检查席位申领是否已开放:
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/)。份额等于队列大小除以 200 个席位,队列为 1,500 时即 7 台设备。队列之外的已绑定设备没有头部分数,也已离开资金池,因此没有任何收益。verify_ cohort_ model.go - 已绑定的设备会离开资金池。 只要设备的绑定在某个纪元的任一边界处于活动状态,无论设备群是否有收益,它都得不到资金池份额:它的记录行会被标记为
head_,账本会跳过它(excluded sn protocol/、ledger_ allocation.go server controller/)。一台设备同一时间只在一个层级获得收益。coldkey 保留其资金池账户中已累积的金额。st_ head_ exclusion.go - 超过 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://;<rpc_url> 是链 964 的 JSON-RPC,例如 https://。
授权文档和持久存储
在主网上,没有经过审查的设备群运行时授权文档,provider fleet register、publish、bind、status 和 revoke 会拒绝运行。请下载该文档并检查其哈希:
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.:它们就是 --durable-volumes 和 --durable-volumes-sha256 的值,而且该哈希已经以 sha256: 开头。这些步骤以及之后每一次设备群写入操作都要使用同一个 URNETWORK_(如果您没有设置,就是 ~/.urnetwork),并且切勿从备份中恢复该目录。
请在 shell 中保留这两项,供下面的命令使用。这些数组在 bash 和 zsh 中都可用:
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,请创建一个:
btcli wallet new-hotkey查看费用,然后注册。btcli 会询问钱包和 hotkey,并在花费之前显示销毁费用。
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:
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= 添加。要再次输出清单及其承诺:
provider fleet manifest --manifest= fleet-manifest.json3. 从 hotkey 发布清单
provider fleet publish --manifest= fleet-manifest.json --substrate=<ws_url> --hotkey_seed_file=<path> "${AUTHORITY[@]}" "${DURABLE[@]}"--hotkey_ 是 hotkey 的 32 字节原始种子,保存在只有您能读取的文件中,并留在这台机器上。btcli 以 JSON 保存 hotkey,所以请从中写出一次原始种子,不要把它打印出来:
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_ 使用。
之后,承诺预言机会在您的承诺最终确定后,自动把它镜像到链 964。在此之前,绑定会以 StaleCommitment() 回退。
4. 为每台设备的绑定签名
在每台设备上,或在保存 hotkey 种子的地方,以纪元为单位指定有效期。第一个纪元必须晚于当前纪元,一次绑定最多跨 12 个纪元:
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_ 时,第 4 步的载荷已包含它。如果 hotkey 种子在另一台机器上,请在那里用设备的 --client_id 和 --hotkey_ 运行 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_(支付 gas 的 EVM 密钥)和 --dry-run。请先试运行。
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[@]}"检查和撤销
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,您设备的绑定就不再生效,设备会从下一个纪元边界起重新在其运营方的资金池中获得收益。要重新申领:
- 再次注册 hotkey(第 1 步)。这是一次新的销毁和一个新的 UID。
- 用
provider fleet revoke从下一个纪元起撤销每台设备的旧绑定。 - 用更高的
--generation生成新清单(第 2 步),发布它(第 3 步),然后从该纪元起为每台设备的绑定签名并提交(第 4 到 6 步)。