Crate lwk

Source
Expand description

§Bindings

To generate bindings the projects use Mozilla uniffi giving support for: Kotlin, Swift, Python, Ruby and also third party support for Kotlin multiplatform, Go, C++, C# and Dart.

There is an architectural refactor already planned for the crates the bindings are created on, this initial version is for experimentation only, expect breaking changes in the API

Most of the rust types in this crate are wrappers on types in lwk_wollet and lwk_signer which satisfy uniffi requirements such as:

  • Methods on types support only &self, thus if the inner type needs mutability, it is usually enclosed in a std::sync::Mutex.
  • Returned values must be wrapped in std::sync::Arc so that there aren’t issue in memory management.

§Host & Requirements

Build supported on Mac and Linux.

Note the following commands requires some env var defined in ../context/env.sh. If you use direnv and allowed the .envrc file they are automatically evaluated when entering the dir, otherwise launch manually via . ./context/env.sh

For android build you need the NDK greater than r23 in ${PROJECT_DIR}/bin/android-ndk, if you already have it elsewhere just symlink your path.

Building bindings requires launching commands with many arguments, just tool is used for that. It’s a simple make-like tool, you can either install the tool or copy-paste the shell commands inside it.

§Python

§Examples

§Build Python wheel

First, create a virtual env, skip the step if you already created it.

cd lwk/lwk_bindings
virtualenv venv
source venv/bin/activate
pip install maturin maturin[patchelf] uniffi-bindgen==0.28.0

Then build the wheel

cd lwk/lwk_bindings
maturin develop

Try it (note there is still an issue in how we import the package when using the wheel):

import lwk
str(lwk.Network.mainnet())

§Publish Python wheel

Download artifacts from CI:

  • github ci for windows and mac
  • gitlab ci for linux
$ twine upload *.whl

§Test

cargo test -p lwk_bindings --features foreign_bindings --test bindings -- py

Live environment

just python-env-bindings

§Kotlin

§Example

§Build

This will build the bindings library in debug mode and generate the kotlin file

just kotlin

Create android bindings library libs, 4 architectures in release mode

just android

§Swift

§Example

Re-exports§

pub use blockdata::address::Address;
pub use blockdata::address_result::AddressResult;
pub use blockdata::out_point::OutPoint;
pub use blockdata::script::Script;
pub use blockdata::transaction::Transaction;
pub use blockdata::tx_in::TxIn;
pub use blockdata::tx_out::TxOut;
pub use blockdata::tx_out_secrets::TxOutSecrets;
pub use blockdata::txid::Txid;
pub use blockdata::wallet_tx::WalletTx;
pub use blockdata::wallet_tx_out::WalletTxOut;

Modules§

blockdata
Elements block data.
types
In this module there are wrapper of existing foreign simple types that:

Structs§

Bip
wrapper over lwk_common::Bip
Contract
Wrapper over lwk_wollet::Contract
ElectrumClient
Wrapper over lwk_wollet::ElectrumClient
EsploraClient
Wrapper over blocking::EsploraClient
ForeignPersisterLink
Implements ForeignPersister
Issuance
Mnemonic
Wrapper over bip39::Mnemonic
Network
Wrapper over lwk_wollet::ElementsNetwork
Precision
Wrapper over lwk_common::Precision
Pset
Partially Signed Elements Transaction, wrapper over elements::pset::PartiallySignedTransaction
PsetDetails
PsetInput
PSET input
Signer
A Software signer, wrapper over lwk_signer::SwSigner
TestEnv
Represent a test environment with an elements node and an electrum server. useful for testing only, wrapper over lwk_test_util::TestElectrumServer
TxBuilder
Wrapper over lwk_wollet::TxBuilder
Update
Wrapper over lwk_wollet::Update
Wollet
A Watch-Only wallet, wrapper over lwk_wollet::Wollet
WolletDescriptor
The output descriptors, wrapper over lwk_wollet::WolletDescriptor

Enums§

Chain
see lwk_wollet::Chain
LwkError
Possible errors emitted

Traits§

ForeignPersister
An exported trait, useful for caller-defined persistence.