mirror of
https://github.com/sparrowwallet/sparrow.git
synced 2024-11-02 20:36:44 +00:00
97ef580602
This tiny Readme edit would, I think, have preempted the confusion that prompted #263 . I thought that the general install installed a global command, and didn't think, for some time, to run from within the directory. Dumb, but figured clarifying the doc would be better than just figuring it out silently on my own.
92 lines
3.4 KiB
Markdown
92 lines
3.4 KiB
Markdown
# Sparrow Bitcoin Wallet
|
|
|
|
Sparrow is a modern desktop Bitcoin wallet application supporting most hardware wallets and built on common standards such as PSBT, with an emphasis on transparency and usability.
|
|
|
|
More information (and release binaries) can be found at https://sparrowwallet.com. Release binaries are also available directly from [Github](https://github.com/sparrowwallet/sparrow/releases).
|
|
|
|
|
|
|
|
## Building
|
|
|
|
To clone this project, use
|
|
|
|
`git clone --recursive git@github.com:sparrowwallet/sparrow.git`
|
|
|
|
or for those without SSH credentials:
|
|
|
|
`git clone --recursive https://github.com/sparrowwallet/sparrow.git`
|
|
|
|
In order to build, Sparrow requires Java 16 to be installed.
|
|
The release binaries are built with [AdoptOpenJdk 16.0.1+9 Hotspot](https://adoptopenjdk.net/archive.html?variant=openjdk16&jvmVariant=hotspot).
|
|
|
|
These binaries can be built from source using
|
|
|
|
`./gradlew jpackage`
|
|
|
|
When updating to the latest HEAD
|
|
|
|
`git pull --recurse-submodules`
|
|
|
|
The release binaries are reproducible from v1.5.0 onwards (pre codesigning and installer packaging). More detailed [instructions on reproducing the binaries](docs/reproducible.md) are provided.
|
|
|
|
## Running
|
|
|
|
If you prefer to run Sparrow directly from source, it can be launched from within the project directory with
|
|
|
|
`./sparrow`
|
|
|
|
Java 16 or higher must be installed.
|
|
|
|
## Configuration
|
|
|
|
Sparrow has a number of command line options, for example to change its home folder or use testnet:
|
|
|
|
```
|
|
./sparrow -h
|
|
|
|
Usage: sparrow [options]
|
|
Options:
|
|
--dir, -d
|
|
Path to Sparrow home folder
|
|
--help, -h
|
|
Show usage
|
|
--level, -l
|
|
Set log level
|
|
Possible Values: [ERROR, WARN, INFO, DEBUG, TRACE]
|
|
--network, -n
|
|
Network to use
|
|
Possible Values: [mainnet, testnet, regtest, signet]
|
|
```
|
|
|
|
As a fallback, the network (mainnet, testnet, regtest or signet) can also be set using an environment variable `SPARROW_NETWORK`. For example:
|
|
|
|
`export SPARROW_NETWORK=testnet`
|
|
|
|
A final fallback which can be useful when running the Sparrow binary is to create a file called ``network-testnet`` in the Sparrow home folder (see below) to configure the testnet network.
|
|
|
|
Note that if you are connecting to an Electrum server when using testnet, that server will need to be running on testnet configuration as well.
|
|
|
|
When not explicitly configured using the command line argument above, Sparrow stores its mainnet config file, log file and wallets in a home folder location appropriate to the operating system:
|
|
|
|
Platform | Location
|
|
-------- | --------
|
|
OSX | ~/.sparrow
|
|
Linux | ~/.sparrow
|
|
Windows | %APPDATA%/Sparrow
|
|
|
|
Testnet, regtest and signet configurations (along with their wallets) are stored in subfolders to allow easy switching between networks.
|
|
|
|
## Reporting Issues
|
|
|
|
Please use the [Issues](https://github.com/sparrowwallet/sparrow/issues) tab above to report an issue. If possible, look in the sparrow.log file in the configuration directory for information helpful in debugging.
|
|
|
|
## License
|
|
|
|
Sparrow is licensed under the Apache 2 software licence.
|
|
|
|
## Credit
|
|
|
|
|
|
|
|
Sparrow Wallet uses the [Yourkit Java Profiler](https://www.yourkit.com/java/profiler/) to profile and improve performance.
|
|
YourKit supports open source projects with useful tools for monitoring and profiling Java and .NET applications.
|