Crate secp256k1_zkp

Secp256k1-zkp

Rust bindings for libsecp256k1-zkp, a fork of Pieter Wuille’s secp256k1 library.

This library re-exports everything from secp256k1 and adds bindings for the following modules:

• generators
• range proofs
• pedersen commitments

As such, it can be used as a drop-in replacement for secp256k1. All types are interoperable (as long as you are dependening on the correct version) which means SecretKeys and the Context are interoperable.

Re-exports

pub extern crate rand;

pub extern crate secp256k1_zkp_sys;

pub extern crate serde;

pub use secp256k1_zkp_sys as ffi;

Modules

constants

Constants related to the API and the underlying curve.

ecdh

Support for shared secret computations.

ecdsa

Structs and functionality related to the ECDSA signature algorithm.

rand

Utilities for random number generation

schnorr

schnorrsig

schnorrsigDeprecated

Schnorr Signature related methods.

secp256k1_sys

secp256k1-sys FFI bindings

serde

Serde

Structs

AllPreallocated

Represents the set of all capabilities with a user preallocated memory.

CommitmentSecrets

Represents all secret data involved in making a PedersenCommitment where one of the generators is blinded.

EcdsaAdaptorSignature

Represents an adaptor signature and dleq proof.

Generator

Represents a generator on the secp256k1 curve.

InvalidParityValue

Error returned when conversion from an integer to Parity fails.

KeyPair

Opaque data structure that holds a keypair consisting of a secret and a public key.

Message

A (hashed) message input to an ECDSA signature.

Opening

The result of rewinding a range proof.

PedersenCommitment

Represents a commitment to a single u64 value.

PublicKey

A Secp256k1 public key, used for verification of signatures.

RangeProof

Represents a range proof.

Secp256k1

The secp256k1 engine, used to execute all signature operations.

SecretKey

Secret 256-bit key used as x in an ECDSA signature.

SignOnlyPreallocated

Represents the set of capabilities needed for signing with a user preallocated memory.

SurjectionProof

Represents a surjection proof.

Tag

Represents a tag.

Tweak

Represents a blinding factor/Tweak on secp256k1 curve

VerifyOnlyPreallocated

Represents the set of capabilities needed for verification with a user preallocated memory.

WhitelistSignature

A whitelist ring signature.

XOnlyPublicKey

An x-only public key, used for verification of Schnorr signatures and serialized according to BIP-340.

Enums

All

Represents the set of all capabilities.

Error

An ECDSA error

Error

An ECDSA error

Parity

Represents the parity passed between FFI function calls.

SignOnly

Represents the set of capabilities needed for signing.

UpstreamError

An ECDSA error

VerifyOnly

Represents the set of capabilities needed for verification.

Constants

ONE_KEY

The number 1 encoded as a secret key.

ZERO_TWEAK

The zero Tweak

Traits

Context

A trait for all kinds of contexts that lets you define the exact flags and a function to deallocate memory. It isn’t possible to implement this for types outside this crate.

Signing

Marker trait for indicating that an instance of Secp256k1 can be used for signing.

ThirtyTwoByteHash

Trait describing something that promises to be a 32-byte random number; in particular, it has negligible probability of being zero or overflowing the group order. Such objects may be converted to Messages without any error paths.

Verification

Marker trait for indicating that an instance of Secp256k1 can be used for verification.

Functions

compute_adaptive_blinding_factor

Compute a blinding factor such that the sum of all blinding factors in both sets is equal.

verify_commitments_sum_to_equal

Verifies that the sum of the committed values within the commitments of both sets is equal.

Type Definitions

SignatureDeprecated

backwards compatible re-export of ecdsa signatures