git.iko.soy/bridge
on 05c1914 help sign in
bridge/README.md
120 lines 4.0 kB history raw
1# Bridge
3An application for interacting with Azimuth.
5## Usage
7To run Bridge, follow the instructions on the [latest release][rele] page.
9## Development Notes
11### Install / Build
13Clone the repo, and use a simple `npm install`. You can then use a `npm run
14build` to create an optimised static build (serve it with e.g. [serve][serv]).
16### General notes
18For development, use `npm run pilot` to get going after a `npm install`. This
19will boot up a Ganache node in the background, deploy the Azimuth contracts to
20it, and fire up a local webserver. Bridge will be served on `localhost:3000`.
22Note that one of our dependencies itself depends on a library called
23`handle-thing` which breaks under the Ledger support requirements (see below)
24on node 11.1.0, so make sure you're using some other node version.
26You can use [nvm](https://github.com/creationix/nvm), for example, and do:
28```
29$ nvm install 11.0.0
30$ nvm use v11.0.0
31```
33before running `npm run pilot`.
35### Ledger support
37To authenticate and sign transactions with a Ledger, Bridge must be serving
38over HTTPS on localhost. This requires self-signed certificates. You can do
39this via the following:
41* Install [mkcert](https://github.com/FiloSottile/mkcert)
42* Install a local certificate authority via `mkcert -install`
43* In your `bridge` directory, generate a certificate valid for localhost via
44 `mkcert localhost`. This will produce two files: `localhost.pem`, the local
45 certificate, and `localhost-key.pem`, its corresponding private key.
46* Run `python bridge-https.py`
48Bridge will serve to localhost over HTTPS on port 4443
50### Useful Accounts
52The ecliptic owner is the only account that's able to create galaxies, so
53it's a good place to get started. On the testnet, it's the address:
55```
560x6DEfFb0caFDB11D175F123F6891AA64F01c24F7d
57```
59You can authenticate as it using the following mnemonic:
61```
62benefit crew supreme gesture quantum web media hazard theory mercy wing kitten
63```
65Under that mnemonic, Ganache will also auto-populate the following accounts
66with 100 ETH:
68```
690x6deffb0cafdb11d175f123f6891aa64f01c24f7d
700xd53208cf45fc9bd7938b200bff8814a26146688f
710x7b2a2d51e4d8fac602e20a5f6907ff9fbd88e1fd
720xf48062ae8bafd6ef19cd6cb89db93a0d0ca6ce26
730xf84a77aeb351c49dfa87e805a659d2daddff7606
740x167e357cf8b845370d0d408f9b389b66185b7b5b
750xcbecf3abc9878f07afc851aead2d8f1c436cc71d
760x0afc0c3f4eeea500871f464ca71eef5e54a9af36
770x6d654ef2489674d21aed428e8a4ad8ca4820f125
780x218f6f87683db546ad47a5dc8b480e5a9b694866
79```
81To play around with any of these, authenticate using the same mnemonic, but
82use a custom HD path of `m/44'/60'/0'/0/1`, `m/44'/60'/0'/0/2`, and so on.
84### Initial Development State
86You can also tweak a couple of things to change your development state
87somewhat (say, for example, you want to start on the points list screen, instead
88of having to re-authenticate whenever you make a change or refresh the page):
90* The `.env.development` file contains environment variables that you can
91 provide to the application when it's running in development. You can access
92 them via `process.env.REACT_APP_<whatever>`.
94* The `componentDidMount` method of the Bridge component in `src/Bridge.js`
95 can be tweaked for setting your initial state. You can provide a specific
96 wallet, network type, and so on.
98### HTTPS
100For development, you can enable HTTPS on localhost without a certificate for
101Chrome by pasting the following into the URL bar:
103```
104chrome://flags/#allow-insecure-localhost
105```
107Additionally you need to run with the `HTTPS` environment variable set to
108`true`. Note that `npm run pilot` will handle this automatically.
110### Releases
112To generate a release `bridge-$VERSION.zip` file, use a simple `npm run
113release`.
115This will pack the build directory together with the README, `bridge-https.py`
116script, and also generate a set of checksums for the build directory. You can
117verify the checksums on e.g. OS X via `shasum -c checksums.txt`.
119[rele]: https://github.com/urbit/bridge/releases/latest
120[serv]: http://npmjs.com/package/serve