Códigos QR de emparejamiento
El emparejamiento le da a tu billetera las claves públicas que necesita para mostrar saldos y construir transacciones. En BitTool Signer, el usuario abre una billetera y toca Connect (Conectar), que tiene dos pestañas.
| Nivel de billetera | Nivel de moneda | |
|---|---|---|
| Contenido del QR | Un código QR animado ur:bytes | Un código QR por cadena y tipo de cuenta |
| Cadenas | Bitcoin (4 tipos de dirección), EVM, TRON, Solana (3 presets) | La cadena que el usuario selecciona |
| Formato | El formato propio de BitTool bittool-signer-wallet v1 | Tipos UR estándar: crypto-account, crypto-hdkey, crypto-multi-accounts, o una dirección simple |
| Ideal para | Billeteras multicadena que quieren un solo escaneo | Billeteras que ya admiten firmadores de hardware por QR (estilo Keystone) |
| Compatible actualmente con | BitTool Wallet | Sparrow, BlueWallet, MetaMask, Rabby, Solflare y otras (consulta Compatibilidad) |
Ambos son exportaciones de solo lectura de las mismas claves públicas; el código a nivel de billetera simplemente las incluye todas a la vez. Ninguno necesita la contraseña de la billetera, y ninguno contiene la frase, la semilla ni ninguna clave privada.
Qué guardar
Para cada cuenta que importes, conserva:
| Campo | Por qué |
|---|---|
| Huella digital maestra (8 dígitos hex) | Va en cada solicitud de firma para que BitTool Signer pueda encontrar la billetera |
Ruta de la cuenta, p. ej. m/84'/0'/0' | El prefijo de cada ruta completa que pongas en una solicitud |
| xpub de la cuenta (Bitcoin, EVM, TRON) | Para derivar direcciones de recepción y de cambio |
| Tipo de script (Bitcoin) | Determina el formato de dirección y los campos del PSBT |
| Dirección y ruta completa (Solana, y exportaciones de TRON o EVM solo con dirección) | Solana no tiene xpub; cada preset es una sola clave |
Deriva las direcciones localmente a partir del xpub. Nunca le pidas al usuario la frase de recuperación, y no intentes derivar las claves de una cadena a partir del xpub de otra cadena.
Deja que el usuario verifique
BitTool Signer muestra la primera dirección de cada cuenta exportada debajo del código QR. Después de importar, muestra las mismas direcciones en tu app y pide al usuario que las compare completas, no solo los primeros y últimos caracteres. Esta es la única defensa contra un emparejamiento manipulado o erróneo, porque el código QR en sí no está firmado.
Duplicados y nuevo emparejamiento
- Trata un emparejamiento como la misma billetera solo si las claves públicas coinciden. La huella digital por sí sola no es suficiente.
- Si un nuevo emparejamiento tiene una huella digital conocida pero claves diferentes, no sobrescribas la billetera existente (una passphrase BIP39 diferente produce exactamente esto).
- Volver a emparejar las mismas claves después de reinstalar cualquiera de las dos apps debe restaurar la misma billetera, no crear una segunda.
Red
Todas las exportaciones son de mainnet: Bitcoin mainnet, las ocho redes EVM compatibles, TRON mainnet y Solana mainnet-beta. Las claves de testnet no se exportan.