Made spelling, grammar, and punctuation changes. Squashed commits into one as requested.
Made some corrections as suggested.
This commit is contained in:
parent
44cd8a13ec
commit
5245ba132b
33
README.md
33
README.md
|
@ -73,11 +73,11 @@ Monero is a private, secure, untraceable, decentralised digital currency. You ar
|
||||||
|
|
||||||
**Privacy:** Monero uses a cryptographically sound system to allow you to send and receive funds without your transactions being easily revealed on the blockchain (the ledger of transactions that everyone has). This ensures that your purchases, receipts, and all transfers remain absolutely private by default.
|
**Privacy:** Monero uses a cryptographically sound system to allow you to send and receive funds without your transactions being easily revealed on the blockchain (the ledger of transactions that everyone has). This ensures that your purchases, receipts, and all transfers remain absolutely private by default.
|
||||||
|
|
||||||
**Security:** Using the power of a distributed peer-to-peer consensus network, every transaction on the network is cryptographically secured. Individual wallets have a 25 word mnemonic seed that is only displayed once, and can be written down to backup the wallet. Wallet files are encrypted with a passphrase to ensure they are useless if stolen.
|
**Security:** Using the power of a distributed peer-to-peer consensus network, every transaction on the network is cryptographically secured. Individual wallets have a 25-word mnemonic seed that is only displayed once and can be written down to backup the wallet. Wallet files are encrypted with a passphrase to ensure they are useless if stolen.
|
||||||
|
|
||||||
**Untraceability:** By taking advantage of ring signatures, a special property of a certain type of cryptography, Monero is able to ensure that transactions are not only untraceable, but have an optional measure of ambiguity that ensures that transactions cannot easily be tied back to an individual user or computer.
|
**Untraceability:** By taking advantage of ring signatures, a special property of a certain type of cryptography, Monero is able to ensure that transactions are not only untraceable but have an optional measure of ambiguity that ensures that transactions cannot easily be tied back to an individual user or computer.
|
||||||
|
|
||||||
**Decentralization:** The utility of monero depends on its decentralised peer-to-peer consensus network - anyone should be able to run the monero software, validate the integrity of the blockchain, and participate in all aspects of the monero network using consumer-grade commodity hardware. Decentralization of the monero network is maintained by software development that minimizes the costs of running the monero software and inhibits the proliferation of specialized, non-commodity hardware.
|
**Decentralization:** The utility of Monero depends on its decentralised peer-to-peer consensus network - anyone should be able to run the monero software, validate the integrity of the blockchain, and participate in all aspects of the monero network using consumer-grade commodity hardware. Decentralization of the monero network is maintained by software development that minimizes the costs of running the monero software and inhibits the proliferation of specialized, non-commodity hardware.
|
||||||
|
|
||||||
## About this project
|
## About this project
|
||||||
|
|
||||||
|
@ -85,11 +85,11 @@ This is the core implementation of Monero. It is open source and completely free
|
||||||
|
|
||||||
As with many development projects, the repository on Github is considered to be the "staging" area for the latest changes. Before changes are merged into that branch on the main repository, they are tested by individual developers in their own branches, submitted as a pull request, and then subsequently tested by contributors who focus on testing and code reviews. That having been said, the repository should be carefully considered before using it in a production environment, unless there is a patch in the repository for a particular show-stopping issue you are experiencing. It is generally a better idea to use a tagged release for stability.
|
As with many development projects, the repository on Github is considered to be the "staging" area for the latest changes. Before changes are merged into that branch on the main repository, they are tested by individual developers in their own branches, submitted as a pull request, and then subsequently tested by contributors who focus on testing and code reviews. That having been said, the repository should be carefully considered before using it in a production environment, unless there is a patch in the repository for a particular show-stopping issue you are experiencing. It is generally a better idea to use a tagged release for stability.
|
||||||
|
|
||||||
**Anyone is welcome to contribute to Monero's codebase!** If you have a fix or code change, feel free to submit it as a pull request directly to the "master" branch. In cases where the change is relatively small or does not affect other parts of the codebase it may be merged in immediately by any one of the collaborators. On the other hand, if the change is particularly large or complex, it is expected that it will be discussed at length either well in advance of the pull request being submitted, or even directly on the pull request.
|
**Anyone is welcome to contribute to Monero's codebase!** If you have a fix or code change, feel free to submit it as a pull request directly to the "master" branch. In cases where the change is relatively small or does not affect other parts of the codebase, it may be merged in immediately by any one of the collaborators. On the other hand, if the change is particularly large or complex, it is expected that it will be discussed at length either well in advance of the pull request being submitted, or even directly on the pull request.
|
||||||
|
|
||||||
## Supporting the project
|
## Supporting the project
|
||||||
|
|
||||||
Monero is a 100% community-sponsored endeavor. If you want to join our efforts, the easiest thing you can do is support the project financially. Both Monero and Bitcoin donations can be made to **donate.getmonero.org** if using a client that supports the [OpenAlias](https://openalias.org) standard. Alternatively you can send XMR to the Monero donation address via the `donate` command (type `help` in the command-line wallet for details).
|
Monero is a 100% community-sponsored endeavor. If you want to join our efforts, the easiest thing you can do is support the project financially. Both Monero and Bitcoin donations can be made to **donate.getmonero.org** if using a client that supports the [OpenAlias](https://openalias.org) standard. Alternatively, you can send XMR to the Monero donation address via the `donate` command (type `help` in the command-line wallet for details).
|
||||||
|
|
||||||
The Monero donation address is: `888tNkZrPN6JsEgekjMnABU4TBzc2Dt29EPAvkRxbANsAnjyPbb3iQ1YBRk1UXcdRsiKc9dhwMVgN5S9cQUiyoogDavup3H` (viewkey: `f359631075708155cc3d92a32b75a7d02a5dcf27756707b47a2b31b21c389501`)
|
The Monero donation address is: `888tNkZrPN6JsEgekjMnABU4TBzc2Dt29EPAvkRxbANsAnjyPbb3iQ1YBRk1UXcdRsiKc9dhwMVgN5S9cQUiyoogDavup3H` (viewkey: `f359631075708155cc3d92a32b75a7d02a5dcf27756707b47a2b31b21c389501`)
|
||||||
|
|
||||||
|
@ -150,7 +150,7 @@ Approximately three months prior to a scheduled software upgrade, a branch from
|
||||||
|
|
||||||
The following table summarizes the tools and libraries required to build. A
|
The following table summarizes the tools and libraries required to build. A
|
||||||
few of the libraries are also included in this repository (marked as
|
few of the libraries are also included in this repository (marked as
|
||||||
"Vendored"). By default, the build uses the library installed on the system,
|
"Vendored"). By default, the build uses the library installed on the system
|
||||||
and ignores the vendored sources. However, if no library is found installed on
|
and ignores the vendored sources. However, if no library is found installed on
|
||||||
the system, then the vendored source will be built and used. The vendored
|
the system, then the vendored source will be built and used. The vendored
|
||||||
sources are also used for statically-linked builds because distribution
|
sources are also used for statically-linked builds because distribution
|
||||||
|
@ -288,7 +288,7 @@ Tested on a Raspberry Pi Zero with a clean install of minimal Raspbian Stretch (
|
||||||
|
|
||||||
* If using an external hard disk without an external power supply, ensure it gets enough power to avoid hardware issues when syncing, by adding the line "max_usb_current=1" to /boot/config.txt
|
* If using an external hard disk without an external power supply, ensure it gets enough power to avoid hardware issues when syncing, by adding the line "max_usb_current=1" to /boot/config.txt
|
||||||
|
|
||||||
* Clone monero and checkout the most recent release version:
|
* Clone Monero and checkout the most recent release version:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/monero-project/monero.git
|
git clone https://github.com/monero-project/monero.git
|
||||||
|
@ -314,7 +314,7 @@ Tested on a Raspberry Pi Zero with a clean install of minimal Raspbian Stretch (
|
||||||
|
|
||||||
#### *Note for Raspbian Jessie users:*
|
#### *Note for Raspbian Jessie users:*
|
||||||
|
|
||||||
If you are using the older Raspbian Jessie image, compiling Monero is a bit more complicated. The version of Boost available in the Debian Jessie repositories is too old to use with Monero, and thus you must compile a newer version yourself. The following explains the extra steps, and has been tested on a Raspberry Pi 2 with a clean install of minimal Raspbian Jessie.
|
If you are using the older Raspbian Jessie image, compiling Monero is a bit more complicated. The version of Boost available in the Debian Jessie repositories is too old to use with Monero, and thus you must compile a newer version yourself. The following explains the extra steps and has been tested on a Raspberry Pi 2 with a clean install of minimal Raspbian Jessie.
|
||||||
|
|
||||||
* As before, `apt-get update && apt-get upgrade` to install all of the latest software, and increase the system swap size
|
* As before, `apt-get update && apt-get upgrade` to install all of the latest software, and increase the system swap size
|
||||||
|
|
||||||
|
@ -326,7 +326,7 @@ If you are using the older Raspbian Jessie image, compiling Monero is a bit more
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
* Then, install the dependencies for Monero except `libunwind` and `libboost-all-dev`
|
* Then, install the dependencies for Monero except for `libunwind` and `libboost-all-dev`
|
||||||
|
|
||||||
* Install the latest version of boost (this may first require invoking `apt-get remove --purge libboost*-dev` to remove a previous version if you're not using a clean install):
|
* Install the latest version of boost (this may first require invoking `apt-get remove --purge libboost*-dev` to remove a previous version if you're not using a clean install):
|
||||||
|
|
||||||
|
@ -347,7 +347,7 @@ If you are using the older Raspbian Jessie image, compiling Monero is a bit more
|
||||||
|
|
||||||
* Wait ~4 hours
|
* Wait ~4 hours
|
||||||
|
|
||||||
* From here, follow the [general Raspberry Pi instructions](#on-the-raspberry-pi) from the "Clone monero and checkout most recent release version" step.
|
* From here, follow the [general Raspberry Pi instructions](#on-the-raspberry-pi) from the "Clone Monero and checkout most recent release version" step.
|
||||||
|
|
||||||
#### On Windows:
|
#### On Windows:
|
||||||
|
|
||||||
|
@ -447,7 +447,7 @@ application.
|
||||||
### On FreeBSD:
|
### On FreeBSD:
|
||||||
|
|
||||||
The project can be built from scratch by following instructions for Linux above(but use `gmake` instead of `make`).
|
The project can be built from scratch by following instructions for Linux above(but use `gmake` instead of `make`).
|
||||||
If you are running monero in a jail, you need to add `sysvsem="new"` to your jail configuration, otherwise lmdb will throw the error message: `Failed to open lmdb environment: Function not implemented`.
|
If you are running Monero in a jail, you need to add `sysvsem="new"` to your jail configuration, otherwise lmdb will throw the error message: `Failed to open lmdb environment: Function not implemented`.
|
||||||
|
|
||||||
Monero is also available as a port or package as 'monero-cli`.
|
Monero is also available as a port or package as 'monero-cli`.
|
||||||
|
|
||||||
|
@ -460,7 +460,7 @@ Running the test suite also requires `py-requests` package.
|
||||||
|
|
||||||
Build monero: `env DEVELOPER_LOCAL_TOOLS=1 BOOST_ROOT=/usr/local gmake release-static`
|
Build monero: `env DEVELOPER_LOCAL_TOOLS=1 BOOST_ROOT=/usr/local gmake release-static`
|
||||||
|
|
||||||
Note: you may encounter the following error, when compiling the latest version of monero as a normal user:
|
Note: you may encounter the following error when compiling the latest version of Monero as a normal user:
|
||||||
|
|
||||||
```
|
```
|
||||||
LLVM ERROR: out of memory
|
LLVM ERROR: out of memory
|
||||||
|
@ -563,7 +563,6 @@ Packages are available for
|
||||||
```
|
```
|
||||||
More info and versions in the [Debian package tracker](https://tracker.debian.org/pkg/monero).
|
More info and versions in the [Debian package tracker](https://tracker.debian.org/pkg/monero).
|
||||||
|
|
||||||
|
|
||||||
* Arch Linux (via Community packages):
|
* Arch Linux (via Community packages):
|
||||||
[`monero`](https://www.archlinux.org/packages/community/x86_64/monero/)
|
[`monero`](https://www.archlinux.org/packages/community/x86_64/monero/)
|
||||||
|
|
||||||
|
@ -618,7 +617,7 @@ Packaging for your favorite distribution would be a welcome contribution!
|
||||||
## Running monerod
|
## Running monerod
|
||||||
|
|
||||||
The build places the binary in `bin/` sub-directory within the build directory
|
The build places the binary in `bin/` sub-directory within the build directory
|
||||||
from which cmake was invoked (repository root by default). To run in
|
from which cmake was invoked (repository root by default). To run in the
|
||||||
foreground:
|
foreground:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
@ -629,7 +628,7 @@ To list all available options, run `./bin/monerod --help`. Options can be
|
||||||
specified either on the command line or in a configuration file passed by the
|
specified either on the command line or in a configuration file passed by the
|
||||||
`--config-file` argument. To specify an option in the configuration file, add
|
`--config-file` argument. To specify an option in the configuration file, add
|
||||||
a line with the syntax `argumentname=value`, where `argumentname` is the name
|
a line with the syntax `argumentname=value`, where `argumentname` is the name
|
||||||
of the argument without the leading dashes, for example `log-level=1`.
|
of the argument without the leading dashes, for example, `log-level=1`.
|
||||||
|
|
||||||
To run in background:
|
To run in background:
|
||||||
|
|
||||||
|
@ -654,7 +653,7 @@ See [README.i18n.md](README.i18n.md).
|
||||||
## Using Tor
|
## Using Tor
|
||||||
|
|
||||||
> There is a new, still experimental, [integration with Tor](ANONYMITY_NETWORKS.md). The
|
> There is a new, still experimental, [integration with Tor](ANONYMITY_NETWORKS.md). The
|
||||||
> feature allows connecting over IPv4 and Tor simulatenously - IPv4 is used for
|
> feature allows connecting over IPv4 and Tor simultaneously - IPv4 is used for
|
||||||
> relaying blocks and relaying transactions received by peers whereas Tor is
|
> relaying blocks and relaying transactions received by peers whereas Tor is
|
||||||
> used solely for relaying transactions received over local RPC. This provides
|
> used solely for relaying transactions received over local RPC. This provides
|
||||||
> privacy and better protection against surrounding node (sybil) attacks.
|
> privacy and better protection against surrounding node (sybil) attacks.
|
||||||
|
@ -753,7 +752,7 @@ Print the stack trace with `bt`
|
||||||
coredumpctl -1 gdb
|
coredumpctl -1 gdb
|
||||||
```
|
```
|
||||||
|
|
||||||
#### To run monero within gdb:
|
#### To run Monero within gdb:
|
||||||
|
|
||||||
Type `gdb /path/to/monerod`
|
Type `gdb /path/to/monerod`
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue