# CLI
Building the needed executable requires [rust](https://www.rust-lang.org/tools/install):
```sh
$ git clone git@github.com:Blockstream/lwk.git
$ cd lwk
$ cargo install --path ./lwk_cli
```
If you want to enable Jade over serial build with
```sh
$ cargo install --path ./lwk_cli --features serial
```
Help shows available commands:
```sh
$ lwk_cli --help
```
Install bash completion with:
```sh
$ lwk_cli generate-completion bash | jq -r . | sudo tee /usr/share/bash-completion/completions/lwk_cli
```
Other shell are available: bash, elvish, fish, powershell, zsh.
The destination file path `/usr/share/bash-completion/completions/cli` may change according to your distro.
## Server
### Start
```sh
$ lwk_cli server start
```
Or with more logs:
```sh
$ RUST_LOG=debug lwk_cli server start
```
Start the server in background and have logs on file
```sh
$ lwk_cli server start 2>debug.log &
```
### Stop
If not in background hit ctrl-c in the terminal where it started or in another shell:
```sh
$ lwk_cli server stop
```
Another way to terminate a server started in background is to type `fg` to bring the background
process in the forground and then hit `ctrl-c`
## Client
Every command requires the server running.
Generate a software signer ("stateless" request)
```sh
$ lwk_cli signer generate
```
is equivalent to:
```sh
$ curl --header "Content-Type: application/json" --request POST --data '{"method":"signer_generate","params":[],"id":1,"jsonrpc":"2.0"}' http://localhost:32111 -s
```
To see RPC data exchanged via the cli commands enable app log tracing eg:
```sh
$ RUST_LOG=app=trace cargo run -- wallet balance --wallet ciao
...
2023-11-28T09:36:18.696846Z TRACE app::client: ---> {"method":"balance","params":{"name":"ciao"},"id":2,"jsonrpc":"2.0"}
2023-11-28T09:36:18.697675Z TRACE app::client: <--- {"result":null,"error":{"code":-32008,"message":"Wallet 'ciao' does not exist","data":{"name":"ciao"}},"id":2,"jsonrpc":"2.0"}
{
"code": -32008,
"data": {
"name": "ciao"
},
"message": "Wallet 'ciao' does not exist"
}
```
Load a wallet and request a balance ("stateful" request)
```sh
$ lwk_cli wallet load --wallet custody -d "ct(L3jXxwef3fpB7hcrFozcWgHeJCPSAFiZ1Ji2YJMPxceaGvy3PC1q,elwpkh(tpubD6NzVbkrYhZ4Was8nwnZi7eiWUNJq2LFpPSCMQLioUfUtT1e72GkRbmVeRAZc26j5MRUz2hRLsaVHJfs6L7ppNfLUrm9btQTuaEsLrT7D87/*))#lrwadl63"
$ lwk_cli wallet balance --wallet custody
```
is equivalent to:
```sh
$ curl --header "Content-Type: application/json" --request POST --data '{"method":"wallet_load","params":{"descriptor":"ct(L3jXxwef3fpB7hcrFozcWgHeJCPSAFiZ1Ji2YJMPxceaGvy3PC1q,elwpkh(tpubD6NzVbkrYhZ4Was8nwnZi7eiWUNJq2LFpPSCMQLioUfUtT1e72GkRbmVeRAZc26j5MRUz2hRLsaVHJfs6L7ppNfLUrm9btQTuaEsLrT7D87/*))#lrwadl63", "name": "custody"},"id":1,"jsonrpc":"2.0"}' http://localhost:32111 -s
Request an address:
```sh
$ lwk_cli wallet address --wallet custody
$ lwk_cli wallet address --wallet custody --index 4
```
An error test case:
```sh
$ curl --header "Content-Type: application/json" --request POST --data '{"method":"wallet_load","params":{"desc":"fake"},"id":1,"jsonrpc":"2.0"}' http://localhost:32111 -s | jq
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32603,
"message": "Serde JSON Error: missing field `descriptor`",
"data": null
}
}
```
### Create a singlesig wallet
First start the server
```sh
lwk_cli --network testnet server start
```
```sh
$ MNEMONIC=$(lwk_cli signer generate | jq -r .mnemonic)
$ lwk_cli signer load-software --persist true --mnemonic "$MNEMONIC" --signer s1
$ DESCRIPTOR=$(lwk_cli signer singlesig-desc --signer s1 --descriptor-blinding-key slip77 --kind wpkh | jq -r .descriptor)
$ lwk_cli wallet load --wallet w1 -d "$DESCRIPTOR"
$ lwk_cli wallet address --wallet w1
```
Send some lbtc to the address
```sh
$ lwk_cli wallet balance --wallet w1
```
Should show a balance
### Creating a transaction, signing and broadcasting
You must have a loaded singlesig wallet `w1`, with the corresponding signer `w1` as created in the previous step.
Must also have funds in the wallet.
```sh
Creates an unsigned PSET sending 1000 satoshi of liquid btc (144c654344aa716d6f3abcc1ca90e5641e4e2a7f633bc09fe3baf64585819a49 is the policy asset in testnet) to the address tlq1qqwe0a3dp3hce866snkll5vq244n47ph5zy2xr330uc8wkrvc0whwsvw4w67xksmfyxwqdyrykp0tsxzsm24mqm994pfy4f6lg
Sign the pset
```sh
$ SIGNED_PSET=$(lwk_cli signer sign --signer s1 --pset $UNSIGNED_PSET | jq -r .pset)
```
Broadcast it. Remove `--dry-run` to effectively broadcast live, otherwise only partial checks on the transactions finalization are made (for example it's not checked inputs are unspent)
```sh
$ lwk_cli wallet broadcast --dry-run --wallet w1 --pset $SIGNED_PSET)
```