Bittensor BTCLI 挖矿详细安装教程

Bittensor BTCLI 挖矿详细安装教程

以下是基于官方文档的 Bittensor BTCLI 矿工指南，旨在帮助您了解如何使用 BTCLI 进行矿工操作。由于目前没有官方中文版本，建议结合翻译工具使用。

概述

Bittensor 是一个去中心化的 AI 网络，矿工通过运行 AI 模型为网络提供计算资源，并获得 TAO 奖励。BTCLI（Bittensor 命令行界面）是与网络交互的主要工具，允许矿工管理钱包、注册子网和处理质押等操作。

矿工角色

  • 矿工：运行 AI 模型，响应验证者的请求，生产数字商品（如预测或生成内容）。
  • 主要任务：使用热钥签名请求，管理 TAO 和 alpha 质押，注册到子网。

安装前准备（示例操作系统：Ubuntu 22.04）

  1. 更新软件包列表：
1
2
sudo apt update
sudo apt upgrade -y
  1. 安装依赖项：
1
sudo apt install -y software-properties-common
  1. 添加 deadsnakes PPA：
1
2
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
  1. 安装 Python 3.12：
1
sudo apt install -y python3.12
  1. 验证安装：
1
python3.12 --version

安装 pip 并关联到 Python 3.12

  1. 安装 pip
1
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.12
  1. 验证 pip 是否安装成功
1
python3.12 -m pip --version

开始安装 BTCLI

在开始之前，您需要安装 BTCLI。以下是安装步骤：

  1. 安装 Python 3.12 的 venv 虚拟模块
1
sudo apt install python3.12-venv

  1. 创建虚拟环境：

    1
    2
    python3.12 -m venv btcli_venv
    source btcli_venv/bin/activate

  2. 安装 BTCLI：

    • 通过 PyPI：

      1
      pip install bittensor-cli

    • 或从源代码安装：

      1
      2
      3
      git clone https://github.com/opentensor/btcli.git
      cd btcli
      pip install -e .

  3. 验证安装：

    1
    btcli --help

  4. 配置config.yml文件

1
2
3
mkdir -p ~/.bittensor  # 创建目录
touch ~/.bittensor/config.yml  # 创建空配置文件
vim ~/.bittensor/config.yml  # 编辑配置文件

把以下代码复制到config.yml里面《配置示例》：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
chain: ws://127.0.0.1:9945
network: local
no_cache: False
wallet_hotkey: hotkey-user1
wallet_name: coldkey-user1
wallet_path: ~/.bittensor/wallets
metagraph_cols:
  ACTIVE: true
  AXON: true
  COLDKEY: true
  CONSENSUS: true
  DIVIDENDS: true
  EMISSION: true
  GLOBAL_STAKE: true
  HOTKEY: true
  INCENTIVE: true
  LOCAL_STAKE: true
  RANK: true
  STAKE_WEIGHT: true
  TRUST: true
  UID: true
  UPDATED: true
  VAL: true
  VTRUST: true

注意：

  • 支持 macOS、Linux 和 WSL2（Windows 子系统 Linux）。Windows 原生环境不支持挖矿。
  • 确保使用 Python 3.12。

更多安装详情见 BTCLI 安装指南。

关键 BTCLI 命令

以下是矿工常用的 BTCLI 命令：

1. 钱包管理

矿工需要冷钥（存储 TAO）和热钥（日常操作）。冷钥应保存在安全设备上。

  • 创建冷钥：

    1
    btcli wallet new-coldkey --wallet-name miner-coldkey

  • 创建热钥：

    1
    btcli wallet new-hotkey --wallet-name miner-hotkey --wallet-hotkey default

  • 重新生成热钥（如需恢复）：

    1
    btcli wallet regen-hotkey --wallet-name miner-hotkey --wallet-hotkey default

  • 查看钱包列表：

    1
    btcli wallet list

安全提示：

  • 在安全的冷钥工作站上创建热钥，然后转移到矿工工作站。
  • 不要在不安全的设备上暴露冷钥。

2. 子网注册

矿工需要注册到子网以参与挖矿。

  • 注册子网：

    1
    btcli subnets register --wallet-name miner-coldkey --wallet-hotkey default --netuid <子网ID>

  • 通过工作量证明注册（如适用）：

    1
    btcli subnets pow-register --wallet-name miner-coldkey --wallet-hotkey default --netuid <子网ID>

注意：

  • 注册可能需要支付 TAO 费用（例如，主网注册费用约为 1000 TAO，测试网可退还）。

  • 检查子网锁成本：

    1
    btcli subnet lock-cost --subtensor.network test

3. 质押管理

矿工需要管理 TAO 和 alpha 质押以获得排放奖励。

  • 质押 TAO：

    1
    btcli stake add --wallet-name miner-coldkey --wallet-hotkey default --amount <TAO数量>

  • 取消质押：

    1
    btcli stake remove --wallet-name miner-coldkey --wallet-hotkey default --amount <TAO数量>

  • 查看质押状态：

    1
    btcli stake show --wallet-name miner-coldkey

4. 其他命令

  • 查看子网列表：

    1
    btcli subnets list

  • 检查账户概览：

    1
    btcli overview --wallet-name miner-coldkey

  • 更新 BTCLI：

    1
    pip install --upgrade bittensor-cli

安全与最佳实践

  • 冷钥与热钥分离：

    • 冷钥存储在离线设备上，仅用于创建热钥、质押或支付注册费用。
    • 热钥用于日常挖矿，存储在矿工工作站。

  • 冷钥交换：

    • 冷钥交换成本为 0.1 TAO，需等待 5 天。
    • 使用命令计划冷钥交换，详情见 冷钥交换。

  • 测试环境：

    • 在测试网（--subtensor.network test）上练习操作，避免主网损失。
    • 可在 Bittensor Discord 请求测试 TAO。

  • 避免不安全环境：

常见问题

问题 解决方案
注册子网失败 检查 TAO 余额是否足够，确认网络连接，使用 --subtensor.network test 测试。
热钥丢失 使用 btcli wallet regen-hotkey 恢复，需保留助记词。
命令无响应 确保 BTCLI 为最新版本，检查网络连接，或在 Discord 寻求帮助。

社区与资源