@@ -10,22 +10,24 @@ Python 3.7.2
11### Instructions
11### Instructions
13−Before using Bridge, you'll need access to whatever media you're using to store the Ethereum wallet that owns or will own your Azimuth points. This could be an Urbit HD wallet containing a Master Ticket, a BIP39 mnemonic, a Ledger or Trezor hardware wallet, or an Ethereum private key or keystore file.
13+To use Bridge:
15−With that in hand, to use Bridge, [download a release](https://github.com/urbit/bridge/releases) and unzip it (`bridge-$version.zip`), then do one of the following:
15+- [Download a release](https://github.com/urbit/bridge/releases)
16+- Unzip it (`bridge-$version.zip`)
17+- Open up your command line interface (Terminal on MacOS, Command Prompt on Windows)
18+- Follow the instructions below to run Bridge
17−#### Non-Ledger
20+#### Running Bridge
19If you plan to authenticate and sign transactions with a Master Ticket, BIP39 mnemonic, Ethereum private key, or keystore file:
22If you plan to authenticate and sign transactions with a Master Ticket, BIP39 mnemonic, Ethereum private key, or keystore file:
21−1. Open up your command line interface (Terminal on MacOS, Command Prompt on Windows)
22−2. `cd` into the `bridge-$version` directory
24+1. `cd` into the `bridge-$version` directory
23−3. Run this command: `python3 -m http.server 5000 --bind 127.0.0.1`
25+2. Run this command: `python3 -m http.server 5000 --bind 127.0.0.1`
24−4. Navigate to http://localhost:5000 using a web browser to access Bridge
26+3. Navigate to http://localhost:5000 using a web browser to access Bridge
26−#### Ledger support
28+#### Running Bridge with Ledger support
28−To authenticate and sign transactions with a [Ledger](https://www.ledger.com/), Bridge must be serving over HTTPS on localhost. This requires self-signed certificates. To do this, follow these steps:
30+If you plan to authenticate and sign transactions with a [Ledger](https://www.ledger.com/), Bridge must be serving over HTTPS on localhost. This requires self-signed certificates. To do this:
301. Install [mkcert](https://github.com/FiloSottile/mkcert)
321. Install [mkcert](https://github.com/FiloSottile/mkcert)
312. If you're using Firefox, additionally install [nss](https://github.com/nss-dev/nss)
332. If you're using Firefox, additionally install [nss](https://github.com/nss-dev/nss)
@@ -33,8 +35,9 @@ To authenticate and sign transactions with a [Ledger](https://www.ledger.com/),
334. In the `bridge-$version` directory, generate a certificate valid for localhost via
354. In the `bridge-$version` directory, generate a certificate valid for localhost via
34 `mkcert localhost`. This will produce two files: `localhost.pem`, the local
36 `mkcert localhost`. This will produce two files: `localhost.pem`, the local
35 certificate, and `localhost-key.pem`, its corresponding private key
37 certificate, and `localhost-key.pem`, its corresponding private key
38+5. `cd` into the `bridge-$version` directory
36−5. Run `python bridge-https.py` from the `bridge-$version` directory
39+6. Run `python bridge-https.py` from the `bridge-$version` directory
37−6. Navigate to https://localhost:4443 in a web browser to access Bridge
40+7. Navigate to https://localhost:4443 in a web browser to access Bridge
39### Verify checksums
42### Verify checksums