milksad

History

Andrew Poelstra 29316efff5 add warning about fuzzing being enabled		2020-12-22 17:34:50 +00:00
..
depend	Update depend folder to latest master	2020-10-12 21:35:28 +09:00
src	add warning about fuzzing being enabled	2020-12-22 17:34:50 +00:00
wasm-sysroot	Add sanity checks for wasm32 for size and alignment of types	2020-04-29 15:32:57 -04:00
CHANGELOG.md	Update MSRV to 1.29; increase version to 0.19 and -sys version to 0.3	2020-08-27 14:18:06 +00:00
Cargo.toml	replace `fuzztarget` Cargo feature with a rustc --cfg flag	2020-12-22 15:42:02 +00:00
LICENSE	Add secp256k1-sys README and LICENSE files	2019-11-27 21:02:44 +00:00
README.md	replace cargo `external-symbols` feature with a rustc --cfg flag	2020-12-22 15:35:16 +00:00
build.rs	replace cargo `external-symbols` feature with a rustc --cfg flag	2020-12-22 15:35:16 +00:00
vendor-libsecp.sh	Update Cargo.toml link in vendor script	2019-12-11 15:54:30 +00:00

README.md

secp256k1-sys

This crate provides Rust definitions for the FFI structures and methods.

Vendoring

The default build process is to build using the vendored libsecp256k1 sources in the depend folder. These sources are prefixed with a special rust-secp256k1-sys-specific prefix rustsecp256k1_v1_2_3_.

This prefix ensures that no symbol collision can happen:

when a Rust project has two different versions of rust-secp256k1 in its depepdency tree, or
when rust-secp256k1 is used for building a static library in a context where existing libsecp256k1 symbols are already linked.

To update the vendored sources, use the vendor-libsecp.sh script:

$ ./vendor-libsecp.sh depend <version-code> <rev>

Where <version-code> is the secp256k1-sys version number underscored: 0_1_2.
Where <rev> is the git revision of libsecp256k1 to checkout.

Linking to external symbols

If you want to compile this library without using the bundled symbols (which may be required for integration into other build systems), you can do so by adding --cfg=rust_secp_no_symbol_renaming' to your RUSTFLAGS variable.