bitmask-core
Version:
Core functionality for the BitMask wallet
94 lines (58 loc) • 4.44 kB
Markdown
# BitMask Core
Core functionality for the BitMask wallet - <https://bitmask.app>
**BitMask** is a Bitcoin-only web wallet and browser extension for accessing decentralized web applications on the Bitcoin timechain. It is designed to support UTXO-based smart contracting protocols such as [RGB](https://rgb.tech), in addition to Lightning payments.
[](https://github.com/diba-io/bitmask-core/actions/workflows/rust.yaml)
[](https://docs.rs/bitmask-core/latest/bitmask-core/)
[](https://www.npmjs.com/package/bitmask-core)
[](https://mit-license.org)
[](https://t.me/+eQk5aQ5--iUxYzVk)
## Uses
- [bdk](https://github.com/bitcoindevkit/bdk) - Bitcoin Dev Kit
- [rgb-wallet](https://github.com/RGB-WG/rgb-wallet) - RGB Wallet
- [wasm-pack](https://github.com/rustwasm/wasm-pack) - WebAssembly
- [lndhubx](https://lndhubx.kollider.xyz) - Custodial Lightning
- [nostr-sdk](https://github.com/rust-nostr/nostr) - Nostr SDK
- [carbonado](https://github.com/diba-io/carbonado) - Carbonado e2ee decentralized storage
## Build
This should work with either wasm-pack, [trunk](https://github.com/thedodd/trunk), or x86-64.
Some environment variables may be needed in order to compile on macos-aarch64, for more, [see this](https://github.com/sapio-lang/sapio/issues/146#issuecomment-960659800).
If there are issues compiling, be sure to check you're compiling with the latest Rust version.
To build this as a NodeJS module:
1. Define rust flags: `export RUSTFLAGS='-C target-feature=+atomics,+bulk-memory,+mutable-globals'`
2. Execute: `wasm-pack build --release --target bundler`
## Test
1. Lint against wasm32: `cargo clippy --target wasm32-unknown-unknown`
2. Run tests in browser: `TEST_WALLET_SEED="replace with a 12 word mnemonic for a wallet containing testnet sats" wasm-pack test --headless --chrome`
## Run
To run the bitmaskd node with REST server, either for testing the web wallet, or simply for increased privacy:
`cargo install --features=server --path .`
Then run `bitmaskd`.
## Development
Parts of this application are built with conditional compilation statements for wasm32 support. This is a helpful command for checking linting and correctness while also developing on desktop platforms:
`cargo clippy --target wasm32-unknown-unknown --no-default-features --release`
## Release
Upon a new release, follow these steps:
1. Run `cargo update` to update to latest deps.
1. Run `cargo +nightly udeps` to see if there are any unused dependencies.
## Docker
For running bitmask-core tests in Regtest Mode, please follow the steps below:
### Initial Setup
1. Load the command line: `source .commands` or if using fish shell, `bass source .commands`
2. Build bitcoin node + electrum: `docker-compose build`.
3. Up and running Docker containers: `docker-compose up -d bitcoin1 electrs carbonado rgb-proxy`.
4. Download and install BDK cli: `cargo install bdk-cli` (We will use BDK to generate the mnemonic).
5. Generate a new mnemonic: `bdk-cli key generate`.
6. Create an environment variable called **TEST_WALLET_SEED** with mnemonic generated in the **step 5** (only wasm32).
7. Run the test to get regtest address for bitcoin and rgb: `cargo test --test wallet -- create_wallet --exact --nocapture`.
8. Load your wallet in the bitcoin node: `bc1 loadwallet default`, or if using a new wallet, `bc1 createwallet default`.
9. Generate new first 500 blocks: `bc1 -generate 500`.
10. Send some coins to the main wallet address: `bc1 sendtoaddress {MAIN_VAULT_ADDRESS} 10`. Change `{MAIN_VAULT_ADDRESS}` with the address generated in the **step 7**.
11. Mine a new block: `bc1 -generate 1`
### Running the tests
Running the tests: `cargo test -- --test-threads 1`
### Troubleshooting
#### **1. After restarting the container**
**A.The bitcoin node does not work?**
Check if your wallet is loaded. For that, run the command `bitcoin1 loadwallet default`.
**B.The electrs node does not work?**
To stop the electrs freeze, run `bitcoin1 -generate`.