util_verify

Comportamiento

Verifica una firma criptográfica

• Si la clave pública tiene el prefijo 0xED, se usa ED25519
• En caso contrario, se asume SECP256k1

Definición

C

int64_t util_verify (
    uint32_t dread_ptr,
    uint32_t dread_len,
    uint32_t sread_ptr,
    uint32_t sread_len,
    uint32_t kread_ptr,
    uint32_t kread_len
);

JavaScript

function util_verify(
    signedData: ByteArray | HexString,
    signature: ByteArray | HexString,
    pubkey: ByteArray | HexString
  ): 0 | 1

Ejemplo

C

if (!util_verify(payload_ptr,    payload_len,
                 signature_ptr,  signature_len,
                 publickey_ptr,  publickey_len))
  rollback("Firma inválida", 17, 60);

JavaScript

if (util_verify(signedData, signature, pubkey))
    rollback("Firma inválida", 60)

Parámetros

C

Nombre	Tipo	Descripción
dread_ptr	uint32_t	Puntero a los datos firmados
dread_len	uint32_t	Longitud de los datos firmados
sread_ptr	uint32_t	Puntero a la firma
sread_len	uint32_t	Longitud de la firma
kread_ptr	uint32_t	Puntero a la clave pública
kread_len	uint32_t	Longitud de la clave pública

JavaScript

Nombre	Tipo	Descripción
signedData	number / string	Datos firmados a verificar, como array de números o string
signature	number / string	Firma a verificar, como array de números o string
pubkey	number / string	Clave pública asociada a la firma, como array de números o string

Código de retorno

C

Tipo	Descripción
int64_t	0 - validación fallida, la firma es inválida. 1 - validación correcta, la firma es válida. Si es negativo, indica error: OUT_OF_BOUNDS punteros/longitudes fuera de la memoria del hook.

JavaScript

Tipo	Descripción
number	0 - validación fallida, la firma es inválida. 1 - validación correcta, la firma es válida.