Firma y verifica mensajes con una cartera Blocknet

Usa una firma de mensaje Blocknet para demostrar el control de una dirección sin realizar un pago. Esta guía sigue el CLI oficial v1.2.0 y core v0.22.0, comprobados el 27 de octubre de 2026. Prepararás un reto claro, lo firmarás en la cartera elegida y verificarás juntos la dirección completa, el mensaje y la firma.

¿Cómo se firma y verifica un mensaje Blocknet?

Acuerda qué significará el mensaje firmado

Empieza con una petición concreta: ¿qué dirección debe demostrar control, ante quién y para qué acción? Una prueba de pago establece detalles de una transacción. Una firma de mensaje sirve cuando la cuestión es el control de una clave de firma, por ejemplo para confirmar una dirección asociada a una cuenta. La guía de carteras explica cómo crear y abrir la cartera que firmará.

Pide al verificador un reto nuevo e impredecible para esta solicitud. Incluye contexto suficiente para identificar el servicio o destinatario y la acción prevista, y acuerda una caducidad si el proceso la necesita. Son reglas de la aplicación: el verificador de firmas no impone automáticamente novedad, caducidad ni uso único. Quien verifica debe comparar el mensaje con la petición y registrar cuándo se ha utilizado el reto.

Abre la cartera completa prevista

Conéctate a tu core de mainnet en ejecución desde una terminal:

blocknet attach mainnet

Dentro del intérprete interactivo, carga la cartera y comprueba su dirección:

load
address

Selecciona el archivo correcto y desbloquéalo mediante el cliente si se solicita. Compara la dirección completa con la esperada por el verificador, especialmente si guardas varios archivos de cartera en el mismo equipo.

El core revisado firma mensajes con la clave privada de gasto de la cartera. Una cartera de solo lectura no puede realizar esta operación. Mantén la cartera completa en el equipo previsto; quien verifica solo necesita la firma resultante e información pública. No necesitas enviar fondos ni exportar un archivo de cartera para completar la firma.

Prepara el texto exacto antes de firmar

Lee toda la solicitud y confirma que aceptas su propósito. El cliente oficial lee una línea, elimina espacios al principio y al final y rechaza mensajes vacíos o de más de 1024 bytes. El límite cuenta bytes, por lo que los caracteres no ASCII pueden ocupar varios. Usa una línea breve e inequívoca y conserva el texto exacto enviado.

Mantén mayúsculas, puntuación y espacios internos al pasar el mensaje al verificador. Un editor o aplicación de chat puede sustituir comillas o modificar el texto copiado; compara el mensaje real si falla la verificación. Para iniciar sesión o gestionar una cuenta, sigue el formato de reto documentado por el servicio. No reescribas silenciosamente el texto solicitado: debe comprobarse el reto concreto emitido.

Firma el mensaje en el intérprete oficial

Inicia la solicitud dentro del intérprete interactivo:

sign

El cliente pide el texto. Pega el mensaje de una sola línea acordado y pulsa Intro. Si termina correctamente, imprime una firma hexadecimal. Copia la salida completa conservando todos sus caracteres. La implementación del cliente envía el mensaje al endpoint de firma de la cartera; esta operación no crea ni transmite una transacción.

Entrega la dirección completa, el mensaje exacto y la firma como valores separados. Etiquétalos claramente para no confundir la firma con el texto o una dirección. Mantén privados la semilla de recuperación, las claves privadas y la contraseña. La guía de semillas explica el material de recuperación; nada de ello forma parte de las pruebas que envías a quien comprueba una firma.

¿Cómo verifica la firma la otra persona?

Usa la solicitud de verificación del intérprete oficial con un core compatible en ejecución:

verify

Introduce primero la dirección completa, después el mensaje exacto y finalmente la firma hexadecimal. La referencia del intérprete documenta esta secuencia. La verificación no necesita una cartera cargada, así que puede comprobar las pruebas sin importar la cartera del firmante ni manejar claves privadas.

El cliente revisado muestra Signature is VALID si la combinación verifica y Signature is INVALID si no. Un error de formato es un resultado distinto: revisa todos los campos y conserva las pruebas originales antes de repetir. Si el mensaje o la dirección difieren de la solicitud esperada, resuelve la diferencia incluso cuando la firma sea matemáticamente válida para los valores suministrados.

Interpreta el resultado en el contexto de la solicitud

Una firma válida verifica el mensaje con la clave pública de gasto codificada en la dirección suministrada. No establece una identidad legal, muestra un saldo ni demuestra un pago. Para cuestiones de pagos, usa el registro de envío, la consulta del explorador y la prueba específica de la transacción. Elige la evidencia que responda a la pregunta real, sin tratar cualquier firma válida como un recibo.

Comprueba que el reto sea nuevo y esté dirigido al destinatario previsto antes de aceptarlo. Alguien puede copiar un mensaje y firma válidos y presentarlos de nuevo. Un servicio que necesita autorización de un solo uso debe aplicar esa regla. Igualmente, una caducidad escrita en el mensaje solo tiene efecto si el verificador la comprueba. Estas comprobaciones vinculan la validez criptográfica con la acción acordada.

Conserva un registro de verificación claro

Guarda juntos la dirección, el mensaje exacto, la firma, el contexto de la solicitud y el resultado cuando tu proceso necesite un registro de auditoría. Anota la hora de comprobación aparte de cualquier fecha escrita por el firmante. Evita información personal ajena al propósito: cualquiera que reciba el texto firmado puede leerlo y copiarlo. Comparte las pruebas con el verificador previsto por el canal acordado.

Si recibes pagos de minería en esa cartera, el seguimiento del pool sigue proporcionando los registros de shares y pagos; una firma de mensaje no los sustituye. La guía de nodos cubre el core necesario para el intérprete oficial. Tras completar la comprobación acordada, conserva el acceso de firma en tu cartera completa y deja la verificación pública a quienes comprueben el resultado.