MPC · Solicitar firma
Hay tres preocupaciones de firma separadas: autenticar la solicitud HTTP, autorizar un retiro específico y producir la firma de blockchain con los MPC participantes. Pasar el primer control no reemplaza los otros dos.
Autenticar una solicitud API
El API actual usa HMAC-SHA256 con un identificador de clave y un secreto API. Su solicitud canónica contiene cinco líneas, separadas por una nueva línea, sin una nueva línea al final:
Utilice el método HTTP en mayúsculas y solicite la ruta sin el host. Ordene las claves de consulta, mantenga el orden de los valores repetidos y aplique la codificación del formato URL, incluido + para los espacios. La línea de consulta está vacía cuando no existe ninguna consulta. Hash los bytes exactos del cuerpo usando SHA-256, incluido el cuerpo vacío para una solicitud sin cuerpo.
Calcule HMAC-SHA256 utilizando el secreto proporcionado como UTF-8 bytes; no lo decodifique en hexadecimal simplemente porque parece hexadecimal. Codifique el resultado como hexadecimal en minúscula. Los campos del encabezado están separados por espacios:
Ejemplo de firma de solo lectura
Este asistente de biblioteca estándar construye encabezados para una consulta de depósito; no envía una solicitud. Cargue las credenciales de forma segura en su aplicación y envíe la ruta devuelta sin cambios a la base URL proporcionada para su entorno.
Mantenga los relojes sincronizados. Un proxy que cambia la ruta, la consulta o el cuerpo después de firmar puede invalidar la autenticación. En caso de errores de autenticación, inspeccione el motivo de la respuesta y el identificador de solicitud antes de volver a intentarlo; nunca registre el encabezado de autorización secreto o completo.
Autorizar un retiro de API
El flujo de retiro empresarial actual API también requiere una autorización de cliente Ed25519 en client_authorization. Vincula el contexto de la transacción prevista, incluido el identificador de la solicitud, el destino, el activo y el monto. Su registro de clave pública o configuración de confianza depende del acuerdo de custodia.
Utilice el paquete de integración correspondiente para generar la carga útil canónica, la firma y la clave pública. Esta clave de autorización es independiente del secreto HMAC y del MPC compartido. Preservar su clave privada bajo el control del cliente. Confirme la versión de la carga útil y las reglas de validez durante la integración en lugar de crear un formato personalizado a partir de esta descripción general.
Una vez aceptada la solicitud, aún se pueden aplicar verificaciones y aprobaciones comerciales, seguidas de la MPC firma y confirmación en cadena. Ver transacciones y reintentos.