# Как занять место в Топ-200 из командной строки

С помощью `btcli` и `provider` зарегистрируйте hotkey в SN25, опубликуйте с него манифест парка и привяжите к нему свои устройства. Страница Топ-200 на ur.io/app/account/top200 проводит через те же шаги. Сначала прочитайте об ограничениях: сжигание (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`. Если оно высокое, подождите.
- **Привязка стоит газа.** Около 263 640 газа на устройство, то есть 0,0013 TAO при 5 gwei, из вашего EVM-кошелька.
- **Регистрируйтесь в течение 3 дней перед эпохой, с которой начинается ваша привязка.** Привязка начинается не раньше следующей 7-дневной расчётной эпохи, а UID без эмиссии можно заменить, как только закончится его иммунитет, примерно через 3 дня (21 600 блоков) после регистрации. Страница Топ-200 показывает, когда начнётся следующая эпоха. Оставьте время на публикацию и привязку: привязка, попавшая в сеть после первого блока этой эпохи, будет ждать следующую.
- **В заполненной подсети кого-то заменяют.** В SN25 256 UID. Каждая регистрация заменяет UID без иммунитета с самой низкой эмиссией, а среди равных — с самой старой регистрацией. У UID нет эмиссии, пока его парк не измерен и не выбран, а также пока валидатор не управляет своими весами. Чтобы вернуться, придётся заплатить за сжигание и привязать устройства заново: см. [Если ваш UID заменён](#if-your-uid-is-replaced).
- **Место приносит выплаты, только пока валидатор управляет своими весами, и пропорционально вашему баллу, а не месту в рейтинге.** Все выбранные парки делят один канал: 3 % эмиссии майнеров до эпохи 8 и 5 % начиная с эпохи 8. Парк, занявший место, но оказавшийся на 201-м месте или ниже, ничего не зарабатывает на ведущем уровне.
- **Привязывайте не больше 7 устройств, если только остальные уже не измеряются.** Валидаторы измеряют только провайдеров из когорты верификации. Активные участники парка с занятым местом попадают в неё первыми, в пределах доли на парк, а неактивные выходят, освобождая место (`server controller/sn_fleet_binding.go`, `model/verify_cohort_model.go`). Доля — это размер когорты, делённый на 200 мест, то есть 7 устройств при когорте 1 500. Привязанное устройство вне когорты не получает балла ведущего майнера и уже вышло из пула, поэтому ничего не зарабатывает.
- **Привязанные устройства выходят из пула.** Пока привязка устройства активна на любой из границ эпохи, оно не получает доли пула, независимо от того, зарабатывает ли парк: его строка помечается `head_excluded`, и реестр её пропускает (`sn protocol/ledger_allocation.go`, `server controller/st_head_exclusion.go`). Устройство зарабатывает только на одном уровне за раз. Coldkey сохраняют то, что уже накоплено на их счетах в пуле.
- **Коммитмент старше 14 дней не может привязать новые устройства.** Это 100 800 блоков. Чтобы добавить устройства позже, сначала опубликуйте его заново. Если вы уже публиковали коммитмент, возможно, его нужно опубликовать заново: коммитменты в старом формате не зеркалируются, и `provider fleet status` просит опубликовать такой заново.
- **Привязка действует не больше 12 эпох.** Привяжите заново до её последней эпохи.
- **Привязывайте только тогда, когда страница Топ-200 или приложение показывает вашу сеть как измеримую и предлагает занять место.**

## Что понадобится

- Компьютер с `btcli` и coldkey с достаточным количеством свободных TAO на сжигание и комиссии. `pip install bittensor` установит актуальный `btcli`.
- Hotkey для этого парка, отличный от вашего coldkey.
- `provider` на устройстве парка. Его клиентский ключ находится в `~/.urnetwork/.provider.key`.
- EVM-кошелёк в сети 964 с небольшим количеством TAO на газ для последнего шага.
- Документ полномочий и декларация хранилища, описанные ниже.

В командах `<ws_url>` — это websocket Subtensor, например `wss://lite.chain.opentensor.ai:443`, а `<rpc_url>` — JSON-RPC сети 964, например `https://lite.chain.opentensor.ai`.

## Документ полномочий и постоянное хранилище

В mainnet команды `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`, как описано в разделе [Подготовка хранилища для записи в mainnet](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`, если вы его не задавали) для этих шагов и всех последующих записывающих команд парка и никогда не восстанавливайте этот каталог из резервной копии.

Держите и то и другое в оболочке для команд ниже. Эти массивы работают в 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` это пробный запуск. Ему нужен файл с исходным seed вашего coldkey, поэтому используйте btcli.

## 2. Создайте манифест парка

На устройстве провайдера, указав координатор и netuid из `GET /sn/head` (страница Топ-200 подставляет их сама), адрес вашего hotkey и идентификатор клиента этого устройства:

```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` — это исходный 32-байтовый seed hotkey в файле, который можете читать только вы, и он остаётся на этом компьютере. btcli хранит hotkey в JSON, поэтому один раз запишите из него исходный seed, не выводя его на экран:

```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. Подпишите привязку каждого устройства

На каждом устройстве или там, где хранится seed 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 и данные (payload), которые нужно вставить на странице Топ-200. На телефоне используйте приложение: Заработок › Топ-200 › Подписать привязку парка (Earnings › Top 200 › Sign fleet binding).

## 5. Подпись hotkey

Данные из шага 4 уже содержат её, если вы передали `--hotkey_seed_file`. Если seed hotkey находится на другом компьютере, запустите там `provider fleet sign` с `--client_id` устройства и `--hotkey_seed_file` и вставьте выведенную подпись `0x` на странице Топ-200.

**btcli не может создать эту подпись.** Hotkey подписывает 32 байта дайджеста привязки. `btcli wallet sign --use-hotkey --message` подписывает переданный текст, поэтому дайджест, набранный в шестнадцатеричном виде, — это другие байты, и подпись не пройдёт проверку.

## 6. Отправьте

Вставьте данные каждого устройства на странице Топ-200, на ur.io/app/account/top200. В ответ она выдаст calldata для этого устройства. Отправьте их из собственного EVM-кошелька в сети 964. URnetwork никогда не отправляет транзакцию за вас.

`provider fleet bind` вместо этого подписывает и отправляет за один шаг. Он принимает `--relayer_key_file`, 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).
