Configuración de minero Bittensor: de la billetera al UID registrado

Qué ejecuta realmente un minero Bittensor

Un minero Bittensor no es un único binario que instalas y olvidas. Es un rol dentro de una subred: registras una hotkey en una subred, ejecutas el código del minero de esa subred y respondes al tráfico de validación que la subred usa para puntuar a los mineros. La cadena en sí (Finney mainnet) maneja la identidad, el stake y el registro; la subred maneja el trabajo real.

Esa división importa para la configuración. Necesitas dos cosas funcionando al mismo tiempo:

• Una billetera y registro en la cadena Bittensor, lo que requiere acceso RPC confiable a Finney.
• Un proceso minero en ejecución para la subred específica a la que te uniste, lo que requiere las dependencias propias de la subred, recursos de GPU o CPU y, a menudo, una IP pública o endpoint accesible.

La mayoría de los fallos de configuración provienen de que una de esas dos mitades está mal preparada: o el paso de billetera/registro se hace contra un endpoint poco confiable, o el proceso minero se inicia antes de entender los requisitos de la subred.

Recomendación rápida: ¿endpoint público o nodo dedicado?

Antes de instalar nada, decide cómo se comunicará tu minero con la cadena. Esta es la decisión que más afecta si tu configuración se mantiene estable después del registro.

Si todavía estás explorando, comienza con un endpoint público y sube de nivel cuando notes limitación de tasa, tiempos de espera o lecturas lentas del metagrafo. Si ya sabes que ejecutarás mineros continuamente, planifica un endpoint administrado o dedicado desde el principio. OnFinality proporciona Bittensor Finney RPC sobre HTTP y WebSocket, y opciones de nodo dedicado cuando necesitas capacidad aislada. Consulta Bittensor Finney RPC para detalles del endpoint y Precios de RPC para opciones de planes.

Paso 1: Instalar la CLI de Bittensor y crear billeteras

La CLI de Bittensor (btcli) es la herramienta estándar para operaciones de billetera y registro. Instálala en un entorno Python que controles, luego crea una coldkey y una hotkey.

• La coldkey guarda tu TAO y controla tu identidad. Mantenla fuera de línea o en una máquina que no expongas.
• La hotkey la usa el proceso minero para firmar. Puede vivir en el host del minero.

Un flujo típico se ve así:

# Install the CLI (version may change; check current docs)
pip install bittensor

# Create a coldkey (secure this machine)
btcli wallet new_coldkey --wallet.name miner_cold

# Create a hotkey for the miner host
btcli wallet new_hotkey --wallet.name miner_cold --wallet.hotkey miner_hot

Registra el mnemónico de la coldkey fuera de línea. Perderlo significa perder el acceso a la billetera y a cualquier stake asociado.

Paso 2: Apuntar la CLI a un endpoint RPC Finney

La CLI necesita alcanzar Finney mainnet. Puedes pasar un flag de red o configurar un endpoint. Usar un endpoint estable y documentado evita las conjeturas de nodos públicos aleatorios.

OnFinality expone un endpoint público de Bittensor Finney sobre HTTP y WebSocket:

# HTTP endpoint
https://bittensor-finney.api.onfinality.io/public

# WebSocket endpoint
wss://bittensor-finney.api.onfinality.io/public-ws

Puedes verificar la conectividad con una simple llamada JSON-RPC antes de hacer cualquier cosa que cueste TAO:

curl -s https://bittensor-finney.api.onfinality.io/public \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain_getHeader","params":[]}'

Si eso devuelve un encabezado de bloque, tu endpoint es alcanzable. Si se agota el tiempo o devuelve un error, soluciona la conectividad antes de continuar. Las transacciones de registro no son algo que quieras reintentar a ciegas.

Para mineros en producción, configura el endpoint en la configuración de tu minero en lugar de codificarlo en scripts, para que puedas cambiar de endpoint sin editar código.

Paso 3: Financiar la billetera y verificar saldos

Envía TAO a tu dirección coldkey. Necesitarás suficiente para:

• La tarifa de registro (costo de burn) en la subred a la que te unes.
• Un pequeño margen para tarifas de transacción y cualquier stake que quieras agregar.

El costo de registro varía según la subred y cambia con la demanda. Verifica el costo actual antes de registrarte en lugar de asumir un número fijo. Puedes consultar saldos a través de la CLI o directamente mediante llamadas RPC que leen el estado de la cuenta.

Un hábito práctico: confirma el saldo de la coldkey y el estado de registro de la hotkey en una sola pasada antes de enviar una transacción de registro.

Paso 4: Elegir una subred y registrar un UID

Las subredes difieren enormemente en requisitos de hardware, lógica de puntuación y competencia. Antes de registrarte:

• Lee el repositorio y la documentación de la subred para requisitos de hardware y software.
• Verifica cuántos UID están disponibles y qué tan competitiva es la subred.
• Entiende cómo la subred puntúa a los mineros, ya que eso determina si tu configuración puede ganar algo.

El registro en sí es una transacción en cadena que asigna a tu hotkey un UID en la subred. Una vez registrado, tu proceso minero puede iniciarse.

