Códigos QR de vinculación
La vinculación proporciona a tu cartera las claves públicas que necesita para mostrar saldos y construir transacciones. En BitTool Signer, el usuario abre una cartera y toca Connect (conectar), que tiene dos pestañas.
| Nivel de cartera | Nivel de moneda | |
|---|---|---|
| Contenido del QR | Un código QR ur:bytes animado | Un código QR por cadena y tipo de cuenta |
| Cadenas | Bitcoin (4 tipos de dirección), EVM, TRON, Solana (3 preajustes) | La cadena que elija el usuario |
| Formato | 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 | Carteras multicadena que quieren un solo escaneo | Carteras que ya admiten dispositivos de firma por hardware mediante QR (estilo Keystone) |
| Compatible actualmente con | BitTool Wallet | Sparrow, BlueWallet, MetaMask, Rabby, Solflare y otras (consulta Compatibilidad) |
Ambas son exportaciones de solo lectura de las mismas claves públicas; el código a nivel de cartera es simplemente todas ellas a la vez. Ninguna necesita la contraseña de la cartera y ninguna contiene la frase, la semilla ni ninguna clave privada.
Qué guardar
Por cada cuenta que importes, conserva:
| Campo | Por qué |
|---|---|
| Huella maestra (8 dígitos hex) | Va en cada solicitud de firma para que BitTool Signer pueda encontrar la cartera |
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 las 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 que solo contienen la dirección) | Solana no tiene xpub; cada preajuste es una sola clave |
Deriva las direcciones localmente a partir del xpub. No pidas nunca 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 esas mismas direcciones en tu app y pide al usuario que las compare completas, no solo los primeros y los últimos caracteres. Esta es la única defensa contra una vinculación manipulada o errónea, porque el propio código QR no está firmado.
Duplicados y nueva vinculación
- Trata una vinculación como la misma cartera solo si las claves públicas coinciden. La huella por sí sola no basta.
- Si una nueva vinculación tiene una huella conocida pero claves distintas, no sobrescribas la cartera existente (una passphrase BIP39 diferente produce exactamente esto).
- Volver a vincular las mismas claves después de reinstalar cualquiera de las dos apps debería restaurar la misma cartera, no crear una segunda.
Red
Todas las exportaciones son de mainnet: Bitcoin mainnet, las ocho redes EVM compatibles, TRON mainnet y Solana mainnet-beta. No se exportan claves de testnet.