Tutorial de minería de Bittensor: ¿Cómo mantienes un minero registrado y en línea?

La minería de Bittensor no funciona como la minería de Bitcoin o Ethereum. No hay un rompecabezas de hash que resolver. En su lugar, registras una hotkey en la cadena Subtensor, ejecutas un minero dentro de una subred y compites por la calidad de las respuestas que produce tu modelo. Los validadores puntúan esas respuestas y las emisiones fluyen hacia los mineros que obtienen buenas puntuaciones.

Eso replantea todo el tutorial. La parte difícil rara vez es el código del modelo. La parte difícil es mantenerse registrado, mantenerse sincronizado con la cadena y mantener tu minero accesible mientras los validadores lo consultan. Esta página se centra en esa ruta operativa y en la capa RPC que la sostiene.

Recomendación rápida: qué configurar primero

Antes de tocar una GPU o clonar un repositorio de subred, decide cómo hablarás con la cadena. Casi todos los pasos a continuación dependen de una conexión RPC de Subtensor funcional.

Si aún estás decidiendo si autoalojar, las compensaciones son similares a las de otras cadenas. Consulta nodos dedicados para el modelo operativo y precios de RPC para saber cómo se factura el acceso gestionado.

Qué significa realmente minar en Bittensor

Una subred define un mecanismo de incentivos. Los mineros envían respuestas, los validadores las clasifican y la cadena convierte esas clasificaciones en emisiones. Tu trabajo como minero es producir las mejores respuestas que puedas, lo suficientemente rápido para ser puntuado.

Tres componentes importan:

• Billeteras. Necesitas una coldkey (mantiene el stake y controla la hotkey) y una hotkey (firma la actividad del minero). Mantén la coldkey fuera de línea.
• Registro. Registras la hotkey en una ranura UID de una subred. El registro cuesta TAO y el precio sube a medida que se llenan las ranuras.
• El proceso del minero. Este es tu modelo o servicio, generalmente iniciado desde un repositorio de subred, apuntando a un endpoint RPC y a tus archivos de billetera.

Nada de esto es minería de hash. Las emisiones dependen de la puntuación de la subred, no del cómputo gastado adivinando nonces.

Configuración de la cadena de un vistazo

Usa estos valores al configurar una billetera, un cliente Subtensor o una sonda de monitoreo.

Para un endpoint gestionado, reemplaza el host con tu propia URL con clave. La página de la red Bittensor Finney enumera los detalles actuales del endpoint, y redes RPC compatibles muestra qué más sirve OnFinality.

Paso a paso: de máquina vacía a minero registrado

1. Instalar las herramientas

La mayoría de los flujos de trabajo de subred usan el SDK de Python de Bittensor y un repositorio específico de la subred. Instala el SDK en un entorno virtual para que las dependencias de la subred no colisionen.

python3 -m venv ~/.bt
source ~/.bt/bin/activate
pip install bittensor
btcli --version

2. Crear billeteras

Crea una coldkey y una hotkey. Almacena la frase mnemónica de la coldkey fuera de línea. La hotkey es la identidad que tu minero usa en la cadena.

btcli wallet new_coldkey --wallet.name miner
btcli wallet new_hotkey --wallet.name miner --wallet.hotkey default

3. Apuntar el cliente a un endpoint RPC

Aquí es donde la mayoría de los tutoriales se vuelven vagos. Establece el endpoint explícitamente para que cada comando use la misma conexión a la cadena.

export BT_NO_PROMPT=true
btcli subnet list --subtensor.network finney --subtensor.chain_endpoint https://bittensor-finney.api.onfinality.io/public

Si estás usando un endpoint gestionado, sustituye tu URL con clave. Mantener el endpoint en una variable de entorno evita la deriva entre el registro, las lecturas del metagrafo y el inicio del minero.

4. Verificar la conexión antes de gastar TAO

No te registres a ciegas. Confirma que el endpoint responde y devuelve un bloque actual antes de comprometer fondos.

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

Una respuesta válida incluye un encabezado de bloque con un número de bloque reciente. Si no lo hace, soluciona la conectividad antes de registrarte.

5. Registrarse en una subred

Elige una subred cuyo mecanismo de incentivos coincida con el hardware que realmente tienes. El costo de registro varía con la demanda, así que verifica el precio actual primero.

btcli subnet register --netuid <NETUID> \
  --wallet.name miner --wallet.hotkey default \
  --subtensor.chain_endpoint https://bittensor-finney.api.onfinality.io/public

6. Ejecutar el minero

Cada subred incluye su propio punto de entrada del minero. El patrón es consistente: pasa la red, netuid, billetera y a menudo un puerto de axón para que los validadores puedan alcanzarte.

python neurons/miner.py \
  --netuid <NETUID> \
  --wallet.name miner \
  --wallet.hotkey default \
  --subtensor.chain_endpoint wss://bittensor-finney.api.onfinality.io/public-ws \
  --axon.port 8091

