Saltar al contenido
HeartBadge docs

Identificador de Insignia

Live

Tu ID de 20 dígitos: qué significa, cómo está estructurado y por qué puedes compartirlo de forma segura.

Cada insignia tiene un identificador único de 20 dígitos. Este identificador es la forma canónica de referenciar una insignia — en escaneos, en transacciones de recompensas, en llamadas API y en cualquier comunicación entre miembros. Es seguro compartirlo, verificable sin conexión y diseñado para ser difícil de escribir mal.

Cómo se ve

Un identificador de insignia se ve así:

8470 2613 9854 1200 37

Se muestra en grupos de 4 dígitos para facilitar la lectura, pero el valor subyacente es un solo número de 20 dígitos.

Checksum Luhn

El último dígito del identificador es un dígito de verificación Luhn — el mismo algoritmo utilizado en los números de tarjetas de crédito. Si escribes mal un dígito al ingresar un identificador de insignia, el checksum fallará y el sistema lo rechazará antes de que ocurra cualquier consulta. Esto detecta errores comunes de transcripción (dígitos intercambiados, un solo dígito incorrecto) con alta fiabilidad.

Qué codifica el identificador

El identificador de 20 dígitos se deriva de la posición en cadena de la insignia:

  • Colección (programa). A qué programa pertenece la insignia.
  • Grupo. Una subdivisión dentro del programa (ej., VIP vs. entrada general).
  • Nivel. El nivel de acceso dentro del grupo.
  • Secuencia. El orden de acuñación dentro de esa colección/grupo/nivel.

La ruta de derivación completa es m/721'/0'/{group}'/{tier}'/{seq}. Ver Rutas de Derivación.

Seguro de compartir

Tu identificador de insignia no es un secreto. Es la dirección pública de tu insignia — como una dirección de correo electrónico o un número de teléfono. Cualquiera que conozca tu identificador puede:

  • Enviarte recompensas
  • Consultar el estado de tu insignia (si lo has hecho público)
  • Referenciarte en atestiguaciones de co-firma

Lo que no pueden hacer solo con el identificador:

  • Mover tus recompensas
  • Firmar transacciones como tú
  • Acceder a tus datos privados

El identificador es el "qué"; la clave de identidad (que tienes privadamente) es el "cómo". La propiedad requiere ambos.

Dónde lo verás

  • En tu tarjeta de insignia
  • En los recibos de transacciones cuando envías o recibes recompensas
  • En las respuestas de la API al consultar el estado de la insignia
  • En los registros de atestiguación (registros de entrada, co-firmas)

Si alguna vez necesitas referenciar tu insignia en una solicitud de soporte, usa este identificador — es la forma canónica de localizarte.