2014-08-12 02:26:14 +00:00
|
|
|
// Bitcoin secp256k1 bindings
|
|
|
|
// Written in 2014 by
|
|
|
|
// Dawid Ciężarkiewicz
|
|
|
|
// Andrew Poelstra
|
|
|
|
//
|
|
|
|
// To the extent possible under law, the author(s) have dedicated all
|
|
|
|
// copyright and related and neighboring rights to this software to
|
|
|
|
// the public domain worldwide. This software is distributed without
|
|
|
|
// any warranty.
|
|
|
|
//
|
|
|
|
// You should have received a copy of the CC0 Public Domain Dedication
|
|
|
|
// along with this software.
|
|
|
|
// If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
|
|
|
|
//
|
2014-08-09 20:27:08 +00:00
|
|
|
|
|
|
|
//! FFI bindings
|
2015-04-06 05:13:38 +00:00
|
|
|
use libc::{c_int, c_uchar, c_uint, c_void};
|
2015-01-17 16:38:16 +00:00
|
|
|
|
|
|
|
pub const SECP256K1_START_VERIFY: c_uint = 0x1;
|
|
|
|
pub const SECP256K1_START_SIGN: c_uint = 0x2;
|
2014-08-09 20:27:08 +00:00
|
|
|
|
2015-04-06 05:13:38 +00:00
|
|
|
/// A nonce generation function. Ordinary users of the library
|
|
|
|
/// never need to see this type; only if you need to control
|
|
|
|
/// nonce generation do you need to use it. I have deliberately
|
|
|
|
/// made this hard to do: you have to write your own wrapper
|
|
|
|
/// around the FFI functions to use it. And it's an unsafe type.
|
|
|
|
/// Nonces are generated deterministically by RFC6979 by
|
|
|
|
/// default; there should be no need to ever change this.
|
|
|
|
pub type NonceFn = unsafe extern "C" fn(nonce32: *mut c_uchar,
|
|
|
|
msg32: *const c_uchar,
|
|
|
|
key32: *const c_uchar,
|
|
|
|
attempt: c_uint,
|
|
|
|
data: *const c_void);
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
#[repr(C)]
|
|
|
|
struct ContextInner;
|
|
|
|
|
|
|
|
/// A Secp256k1 context, containing various precomputed values and such
|
|
|
|
/// needed to do elliptic curve computations. If you create one of these
|
|
|
|
/// with `secp256k1_context_create` you MUST destroy it with
|
|
|
|
/// `secp256k1_context_destroy`, or else you will have a memory leak.
|
|
|
|
/// Furthermore, you MUST NOT use this object after destroying it; it is
|
|
|
|
/// `Copy` so the compiler will not help you to avoid this. There is no
|
|
|
|
/// need for ordinary users of this library to ever use this type directly.
|
|
|
|
#[repr(C)]
|
|
|
|
#[allow(raw_pointer_derive)]
|
|
|
|
#[derive(Copy, Clone, Debug)]
|
|
|
|
pub struct Context(*mut ContextInner);
|
|
|
|
|
2015-04-14 01:41:24 +00:00
|
|
|
unsafe impl Send for Context {}
|
|
|
|
unsafe impl Sync for Context {}
|
|
|
|
|
2014-08-09 20:27:08 +00:00
|
|
|
#[link(name = "secp256k1")]
|
|
|
|
extern "C" {
|
2015-04-06 05:13:38 +00:00
|
|
|
pub static secp256k1_nonce_function_rfc6979: NonceFn;
|
|
|
|
|
|
|
|
pub static secp256k1_nonce_function_default: NonceFn;
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_context_create(flags: c_uint) -> Context;
|
2014-08-10 01:03:17 +00:00
|
|
|
|
2015-04-12 14:36:49 +00:00
|
|
|
pub fn secp256k1_context_clone(cx: Context) -> Context;
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_context_destroy(cx: Context);
|
2014-08-10 01:03:17 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ecdsa_verify(cx: Context, msg32: *const c_uchar,
|
2014-08-10 01:03:17 +00:00
|
|
|
sig: *const c_uchar, sig_len: c_int,
|
|
|
|
pk: *const c_uchar, pk_len: c_int)
|
|
|
|
-> c_int;
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_pubkey_create(cx: Context,
|
|
|
|
pk: *mut c_uchar, pk_len: *mut c_int,
|
2015-01-17 16:38:16 +00:00
|
|
|
sk: *const c_uchar, compressed: c_int)
|
|
|
|
-> c_int;
|
2014-08-10 01:03:17 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ecdsa_sign(cx: Context, msg32: *const c_uchar,
|
2014-08-10 01:03:17 +00:00
|
|
|
sig: *mut c_uchar, sig_len: *mut c_int,
|
2015-04-06 05:13:38 +00:00
|
|
|
sk: *const c_uchar,
|
|
|
|
noncefn: NonceFn, noncedata: *const c_void)
|
2014-08-10 01:03:17 +00:00
|
|
|
-> c_int;
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ecdsa_sign_compact(cx: Context, msg: *const c_uchar,
|
2014-08-10 01:03:17 +00:00
|
|
|
sig64: *mut c_uchar, sk: *const c_uchar,
|
2015-04-06 05:13:38 +00:00
|
|
|
noncefn: NonceFn, noncedata: *const c_void,
|
|
|
|
recid: *mut c_int)
|
2014-08-10 01:03:17 +00:00
|
|
|
-> c_int;
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ecdsa_recover_compact(cx: Context, msg32: *const c_uchar,
|
2014-08-10 01:03:17 +00:00
|
|
|
sig64: *const c_uchar, pk: *mut c_uchar,
|
|
|
|
pk_len: *mut c_int, compressed: c_int,
|
|
|
|
recid: c_int) -> c_int;
|
2014-08-24 23:13:08 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_seckey_verify(cx: Context,
|
|
|
|
sk: *const c_uchar) -> c_int;
|
2014-08-28 16:16:53 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_pubkey_verify(cx: Context,
|
|
|
|
pk: *const c_uchar,
|
2015-01-17 16:38:16 +00:00
|
|
|
pk_len: c_int) -> c_int;
|
2014-08-31 21:04:14 +00:00
|
|
|
|
2015-04-06 05:13:38 +00:00
|
|
|
//TODO secp256k1_ec_pubkey_decompress
|
|
|
|
//TODO secp256k1_ec_privkey_export
|
|
|
|
//TODO secp256k1_ec_privkey_import
|
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_privkey_tweak_add(cx: Context,
|
|
|
|
sk: *mut c_uchar,
|
2015-01-17 16:38:16 +00:00
|
|
|
tweak: *const c_uchar)
|
|
|
|
-> c_int;
|
2014-08-28 16:16:53 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_pubkey_tweak_add(cx: Context,
|
|
|
|
pk: *mut c_uchar,
|
2015-01-17 16:38:16 +00:00
|
|
|
pk_len: c_int,
|
|
|
|
tweak: *const c_uchar)
|
|
|
|
-> c_int;
|
2014-08-28 16:16:53 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_privkey_tweak_mul(cx: Context,
|
|
|
|
sk: *mut c_uchar,
|
2015-01-17 16:38:16 +00:00
|
|
|
tweak: *const c_uchar)
|
|
|
|
-> c_int;
|
2014-08-28 16:16:53 +00:00
|
|
|
|
2015-04-11 17:00:20 +00:00
|
|
|
pub fn secp256k1_ec_pubkey_tweak_mul(cx: Context,
|
|
|
|
pk: *mut c_uchar,
|
2015-01-17 16:38:16 +00:00
|
|
|
pk_len: c_int,
|
|
|
|
tweak: *const c_uchar)
|
|
|
|
-> c_int;
|
2014-08-09 20:27:08 +00:00
|
|
|
}
|
|
|
|
|