fix typos and add suggested edits from community

This commit is contained in:
Adi Shankara
2023-11-07 18:29:08 +04:00
committed by Rusty Russell
parent 6f4a3c86e9
commit d50d7d428d
4 changed files with 50 additions and 47 deletions

View File

@@ -22,4 +22,5 @@ In order to avoid this situation you should be monitoring the gap between Core L
You can use _trusted_ third-party plugins as bitcoin backends instead of using your own node.
- [sauron](https://github.com/lightningd/plugins/tree/master/sauron) is a bitcoin backend plugin relying on [Esplora](https://github.com/Blockstream/esplora).
- [trustedcoin](https://github.com/nbd-wtf/trustedcoin) is a plugin that uses block explorers (blockstream.info, mempool.space, blockchair.com and blockchain.info) as backends instead of your own bitcoin node.
- [trustedcoin](https://github.com/nbd-wtf/trustedcoin) is a plugin that uses block explorers (blockstream.info, mempool.space, blockchair.com and blockchain.info) as backends instead of your own bitcoin node.
- [bps](https://github.com/coinos/bps) is a proxy server that exposes just the RPC commands that lightning needs. There's a public endpoint at <https://coinos.io/proxy> or you can host your own.

View File

@@ -14,6 +14,7 @@ If you're on Ubuntu, you need to install bitcoind:
```shell
sudo apt-get install -y software-properties-common
sudo snap install bitcoin-core
sudo snap refresh --hold bitcoin-core # To prevent automated update of bitcoin-core
sudo ln -s /snap/bitcoin-core/current/bin/bitcoin{d,-cli} /usr/local/bin/
```
@@ -175,7 +176,7 @@ OS version: Fedora 27 or above
Get dependencies:
```shell
$ sudo dnf update -y && \
sudo dnf update -y && \
sudo dnf groupinstall -y \
'C Development Tools and Libraries' \
'Development Tools' && \
@@ -201,36 +202,36 @@ Make sure you have [bitcoind](https://github.com/bitcoin/bitcoin) available to r
Clone lightning:
```shell
$ git clone https://github.com/ElementsProject/lightning.git
$ cd lightning
git clone https://github.com/ElementsProject/lightning.git
cd lightning
```
Checkout a release tag:
```shell
$ git checkout v22.11.1
git checkout v22.11.1
```
Build and install lightning:
```shell
$lightning> ./configure
$lightning> make
$lightning> sudo make install
./configure
make
sudo make install
```
Running lightning (mainnet):
```shell
$ bitcoind &
$ lightningd --network=bitcoin
bitcoind &
lightningd --network=bitcoin
```
Running lightning on testnet:
```shell
$ bitcoind -testnet &
$ lightningd --network=testnet
bitcoind -testnet &
lightningd --network=testnet
```
## To Build on FreeBSD
@@ -318,11 +319,11 @@ Finally, build `c-lightning`:
Use nix-shell launch a shell with a full Core Lightning dev environment:
```shell
$ nix-shell -Q -p gdb sqlite autoconf git clang libtool sqlite autoconf \
nix-shell -Q -p gdb sqlite autoconf git clang libtool sqlite autoconf \
autogen automake gmp zlib gettext libsodium poetry 'python3.withPackages (p: [p.bitcoinlib])' \
valgrind --run "./configure && poetry shell"
$ poetry install
$ make
poetry install
make
```
## To Build on macOS
@@ -330,67 +331,67 @@ $ make
Assuming you have Xcode and Homebrew installed. Install dependencies:
```shell
$ brew install autoconf automake libtool python3 gnu-sed gettext libsodium
$ ln -s /usr/local/Cellar/gettext/0.20.1/bin/xgettext /usr/local/opt
$ export PATH="/usr/local/opt:$PATH"
brew install autoconf automake libtool python3 gnu-sed gettext libsodium
ln -s /usr/local/Cellar/gettext/0.20.1/bin/xgettext /usr/local/opt
export PATH="/usr/local/opt:$PATH"
```
If you need SQLite (or get a SQLite mismatch build error):
```shell
$ brew install sqlite
$ export LDFLAGS="-L/usr/local/opt/sqlite/lib"
$ export CPPFLAGS="-I/usr/local/opt/sqlite/include"
brew install sqlite
export LDFLAGS="-L/usr/local/opt/sqlite/lib"
export CPPFLAGS="-I/usr/local/opt/sqlite/include"
```
Some library paths are different when using `homebrew` with M1 macs, therefore the following two variables need to be set for M1 machines
Some library paths are different when using `homebrew` on Macs with Apple silicon, therefore the following two variables need to be set for Macs with Apple silicon:
```shell
$ export CPATH=/opt/homebrew/include
$ export LIBRARY_PATH=/opt/homebrew/lib
export CPATH=/opt/homebrew/include
export LIBRARY_PATH=/opt/homebrew/lib
```
If you need Python 3.x for mako (or get a mako build error):
```shell
$ brew install pyenv
$ echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bash_profile
$ source ~/.bash_profile
$ pyenv install 3.8.10
$ pip install --upgrade pip
$ pip install poetry
brew install pyenv
echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bash_profile
source ~/.bash_profile
pyenv install 3.8.10
pip install --upgrade pip
pip install poetry
```
If you don't have bitcoind installed locally you'll need to install that as well:
```shell
$ brew install berkeley-db4 boost miniupnpc pkg-config libevent
$ git clone https://github.com/bitcoin/bitcoin
$ cd bitcoin
$ ./autogen.sh
$ ./configure
$ make src/bitcoind src/bitcoin-cli && make install
brew install berkeley-db4 boost miniupnpc pkg-config libevent
git clone https://github.com/bitcoin/bitcoin
cd bitcoin
./autogen.sh
./configure
make src/bitcoind src/bitcoin-cli && make install
```
Clone lightning:
```shell
$ git clone https://github.com/ElementsProject/lightning.git
$ cd lightning
git clone https://github.com/ElementsProject/lightning.git
cd lightning
```
Checkout a release tag:
```shell
$ git checkout v22.11.1
git checkout v22.11.1
```
Build lightning:
```shell
$ poetry install
$ ./configure
$ poetry run make
poetry install
./configure
poetry run make
```
Running lightning:
@@ -411,7 +412,7 @@ To install the built binaries into your system, you'll need to run `make install
make install
```
On an M1 mac you may need to use this command instead:
On a Mac with Apple silicon, you may need to use this command instead:
```shell
sudo PATH="/usr/local/opt:$PATH" LIBRARY_PATH=/opt/homebrew/lib CPATH=/opt/homebrew/include make install
@@ -429,8 +430,8 @@ pip install --user poetry
Clone Core Lightning:
```shell
$ git clone https://github.com/ElementsProject/lightning.git
$ cd lightning
git clone https://github.com/ElementsProject/lightning.git
cd lightning
```
Build Core Lightning: