El sistema de claves de Bittensor
1.1. Coldkey y hotkey: la arquitectura dual
Bittensor usa un sistema de dos tipos de claves diseñado para separar seguridad y operatividad:
- Coldkey (clave fría): es tu identidad principal en la red y guarda tus fondos. NUNCA debe estar conectada a internet durante uso normal. Es el equivalente a tu cuenta bancaria principal: la usas poco, pero es donde guardas el dinero real.
- Hotkey (clave caliente): es una clave secundaria vinculada a tu coldkey. Se usa para operaciones frecuentes como registrarse en una subred, enviar consultas o recibir recompensas diarias. Está conectada a internet. Si se compromete, los fondos de la coldkey siguen seguros.
La separación coldkey/hotkey es una innovación de seguridad de Bittensor. Los fondos TAO viven en la coldkey. La hotkey opera en la red pero no puede mover esos fondos sin la autorización de la coldkey. Aunque te hackeen la hotkey, no pueden robar tu TAO.
1.2. Cómo se relacionan
La relación es jerárquica:
- Una coldkey puede tener múltiples hotkeys asociadas.
- Una hotkey siempre pertenece a una sola coldkey.
- Las recompensas se acumulan en la hotkey pero puedes transferirlas a la coldkey periódicamente.
- Para hacer staking o transferir fondos grandes, necesitas la coldkey.
- Para registrarte en una subred o minar, solo necesitas la hotkey.
| Clave | Función | Seguridad | Conectada |
|---|---|---|---|
| Coldkey | Guarda fondos TAO, firma transferencias y staking grandes | Máxima | Nunca (idealmente) |
| Hotkey | Opera en subredes, recibe recompensas diarias | Alta | Sí (servidor) |
Instalación del CLI de Bittensor
2.1. Requisitos previos
El CLI de Bittensor (btcli) se instala con Python. Necesitas:
- Python 3.10 o superior instalado en tu sistema (recomendado 3.11+).
- pip (el gestor de paquetes de Python), que viene incluido con Python 3.
- Un terminal (Terminal en Mac/Linux, PowerShell o CMD en Windows).
- Conexión a internet.
2.2. Instalación en Linux/Mac
Abre el terminal y ejecuta los siguientes comandos:
# Crear un entorno virtual (recomendado)
python3 -m venv bittensor-env
source bittensor-env/bin/activate
# Instalar bittensor
pip install bittensor
# Verificar la instalación
btcli --version
2.3. Instalación en Windows
En Windows, usa PowerShell como administrador:
# Crear entorno virtual
python -m venv bittensor-env
.\bittensor-env\Scripts\Activate.ps1
# Instalar bittensor
pip install bittensor
# Verificar
btcli --version
Si ves un número de versión (ej. 8.x.x), la instalación fue correcta. Si hay errores, revisa que Python está en el PATH del sistema.
Crear tu coldkey
3.1. El comando de creación
Con el CLI instalado, crear una coldkey es un solo comando:
btcli wallet new_coldkey --wallet.name mi-wallet
El CLI te pedirá una contraseña para cifrar la coldkey localmente. Esta contraseña protege el archivo en tu ordenador. Elige una contraseña fuerte que recuerdes.
3.2. La frase semilla (mnemonic)
Después de crear la coldkey, el CLI te mostrará una frase semilla de 12 o 24 palabras, similar a:
abandon ability able about above absent
access accident account accuse achieve acid
NUNCA muestres tu frase semilla a nadie. NUNCA la almacenes en texto digital (email, Notion, Google Drive, fotos). Escríbela en papel y guárdala en un lugar seguro. Esta frase ES tu wallet. Con ella puedes recuperar todos tus fondos en cualquier ordenador del mundo. Sin ella, si pierdes el ordenador, pierdes todo.
3.3. Dónde se guarda la coldkey
El CLI crea los archivos de la wallet en:
- Linux/Mac:
~/.bittensor/wallets/mi-wallet/coldkey - Windows:
C:\Users\TuUsuario\.bittensor\wallets\mi-wallet\coldkey
Estos archivos están cifrados con tu contraseña. Puedes hacer una copia de seguridad de la carpeta ~/.bittensor/wallets, pero la copia más importante es siempre la frase semilla en papel.
Crear tu hotkey
4.1. El comando de creación
Con la coldkey creada, ahora puedes crear una hotkey asociada:
btcli wallet new_hotkey --wallet.name mi-wallet --wallet.hotkey mi-hotkey
La hotkey tiene su propia frase semilla, separada de la coldkey. Guárdala también en papel, aunque con menor prioridad que la coldkey (recuerda: los fondos están en la coldkey, no en la hotkey).
4.2. Ver tus wallets
Para ver todas tus wallets creadas y su estado:
btcli wallet list
Para ver el balance de tu wallet:
btcli wallet balance --wallet.name mi-wallet
4.3. Tu dirección pública
Para ver tu dirección pública de coldkey (la que das a otros para recibir TAO):
btcli wallet inspect --wallet.name mi-wallet
La dirección tiene el formato SS58 de Substrate, empezando por '5': algo como 5FHneLTW.... Esta dirección es pública: puedes compartirla con quien quiera enviarte TAO, sin riesgo.
Seguridad: las reglas de oro
5.1. Las 5 reglas fundamentales
- Regla 1 — Frase semilla en papel: escribe las palabras a mano en papel. Nunca en digital. Guarda al menos dos copias en lugares físicos diferentes.
- Regla 2 — Contraseña fuerte: usa una contraseña larga y única para cifrar tu coldkey. No uses la misma que en otras cuentas.
- Regla 3 — No en el portapapeles: nunca copies tu frase semilla o clave privada al portapapeles. Puede quedar accesible a malware.
- Regla 4 — Verifica las URLs: antes de conectar tu wallet a cualquier web, verifica que la URL es correcta. Los ataques de phishing son frecuentes.
- Regla 5 — Hardware wallet para cantidades grandes: si tienes cantidades significativas de TAO, considera usar una Ledger u otro hardware wallet para custodiar la coldkey offline.
5.2. Qué hacer si pierdes tu contraseña
Si olvidas la contraseña de tu coldkey pero tienes la frase semilla, puedes recuperar la wallet con:
btcli wallet regen_coldkey --wallet.name mi-wallet-recuperada
# El CLI te pedirá las 12/24 palabras de tu frase semilla
5.3. Verificar la wallet en el explorador
Una vez creada tu wallet y depositado TAO, puedes verificar tu saldo en:
- Wallet tool — buscando tu dirección SS58.
- La dirección es pública: cualquiera puede ver el saldo, pero nadie puede mover fondos sin tu clave privada.
- Instala btcli en tu ordenador siguiendo los pasos del módulo. Verifica la instalación con
btcli --version. - Crea una coldkey de prueba llamada
prueba. Escribe las palabras semilla en papel (esta es práctica, después puedes borrarla). - Crea una hotkey llamada
hotkey-pruebaasociada a la coldkeyprueba. Ejecutabtcli wallet listy muestra el resultado. - Explica con tus palabras por qué la frase semilla es más importante que la contraseña local.
- ¿Qué diferencia hay entre perder la contraseña de tu coldkey y perder la frase semilla? ¿Cuál es recuperable?
- Compara el sistema coldkey/hotkey de Bittensor con el sistema de cuentas de un banco. ¿Qué ventajas de seguridad tiene el sistema cripto?
- Documentación oficial btcli: docs.bittensor.com/btcli — referencia completa de todos los comandos.
- BIP39 wordlist: el estándar de frases semilla de 2048 palabras usado por Bittensor y la mayoría de wallets.
- Ledger.com — hardware wallet compatible con TAO a través de la app Bittensor.
- docs.bittensor.com — para consultar documentación técnica y recursos del ecosistema.