4 releases (2 breaking)
0.3.0 | Jun 3, 2024 |
---|---|
0.2.0 | May 15, 2024 |
0.1.1 | Mar 17, 2024 |
0.1.0 | Mar 15, 2024 |
#4 in #silent
107 downloads per month
50KB
870 lines
Silent Payments
A rust implementation of BIP352: Silent Payments.
About
Warning: both this crate and BIP352 are still quite new. Review this library carefully before using it with mainnet funds.
This library supports creating and sending to silent payment addresses,
building on secp256k1
PublicKey
and SecretKey
structs for the interface.
In the future, the library will probably be expanded to rely on structs from rust-bitcoin as well.
The library is split up in two parts: sending and receiving.
Sending
For sending to a silent payment address, you can call the sender::generate_recipient_pubkeys
function.
This function takes a list of silent payment recipients, as well as a partial_secret
.
The partial_secret
represents the sum of all input private keys multiplied with the input hash.
To compute the partial_secret
, the utils::sending::compute_partial_secret
function can be used,
although this requires exposing secret data to this library.
Other methods for calculating the partial_secret
will be added later.
Recipient
For receiving silent payments, we use the receiving::Receiver
struct.
This Receiver
struct implements a scan_transaction
function that can be used to scan an incoming transaction for newly received payments.
The library also supports labels.
The change label (label for generating change addresses) is included by default.
You can add additional labels before scanning by using the add_label
function.
Examples
Check out the examples
folder for some simple sending and receiving examples.
These examples are still very elementary, and will be expanded later.
In the meantime, you can look at tests/vector_tests.rs
to see how sending and receiving works in more detail.
We are also working on a client that implements sending and receiving. This client can be used as a basis for building a silent payments wallet. Even if that isn't directly useful for you, it can still be a good resource for showing how this library can be integrated with wallets.
Tests
The tests/resources
folder contains a copy of the test vectors as of May 1st 2024.
You can test the code using the test vectors by running cargo test
.
Dependencies
~7.5MB
~99K SLoC