Usa el endpoint WebSocket para mineros de larga duración. Mantiene una suscripción persistente a nuevos bloques en lugar de sondear, lo que reduce la rotación de reconexiones.

Mantener un minero en línea sin supervisarlo constantemente

El registro es un costo único. Mantenerse registrado y receptivo es el trabajo continuo. Los modos de fallo son predecibles:

Un bucle de monitoreo simple detecta la mayoría de estos casos a tiempo. Sondea el endpoint y el endpoint de salud de tu minero de forma programada.

while true; do
  curl -sf -H 'Content-Type: application/json' \
    -d '{"jsonrpc":"2.0","id":1,"method":"chain_getHeader","params":[]}' \
    https://bittensor-finney.api.onfinality.io/public \
    > /dev/null && echo "rpc ok $(date -u +%FT%TZ)" || echo "rpc fail $(date -u +%FT%TZ)"
  sleep 60
done

Ejecuta el minero bajo systemd o una política de reinicio de contenedor para que una caída no te cueste emisiones silenciosamente.

Cuándo dejar el endpoint público

Un endpoint público está bien para aprender, registrarse y lecturas ocasionales. Se convierte en una responsabilidad cuando ejecutas un minero del que dependen los validadores.

Cambia a una configuración gestionada o dedicada cuando se aplique cualquiera de estas:

• Ejecutas más de un minero o subred y necesitas rendimiento aislado.
• Necesitas suscripciones WebSocket que permanezcan abiertas durante días.
• Necesitas consultas históricas o de archivo para herramientas.
• Quieres que la salud del endpoint se gestione por ti en lugar de depurarla a las 3 a.m.

OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados para Bittensor y otras redes. La página del servicio API cubre endpoints gestionados, y nodos dedicados cubre implementaciones aisladas. Para un marco de comparación más amplio, lee cómo elegir un proveedor de RPC.

Errores comunes que desperdician TAO

• Registrarse antes de probar el endpoint. Una conexión caída durante el registro desperdicia la tarifa.
• Usar la coldkey en el host del minero. El minero solo necesita la hotkey. Mantén la coldkey fuera de línea.
• Ignorar la accesibilidad del axón. Si los validadores no pueden alcanzar tu puerto, tus respuestas nunca se puntúan.
• Sondear en lugar de suscribirse. Sondear un metagrafo en un bucle ajustado invita a presión de tasa y lecturas obsoletas.
• Sin política de reinicio. Un minero caído deja de ganar hasta que alguien lo nota.
• Elegir una subred que no puedes servir. Haz coincidir la tarea de la subred con tu hardware y habilidades reales.

Puntos clave

• La minería de Bittensor es puntuación de subred, no minería de hash. Registras una hotkey y compites por la calidad de las respuestas.
• El registro, las lecturas del metagrafo y la sincronización de pesos dependen de una conexión RPC de Subtensor estable.
• Usa el endpoint HTTP de Bittensor Finney para la configuración y el endpoint WebSocket para mineros de larga duración.
• Verifica que el endpoint devuelva un bloque actual antes de gastar TAO en el registro.
• Ejecuta mineros bajo un supervisor y monitorea tanto el endpoint RPC como el puerto del axón.
• Cambia a un endpoint gestionado o dedicado cuando ejecutes mineros de producción de los que dependan los validadores.

Preguntas frecuentes

¿Necesito una GPU para minar Bittensor?

Depende de la subred. Algunas subredes son intensivas en cómputo y esperan GPUs; otras recompensan datos, APIs o servicios especializados. Verifica el mecanismo de incentivos de la subred antes de comprar hardware.

¿Cuánto TAO cuesta el registro?

El costo de registro es dinámico y sube a medida que se llenan las ranuras de la subred. Verifica el precio actual con la CLI antes de registrarte en lugar de asumir un número fijo.

¿Puedo minar Bittensor con un endpoint RPC público?

Sí, para aprender y registrarse. Para un minero que debe permanecer en línea y responder a los validadores continuamente, un endpoint gestionado o dedicado es la opción operativa más confiable.

¿Por qué mi minero sigue siendo desregistrado?

Generalmente porque perdió bloques mientras estaba fuera de línea o no se pudo alcanzar. Usa un supervisor de procesos, mantén el endpoint estable y confirma que tu puerto de axón sea accesible externamente.

¿Debo usar HTTP o WebSocket para el minero?

Usa WebSocket para mineros de larga duración para que las actualizaciones de bloques lleguen en flujo. HTTP está bien para comandos puntuales como el registro y la verificación de saldo.

¿Dónde encuentro los detalles actuales del endpoint de Bittensor?

Consulta la página de la red Bittensor Finney para detalles del endpoint y transporte, y redes RPC compatibles para otras cadenas.