secp_bridge.h

Go to the documentation of this file.

// Copyright (c) 2026 Judica, Inc.
// Distributed under the MIT software license, see the accompanying
// file COPYING or https://opensource.org/license/mit/.
 
#pragma once
 
#include <stddef.h>
#include <stdint.h>
 
#include "purify/secp_context.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct purify_scalar {
    uint64_t words[4];
} purify_scalar;
 
void purify_scalar_set_int(purify_scalar* out, unsigned int value);
void purify_scalar_set_u64(purify_scalar* out, uint64_t value);
void purify_scalar_set_b32(purify_scalar* out, const unsigned char input32[32], int* overflow);
void purify_scalar_get_b32(unsigned char output32[32], const purify_scalar* value);
 
int purify_scalar_is_zero(const purify_scalar* value);
int purify_scalar_is_one(const purify_scalar* value);
int purify_scalar_is_even(const purify_scalar* value);
int purify_scalar_eq(const purify_scalar* lhs, const purify_scalar* rhs);
 
void purify_scalar_negate(purify_scalar* out, const purify_scalar* value);
void purify_scalar_inverse(purify_scalar* out, const purify_scalar* value);
void purify_scalar_inverse_var(purify_scalar* out, const purify_scalar* value);
int purify_scalar_add(purify_scalar* out, const purify_scalar* lhs, const purify_scalar* rhs);
void purify_scalar_mul(purify_scalar* out, const purify_scalar* lhs, const purify_scalar* rhs);
void purify_scalar_cmov(purify_scalar* dst, const purify_scalar* src, int flag);
 
void purify_sha256(unsigned char output32[32], const unsigned char *data,
                   size_t data_len);
 
int purify_sha256_many(unsigned char output32[32],
                       const unsigned char *const *items,
                       const size_t *item_lens,
                       size_t items_count);
 
void purify_hmac_sha256(unsigned char output32[32],
                        const unsigned char* key, size_t key_len,
                        const unsigned char* data, size_t data_len);
 
int purify_bip340_key_from_seckey(purify_secp_context* context,
                                  unsigned char seckey32[32],
                                  unsigned char xonly_pubkey32[32]);
 
int purify_bip340_nonce_from_scalar(purify_secp_context* context,
                                    unsigned char scalar32[32],
                                    unsigned char xonly_nonce32[32]);
 
int purify_bip340_xonly_from_point(purify_secp_context* context,
                                   const unsigned char point33[33],
                                   unsigned char xonly32[32],
                                   int* parity_out);
 
int purify_bip340_validate_xonly_pubkey(purify_secp_context* context,
                                        const unsigned char xonly_pubkey32[32]);
 
int purify_bip340_validate_signature(purify_secp_context* context,
                                     const unsigned char sig64[64]);
 
int purify_bip340_sign_with_fixed_nonce(purify_secp_context* context,
                                        unsigned char sig64[64],
                                        const unsigned char* msg, size_t msglen,
                                        const unsigned char seckey32[32],
                                        const unsigned char nonce32[32]);
 
int purify_bip340_verify(purify_secp_context* context,
                         const unsigned char sig64[64],
                         const unsigned char* msg, size_t msglen,
                         const unsigned char xonly_pubkey32[32]);
 
#ifdef __cplusplus
}
#endif