Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mintlayer/mojito_mobile_wallet
https://github.com/mintlayer/mojito_mobile_wallet
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mintlayer/mojito_mobile_wallet
- Owner: mintlayer
- License: mit
- Created: 2022-01-05T09:25:27.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-12T11:10:25.000Z (7 months ago)
- Last Synced: 2024-04-12T17:56:42.860Z (7 months ago)
- Language: JavaScript
- Size: 87.2 MB
- Stars: 6
- Watchers: 8
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Mojito - A Bitcoin & Mintlayer Wallet
Built with React Native and Electrum, based on [BlueWallet](https://github.com/BlueWallet/BlueWallet)
Website: [mintlayer.org](https://www.mintlayer.org/)
Community: [telegram group](https://t.me/mintlayer)
- Private keys never leave your device
- SegWit-first. Replace-By-Fee support
- Encryption. Plausible deniability
Learn more about Mintlayer [here.](https://www.mintlayer.org/technology/)
## BUILD & RUN IT
### Node and Java versions
It is recommended to run everything with node `16.14.2` for Android build. But `npm run ios` uses node version `>18`, so in this case you will need two different node versions. We recommend NVM to make that easier.
The recommended `JDK` version is `11`.
### Dependencies
After installing the correct vesions of Java and Node, clone this repo and install dependencies:
```bash
git clone https://github.com/mintlayer/mobile_wallet
cd mobile_wallet
npm install
```
#### Possible Issues
##### Got an `EINTEGRITY` error on install
Remove lock file and node_modules and try installing again.
```bash
rm -rf node_modules package-lock.json
npm install
```
##### Got an `ERESOLVE unable ro resolve dependency tree` error on install
Try running the install with legacy deps flag:
```bash
npm install --legacy-peer-deps
```
### Running on Android:
#### Android Studio
You will now need to either connect an Android device to your computer or run an emulated Android device using AVD Manager which comes shipped with Android Studio. So first of all, install Android Studio.
Then verify if you have these env vars set on you OS:
```bash
export PATH=$PATH:$HOME/android-studio/bin
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/platform-tools
```
Now, inside Android Studio, remove all default emulators and create a new one using API 33 (Tiramisu).
##### Possible issues
###### Android studio not working properly
You might to reinstall Android Studio for different reasons. If you are on Linux and used default installation we recommend using this command to start from scratch:
```bash
rm -rf .local/share/Google/ .local/share/Android\ Open\ Source\ Project .local/share/kotlin .config/Android\ Open\ Source\ Project .config/Google/AndroidStudio2022.3 .cache/Android\ Open\ Source\ Project .cache/Google/AndroidStudio2022.3 android-studio Android
```
If you are not on Linux, or not running the default install, you should look for these folders:
- `android-studio`: where is keeps the software itself
- `Android`: where SDKs are kept
- User specific settings, configs and cache.
#### Node
Now run metro web server in one terminal with:
```bash
npm start
```
Then build, install it, and run on android emulator in another terminal:
```bash
npm run android
```
Once you launch the app it will take some time for all of the dependencies to load. Once everything loads up, you should have the built app running.
### Running on iOS:
Run `pod-install` (just on first run):
```bash
npx pod-install
```
Now run metro web server in one terminal with:
```bash
npm start
```
Then build, install it, and run on iOS emulator in another terminal:
```bash
npm run ios
```
#### Specifics
##### Run on macOS using Mac Catalyst:
```bash
npm run maccatalystpatches
```
Once the patches are applied, open Xcode and select "My Mac" as destination. If you are running macOS Catalina, you may need to remove all iOS 14 Widget targets.
## TESTS
```bash
npm run test
```
## TESTS CASES DELETED
multisig-hd-wallet.test.js
cosign.test.js
payjoin-transaction.test.js
“We should bring it back once Multisign wallet is back”
## BrowserStack
“This project is tested with BrowserStack.”
## LICENSE
MIT
## WANT TO CONTRIBUTE?
Grab an issue from [the backlog](https://github.com/mintlayer/mobile_wallet/issues), try to start or submit a PR, any doubts we will try to guide you.
## RESPONSIBLE DISCLOSURE
Found critical bugs/vulnerabilities? Please email them [email protected]
For more info check [here](https://github.com/mintlayer/mobile_wallet/security/policy)