Rust Native Implemented Function (NIF) that wraps a couple functions from the libsecp256k1 Rust library. It only wraps secp256k1 functions used in Ethereum.
ex_secp256k1 requires Rust to be installed.
The package can be installed by adding ex_secp256k1 to your list of
dependencies in mix.exs:
[
{:ex_secp256k1, "~> 0.2.1"}
]To create a public key from a private key use ExSecp256k1.create_public_key/1. The result is uncompressed public key:
{:ok, _binary} = ExSecp256k1.create_public_key(<<120, 128, 174, 201, 52, 19,
241, 23, 239, 20, 189, 78, 109, 19, 8, 117, 171, 44, 125, 125, 85, 160, 100,
250, 195, 194, 247, 189, 81, 81, 99, 128>>)
{:error, :wrong_private_key_size} = ExSecp256k1.create_public_key(<<1>>)To sign a message use ExSecp256k1.sign/2. It returns a tuple with {:ok, {r, s, recovery_id}} on success and {:error, reason_atom} on error:
message =
<<0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 2>>
private_key =
<<120, 128, 174, 201, 52, 19, 241, 23, 239, 20, 189, 78, 109, 19, 8, 117,
171, 44, 125, 125, 85, 160, 100, 250, 195, 194, 247, 189, 81, 81, 99, 128>>
{:ok {r_binary, s_binary, recovery_id_int}} = ExSecp256k1.sign(message, private_key)
{:ok {signature_bin, recovery_id_int}} = ExSecp256k1.sign_compact(message, private_key)To recover a public key from signed message use ExSecp256k1.recover/4 or ExSecp256k1.recover_compact/3:
hash =
<<218, 245, 167, 121, 174, 151, 47, 151, 33, 151, 48, 61, 123, 87, 71, 70, 199, 239, 131,
234, 218, 192, 242, 121, 26, 210, 61, 185, 46, 76, 142, 83>>
r =
<<40, 239, 97, 52, 11, 217, 57, 188, 33, 149, 254, 83, 117, 103, 134, 96, 3, 225, 161, 93,
60, 113, 255, 99, 225, 89, 6, 32, 170, 99, 98, 118>>
s =
<<103, 203, 233, 216, 153, 127, 118, 26, 236, 183, 3, 48, 75, 56, 0, 204, 245, 85, 201,
243, 220, 100, 33, 75, 41, 127, 177, 150, 106, 59, 109, 131>>
recovery_id = 0
{:ok, _public_key_binary} = ExSecp256k1.recover(hash, r, s, recovery_id)
{:error, :recovery_failure} = ExSecp256k1.recover(hash, r, s, 2)
{:ok, _public_key_binary} = ExSecp256k1.recover_compact(hash, r <> s, recovery_id)All nif functions will fail with ArgumentError if parameters of wrong types are provided:
assert_raise ArgumentError, fn ->
ExSecp256k1.sign(message, nil)
end- Fork it!
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request