Paso 5: Ejecutar el proceso minero

Cada subred incluye su propio minero. El patrón general es:

1. Clonar el repositorio de la subred e instalar sus dependencias.
2. Configurar el minero con el nombre de tu billetera, nombre de hotkey, endpoint de red y cualquier configuración específica de la subred.
3. Iniciar el minero y confirmar que produce las respuestas que la subred espera.
4. Monitorear los registros en busca de errores, solicitudes perdidas o caídas de puntuación.

El host del minero debe permanecer alcanzable y estable. Si tu minero se desconecta, la subred puede dejar de puntuarlo, y la recuperación no siempre es instantánea.

Mantener un minero saludable después del registro

El registro es el comienzo, no el final. La operación continua es donde está la mayor parte del trabajo práctico:

• Confiabilidad del endpoint. Si tu minero o scripts de monitoreo consultan la cadena con frecuencia, un endpoint público compartido puede convertirse en un cuello de botella. Un endpoint RPC administrado o un nodo dedicado te da una URL estable y capacidad aislada. Consulta nodos dedicados si ejecutas varios mineros o un validador.
• Lecturas de metagrafo y stake. Las herramientas que leen datos del metagrafo o estado de stake de forma programada se benefician de un rendimiento consistente. Agrupa lecturas cuando sea posible y evita bucles de sondeo ajustados.
• Higiene de billetera. Mantén la coldkey fuera del host del minero. Usa la hotkey solo para firmar.
• Seguimiento de versiones. Las subredes actualizan su código de minero. Fija una versión conocida como buena y prueba las actualizaciones antes de implementarlas.
• Alertas. Vigila la pérdida de registro, errores RPC repetidos y salidas del proceso minero. Una sonda de salud simple contra tu endpoint RPC puede detectar problemas de conectividad a tiempo.

Una sonda de monitoreo mínima podría verse así:

#!/usr/bin/env bash
# Basic endpoint health check for a Bittensor miner host
ENDPOINT="https://bittensor-finney.api.onfinality.io/public"
RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" -X POST "$ENDPOINT" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain_getHeader","params":[]}')
if [ "$RESPONSE" != "200" ]; then
  echo "RPC endpoint unhealthy: $RESPONSE"
fi

Ejecuta esto de forma programada y alerta cuando falle. No detectará todos los problemas a nivel de subred, pero captura el más común: perder la conectividad con la cadena.

Modos de fallo comunes y cómo interpretarlos

Cuándo dejar un endpoint público

Los endpoints públicos están bien para aprender y uso ligero. Cambia a un endpoint RPC administrado o nodo dedicado cuando:

• Ejecutas mineros continuamente y necesitas acceso predecible.
• Operas múltiples subredes o un validador junto con mineros.
• Construyes herramientas que leen el estado de la cadena de forma programada.
• Has estado alcanzando límites de tasa o tiempos de espera intermitentes.

OnFinality ofrece Bittensor Finney RPC sobre HTTP y WebSocket, además de opciones de nodo dedicado para equipos que necesitan capacidad aislada. Comienza con la página de la red Bittensor Finney, compara Precios de RPC y explora otras redes RPC compatibles si ejecutas infraestructura en varias cadenas.

Puntos clave

• La configuración de un minero Bittensor tiene dos mitades: el registro del lado de la cadena (billetera, TAO, UID) y el proceso minero de la subred.
• Usa un endpoint RPC Finney documentado y verifícalo con una llamada de lectura antes de gastar TAO en el registro.
• Mantén la coldkey fuera de línea; usa la hotkey en el host del minero.
• Verifica el costo de registro actual y los requisitos de la subred antes de registrarte.
• Pasa de un endpoint público compartido a un endpoint RPC administrado o nodo dedicado cuando ejecutes mineros continuamente o alcances límites de tasa.
• Monitorea la salud del endpoint y los registros del minero; la mayoría de los fallos son problemas de conectividad o configuración.

Preguntas frecuentes

¿Necesito un nodo dedicado para ejecutar un minero Bittensor?

No. Puedes comenzar con un endpoint RPC público compartido. Un nodo dedicado o endpoint RPC administrado vale la pena cuando ejecutas mineros continuamente, operas múltiples subredes o necesitas rendimiento predecible.

¿Cuánto TAO necesito para registrar un minero?

El costo de registro varía según la subred y cambia con la demanda. Verifica el costo de burn actual antes de registrarte y mantén un pequeño margen para tarifas.

¿Puedo ejecutar un minero y un validador en el mismo host?

Es posible, pero la contención de recursos es un riesgo real. Si lo haces, planifica capacidad aislada y monitorea ambos procesos de cerca.

¿Qué sucede si mi minero se desconecta?

La subred puede dejar de puntuar a tu minero, y la recuperación no siempre es inmediata. Mantén el host estable y monitorea salidas de proceso y pérdida de conectividad.

¿Qué endpoint RPC debo usar para Bittensor?

Usa un endpoint Finney documentado. OnFinality proporciona acceso HTTP y WebSocket a Bittensor Finney; consulta la página de la red Bittensor Finney para más detalles.