8 releases (breaking)
new 0.8.0 | Oct 14, 2024 |
---|---|
0.7.0 | Jul 5, 2024 |
0.5.1 | May 22, 2024 |
0.4.0 | May 3, 2024 |
0.1.0 | Jan 26, 2024 |
#689 in Magic Beans
288 downloads per month
Used in 4 crates
(3 directly)
250KB
5.5K
SLoC
LWK is a collection of libraries for Liquid wallets.
lwk_wollet
is the library for Watch-Only Wallets, the wollet
spelling is not a typo but highlights the fact it is Watch-Only.
A wallet is defined by a CT descriptor, which consists in a Bitcoin descriptor plus the descriptor blinding key.
From a wallet you can generate addresses, sync wallet data from the blockchain and create transactions, inclunding issuances, reissuances and burn.
Examples
Generate an address
let desc = "ct(slip77(ab5824f4477b4ebb00a132adfd8eb0b7935cf24f6ac151add5d1913db374ce92),elwpkh([759db348/84'/1'/0']tpubDCRMaF33e44pcJj534LXVhFbHibPbJ5vuLhSSPFAw57kYURv4tzXFL6LSnd78bkjqdmE3USedkbpXJUPA1tdzKfuYSL7PianceqAhwL2UkA/<0;1>/*))#cch6wrnp";
// Parse the descriptor and create the watch only wallet
let descriptor: WolletDescriptor = desc.parse()?;
let mut wollet = Wollet::new(
ElementsNetwork::LiquidTestnet,
NoPersist::new(), // Do not persist data
descriptor,
)?;
// Generate the address
let addr = wollet.address(None)?;
println!("Address: {} (index {})", addr.address(), addr.index());
Sync wallet
full_scan_with_electrum_client};
// Use an Electrum server
let electrum_url = ElectrumUrl::new("elements-testnet.blockstream.info:50002", true, true)?;
let mut electrum_client = ElectrumClient::new(&electrum_url)?;
full_scan_with_electrum_client(&mut wollet, &mut electrum_client)?;
// Print a summary of the wallet transactions
for tx in wollet.transactions()?.into_iter().rev() {
println!("TXID: {}, balance {:?}", tx.txid, tx.balance);
}
Create transaction
// Create a transaction
let recipient = UnvalidatedRecipient {
satoshi: 1000,
address: "tlq1qqgpjea0jcel4tqeln5kyxlrgqx2eh4vw67ecswm54476mddy3n0klrlmty5gn0wsdw4045rtl2y2wdtr4rdu6v93zds6zn8xd".to_string(),
asset: "144c654344aa716d6f3abcc1ca90e5641e4e2a7f633bc09fe3baf64585819a49".to_string(),
};
let pset = wollet
.tx_builder()
.add_unvalidated_recipient(&recipient)?
.finish()?;
// Then pass the PSET to the signer(s) for them to sign.
Dependencies
~26–43MB
~583K SLoC