diff --git a/CONDUCT.md b/CONDUCT.md new file mode 100644 index 0000000..ceb5f50 --- /dev/null +++ b/CONDUCT.md @@ -0,0 +1,61 @@ +# Contributor Code of Conduct + +As contributors and maintainers of this project, and in the interest of +fostering an open and welcoming community, we pledge to respect all people who +contribute through reporting issues, posting feature requests, updating +documentation, submitting pull requests or patches, and other activities. + +We are committed to making participation in this project a harassment-free +experience for everyone, regardless of level of experience, gender, gender +identity and expression, sexual orientation, disability, personal appearance, +body size, race, ethnicity, age, religion, or nationality. + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery +* Personal attacks +* Trolling or insulting/derogatory comments +* Public or private harassment +* Publishing other's private information, such as physical or electronic + addresses, without explicit permission +* Other unethical or unprofessional conduct + +Project maintainers have the right and responsibility to remove, edit, or +reject comments, commits, code, wiki edits, issues, and other contributions +that are not aligned to this Code of Conduct, or to ban temporarily or +permanently any contributor for other behaviors that they deem inappropriate, +threatening, offensive, or harmful. Note that contributors may be volunteers +who do not represent Electric Coin Company. They are free to express their own +opinions so long as they adhere to these guidelines. + +By adopting this Code of Conduct, project maintainers commit themselves to +fairly and consistently applying these principles to every aspect of managing +this project. Project maintainers who do not follow or enforce the Code of +Conduct may be permanently removed from the project team. + +This Code of Conduct applies both within project spaces and in public spaces +when an individual is representing the project or its community. + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported by contacting a project maintainer (see below). All +complaints will be reviewed and investigated and will result in a response that +is deemed necessary and appropriate to the circumstances. Maintainers are +obligated to maintain confidentiality with regard to the reporter of an +incident. + +You may send reports to [our Conduct email](mailto:conduct@z.cash). + +If you wish to contact specific maintainers directly, the following have made +themselves available for conduct issues: + +- Daira Hopwood (daira at z.cash) +- Sean Bowe (sean at z.cash) + + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 1.3.0, available at +[https://www.contributor-covenant.org/version/1/3/0/][version] + +[homepage]: https://www.contributor-covenant.org +[version]: https://www.contributor-covenant.org/version/1/3/0/ + diff --git a/README.md b/README.md index 0934092..5f82ab4 100644 --- a/README.md +++ b/README.md @@ -6,42 +6,63 @@ An Android wallet using the Zcash Android SDK that is maintained by ECC develope Please take note: the wallet is not an official product by ECC, but rather a tool for learning about our libraries that it is built on. This means that we do not have robust infrasturcture or user support for this application. We open sourced it as a resource to make wallet development easier for the Zcash ecosystem. -### Setup - -To run, clone the repo, open it in Android Studio and press play. It should just work.™ - -#### Requirements -- [The code](https://github.com/zcash/zcash-android-wallet) -- [Android Studio](https://developer.android.com/studio/index.html) or [adb](https://www.xda-developers.com/what-is-adb/) -- A device or emulator - -### Install from Android Studio -1. [Install Android studio](https://developer.android.com/studio/install) and setup an emulator - 1a. If using a device, be sure to [put it in developer mode](https://developer.android.com/studio/debug/dev-options) to enable side-loading apps -2. `Import` the zcash-android-wallet folder. - It will be recognized as an Android project. -3. Press play (once it is done opening and indexing) - -### OR Install from the command line -To build from the command line, [setup ADB](https://www.xda-developers.com/install-adb-windows-macos-linux/) and connect your device. Then simply run this and it will both build and install the app: -```bash -cd /path/to/zcash-android-wallet -./gradlew -``` - -## Disclaimers +# Disclaimers There are some known areas for improvement: - This app is mainly intended for learning and improving the related libraries that it uses. There may be bugs. -- This wallet currently only supports receiving at shielded addresses, which makes it incompatible with wallets that do not support sending to shielded addresses. - Traffic analysis, like in other cryptocurrency wallets, can leak some privacy of the user. - The wallet requires a trust in the server to display accurate transaction information. -- This app has been developed and run exclusively on `mainnet` it might not work on `testnet`. See the [Wallet App Threat Model](https://zcash.readthedocs.io/en/latest/rtd_pages/wallet_threat_model.html) for more information about the security and privacy limitations of the wallet. If you'd like to sign up to help us test, reach out on discord and let us know! We're always happy to get feedback! -### License +# Description + +ECC Wallet is developed using the Zcash iOS SDK that is maintained by core developers. + +This a reference wallet for the following set of features: +- z2z transactions w/ encrypted memos +- reply-to formatted memos +- z2t transactions +- transparent receive-only +- autoshielding on threshold from receive only t-address + +note: z means sapling shielded addresses. + +# Prerequisites +- [The code](https://github.com/zcash/zcash-android-wallet) +- [Android Studio](https://developer.android.com/studio/index.html) or [adb](https://www.xda-developers.com/what-is-adb/) +- A device or emulator + +# Building the App + +To run, clone the repo, open it in Android Studio and press play. It should just work.™ + + +## Install from Android Studio +1. [Install Android studio](https://developer.android.com/studio/install) and setup an emulator + 1a. If using a device, be sure to [put it in developer mode](https://developer.android.com/studio/debug/dev-options) to enable side-loading apps +2. `Import` the zcash-android-wallet folder. + It will be recognized as an Android project. +3. Press play (once it is done opening and indexing) + +## OR Install from the command line +To build from the command line, [setup ADB](https://www.xda-developers.com/install-adb-windows-macos-linux/) and connect your device. Then simply run this and it will both build and install the app: +```bash +cd /path/to/zcash-android-wallet +./gradlew +``` + +# Contributing + +Contributions are very much welcomed! Please read our [Contributing Guidelines](/CONTRIBUTING.md) and [Code of Conduct](/CONDUCT.md). Our backlog has many Issues tagged with the `good first issue` label. Please fork the repo and make a pull request for us to review. + +# Reporting an issue + +If you wish to report a security issue, please follow our [Responsible Disclosure guidelines](https://github.com/zcash/zcash-android-wallet-sdk/blob/master/responsible_disclosure.md). + + For other kind of inquiries, feel welcome to open an Issue if you encounter a bug or would like to request a feature. +# License MIT